@cnbcool/cnb-api-generate 2.21.0 → 2.21.2

package/client/lib/execute-action.ts

@@ -114,7 +114,8 @@ export async function executeAction(
     const result = await diagnoseBuild({
       repo: (params.repo as string) || '',
       sn: (opts.sn as string) || undefined,
-      prNumber: process.env.CNB_PULL_REQUEST_IID || undefined,
+      // --number 显式传入时优先，未传时由 autoPath 用 CNB_PULL_REQUEST_IID 兜底
+      prNumber: (params.number as string) || undefined,
     });
     console.log(result);
     return;
@@ -124,7 +125,8 @@ export async function executeAction(
     const result = await analyzeBuildTiming({
       repo: (params.repo as string) || '',
       sn: (opts.sn as string) || undefined,
-      prNumber: process.env.CNB_PULL_REQUEST_IID || undefined,
+      // --number 显式传入时优先，未传时由 autoPath 用 CNB_PULL_REQUEST_IID 兜底
+      prNumber: (params.number as string) || undefined,
     });
     console.log(result);
     return;

package/client/lib/register-modules.ts

@@ -203,17 +203,16 @@ export function registerModuleCommands(program: Command): void {
       // 按命令类别注册选项：upload / ci 自定义 / 普通 swagger 命令
       if (shortcut.upload) {
         shortcutCmd.requiredOption('--file <string>', '本地文件路径。必填。');
-        // --number 一律注册，但只有 issue 评论上传会消费：
+        // --number 一律注册以统一 Issue / PR 两侧参数形态，但只有 issue 评论上传会消费：
         // - post-issue-comment-*-asset-upload-url（issue 评论上传）：path 为 repo + number
-        // - post-asset-group（创建 issue 时上传）：path 只有 repo，number 传了也会被忽略
-        // - pull 侧 upload-files / upload-imgs：按仓库维度上传，同样不需要 number
+        // - post-asset-group / pull 侧 upload-*：path 只有 repo，number 传了也被忽略
         registerAutoInjectedPathOptions(shortcutCmd);
       } else if (
         shortcut.realTool === '__get-ci-logs__' ||
         shortcut.realTool === '__get-ci-timing__'
       ) {
         shortcutCmd.option('--sn <string>', '构建号（可选，默认自动从环境变量或 PR 状态获取）');
-        // CI 命令按 PR 维度查询，同样注册 --number 保持两侧参数形态一致
+        // CI 命令按 PR 维度查询，--number 会作为 prNumber 参与查询（见 execute-action）
         registerAutoInjectedPathOptions(shortcutCmd);
       } else {
         registerToolOptions(shortcutCmd, moduleName, shortcut.realTool, true);

package/client/shortcuts.ts

@@ -16,7 +16,11 @@ export interface ShortcutDefinition {
   shortName: string;
   /** 实际对应的 tool 文件名 */
   realTool: string;
-  /** 为 true 时只注入 repo，不注入 number */
+  /**
+   * 为 true 时只注入 repo，不注入 number。
+   * CI 查询类命令（get-ci-logs / get-ci-timing）不得标记：其 number 会作为
+   * prNumber 参与查询，标记后会静默丢失 --number 的覆盖能力。
+   */
   repoOnly?: boolean;
   /** 为 true 时表示是上传命令，走完整上传流程 */
   upload?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "2.21.0",
+  "version": "2.21.2",
   "main": "./built/index.js",
   "module": "./src/index.ts",
   "types": "./src/index.ts",

package/quick-commands.json

@@ -31,8 +31,8 @@
     { "shortName": "list-assignees", "realTool": "list-pull-assignees",       "description": "查看处理人" },
     { "shortName": "upload-file",    "realTool": "upload-files",              "description": "上传文件",      "repoOnly": true, "upload": true, "kind": "file",  "hideInSkill": true, "dataTip": "--file 文件路径" },
     { "shortName": "upload-image",   "realTool": "upload-imgs",               "description": "上传图片",      "repoOnly": true, "upload": true, "kind": "image", "hideInSkill": true, "dataTip": "--file 图片路径" },
-    { "shortName": "get-ci-logs",    "realTool": "__get-ci-logs__",           "description": "获取 CI 失败日志", "repoOnly": true, "custom": true, "dataTip": "--sn 构建号（可选）" },
-    { "shortName": "get-ci-timing",  "realTool": "__get-ci-timing__",         "description": "分析 CI 耗时瓶颈", "repoOnly": true, "custom": true, "dataTip": "--sn 构建号（可选）" },
+    { "shortName": "get-ci-logs",    "realTool": "__get-ci-logs__",           "description": "获取 CI 失败日志", "custom": true, "dataTip": "--sn 构建号（可选）" },
+    { "shortName": "get-ci-timing",  "realTool": "__get-ci-timing__",         "description": "分析 CI 耗时瓶颈", "custom": true, "dataTip": "--sn 构建号（可选）" },
     { "shortName": "get-imgs",       "realTool": "get-pr-imgs",               "description": "获取 PR 图片",     "repoOnly": true, "dataTip": "--img-path 图片路径" },
     { "shortName": "get-files",      "realTool": "get-pr-files",              "description": "获取 PR 附件",     "repoOnly": true, "dataTip": "--file-path 附件路径" }
   ],