@cnbcool/cnb-api-generate 2.11.3 → 2.11.5

package/client/utils/upload.ts

@@ -99,7 +99,6 @@ interface IssueAssetUploadURLResponseData {
   path?: string;
   asset_link?: string;
   upload_url?: string;
-  download_url?: string;
 }
 
 /** Pull 上传 API 响应 */
@@ -124,15 +123,19 @@ 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;
   asset_group_id?: string;
-  download_url?: string;
 }
 
 /** Pull 上传成功时的 data */
 interface PullUploadData {
+  /** asset_link 的别名，语义更直观，方便 AI 理解这是一个可直接插入评论的 markdown 链接 */
+  asset_link?: string;
+  markdown?: string;
   name: string;
   path?: string;
   size: number;
@@ -283,15 +286,17 @@ 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: firstEntry?.asset_link,
+      asset_link: assetLink,
+      markdown: assetLink,
       name: firstEntry?.name || fileName,
       path: firstEntry?.path,
       size: fileSize,
       asset_group_id: groupData?.asset_group_id,
-      download_url: firstEntry?.download_url,
     },
   };
 }
@@ -343,12 +348,13 @@ 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: data?.asset_link,
+      asset_link: assetLink,
+      markdown: assetLink,
       name: data?.name || fileName,
       path: data?.path,
       size: fileSize,
-      download_url: data?.download_url,
     };
   } else {
     // Pull：沿用 upload-files / upload-imgs 一步走接口
@@ -357,9 +363,19 @@ 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 = {
-      name: data?.assets?.name || fileName,
-      path: data?.assets?.path,
+      asset_link: assetLink,
+      markdown: assetLink,
+      name: assetName,
+      path: assetPath,
       size: fileSize,
       token: data?.token,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "2.11.3",
+  "version": "2.11.5",
   "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, "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, "kind": "file",  "dataTip": "--file 文件路径" },
+    { "shortName": "upload-image",   "realTool": "upload-imgs",               "description": "上传图片",      "repoOnly": true, "upload": true, "kind": "image", "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 图片路径" },