@cnbcool/cnb-api-generate 2.2.0 → 2.2.2

package/client/lib/execute-action.ts

@@ -1,11 +1,49 @@
 import fs from 'fs';
 import path from 'path';
 import { Command } from 'commander';
-import { showShort, resolveShortcut } from '../shortcuts';
+import { showShort, resolveShortcut, type ResolvedShortcut } from '../shortcuts';
 import { handleUpload } from '../utils/upload';
 import { formatParams } from './format-params';
 import { formatOutput } from './format-output';
 
+/**
+ * 加载 tool 模块并返回其 default 导出函数
+ */
+function loadToolFunction(moduleName: string, toolName: string): any {
+  const toolPath = path.join(
+    __dirname,
+    '../../modules',
+    `${moduleName}/${toolName}.js`,
+  );
+
+  if (!fs.existsSync(toolPath)) {
+    console.error(`工具文件不存在: ${toolPath}`);
+    process.exit(1);
+  }
+
+  const toolModule = require(toolPath);
+  const toolFunction = toolModule.default;
+
+  if (!toolFunction) {
+    console.error(`工具函数不存在`);
+    process.exit(1);
+  }
+
+  return toolFunction;
+}
+
+/**
+ * 处理上传命令的独立分支
+ * 上传命令只需要 --file 和自动注入的 path 参数，不经过 formatParams
+ */
+async function executeUpload(
+  shortcut: ResolvedShortcut,
+  opts: Record<string, any>,
+): Promise<any> {
+  const toolFunction = loadToolFunction(shortcut.module, shortcut.tool);
+  return handleUpload(shortcut, opts.file, toolFunction, shortcut.autoPath as any);
+}
+
 export async function executeAction(
   moduleArg: string | undefined,
   toolArg: string | undefined,
@@ -59,26 +97,18 @@ export async function executeAction(
     parentCmd.help();
   }
 
-  const formattedParams = formatParams(params);
-
-  const toolPath = path.join(
-    __dirname,
-    '../../modules',
-    `${formattedParams.module}/${formattedParams.tool}.js`,
-  );
-
-  if (!fs.existsSync(toolPath)) {
-    console.error(`工具文件不存在: ${toolPath}`);
-    process.exit(1);
+  // 上传命令走独立分支：只需 --file + autoPath，跳过 formatParams 常规流程
+  if (shortcut?.upload) {
+    const data = await executeUpload(shortcut, opts);
+    const toolKey = `${shortcut.module}/${shortcut.tool}`;
+    const isVerbose = !!opts.verbose;
+    console.log(formatOutput(data, isVerbose, !isVerbose, toolKey));
+    return;
   }
 
-  const toolModule = require(toolPath);
-  const toolFunction = toolModule.default;
+  const formattedParams = formatParams(params);
 
-  if (!toolFunction) {
-    console.error(`工具函数不存在`);
-    process.exit(1);
-  }
+  const toolFunction = loadToolFunction(formattedParams.module, formattedParams.tool);
 
   const toolsParam: any[] = [];
   let pathAndQueryParams: Record<string, any> | string | null = null;
@@ -109,15 +139,10 @@ export async function executeAction(
     toolsParam.push(pathAndQueryParams);
   }
 
-  let data: any;
-  if (shortcut?.upload) {
-    data = await handleUpload(shortcut, formattedParams.data?.file, toolFunction, pathAndQueryParams as { repo: string; number?: string });
-  } else {
-    if (formattedParams.data) {
-      toolsParam.push(formattedParams.data);
-    }
-    data = await toolFunction(...toolsParam);
+  if (formattedParams.data) {
+    toolsParam.push(formattedParams.data);
   }
+  const data = await toolFunction(...toolsParam);
 
   const toolKey = `${formattedParams.module}/${formattedParams.tool}`;
   const isVerbose = !!formattedParams.verbose;

package/client/lib/register-modules.ts

@@ -131,8 +131,13 @@ export function registerModuleCommands(program: Command): void {
           await executeAction(moduleName, shortcut.shortName, opts, sub);
         });
 
-      // 复用真实 tool 的选项，跳过 path 参数
-      registerToolOptions(shortcutCmd, moduleName, shortcut.realTool, true);
+      // 上传命令只需要 --file，不复用真实 tool 的 body 选项（name/size/content_type 由上传流程自动获取）
+      if (!shortcut.upload) {
+        registerToolOptions(shortcutCmd, moduleName, shortcut.realTool, true);
+      } else {
+        shortcutCmd.requiredOption('--file <string>', '本地文件路径。必填。');
+      }
+
       registeredNames.add(shortcut.shortName);
     }
 

package/client/utils/upload.ts

@@ -181,7 +181,10 @@ export async function handleUpload(
     ? { name: fileName, size: fileSize, content_type: contentType }
     : { name: fileName, size: fileSize };
 
-  const uploadResponse = await toolFunction(pathParams, requestBody);
+  // Issue API 签名: fn({ repo, number }, body)
+  // PR API 签名:    fn(repo, body)
+  const apiFirstArg: any = isIssueUpload ? pathParams : pathParams.repo;
+  const uploadResponse = await toolFunction(apiFirstArg, requestBody);
 
   // 提取 upload_url
   const responseData = uploadResponse?.data;

package/package.json

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

package/skills-template/SKILL.md

@@ -7,6 +7,20 @@ description: CNB OpenAPI 交互能力，支持仓库、Issue、PR、流水线、
 
 操作 CNB 平台资源的 CLI 工具。
 
+## 安装CLI
+
+检查是否已安装
+
+```bash
+cnb
+```
+
+如果没有安装，则安装
+
+```bash
+npm install @cnbcool/cnb-cli -g
+```
+
 ## 快捷命令（优先使用）
 
 issues 快捷命令：