更新模板到最新状态

components/system/source/shell/sh.h

@@ -244,7 +244,8 @@ typedef struct sh_obj_def // 对象内存结构
  *   1. 如果 FUNC 取值为 NULL 时， SUB_NAME 必须指向 SH_DEF_SUB_CMD 定义的子命令列表名；
  *   2. 如果 FUNC 取值为函数时:
  *      2.1 SUB_NAME 可为 NULL；
- *      2.1 SUB_NAME 指向 void (*cp_fn)(sh_t *sh_hdl, int argc, const char *argv[]) 表示按 TAB 键时被执行的函数，用于参数补全。
+ *      2.1 SUB_NAME 指向 void (*cp_fn)(sh_t *sh_hdl, int argc, const char *argv[]) 表示按 TAB 键时被执行的函数，
+ *          这个函数内部允许执行 cp_fn 应用，用于帮助对 FUNC 命令参数补全。
  *
  * @verbatim
  * @c sh.c
@@ -316,6 +317,7 @@ SH_CMD_CP_FN(_sh_generic_cp_fn) {}
 int sh_register_cmd(const sh_cmd_reg_t *sh_reg);      // 可用自动初始化宏执行 @ref SH_REGISTER_CMD
 int sh_register_cmd_hide(const sh_cmd_reg_t *sh_reg); // 可用自动初始化宏执行 @ref SH_REGISTER_CMD
 int sh_unregister_cmd(const sh_cmd_reg_t *sh_reg);    // 取消注册一个根命令
+void sh_unregister_all(sh_t *sh_hdl);                 // 取消所有已注册命令
 
 /* 现成终端协议初始化 ----------------------------------------------------------------- */
 
@@ -337,7 +339,7 @@ void sh_set_prompt(sh_t *sh_hdl, const char *prompt); // 设置提示符
 
 void sh_reset_line(sh_t *sh_hdl); // 清除命令接收缓存
 
-int sh_echo(sh_t *sh_hdl, const char *fmt, ...);  // 回显到终端
+int sh_echo(sh_t *sh_hdl, const char *fmt, ...); // 回显到终端
 
 sh_parse_t sh_parse_value(const char *str); // 参数工具：解析字符串表示的数值
 
@@ -347,12 +349,10 @@ int sh_get_cmd_result(sh_t *sh_hdl); // 获取上一条有效命令的返回值
 
 void sh_refresh_line(sh_t *sh_hdl); // 执行刷一次当前命令行显示
 
+sh_cmd_info_t sh_cmd_test(sh_t *sh_hdl, int argc, const char *argv[]); // 根据参数，完整解析命令并获取命令信息
+
 /* cp_fn 应用 ---------------------------------------------------------------------- */
 
-sh_cmd_info_t sh_cmd_info(sh_t *sh_hdl, int argc, const char *argv[]); // 根据参数，获取完全匹配的命令信息
-
-sh_cp_op_t sh_completion_cmd(sh_t *sh_hdl, int argc, const char *argv[]); // 根据参数，在已注册命令中查找并自动补全命令
-
 sh_cp_op_t sh_completion_param(sh_t *sh_hdl, const sh_cp_param_t *param); // 仅在 cp_fn() 中可用，根据当前命令行内容，在给出的参数结构中查找并自动补全参数。参数允许为 NULL
 
 void sh_completion_resource(sh_t *sh_hdl, const char *arg_str, const char *res_str, const char *help); // 仅在 cp_fn() 中可用，根据当前命令行内容，逐个给出可供查找的提示符。内部将根据所提供的数据自动补全