@cnbcool/cnb-cli 1.2.0 → 1.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-cli",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作",
   "main": "skills/cnb-api/scripts/core/index.js",
   "bin": {
@@ -33,10 +33,10 @@
   },
   "author": "",
   "license": "MIT",
-  "dependencies": {
-    "@cnbcool/cnb-api-generate": "^2.1.0"
-  },
   "devDependencies": {
     "skills": "^1.4.4"
+  },
+  "dependencies": {
+    "@cnbcool/cnb-api-generate": "^2.2.0"
   }
 }

package/skills/cnb-api/scripts/core/lib/format-params.js

@@ -27,10 +27,8 @@ function getToolParamDefs(moduleName, toolName) {
  * @returns 格式化后的参数对象，包含 module, tool, path, query, data 等
  */
 function formatParams(params) {
-  console.log(JSON.stringify(params));
   // 先将 CLI 带 '-' 的参数名还原为原始 '_'/'@' 参数名
   params = (0, _restoreOriginalKeys.restoreOriginalKeys)(params);
-  console.log(params);
   const formatted = {
     module: params.module,
     tool: params.tool
@@ -106,7 +104,15 @@ function formatParams(params) {
       } else if (bodyProps[key]) {
         // body 字段（无冲突，直接用原 key）
         if (!formatted.data) formatted.data = {};
-        formatted.data[key] = Array.isArray(value) ? value : (0, _parsers.tryParseJSON)(value);
+        if (Array.isArray(value)) {
+          formatted.data[key] = value;
+        } else if (bodyProps[key].type === 'string') {
+          // schema 定义为 string 类型时，保持原始字符串，不做 JSON 解析
+          // 避免纯数字字符串（如 "123"）被转为 number
+          formatted.data[key] = value;
+        } else {
+          formatted.data[key] = (0, _parsers.tryParseJSON)(value);
+        }
       } else {
         // 处理 d- 前缀（冲突时 CLI 以 d- 前缀传入）
         const stripped = key.startsWith('d-') || key.startsWith('d_') ? key.replace(/^d[-_]/, '') : key;

package/skills/cnb-api/scripts/core/lib/print-json.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.printJSON = printJSON;
+var _toon = require("@toon-format/toon");
 /**
  * 将数据转换为格式化的 JSON 字符串
  * @param data 要序列化的数据（可以是任意类型）缩进）
@@ -11,5 +12,13 @@ exports.printJSON = printJSON;
  * @returns 格式化的 JSON 字符串，如果序列化失败则返回错误信息的 JSON
  */
 function printJSON(data, verbose = false) {
-  return verbose ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+  if (verbose) {
+    return JSON.stringify(data, null, 2);
+  } else {
+    try {
+      return (0, _toon.encode)(data);
+    } catch (e) {
+      return JSON.stringify(data);
+    }
+  }
 }

package/skills/cnb-api/scripts/core/lib/register-modules.js

@@ -14,14 +14,16 @@ var _shortcuts = require("../shortcuts");
  * 为单个 tool 子命令注册 Commander options
  * 直接读取预生成的 flat-options.json 中已扁平化的参数定义，无需运行时计算
  */
-function registerToolOptions(toolCmd, moduleName, toolName) {
+function registerToolOptions(toolCmd, moduleName, toolName, skipPathMandatory) {
   const moduleOptions = _flatOptionsData.flatOptionsData[moduleName];
   if (!moduleOptions) return;
   const toolOptions = moduleOptions[toolName];
   if (!toolOptions) return;
   for (const [, opt] of Object.entries(toolOptions)) {
+    // 快捷命令跳过 path 参数（由环境变量自动注入）
+    if (skipPathMandatory && opt.source === 'path') continue;
     const option = new _commander.Option(`--${opt.optKey} ${opt.valuePlaceholder}`.trim(), opt.description);
-    if (opt.required && opt.source === 'path') {
+    if (opt.required && opt.source === 'path' && !skipPathMandatory) {
       option.makeOptionMandatory();
     }
     if (opt.choices) {
@@ -43,6 +45,15 @@ function registerToolOptions(toolCmd, moduleName, toolName) {
   }
 }
 
+/**
+ * 获取指定模块的快捷命令列表
+ */
+function getShortcutsForModule(moduleName) {
+  if (moduleName === 'issues') return _shortcuts.ISSUE_SHORTCUTS;
+  if (moduleName === 'pulls') return _shortcuts.PR_SHORTCUTS;
+  return [];
+}
+
 /**
  * 为每个模块注册子命令，使 cnb <module> -h 显示模块帮助
  * 每个 tool 的参数通过 Commander 的 option 系统注册，--help 自动展示参数说明
@@ -53,6 +64,9 @@ function registerModuleCommands(program) {
     const toolEntries = Object.values(tools);
     const sub = program.command(moduleName).description(`${moduleName} 模块 (${toolEntries.length} tools)`).helpOption('-h, --help', '显示帮助文档');
 
+    // 收集已注册的子命令名，避免快捷命令与真实 tool 名冲突
+    const registeredNames = new Set();
+
     // 为每个 tool 注册子命令
     for (const [toolName, toolInfo] of Object.entries(tools)) {
       const summary = (0, _trimSummary.trimSummary)(toolInfo.summary || '');
@@ -67,6 +81,23 @@ function registerModuleCommands(program) {
 
       // 根据 flat-options.json 注册参数选项
       registerToolOptions(toolCmd, moduleName, toolName);
+      registeredNames.add(toolName);
+    }
+
+    // 为快捷命令注册 Commander 子命令（别名）
+    // 复用对应真实 tool 的选项定义，但跳过 path 参数（由环境变量自动注入）
+    const shortcuts = getShortcutsForModule(moduleName);
+    for (const shortcut of shortcuts) {
+      // 如果快捷命令名与真实 tool 名重复，跳过（真实 tool 优先）
+      if (registeredNames.has(shortcut.shortName)) continue;
+      const shortcutCmd = sub.command(shortcut.shortName).description(`[快捷] ${shortcut.description}`).option('-v, --verbose', '输出完整原始响应').helpOption('-h, --help', '显示帮助文档').showHelpAfterError(true).action(async opts => {
+        // 传入快捷命令名，executeAction 内部会通过 resolveShortcut 转换
+        await (0, _executeAction.executeAction)(moduleName, shortcut.shortName, opts, sub);
+      });
+
+      // 复用真实 tool 的选项，跳过 path 参数
+      registerToolOptions(shortcutCmd, moduleName, shortcut.realTool, true);
+      registeredNames.add(shortcut.shortName);
     }
 
     // 允许未匹配到子命令时也能正常执行（不报错）
@@ -74,16 +105,11 @@ function registerModuleCommands(program) {
     sub.allowExcessArguments();
 
     // 模块级 action：处理未匹配到子命令的情况
-    // 如果输入了快捷命令名（如 cnb issues get），Commander 匹配不到真实 tool 子命令，
-    // 会走到这里，此时尝试 resolveShortcut 将其转换为真实 tool
-    sub.argument('[tool]', '工具名称（支持快捷命令）').action(async (toolArg, opts) => {
+    sub.argument('[tool]', '工具名称（支持快捷命令）').action(async (toolArg, _opts) => {
       if (toolArg) {
-        const shortcut = (0, _shortcuts.resolveShortcut)(moduleName, toolArg);
-        if (shortcut) {
-          // 快捷命令匹配成功，走 executeAction 流程
-          await (0, _executeAction.executeAction)(moduleName, toolArg, opts, sub);
-          return;
-        }
+        // 此处已不会再命中快捷命令（因为已注册为子命令），仅作兜底
+        sub.help();
+        return;
       }
       sub.help();
     });

package/skills/cnb-api/scripts/core/shortcuts.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.PR_SHORTCUTS = exports.ISSUE_SHORTCUTS = void 0;
 exports.detectEventContext = detectEventContext;
 exports.resolveShortcut = resolveShortcut;
 exports.showShort = showShort;
@@ -40,7 +41,7 @@ function getPRNumber() {
 // 快捷命令定义
 // ============================================================
 
-const ISSUE_SHORTCUTS = [{
+const ISSUE_SHORTCUTS = exports.ISSUE_SHORTCUTS = [{
   shortName: 'get',
   realTool: 'get-issue',
   description: '获取详情'
@@ -100,7 +101,7 @@ const ISSUE_SHORTCUTS = [{
   upload: true,
   dataTip: "--file 图片路径"
 }];
-const PR_SHORTCUTS = [{
+const PR_SHORTCUTS = exports.PR_SHORTCUTS = [{
   shortName: 'get',
   realTool: 'get-pull',
   description: '获取详情'