@cnbcool/cnb-cli 1.0.7 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-cli",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "description": "CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作",
   "main": "skills/cnb-api/scripts/core/index.js",
   "bin": {
@@ -34,7 +34,7 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
-    "@cnbcool/cnb-api-generate": "^1.2.3",
+    "@cnbcool/cnb-api-generate": "^1.2.5",
     "skills": "^1.4.4"
   }
 }

package/skills/cnb-api/scripts/core/index.js

@@ -10,6 +10,7 @@ var _path = _interopRequireDefault(require("path"));
 var _modules = require("./modules.help");
 var _tools = require("./tools.help");
 var _shortcuts = require("./shortcuts");
+var _upload = require("./utils/upload");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const helpFileContent = _fs.default.readFileSync(_path.default.join(__dirname, 'help.json'), 'utf8');
 if (!helpFileContent) {
@@ -169,7 +170,6 @@ function formatParams(params) {
   if (params.help) formatted.help = true;
   if (params.short) formatted.short = true;
   if (params.verbose) formatted.verbose = true;
-  if (params.summary) formatted.summary = true;
 
   // 旧格式兼容：--path / --query / --data 是 JSON 字符串
   if (typeof params.path === 'string') {
@@ -187,7 +187,7 @@ function formatParams(params) {
   if (paramDefs) {
     const pathDef = paramDefs.path || {};
     const queryDef = paramDefs.query || {};
-    const reservedKeys = new Set(['module', 'tool', 'help', 'short', 'verbose', 'summary', 'path', 'query', 'data', 'h', 'v']);
+    const reservedKeys = new Set(['module', 'tool', 'help', 'short', 'verbose', 'path', 'query', 'data', 'h', 'v']);
     for (const [key, value] of Object.entries(params)) {
       if (reservedKeys.has(key)) continue;
       if (typeof value === 'boolean') continue;
@@ -262,8 +262,8 @@ function isStandardResponse(response) {
 /**
  * 格式化 CLI 输出
  * - verbose 模式：完整 JSON（含 trace、header 等全部字段）
- * - summary 模式：只输出核心摘要字段（需要 --summary 显式指定）
- * - 默认：精简 JSON（去掉 trace、header，保留完整 data）
+ * - 快捷命令默认：只输出核心摘要字段
+ * - 非快捷命令默认：精简 JSON（去掉 trace、header，保留完整 data）
  * @param response 原始响应
  * @param verbose 是否 verbose 模式
  * @param summary 是否 summary 模式
@@ -289,7 +289,7 @@ function formatOutput(response, verbose, summary, toolKey) {
   // 精简响应
   const compact = compactResponse(response);
 
-  // --summary 模式：对特定 tool 应用摘要提取（仅成功响应）
+  // summary 模式：对特定 tool 应用摘要提取（仅成功响应）
   if (summary && compact.status >= 200 && compact.status < 300) {
     const summarized = (0, _shortcuts.summarizeResponse)(compact.data, toolKey);
     if (summarized !== null) {
@@ -342,7 +342,7 @@ ${lines.join('\n')}
   <tool>            工具名称 (如: list-issues, get-issue)
   --key value       路径或查询参数，CLI 自动识别归类
   --data 'JSON'     请求体参数，JSON 字符串
-  --verbose         输出完整响应（含 trace、header）
+  --verbose         输出完整原始响应（含 trace、header 等全部字段）
   --help            显示帮助文档
   --short           显示当前仓库的快捷命令
 
@@ -371,24 +371,13 @@ async function main() {
   // 尝试解析快捷命令
   const shortcut = (0, _shortcuts.resolveShortcut)(params.module, params.tool);
   if (shortcut) {
+    params.module = shortcut.module;
     params.tool = shortcut.tool;
 
-    // 自动注入 path 参数（兼容新旧格式）
-    // 新格式：用户可能直接传了 --repo xxx，检查扁平参数是否已存在
-    const autoPathKeys = Object.keys(shortcut.autoPath);
-    const hasPathAlready = params.path || autoPathKeys.some(k => params[k]);
-    if (!hasPathAlready) {
-      if (autoPathKeys.length > 0) {
-        // 新格式：直接注入为扁平参数
-        for (const [key, value] of Object.entries(shortcut.autoPath)) {
-          if (!params[key]) {
-            params[key] = value;
-          }
-        }
-      } else {
-        const envHint = params.module === 'issues' ? 'CNB_REPO_SLUG 和 CNB_ISSUE_IID' : 'CNB_REPO_SLUG 和 CNB_PULL_REQUEST_IID';
-        console.error(`快捷命令需要环境变量 ${envHint}，或手动传参数。\n` + `提示：运行 ${"cnb" || 'cnb'} --short 查看快捷命令详情。`);
-        process.exit(1);
+    // 自动注入 path 参数
+    for (const [key, value] of Object.entries(shortcut.autoPath)) {
+      if (!params[key]) {
+        params[key] = value;
       }
     }
 
@@ -453,11 +442,21 @@ async function main() {
   if (pathAndQueryParams) {
     toolsParam.push(pathAndQueryParams);
   }
-  if (formattedParams.data) {
-    toolsParam.push(formattedParams.data);
+
+  // 上传快捷命令：走完整上传流程（获取 URL → PUT 文件 → 返回结果）
+  let data;
+  if (shortcut?.upload) {
+    data = await (0, _upload.handleUpload)(shortcut, formattedParams.data?.file, toolFunction, pathAndQueryParams);
+  } else {
+    if (formattedParams.data) {
+      toolsParam.push(formattedParams.data);
+    }
+    data = await toolFunction(...toolsParam);
   }
-  const data = await toolFunction(...toolsParam);
   const toolKey = `${formattedParams.module}/${formattedParams.tool}`;
-  console.log(formatOutput(data, !!formattedParams.verbose, !!formattedParams.summary, toolKey));
+  // 快捷命令默认输出摘要，--verbose 时输出全部信息
+  const isVerbose = !!formattedParams.verbose;
+  const isSummary = shortcut ? !isVerbose : false;
+  console.log(formatOutput(data, isVerbose, isSummary, toolKey));
 }
 main();

package/skills/cnb-api/scripts/core/modules.help.js

@@ -29,11 +29,18 @@ function showModuleHelp(helpData, moduleName) {
     process.exit(1);
   }
   const cliCmd = "cnb" || 'cnb';
+  const entries = Object.values(moduleHelpData).map(info => ({
+    name: info.filename,
+    summary: trimSummary(info.summary || '')
+  }));
+  const maxNameLen = Math.max(...entries.map(e => e.name.length));
+  const pad = maxNameLen + 2;
   let toolListMsg = '';
-  for (const [, info] of Object.entries(moduleHelpData)) {
-    const name = info.filename;
-    const summary = info.summary;
-    toolListMsg += `  ${name.padEnd(30)} ${summary}\n`;
+  for (const {
+    name,
+    summary
+  } of entries) {
+    toolListMsg += `  ${name.padEnd(pad)} ${summary}\n`;
   }
   const helpMsg = `
 ${moduleName} 模块

package/skills/cnb-api/scripts/core/shortcuts.js

@@ -88,6 +88,18 @@ const ISSUE_SHORTCUTS = [{
   realTool: 'post-issue-assignees',
   description: '添加处理人',
   dataTip: "--data '{\"assignees\":[\"username\"]}'"
+}, {
+  shortName: 'upload-file',
+  realTool: 'post-issue-file-asset-upload-url',
+  description: '上传文件',
+  upload: true,
+  dataTip: "--data '{\"file\":\"文件路径\"}'"
+}, {
+  shortName: 'upload-image',
+  realTool: 'post-issue-image-asset-upload-url',
+  description: '上传图片',
+  upload: true,
+  dataTip: "--data '{\"file\":\"图片路径\"}'"
 }];
 const PR_SHORTCUTS = [{
   shortName: 'get',
@@ -131,16 +143,50 @@ const PR_SHORTCUTS = [{
   shortName: 'list-assignees',
   realTool: 'list-pull-assignees',
   description: '查看处理人'
+}, {
+  shortName: 'upload-file',
+  realTool: 'upload-files',
+  description: '上传文件',
+  repoOnly: true,
+  upload: true,
+  dataTip: "--data '{\"file\":\"文件路径\"}'"
+}, {
+  shortName: 'upload-image',
+  realTool: 'upload-imgs',
+  description: '上传图片',
+  repoOnly: true,
+  upload: true,
+  dataTip: "--data '{\"file\":\"图片路径\"}'"
 }];
 
 // ============================================================
 // --short 帮助输出
 // ============================================================
 
+/** 计算字符串的显示宽度（中文/全角占2，英文/半角占1） */
+function displayWidth(str) {
+  let width = 0;
+  for (const ch of str) {
+    const code = ch.codePointAt(0) || 0;
+    // CJK、全角字符占2宽度
+    width += code >= 0x1100 && (code <= 0x115f || code === 0x2329 || code === 0x232a || code >= 0x2e80 && code <= 0x3247 || code >= 0x3250 && code <= 0x4dbf || code >= 0x4e00 && code <= 0xa4c6 || code >= 0xa960 && code <= 0xa97c || code >= 0xac00 && code <= 0xd7a3 || code >= 0xf900 && code <= 0xfaff || code >= 0xfe10 && code <= 0xfe19 || code >= 0xfe30 && code <= 0xfe6b || code >= 0xff01 && code <= 0xff60 || code >= 0xffe0 && code <= 0xffe6 || code >= 0x1f000 && code <= 0x1fbff || code >= 0x20000 && code <= 0x2fffd || code >= 0x30000 && code <= 0x3fffd) ? 2 : 1;
+  }
+  return width;
+}
+
+/** 用全角空格将字符串补齐到指定显示宽度 */
+function padToWidth(str, targetWidth) {
+  const diff = targetWidth - displayWidth(str);
+  if (diff <= 0) return str;
+  // 每个全角空格占2宽度
+  const fullSpaces = Math.floor(diff / 2);
+  const halfSpace = diff % 2 === 1 ? ' ' : '';
+  return str + '　'.repeat(fullSpaces) + halfSpace;
+}
 function formatShortcutList(shortcuts, cliCmd, moduleName) {
-  const maxDescLen = Math.max(...shortcuts.map(s => s.description.length));
+  const maxWidth = Math.max(...shortcuts.map(s => displayWidth(s.description)));
   return shortcuts.map(s => {
-    const desc = s.description.padEnd(maxDescLen + 2, '　'); // 全角空格对齐
+    const desc = padToWidth(s.description, maxWidth + 2);
     const cmd = `${cliCmd} ${moduleName} ${s.shortName}`;
     const dataPart = s.dataTip ? ` ${s.dataTip}` : '';
     return `  ${desc} ${cmd}${dataPart}`;
@@ -150,52 +196,45 @@ function showShort() {
   const ctx = detectEventContext();
   const cliCmd = "cnb" || 'cnb';
   const repo = getRepo();
-  if (ctx === 'issue') {
-    const number = getIssueNumber();
-    const list = formatShortcutList(ISSUE_SHORTCUTS, cliCmd, 'issues');
-    console.log(`
-📋 当前场景: Issue 事件 (Issue #${number})
-   仓库: ${repo}
-
-常用快捷命令（path 参数已从环境变量自动获取）：
-${list}
-
-提示: 以上命令自动使用环境变量 CNB_REPO_SLUG 和 CNB_ISSUE_IID，无需手动传 --path
-      添加 --summary 可只输出核心摘要字段
-`);
-  } else if (ctx === 'pull_request') {
-    const number = getPRNumber();
-    const list = formatShortcutList(PR_SHORTCUTS, cliCmd, 'pulls');
+  if (ctx === 'issue' || ctx === 'pull_request') {
+    const isIssue = ctx === 'issue';
+    const number = isIssue ? getIssueNumber() : getPRNumber();
+    const emoji = isIssue ? '📋' : '🔀';
+    const label = isIssue ? 'Issue' : 'Pull Request';
+    const tag = isIssue ? 'Issue' : 'PR';
+    const moduleName = isIssue ? 'issues' : 'pulls';
+    const shortcuts = isIssue ? ISSUE_SHORTCUTS : PR_SHORTCUTS;
+    const envVars = isIssue ? 'CNB_REPO_SLUG 和 CNB_ISSUE_IID' : 'CNB_REPO_SLUG 和 CNB_PULL_REQUEST_IID';
+    const list = formatShortcutList(shortcuts, cliCmd, moduleName);
     console.log(`
-🔀 当前场景: Pull Request 事件 (PR #${number})
+${emoji} 当前场景: ${label} 事件 (${tag} #${number})
    仓库: ${repo}
 
 常用快捷命令（path 参数已从环境变量自动获取）：
 ${list}
 
-提示: 以上命令自动使用环境变量 CNB_REPO_SLUG 和 CNB_PULL_REQUEST_IID，无需手动传 --path
-      添加 --summary 可只输出核心摘要字段
+提示: ${tag} 相关命令会自动使用 ${envVars}
+      默认只输出摘要信息，添加 --verbose 可输出全部信息
 `);
   } else {
-    // 未知上下文，两组都显示
     const issueList = formatShortcutList(ISSUE_SHORTCUTS, cliCmd, 'issues');
     const prList = formatShortcutList(PR_SHORTCUTS, cliCmd, 'pulls');
     console.log(`
 ⚠️  未检测到 Issue/PR 事件上下文
    (CNB_ISSUE_IID 和 CNB_PULL_REQUEST_IID 均未设置)
 
-📋 Issue 场景常用命令（需要设置 CNB_ISSUE_IID 环境变量）：
+📋 Issue 场景常用命令：
 ${issueList}
 
-🔀 PR 场景常用命令（需要设置 CNB_PULL_REQUEST_IID 环境变量）：
+🔀 PR 场景常用命令：
 ${prList}
 
-提示: 快捷命令需要以下环境变量:
+提示: 快捷命令可使用以下环境变量:
   CNB_REPO_SLUG          - 仓库路径
-  CNB_ISSUE_IID          - Issue 编号 (Issue 事件)
-  CNB_PULL_REQUEST_IID   - PR 编号 (PR 事件)
+  CNB_ISSUE_IID          - Issue 编号（Issue 相关快捷命令）
+  CNB_PULL_REQUEST_IID   - PR 编号（PR 相关快捷命令）
 
-  添加 --summary 可只输出核心摘要字段
+  默认只输出摘要信息，添加 --verbose 可输出全部信息
 `);
   }
 }
@@ -204,50 +243,35 @@ ${prList}
 // 快捷命令解析
 // ============================================================
 
+function buildAutoPath(moduleName, repoOnly) {
+  const repo = process.env.CNB_REPO_SLUG || '';
+  if (repoOnly) return {
+    repo
+  };
+  const number = moduleName === 'issues' ? process.env.CNB_ISSUE_IID || '' : process.env.CNB_PULL_REQUEST_IID || '';
+  return {
+    repo,
+    number
+  };
+}
+
 /**
  * 尝试将用户输入的 module + tool 解析为快捷命令
  *
- * 即使环境变量未设置，也会完成 shortName → realTool 的映射，
- * 只是 autoPath 为 null，调用方需要用户手动传 --path。
- *
  * @returns 解析结果，如果不是快捷命令则返回 null
  */
 function resolveShortcut(moduleName, toolName) {
   if (!moduleName || !toolName) return null;
-
-  // 根据 module 名确定对应的快捷命令表
-  let shortcuts = null;
-  let autoPath = null;
-  if (moduleName === 'issues') {
-    shortcuts = ISSUE_SHORTCUTS;
-    const repo = process.env.CNB_REPO_SLUG;
-    const number = process.env.CNB_ISSUE_IID;
-    if (repo && number) {
-      autoPath = {
-        repo,
-        number
-      };
-    }
-  } else if (moduleName === 'pulls') {
-    shortcuts = PR_SHORTCUTS;
-    const repo = process.env.CNB_REPO_SLUG;
-    const number = process.env.CNB_PULL_REQUEST_IID;
-    if (repo && number) {
-      autoPath = {
-        repo,
-        number
-      };
-    }
-  }
+  const shortcuts = moduleName === 'issues' ? ISSUE_SHORTCUTS : moduleName === 'pulls' ? PR_SHORTCUTS : null;
   if (!shortcuts) return null;
-
-  // 在快捷命令表中查找匹配的 shortName
   const matched = shortcuts.find(s => s.shortName === toolName);
   if (!matched) return null;
   return {
+    module: moduleName,
     tool: matched.realTool,
-    autoPath: autoPath || {},
-    autoData: matched.autoData || null
+    autoPath: buildAutoPath(moduleName, !!matched.repoOnly),
+    autoData: matched.autoData || null,
+    upload: !!matched.upload
   };
 }
 
@@ -263,41 +287,151 @@ function resolveShortcut(moduleName, toolName) {
  * - 数组响应：对 data 中每个元素应用提取函数
  */
 const SUMMARY_EXTRACTORS = {
-  // Issue 详情摘要：只保留标题和正文
+  // Issue 详情摘要：保留标题、状态、标签和正文
+  // 过滤: number, state_reason, assignees, author, created_at, updated_at 等
   'issues/get-issue': item => ({
     title: item.title,
+    state: item.state,
+    labels: item.labels?.map?.(l => l.name).filter(Boolean) || [],
     body: item.body
   }),
   // Issue 更新摘要：只保留状态变更结果
+  // 过滤: title, body, labels, assignees, author, created_at, updated_at 等
   'issues/update-issue': item => ({
     number: item.number,
     state: item.state,
     state_reason: item.state_reason
   }),
-  // Issue 添加处理人摘要：只保留处理人列表
+  // Issue 评论列表摘要：只保留作者用户名、内容和创建时间
+  // 过滤: author 完整对象(avatar/email/freeze/is_npc/nickname), reactions, updated_at
+  'issues/list-issue-comments': item => ({
+    id: item.id,
+    author: item.author?.username,
+    body: item.body,
+    created_at: item.created_at
+  }),
+  // Issue 发表评论摘要：只保留评论 ID 和创建时间（body 已在请求中传入，无需重复）
+  // 过滤: body(请求已传入), author 完整对象(avatar/email/freeze/is_npc/nickname/username), reactions, updated_at
+  'issues/post-issue-comment': item => ({
+    id: item.id,
+    created_at: item.created_at
+  }),
+  // Issue 标签列表摘要：保留名称、颜色和描述
+  // 过滤: id
+  'issues/list-issue-labels': item => ({
+    name: item.name,
+    color: item.color,
+    description: item.description
+  }),
+  // Issue 添加标签摘要：只保留 ID 和颜色（name 已在请求中传入，无需重复）
+  // 过滤: name(请求已传入), description
+  'issues/post-issue-labels': item => ({
+    id: item.id,
+    color: item.color
+  }),
+  // Issue 处理人列表摘要：保留用户名和昵称
+  // 过滤: avatar, email, freeze, is_npc
+  'issues/list-issue-assignees': item => ({
+    username: item.username,
+    nickname: item.nickname
+  }),
+  // Issue 添加处理人摘要：保留处理人用户名和昵称列表
+  // 过滤: assignees 中每个用户的 avatar/email/freeze/is_npc，以及 issue 其他字段
   'issues/post-issue-assignees': item => ({
     number: item.number,
-    assignees: item.assignees?.map?.(a => a.username).filter(Boolean) || []
+    assignees: item.assignees?.map?.(a => ({
+      username: a.username,
+      nickname: a.nickname
+    })).filter(a => a.username) || []
   }),
-  // PR 详情摘要：只保留标题、状态、正文和分支信息
+  // PR 详情摘要：保留标题、状态、标签、正文和分支信息
+  // 过滤: number, author, assignees, reviewers, created_at, updated_at, base/head 完整对象等
   'pulls/get-pull': item => ({
     title: item.title,
     state: item.state,
+    labels: item.labels?.map?.(l => l.name).filter(Boolean) || [],
     base: item.base?.ref,
     head: item.head?.ref,
     body: item.body
   }),
-  // PR 文件列表摘要：只保留文件名、变更状态和增删行数
+  // PR 文件列表摘要：保留文件名、sha、变更状态和增删行数
+  // 过滤: patch, blob_url, raw_url, contents_url, previous_filename
   'pulls/list-pull-files': item => ({
     filename: item.filename,
+    sha: item.sha,
     status: item.status,
     additions: item.additions,
     deletions: item.deletions
   }),
   // PR 提交列表摘要：只保留 sha 前 8 位和 commit message
+  // 过滤: sha 完整值, commit 完整对象(author/committer/tree/verification), parents, url 等
   'pulls/list-pull-commits': item => ({
     sha: typeof item.sha === 'string' ? item.sha.substring(0, 8) : item.sha,
     message: item.commit?.message
+  }),
+  // PR 评论列表摘要：保留作者用户名和昵称、内容和创建时间
+  // 过滤: author 完整对象(avatar/email/freeze/is_npc), reactions, updated_at
+  'pulls/list-pull-comments': item => ({
+    id: item.id,
+    author: item.author?.username,
+    nickname: item.author?.nickname,
+    body: item.body,
+    created_at: item.created_at
+  }),
+  // PR 发表评论摘要：只保留评论 ID 和创建时间（body 已在请求中传入，无需重复）
+  // 过滤: body(请求已传入), author 完整对象(avatar/email/freeze/is_npc/nickname/username), reactions, updated_at
+  'pulls/post-pull-comment': item => ({
+    id: item.id,
+    created_at: item.created_at
+  }),
+  // PR 标签列表摘要：保留 ID、名称、颜色和描述
+  // 过滤: 无
+  'pulls/list-pull-labels': item => ({
+    id: item.id,
+    name: item.name,
+    color: item.color,
+    description: item.description
+  }),
+  // PR 添加标签摘要：只保留 ID 和颜色（name 已在请求中传入，无需重复）
+  // 过滤: name(请求已传入), description
+  'pulls/post-pull-labels': item => ({
+    id: item.id,
+    color: item.color
+  }),
+  // PR CI 状态摘要：保留整体状态和各检查项的核心信息（sha 截断为前 8 位）
+  // 过滤: sha 完整值, statuses 中每项的 target_url/created_at/updated_at
+  'pulls/list-pull-commit-statuses': item => ({
+    sha: typeof item.sha === 'string' ? item.sha.substring(0, 8) : item.sha,
+    state: item.state,
+    statuses: item.statuses?.map?.(s => ({
+      context: s.context,
+      state: s.state,
+      description: s.description
+    })) || []
+  }),
+  // PR 评审列表摘要：保留作者用户名和昵称、状态和内容
+  // 过滤: author 完整对象(avatar/email/freeze/is_npc), created_at, updated_at
+  'pulls/list-pull-reviews': item => ({
+    id: item.id,
+    author: item.author?.username,
+    nickname: item.author?.nickname,
+    state: item.state,
+    body: item.body
+  }),
+  // PR 处理人列表摘要：保留用户名和昵称
+  // 过滤: avatar, email, freeze, is_npc
+  'pulls/list-pull-assignees': item => ({
+    username: item.username,
+    nickname: item.nickname
+  }),
+  // PR 添加处理人摘要：保留处理人用户名和昵称列表
+  // 过滤: assignees 中每个用户的 avatar/email/freeze/is_npc，以及 PR 其他字段
+  'pulls/post-pull-assignees': item => ({
+    number: item.number,
+    assignees: item.assignees?.map?.(a => ({
+      username: a.username,
+      nickname: a.nickname
+    })).filter(a => a.username) || []
   })
 };
 

package/skills/cnb-api/scripts/core/utils/upload.js

@@ -0,0 +1,141 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.handleUpload = handleUpload;
+var _fs = _interopRequireDefault(require("fs"));
+var _path = _interopRequireDefault(require("path"));
+var _mimeTypes = require("mime-types");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * 完整上传流程
+ * 1. 读取本地文件 → 获取 name/size
+ * 2. 调用上传 API → 获取 upload_url
+ * 3. PUT 文件内容到 upload_url（流式上传）
+ * 4. 返回最终结果
+ */
+
+// 上传文件大小上限：100MB
+const MAX_FILE_SIZE = 100 * 1024 * 1024;
+
+/**
+ * 处理完整上传流程
+ * @param shortcut 解析后的快捷命令
+ * @param filePath 本地文件路径
+ * @param toolFunction 原始上传 API 函数（获取 upload_url）
+ * @param toolsParam API 调用的 path 参数（repo 或 {repo, number}）
+ */
+async function handleUpload(shortcut, filePath, toolFunction, toolsParam) {
+  // 校验 file 参数
+  if (!filePath || typeof filePath !== 'string') {
+    return {
+      status: 400,
+      data: {
+        error: `上传命令需要指定文件路径，如: --data '{"file":"./path/to/file"}'`
+      }
+    };
+  }
+
+  // 1. 读取本地文件信息
+  if (!_fs.default.existsSync(filePath)) {
+    return {
+      status: 400,
+      data: {
+        error: `文件不存在: ${filePath}`
+      }
+    };
+  }
+  const stat = _fs.default.statSync(filePath);
+  if (!stat.isFile()) {
+    return {
+      status: 400,
+      data: {
+        error: `不是文件: ${filePath}`
+      }
+    };
+  }
+  const fileName = _path.default.basename(filePath);
+  const fileSize = stat.size;
+  if (fileSize === 0) {
+    return {
+      status: 400,
+      data: {
+        error: '文件为空'
+      }
+    };
+  }
+  if (fileSize > MAX_FILE_SIZE) {
+    return {
+      status: 400,
+      data: {
+        error: `文件过大 (${(fileSize / 1024 / 1024).toFixed(1)}MB)，上限 ${MAX_FILE_SIZE / 1024 / 1024}MB`
+      }
+    };
+  }
+  const contentType = (0, _mimeTypes.lookup)(filePath) || 'application/octet-stream';
+
+  // 2. 调用上传 API 获取 upload_url
+  const isIssueUpload = shortcut.module === 'issues';
+  const requestBody = isIssueUpload ? {
+    name: fileName,
+    size: fileSize,
+    content_type: contentType
+  } : {
+    name: fileName,
+    size: fileSize
+  };
+  const uploadResponse = await toolFunction(toolsParam, requestBody);
+
+  // 提取 upload_url（兼容标准响应和裸响应）
+  const responseData = uploadResponse?.data ?? uploadResponse;
+  const uploadUrl = responseData?.upload_url;
+  if (!uploadUrl) {
+    return uploadResponse; // 获取 URL 失败，直接返回原始错误
+  }
+
+  // 3. PUT 文件内容到 upload_url（流式读取，避免大文件撑爆内存）
+  const fileStream = _fs.default.createReadStream(filePath);
+  const putHeaders = {
+    'Content-Type': contentType,
+    'Content-Length': String(fileSize)
+  };
+  const putResponse = await fetch(uploadUrl, {
+    method: 'PUT',
+    headers: putHeaders,
+    body: fileStream,
+    // @ts-ignore duplex required for streaming body in Node.js fetch
+    duplex: 'half'
+  });
+  if (!putResponse.ok) {
+    const errText = await putResponse.text().catch(() => '');
+    return {
+      status: putResponse.status,
+      data: {
+        error: `文件上传失败: ${putResponse.statusText}`,
+        detail: errText
+      }
+    };
+  }
+
+  // 4. 返回最终结果
+  if (isIssueUpload) {
+    return {
+      status: 200,
+      data: {
+        asset_link: responseData.asset_link,
+        name: fileName,
+        size: fileSize
+      }
+    };
+  }
+  return {
+    status: 200,
+    data: {
+      name: responseData.assets?.name || fileName,
+      path: responseData.assets?.path,
+      size: fileSize,
+      token: responseData.token
+    }
+  };
+}

package/skills/cnb-api/scripts/core/convertLink.js

@@ -1,140 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = convertLink;
-/**
- * 把文本里的相对路径转换为绝对路径
- * 与 codebuddy/skills/cnb-text-relative-path-converter/scripts/convertLink.js 逻辑一致
- *
- * @param {String} text 待转换的文本
- * @param {String} repoSlug 仓库路径
- * @param {String} branchOrSha 可选，分支或SHA
- * @returns {String}
- */
-function convertLink(text, repoSlug, branchOrSha) {
-  // 查询所有代码块的位置
-  let codeBlockPositions = [];
-  let index = 0;
-  while (index !== -1) {
-    const nextIndex = text.indexOf('```', index);
-    if (nextIndex === -1) break;
-    codeBlockPositions.push(nextIndex);
-    index = nextIndex + 3; // 跳过已匹配的三个反引号
-  }
-  if (codeBlockPositions.length % 2 !== 0) {
-    codeBlockPositions = codeBlockPositions.slice(0, codeBlockPositions.length - 1);
-  }
-
-  // 查询所有行内代码块的位置
-  let inlineCodeBlockPositions = [];
-  index = 0;
-  while (index < text.length) {
-    const nextIndex = text.indexOf('`', index);
-    if (nextIndex === -1) break;
-    // 检查是否是单独的反引号（不是代码块的一部分）
-    if ((nextIndex === 0 || text.charAt(nextIndex - 1) !== '`') && (nextIndex === text.length - 1 || text.charAt(nextIndex + 1) !== '`')) {
-      inlineCodeBlockPositions.push(nextIndex);
-    }
-    index = nextIndex + 1;
-  }
-  if (inlineCodeBlockPositions.length % 2 !== 0) {
-    inlineCodeBlockPositions = inlineCodeBlockPositions.slice(0, inlineCodeBlockPositions.length - 1);
-  }
-
-  // 整理起始和结束位置
-  const excludedRanges = [...codeBlockPositions, ...inlineCodeBlockPositions].reduce((result, item, index) => {
-    if (index % 2 === 0) {
-      return result.concat([[item]]);
-    }
-    result[result.length - 1].push(item);
-    return result;
-  }, []);
-
-  // Helper function to check if an index is within excluded ranges
-  const isInExcludedRange = index => {
-    return excludedRanges.some(([start, end]) => index >= start && index < end);
-  };
-  let match;
-
-  // Collect all replacements with their positions
-  const replacements = [];
-
-  // Match markdown links and images: [text](url) and ![alt](url)
-  const markdownLinkRegex = /!?\[([^\]]+)\]\(([^)]+)\)/g;
-  while ((match = markdownLinkRegex.exec(text)) !== null) {
-    if (!isInExcludedRange(match.index)) {
-      // Calculate URL position: match.index + length of "![" + match[1] + "]("
-      const prefixLength = (match[0].startsWith('!') ? 1 : 0) + 1 + match[1].length + 2;
-      const urlStart = match.index + prefixLength;
-      const urlEnd = urlStart + match[2].length;
-      const newUrl = normaliseLink(match[2], repoSlug, branchOrSha);
-      if (newUrl !== match[2]) {
-        replacements.push({
-          start: urlStart,
-          end: urlEnd,
-          newUrl
-        });
-      }
-    }
-  }
-
-  // Match HTML tags: <img src="..."> and <a href="...">
-  const htmlTagRegex = /\s(src|href)=["']([^"']+)["']/gi;
-  while ((match = htmlTagRegex.exec(text)) !== null) {
-    if (!isInExcludedRange(match.index)) {
-      const urlStart = match.index + match[0].indexOf(match[2]);
-      const urlEnd = urlStart + match[2].length;
-      const newUrl = normaliseLink(match[2], repoSlug, branchOrSha);
-      if (newUrl !== match[2]) {
-        replacements.push({
-          start: urlStart,
-          end: urlEnd,
-          newUrl
-        });
-      }
-    }
-  }
-
-  // Sort replacements by start position in descending order
-  replacements.sort((a, b) => b.start - a.start);
-
-  // Apply replacements from end to start to maintain correct indices
-  let result = text;
-  for (const {
-    start,
-    end,
-    newUrl
-  } of replacements) {
-    result = result.substring(0, start) + newUrl + result.substring(end);
-  }
-  return result;
-}
-
-/**
- * 相对路径转换为绝对路径
- * 与 codebuddy/skills/text-path-converter/scripts/convertLink.js 逻辑一致
- *
- * @param {String} link 待转换的链接
- * @param {String} repoSlug 仓库路径
- * @param {String} branchOrSha 分支或SHA，默认为 HEAD
- * @returns {String}
- */
-function normaliseLink(link, repoSlug, branchOrSha = 'HEAD') {
-  const baseURL = `${process.env.CNB_WEB_ENDPOINT}/${repoSlug}`;
-  if (link.startsWith('/-/')) {
-    return `${baseURL}${link}`;
-  }
-  if (link.indexOf('/-/') === -1 && (link.startsWith('../') || link.startsWith('./') || link.startsWith('/') && !link.startsWith('//'))) {
-    let chunks = link.split('/');
-    // 过滤掉空字符串和 . .. 这些无效路径
-    chunks = chunks.filter(chunk => !!chunk && chunk !== '.' && chunk !== '..');
-    if (chunks.length === 0) {
-      return link;
-    }
-    chunks.unshift(branchOrSha);
-    return `${baseURL}/-/git/raw/${chunks.join('/')}`;
-  }
-  return link;
-}

package/skills/cnb-api/scripts/core/index.d.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});

package/skills/cnb-api/scripts/core/schemaToJson.d.js

@@ -1,5 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});

package/skills/cnb-api/scripts/modules/ai/ai-auto-pr.js

@@ -1,70 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = _default;
-var _core = _interopRequireDefault(require("../../core/core.js"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// @ts-nocheck
-/* tslint:disable */
-/* eslint-disable */
-/*
- * -------------------------------------------------------------------------
- * ## THIS FILE WAS GENERATED VIA CNB-API-GENERATE                        ##
- * ##                                                                     ##
- * ## AUTHOR: bapelin                                                     ##
- * ## SOURCE: https://cnb.cool/cnb/frontend-science/cnb-api-generate   ##
- * -------------------------------------------------------------------------
- * @Version 1.2.1
- * @Source /{repo}/-/build/ai/auto-pr
- */
-
-/**
- * @description Other reuqest params
- */
-
-/**
- * @description AiAutoPrRes Success Response Type
- */
-
-/**
- * @description AiAutoPrError Error Response Type
- */
-
-/**
-* @description 访问令牌调用此接口需包含以下权限。Required permissions for access token. 
-* repo-code:rw
-* @tags AI
-* @name aiAutoPr
-* @summary 根据传入的需求内容和需求标题借助 AI 自动编码并提 PR。Automatically code and create a PR with AI based on the input requirement content and title.
-* @request post:/{repo}/-/build/ai/auto-pr
-
-----------------------------------
-* @param {string} arg0
-* @param {DtoAiAutoPrReq} arg1
-* @param {RequestConfig} arg2 - Other reuqest params
-*/
-async function _default(repo, request, {
-  req,
-  options,
-  ...axiosConfig
-} = {}) {
-  return await _core.default.request({
-    ...axiosConfig,
-    _next_req: req,
-    options: options,
-    url: `/${repo}/-/build/ai/auto-pr`,
-    _apiTag: "/{repo}/-/build/ai/auto-pr",
-    method: "post",
-    data: request,
-    _originParams: {
-      method: "post",
-      _apiTag: "/{repo}/-/build/ai/auto-pr",
-      path: {
-        repo
-      },
-      body: request
-    }
-  });
-}

package/skills/cnb-api/scripts/modules/pulls/get-files.js

@@ -1,75 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = _default;
-var _core = _interopRequireDefault(require("../../core/core.js"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// @ts-nocheck
-/* tslint:disable */
-/* eslint-disable */
-/*
- * -------------------------------------------------------------------------
- * ## THIS FILE WAS GENERATED VIA CNB-API-GENERATE                        ##
- * ##                                                                     ##
- * ## AUTHOR: bapelin                                                     ##
- * ## SOURCE: https://cnb.woa.com/cnb/frontend-science/cnb-api-generate   ##
- * -------------------------------------------------------------------------
- * @Version 2.2.0
- * @Source /{repo}/-/files/{filePath}
- */
-
-/**
- * @description getFiles request params
- */
-
-/**
- * @description Other reuqest params
- */
-
-/**
- * @description GetFilesRes Success Response Type
- */
-
-/**
- * @description GetFilesError Error Response Type
- */
-
-/**
-* @description 访问令牌调用此接口需包含以下权限。Required permissions for access token. 
-* repo-contents:r
-* @tags Pulls,Issues
-* @name getFiles
-* @summary 获取 issue 文件或合并请求文件的请求，返回文件二进制内容。Request to retrieve file of issues and pull requests, returns binary content.
-* @request get:/{repo}/-/files/{filePath}
-
-----------------------------------
-* @param {GetFilesParams} arg0 - getFiles request params
-* @param {RequestConfig} arg1 - Other reuqest params
-*/
-async function _default({
-  repo,
-  filePath
-}, {
-  req,
-  options,
-  ...axiosConfig
-} = {}) {
-  return await _core.default.request({
-    ...axiosConfig,
-    _next_req: req,
-    options: options,
-    url: `/${repo}/-/files/${filePath}`,
-    _apiTag: "/{repo}/-/files/{filePath}",
-    method: "get",
-    _originParams: {
-      method: "get",
-      _apiTag: "/{repo}/-/files/{filePath}",
-      path: {
-        repo,
-        filePath
-      }
-    }
-  });
-}

package/skills/cnb-api/scripts/modules/pulls/get-imgs.js

@@ -1,75 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = _default;
-var _core = _interopRequireDefault(require("../../core/core.js"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// @ts-nocheck
-/* tslint:disable */
-/* eslint-disable */
-/*
- * -------------------------------------------------------------------------
- * ## THIS FILE WAS GENERATED VIA CNB-API-GENERATE                        ##
- * ##                                                                     ##
- * ## AUTHOR: bapelin                                                     ##
- * ## SOURCE: https://cnb.woa.com/cnb/frontend-science/cnb-api-generate   ##
- * -------------------------------------------------------------------------
- * @Version 2.2.0
- * @Source /{repo}/-/imgs/{imgPath}
- */
-
-/**
- * @description getImgs request params
- */
-
-/**
- * @description Other reuqest params
- */
-
-/**
- * @description GetImgsRes Success Response Type
- */
-
-/**
- * @description GetImgsError Error Response Type
- */
-
-/**
-* @description 访问令牌调用此接口需包含以下权限。Required permissions for access token. 
-* repo-contents:r
-* @tags Pulls,Issues
-* @name getImgs
-* @summary 获取 issue 图片或合并请求图片的请求，返回图片二进制内容。Request to retrieve image of issues and pull requests, returns binary content.
-* @request get:/{repo}/-/imgs/{imgPath}
-
-----------------------------------
-* @param {GetImgsParams} arg0 - getImgs request params
-* @param {RequestConfig} arg1 - Other reuqest params
-*/
-async function _default({
-  repo,
-  imgPath
-}, {
-  req,
-  options,
-  ...axiosConfig
-} = {}) {
-  return await _core.default.request({
-    ...axiosConfig,
-    _next_req: req,
-    options: options,
-    url: `/${repo}/-/imgs/${imgPath}`,
-    _apiTag: "/{repo}/-/imgs/{imgPath}",
-    method: "get",
-    _originParams: {
-      method: "get",
-      _apiTag: "/{repo}/-/imgs/{imgPath}",
-      path: {
-        repo,
-        imgPath
-      }
-    }
-  });
-}