@cnbcool/cnb-api-generate 2.11.5 → 2.11.7

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

@@ -123,8 +123,6 @@ interface UploadErrorData {
 /** Issue 上传成功时的 data（asset_group_id 仅在创建 issue 流程下返回） */
 interface IssueUploadData {
   asset_link?: string;
-  /** asset_link 的别名，语义更直观，方便 AI 理解这是一个可直接插入评论的 markdown 链接 */
-  markdown?: string;
   name: string;
   path?: string;
   size: number;
@@ -133,9 +131,6 @@ interface IssueUploadData {
 
 /** Pull 上传成功时的 data */
 interface PullUploadData {
-  /** asset_link 的别名，语义更直观，方便 AI 理解这是一个可直接插入评论的 markdown 链接 */
-  asset_link?: string;
-  markdown?: string;
   name: string;
   path?: string;
   size: number;
@@ -286,13 +281,10 @@ export async function handleIssueCreateUpload(
   if (putErr) return putErr;
 
   // 3. 返回结果（asset_link 拼入创建 issue 的 body，asset_group_id 备用）
-  // markdown 作为 asset_link 的别名，方便 AI 理解使用
-  const assetLink = firstEntry?.asset_link;
   return {
     status: 200,
     data: {
-      asset_link: assetLink,
-      markdown: assetLink,
+      asset_link: firstEntry?.asset_link,
       name: firstEntry?.name || fileName,
       path: firstEntry?.path,
       size: fileSize,
@@ -348,10 +340,8 @@ export async function handleUpload(
     const data = apiResponse?.data as IssueAssetUploadURLResponseData | undefined;
     uploadUrl = data?.upload_url;
     if (!uploadUrl) return apiResponse as unknown as UploadResult;
-    const assetLink = data?.asset_link;
     successData = {
-      asset_link: assetLink,
-      markdown: assetLink,
+      asset_link: data?.asset_link,
       name: data?.name || fileName,
       path: data?.path,
       size: fileSize,
@@ -363,19 +353,9 @@ export async function handleUpload(
     const data = apiResponse?.data as PullUploadResponseData | undefined;
     uploadUrl = data?.upload_url;
     if (!uploadUrl) return apiResponse as unknown as UploadResult;
-    // markdown 作为 asset_link 的别名，方便 AI 理解使用
-    // Pull 上传不返回 asset_link，由 assets.path + name 构造 markdown 链接
-    const assetPath = data?.assets?.path;
-    const assetName = data?.assets?.name || fileName;
-    const isImage = shortcut.kind === 'image';
-    const assetLink = assetPath
-      ? `${isImage ? '!' : ''}[${assetName}](${assetPath})`
-      : undefined;
     successData = {
-      asset_link: assetLink,
-      markdown: assetLink,
-      name: assetName,
-      path: assetPath,
+      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.5",
+  "version": "2.11.7",
   "main": "./built/index.js",
   "module": "./src/index.ts",
   "types": "./src/index.ts",

package/quick-commands.json

@@ -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, "kind": "file",  "dataTip": "--file 文件路径" },
-    { "shortName": "upload-image",   "realTool": "upload-imgs",               "description": "上传图片",      "repoOnly": true, "upload": true, "kind": "image", "dataTip": "--file 图片路径" },
+    { "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": "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 图片路径" },