@cnbcool/cnb-api-generate 2.11.6 → 2.11.8

package/built/skills-tools/render-quick-commands-md.js

@@ -18,7 +18,8 @@ function renderQuickCommandsMarkdown(byModule, cliCmd) {
         return '';
     const lines = [];
     for (const moduleName of moduleNames) {
-        const items = byModule[moduleName];
+        // hideInSkill 的命令仍正常注册可执行，仅不在 SKILL.md 中展示
+        const items = byModule[moduleName].filter((cmd) => !cmd.hideInSkill);
         if (!items.length)
             continue;
         lines.push(`${moduleName}:`);

package/client/lib/build-tool-params.ts

@@ -42,21 +42,31 @@ export function buildToolParams(formattedParams: {
 
   // 2) 按形态构造第 1 个参数
   let firstParam: Record<string, any> | string | null = null;
+  let hasFirstParam = false;
   if (isObjectShape) {
-    // 对象形态：合并 path 与运行期 query；任一为空都允许，toolFunction 内部解构是可选的
-    if (path || queryHasValue) {
-      firstParam = { ...(path ?? {}), ...(query ?? {}) };
-    }
+    // 对象形态：合并 path 与运行期 query。
+    // 即便 path 与 query 都为空，也必须传入 {}——生成代码的第 1 形参是无默认值的解构
+    // （如 `async function _default({ ...query }, ...)`），不给会触发
+    // `Cannot destructure 'undefined' as it is undefined`。
+    // 典型场景：`workspace/list-workspaces`——无 path、query 全部可选，用户不传任何参数。
+    firstParam = { ...(path ?? {}), ...(query ?? {}) };
+    hasFirstParam = true;
   } else if (path) {
     // 标量形态：仅当 path 恰好 1 个字段时拆出值；其它情形（含异常的多字段）不构造，
     // 避免悄悄把不该传的字段塞给 toolFunction
     const keys = Object.keys(path);
-    if (keys.length === 1) firstParam = path[keys[0]];
+    if (keys.length === 1) {
+      firstParam = path[keys[0]];
+      hasFirstParam = true;
+    }
   }
 
-  // 3) 组装最终位置参数列表（与历史行为一致：firstParam 真值才 push；data 真值才 push）
+  // 3) 组装最终位置参数列表
+  //    - 对象形态：始终占位（即便为空对象），保证解构安全
+  //    - 标量形态：仅当拿到实际值时 push
+  //    - data：真值才 push（与历史行为一致）
   const toolsParam: any[] = [];
-  if (firstParam) toolsParam.push(firstParam);
+  if (hasFirstParam) toolsParam.push(firstParam);
   if (data) toolsParam.push(data);
   return toolsParam;
 }

package/client/utils/upload.ts

@@ -124,7 +124,6 @@ interface UploadErrorData {
 interface IssueUploadData {
   asset_link?: string;
   name: string;
-  path?: string;
   size: number;
   asset_group_id?: string;
 }
@@ -132,7 +131,6 @@ interface IssueUploadData {
 /** Pull 上传成功时的 data */
 interface PullUploadData {
   name: string;
-  path?: string;
   size: number;
   token?: string;
 }
@@ -286,7 +284,6 @@ export async function handleIssueCreateUpload(
     data: {
       asset_link: firstEntry?.asset_link,
       name: firstEntry?.name || fileName,
-      path: firstEntry?.path,
       size: fileSize,
       asset_group_id: groupData?.asset_group_id,
     },
@@ -343,7 +340,6 @@ export async function handleUpload(
     successData = {
       asset_link: data?.asset_link,
       name: data?.name || fileName,
-      path: data?.path,
       size: fileSize,
     };
   } else {
@@ -355,7 +351,6 @@ export async function handleUpload(
     if (!uploadUrl) return apiResponse as unknown as UploadResult;
     successData = {
       name: data?.assets?.name || fileName,
-      path: data?.assets?.path,
       size: fileSize,
       token: data?.token,
     };

package/package.json

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

package/quick-commands.json

@@ -9,8 +9,8 @@
     { "shortName": "add-labels",          "realTool": "post-issue-labels",                        "description": "添加标签",            "dataTip": "--labels bug --labels feature" },
     { "shortName": "list-assignees",      "realTool": "list-issue-assignees",                     "description": "查看处理人" },
     { "shortName": "add-assignees",       "realTool": "post-issue-assignees",                     "description": "添加处理人",          "dataTip": "--assignees username" },
-    { "shortName": "upload-file",         "realTool": "post-issue-comment-file-asset-upload-url", "description": "上传 issue 评论文件",  "upload": true, "kind": "file",  "dataTip": "--file 文件路径" },
-    { "shortName": "upload-image",        "realTool": "post-issue-comment-image-asset-upload-url","description": "上传 issue 评论图片",  "upload": true, "kind": "image", "dataTip": "--file 图片路径" },
+    { "shortName": "upload-file",         "realTool": "post-issue-comment-file-asset-upload-url", "description": "上传 issue 评论文件",  "upload": true, "kind": "file",  "hideInSkill": true, "dataTip": "--file 文件路径" },
+    { "shortName": "upload-image",        "realTool": "post-issue-comment-image-asset-upload-url","description": "上传 issue 评论图片",  "upload": true, "kind": "image", "hideInSkill": true, "dataTip": "--file 图片路径" },
     { "shortName": "create-upload-file",  "realTool": "post-asset-group",                         "description": "创建 issue 时上传文件", "upload": true, "kind": "file",  "dataTip": "--file 文件路径" },
     { "shortName": "create-upload-image", "realTool": "post-asset-group",                         "description": "创建 issue 时上传图片", "upload": true, "kind": "image", "dataTip": "--file 图片路径" },
     { "shortName": "get-imgs",            "realTool": "get-issue-imgs",                           "description": "获取 issue 图片",       "repoOnly": true, "dataTip": "--img-path 图片路径" },
@@ -27,8 +27,8 @@
     { "shortName": "check-status",   "realTool": "list-pull-commit-statuses", "description": "查看 CI 状态" },
     { "shortName": "list-reviews",   "realTool": "list-pull-reviews",         "description": "查看评审列表" },
     { "shortName": "list-assignees", "realTool": "list-pull-assignees",       "description": "查看处理人" },
-    { "shortName": "upload-file",    "realTool": "upload-files",              "description": "上传文件",      "repoOnly": true, "upload": true, "dataTip": "--file 文件路径" },
-    { "shortName": "upload-image",   "realTool": "upload-imgs",               "description": "上传图片",      "repoOnly": true, "upload": true, "dataTip": "--file 图片路径" },
+    { "shortName": "upload-file",    "realTool": "upload-files",              "description": "上传文件",      "repoOnly": true, "upload": true, "hideInSkill": true, "dataTip": "--file 文件路径" },
+    { "shortName": "upload-image",   "realTool": "upload-imgs",               "description": "上传图片",      "repoOnly": true, "upload": true, "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-imgs",       "realTool": "get-pr-imgs",               "description": "获取 PR 图片",     "repoOnly": true, "dataTip": "--img-path 图片路径" },

package/skills-template/SKILL.md

@@ -12,6 +12,7 @@ description: CNB 平台交互命令，支持代码仓库、Issue、PR、CI、制
 <$QUICK_COMMANDS$>
 
 注意事项：
+
 - **参数自动识别**：快捷命令中的 Issue/PR 编号会自动从环境变量识别，无需额外传递。
 - **默认仅需摘要**：默认会精简响应输出结果，添加 `--verbose` 输出完整数据。
 - **单引号传参**：当 bash 的参数为多行文本时，使用单引号可减少防止命令注入攻击。
@@ -21,6 +22,7 @@ description: CNB 平台交互命令，支持代码仓库、Issue、PR、CI、制
 ## 常用链接
 
 在生成链接时请遵循下面的结构：
+
 - Issue: `<host>/<slug>/-/issues/<number>`
 - PR: `<host>/<slug>/-/pulls/<number>`