@cnbcool/cnb-api-generate 2.12.2 → 2.12.3

package/client/utils/upload.ts

@@ -130,6 +130,15 @@ interface IssueUploadData {
 
 /** Pull 上传成功时的 data */
 interface PullUploadData {
+  /**
+   * 资源链接，添加到 body 中提交。
+   *
+   * pull 上传接口（/{repo}/-/upload/{files,imgs}）响应模型 dto.UploadAssetsResponse
+   * 并没有 asset_link 字段，等价信息由 assets.path 承载，
+   * 这里用 assets.path + 文件名拼成与 issue 侧一致的 markdown 形态
+   * （图片 `![name](path)`、文件 `[name](path)`）。
+   */
+  asset_link?: string;
   name: string;
   size: number;
   token?: string;
@@ -209,6 +218,39 @@ async function putFileStream(
   return undefined;
 }
 
+/**
+ * 去掉资源路径里的仓库 slug 前缀。
+ *
+ * pull 上传接口返回的 assets.path 形如 `/{slug}/-/imgs/xxx/xxx.png`，
+ * 而 issue 侧 asset_link 是不带 slug 的 `/-/files/issues/xxx/xxx.txt`，
+ * 这里统一截断到 `/-/` 开始，保证两条上传路径产出的引用格式一致。
+ */
+function stripSlugPrefix(assetPath: string): string {
+  const idx = assetPath.indexOf('/-/');
+  return idx > 0 ? assetPath.slice(idx) : assetPath;
+}
+
+/**
+ * 转义 markdown 链接文字。
+ *
+ * 链接文字取自文件名（本地文件决定，属于不可信输入），
+ * 含 `[` `]` `(` `)` `\` 时会破坏链接结构、甚至注入额外 markdown，
+ * 换行同样会打断评论结构，这里统一转义 / 折叠为空格。
+ */
+function escapeMarkdownLinkText(text: string): string {
+  return text.replace(/[[\]()\\]/g, '\\$&').replace(/\r?\n/g, ' ');
+}
+
+/**
+ * 编码 markdown 链接地址。
+ *
+ * 先做 URL 编码处理空格等字符，再把圆括号转成百分号形式，
+ * 避免路径里的 `(` `)` 提前截断 `[](...)` 结构。
+ */
+function encodeMarkdownLinkUrl(url: string): string {
+  return encodeURI(url).replace(/\(/g, '%28').replace(/\)/g, '%29');
+}
+
 /** asset-group 接口请求体 */
 interface PostAssetGroupForm {
   image_assets?: Array<{ name: string; size: number; content_type: string }>;
@@ -303,6 +345,7 @@ export async function handleIssueCreateUpload(
  * Pull 路径（保留原有的 upload-files / upload-imgs 一步上传）：
  *   1. POST /{repo}/upload-files（或 imgs） 拿 upload_url
  *   2. PUT 文件流到 upload_url
+ *   3. 该接口不返回 asset_link，用 assets.path + 文件名拼成 markdown 形态的 asset_link 返回给调用方
  *
  * @param shortcut    解析后的快捷命令；shortcut.kind 决定 issue 上传走 file 还是 image 通道
  * @param filePath    本地文件路径
@@ -349,8 +392,21 @@ export async function handleUpload(
     const data = apiResponse?.data as PullUploadResponseData | undefined;
     uploadUrl = data?.upload_url;
     if (!uploadUrl) return apiResponse as unknown as UploadResult;
+    // 接口只返回 assets.path，这里按 issue 侧 asset_link 的 markdown 形态拼装：
+    // 图片 -> ![name](path)，文件 -> [name](path)
+    // 链接文字直接复用返回的 name（图片会被服务端改名为 uuid，文件保持原名）
+    // 路径去掉 slug 前缀，与 issue 侧 asset_link 保持一致
+    const assetPath = data?.assets?.path;
+    const assetName = data?.assets?.name || fileName;
+    // kind 由 quick-commands.json 配置，是权威来源；
+    // realTool 名兜底仅用于兼容老版本产物里没有 kind 的 shortcuts 配置，
+    // 一旦 realTool 被重命名该兜底会失效（此时应以配置里的 kind 为准）。
+    const isImage = shortcut.kind === 'image' || shortcut.tool === 'upload-imgs';
     successData = {
-      name: data?.assets?.name || fileName,
+      asset_link: assetPath
+        ? `${isImage ? '!' : ''}[${escapeMarkdownLinkText(assetName)}](${encodeMarkdownLinkUrl(stripSlugPrefix(assetPath))})`
+        : undefined,
+      name: assetName,
       size: fileSize,
       token: data?.token,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "2.12.2",
+  "version": "2.12.3",
   "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, "hideInSkill": true, "dataTip": "--file 文件路径" },
-    { "shortName": "upload-image",   "realTool": "upload-imgs",               "description": "上传图片",      "repoOnly": true, "upload": true, "hideInSkill": true, "dataTip": "--file 图片路径" },
+    { "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-imgs",       "realTool": "get-pr-imgs",               "description": "获取 PR 图片",     "repoOnly": true, "dataTip": "--img-path 图片路径" },