@cnbcool/cnb-api-generate 1.2.8 → 2.1.0

package/client/lib/summary-extractors.ts

@@ -0,0 +1,189 @@
+/**
+ * 摘要输出
+ * 对返回数据量大的快捷命令，默认只输出核心字段，减少 token 消耗
+ */
+
+type SummaryExtractor = (item: any) => any;
+
+/**
+ * 摘要提取器配置
+ * key: "module/tool"，value: 摘要提取函数
+ * - 对象响应：直接对 data 应用提取函数
+ * - 数组响应：对 data 中每个元素应用提取函数
+ */
+const SUMMARY_EXTRACTORS: Record<string, SummaryExtractor> = {
+  // 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: any) => 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 评论列表摘要：只保留作者用户名、内容和创建时间
+  // 过滤: 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: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
+  }),
+
+  // 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: any) => l.name).filter(Boolean) || [],
+    base: item.base?.ref,
+    head: item.head?.ref,
+    body: item.body,
+  }),
+
+  // 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: any) => ({
+      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: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
+  }),
+};
+
+/**
+ * 对响应数据应用摘要提取（如果当前 tool 配置了摘要提取器）
+ * @param data 原始 data（对象或数组）
+ * @param toolKey 当前 tool 标识，格式为 "module/tool"
+ * @returns 摘要后的 data，如果无匹配提取器则返回 null
+ */
+export function summarizeResponse(data: any, toolKey: string): any | null {
+  const extractor = SUMMARY_EXTRACTORS[toolKey];
+  if (!extractor) return null;
+  if (data == null) return data;
+  if (Array.isArray(data)) {
+    return data.map(extractor);
+  }
+  return extractor(data);
+}

package/client/lib/trim-summary.ts

@@ -0,0 +1,11 @@
+/**
+ * 去除 summary 中的英文部分（保留中文句号前的内容）
+ */
+export function trimSummary(summary: string): string {
+  if (!summary) return '';
+  // 匹配中文句号"。"后面跟英文的模式，只保留中文部分
+  const match = summary.match(/^(.*?[\u4e00-\u9fff].*?)[。.]\s*[A-Z]/);
+  if (match) return match[1];
+  // 没有匹配到则返回原文
+  return summary;
+}

package/client/shortcuts.ts

@@ -70,15 +70,15 @@ function getPRNumber(): string {
 const ISSUE_SHORTCUTS: ShortcutDefinition[] = [
   { shortName: 'get',            realTool: 'get-issue',            description: '获取详情' },
   { shortName: 'list-comments',  realTool: 'list-issue-comments',  description: '获取评论列表' },
-  { shortName: 'comment',        realTool: 'post-issue-comment',   description: '评论',           dataTip: "--data '{\"body\":\"内容\"}'" },
+  { shortName: 'comment',        realTool: 'post-issue-comment',   description: '评论',           dataTip: "--body 内容" },
   { shortName: 'close',          realTool: 'update-issue',         description: '关闭',           autoData: { state: 'closed', state_reason: 'completed' } },
   { shortName: 'open',           realTool: 'update-issue',         description: '打开',           autoData: { state: 'open', state_reason: 'reopened' } },
   { shortName: 'list-labels',    realTool: 'list-issue-labels',    description: '查看标签' },
-  { shortName: 'add-labels',     realTool: 'post-issue-labels',    description: '添加标签',        dataTip: "--data '{\"labels\":[\"bug\",\"feature\"]}'" },
+  { shortName: 'add-labels',     realTool: 'post-issue-labels',    description: '添加标签',        dataTip: "--labels bug --labels feature" },
   { shortName: 'list-assignees', realTool: 'list-issue-assignees', description: '查看处理人' },
-  { shortName: 'add-assignees',  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\":\"图片路径\"}'" },
+  { shortName: 'add-assignees',  realTool: 'post-issue-assignees', description: '添加处理人',      dataTip: "--assignees username" },
+  { shortName: 'upload-file',    realTool: 'post-issue-file-asset-upload-url',  description: '上传文件', upload: true, dataTip: "--file 文件路径" },
+  { shortName: 'upload-image',   realTool: 'post-issue-image-asset-upload-url', description: '上传图片', upload: true, dataTip: "--file 图片路径" },
 ];
 
 const PR_SHORTCUTS: ShortcutDefinition[] = [
@@ -86,14 +86,14 @@ const PR_SHORTCUTS: ShortcutDefinition[] = [
   { shortName: 'list-files',     realTool: 'list-pull-files',         description: '获取文件变更' },
   { shortName: 'list-commits',   realTool: 'list-pull-commits',       description: '获取提交记录' },
   { shortName: 'list-comments',  realTool: 'list-pull-comments',      description: '获取评论列表' },
-  { shortName: 'comment',        realTool: 'post-pull-comment',       description: '评论',           dataTip: "--data '{\"body\":\"内容\"}'" },
+  { shortName: 'comment',        realTool: 'post-pull-comment',       description: '评论',           dataTip: "--body 内容" },
   { shortName: 'list-labels',    realTool: 'list-pull-labels',        description: '查看标签' },
-  { shortName: 'add-labels',     realTool: 'post-pull-labels',        description: '添加标签',        dataTip: "--data '{\"labels\":[\"ready\",\"approved\"]}'" },
+  { shortName: 'add-labels',     realTool: 'post-pull-labels',        description: '添加标签',        dataTip: "--labels ready --labels approved" },
   { 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: "--data '{\"file\":\"文件路径\"}'" },
-  { shortName: 'upload-image',   realTool: 'upload-imgs',  description: '上传图片', repoOnly: true, upload: true, dataTip: "--data '{\"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 图片路径" },
 ];
 
 // ============================================================
@@ -199,7 +199,7 @@ ${prList}
   CNB_ISSUE_IID          - Issue 编号（Issue 相关快捷命令）
   CNB_PULL_REQUEST_IID   - PR 编号（PR 相关快捷命令）
 
-  默认只输出摘要信息，添加 --verbose 可输出全部信息
+  默认只输出摘要信息，添加 --v 可输出全部信息
 `);
   }
 }
@@ -247,191 +247,3 @@ export function resolveShortcut(
   };
 }
 
-// ============================================================
-// 摘要输出
-// 对返回数据量大的快捷命令，默认只输出核心字段，减少 token 消耗
-// ============================================================
-
-type SummaryExtractor = (item: any) => any;
-
-/**
- * 摘要提取器配置
- * key: "module/tool"，value: 摘要提取函数
- * - 对象响应：直接对 data 应用提取函数
- * - 数组响应：对 data 中每个元素应用提取函数
- */
-const SUMMARY_EXTRACTORS: Record<string, SummaryExtractor> = {
-  // 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: any) => 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 评论列表摘要：只保留作者用户名、内容和创建时间
-  // 过滤: 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: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
-  }),
-
-  // 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: any) => l.name).filter(Boolean) || [],
-    base: item.base?.ref,
-    head: item.head?.ref,
-    body: item.body,
-  }),
-
-  // 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: any) => ({
-      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: any) => ({ username: a.username, nickname: a.nickname })).filter((a: any) => a.username) || [],
-  }),
-};
-
-/**
- * 对响应数据应用摘要提取（如果当前 tool 配置了摘要提取器）
- * @param data 原始 data（对象或数组）
- * @param toolKey 当前 tool 标识，格式为 "module/tool"
- * @returns 摘要后的 data，如果无匹配提取器则返回 null
- */
-export function summarizeResponse(data: any, toolKey: string): any | null {
-  const extractor = SUMMARY_EXTRACTORS[toolKey];
-  if (!extractor) return null;
-  if (Array.isArray(data)) {
-    return data.map(extractor);
-  }
-  return extractor(data);
-}

package/client/utils/build-nested-field-map.ts

@@ -0,0 +1,38 @@
+export interface NestedFieldMapping {
+  pathKeys: string[];       // schema 路径，如 ["testBody", "critical_count", "id"]
+  leafSchema: any;          // 叶子节点的 schema 定义
+}
+
+/**
+ * 递归遍历嵌套对象的 schema，生成所有叶子节点的 flat key 映射
+ * @param props  当前层级的 properties
+ * @param prefix 当前层级的 CLI flat key 前缀（用 @ 连接），如 "testBody"
+ * @param pathKeys 当前层级的 schema 路径数组，如 ["testBody"]
+ * @returns Map<flatKey, NestedFieldMapping>
+ */
+export function buildNestedFieldMap(
+  props: Record<string, any>,
+  prefix: string,
+  pathKeys: string[],
+): Map<string, NestedFieldMapping> {
+  const map = new Map<string, NestedFieldMapping>();
+
+  for (const [subKey, subProp] of Object.entries(props) as [string, any][]) {
+    const flatKey = `${prefix}@${subKey}`;
+    const currentPath = [...pathKeys, subKey];
+
+    if (subProp.type === 'object' && subProp.properties && Object.keys(subProp.properties).length > 0) {
+      // 嵌套对象：继续递归
+      const subMap = buildNestedFieldMap(subProp.properties, flatKey, currentPath);
+      for (const [k, v] of subMap) {
+        map.set(k, v);
+      }
+    } else {
+      // 叶子节点：注册 flat key
+      const camelKey = flatKey;
+      map.set(camelKey, { pathKeys: currentPath, leafSchema: subProp });
+    }
+  }
+
+  return map;
+}

package/client/utils/flat-key-from-segments.ts

@@ -0,0 +1,8 @@
+/**
+ * 生成 CLI flat key：按 '@' 连接层级
+ * 例如 "testBody@critical_count@id"
+ * Commander 不会对 '@' 做 camelCase 转换，所以 key 保持原样
+ */
+export function flatKeyFromSegments(str: string): string {
+  return str;
+}

package/client/utils/match-array-object-field.ts

@@ -0,0 +1,19 @@
+/**
+ * 检测是否为 array<object> 展开字段（格式：bodyArrayKey@subPropName）
+ * Commander 不会对 '@' 做 camelCase，所以直接匹配原始 key
+ */
+export function matchArrayObjectField(
+  camelKey: string,
+  bodyProps: Record<string, any>,
+): { arrayKey: string; subKey: string } | null {
+  for (const [rootKey, rootProp] of Object.entries(bodyProps) as [string, any][]) {
+    if (rootProp.type !== 'array' || !rootProp.items?.properties) continue;
+    for (const subKey of Object.keys(rootProp.items.properties)) {
+      const flatKey = `${rootKey}@${subKey}`;
+      if (flatKey === camelKey) {
+        return { arrayKey: rootKey, subKey };
+      }
+    }
+  }
+  return null;
+}

package/client/utils/restore-original-keys.ts

@@ -0,0 +1,23 @@
+import { keyMappingData } from '../lib/key-mapping-data';
+
+/**
+ * 将 CLI 传入的带 '-' 的参数名还原为原始的 '_' 或 '@' 参数名
+ * 通过 key-mapping.json 中的映射表进行查找还原
+ */
+export function restoreOriginalKeys(
+  params: Record<string, string | string[] | boolean | undefined>,
+): Record<string, string | string[] | boolean | undefined> {
+  const moduleName = params.module as string;
+  const toolName = params.tool as string;
+  if (!moduleName || !toolName) return params;
+
+  const toolMapping = keyMappingData[moduleName]?.[toolName];
+  if (!toolMapping) return params;
+
+  const restored: Record<string, string | string[] | boolean | undefined> = {};
+  for (const [key, value] of Object.entries(params)) {
+    const originalKey = toolMapping[key];
+    restored[originalKey || key] = value;
+  }
+  return restored;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-api-generate",
-  "version": "1.2.8",
+  "version": "2.1.0",
   "main": "./built/index.js",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
@@ -37,6 +37,7 @@
     "@types/lodash": "4.17.20",
     "babel-plugin-transform-define": "^2.1.4",
     "cli-progress": "^3.12.0",
+    "commander": "^14.0.3",
     "debug": "4.4.1",
     "glob": "^13.0.1",
     "lodash": "^4.17.23",
@@ -47,7 +48,6 @@
   },
   "devDependencies": {
     "@reduxjs/toolkit": "^1.9.5",
-    "eslint-config-tencent": "^1.1.3",
     "@types/debug": "4.1.12",
     "@types/jest": "^29.5.3",
     "@types/node": "24.0.12",
@@ -56,6 +56,7 @@
     "axios": "^1.13.6",
     "eslint": "8.57.0",
     "eslint-config-prettier": "9.1.0",
+    "eslint-config-tencent": "^1.1.3",
     "eslint-config-turbo": "2.2.3",
     "eslint-plugin-prettier": "5.2.1",
     "jest": "^29.6.1",

package/skills-template/SKILL.md

@@ -12,30 +12,29 @@ description: CNB OpenAPI 交互能力，支持仓库、Issue、PR、流水线、
 issues 快捷命令：
 - `<$CNB_CLI_CMD$> issues get` — 获取 Issue 详情
 - `<$CNB_CLI_CMD$> issues list-comments` — 列出 Issue 评论
-- `<$CNB_CLI_CMD$> issues comment --data '{"body":"内容"}'` — 发表 Issue 评论
+- `<$CNB_CLI_CMD$> issues comment --body 内容` — 发表 Issue 评论
 - `<$CNB_CLI_CMD$> issues close` — 关闭 Issue
 - `<$CNB_CLI_CMD$> issues open` — 打开 Issue
 - `<$CNB_CLI_CMD$> issues list-labels` — 列出 Issue 标签
-- `<$CNB_CLI_CMD$> issues add-labels --data '{"labels":["标签"]}'` — 添加 Issue 标签
+- `<$CNB_CLI_CMD$> issues add-labels --labels bug --labels feature` — 添加 Issue 标签
 - `<$CNB_CLI_CMD$> issues list-assignees` — 查看 Issue 处理人
-- `<$CNB_CLI_CMD$> issues add-assignees --data '{"assignees":["用户名"]}'` — 添加 Issue 处理人
-- `<$CNB_CLI_CMD$> issues upload-file --data '{"file":"本地文件路径"}'` — 上传文件到 Issue
-- `<$CNB_CLI_CMD$> issues upload-image --data '{"file":"本地图片路径"}'` — 上传图片到 Issue
+- `<$CNB_CLI_CMD$> issues add-assignees --assignees username` — 添加 Issue 处理人
+- `<$CNB_CLI_CMD$> issues upload-file --file 文件路径` — 上传文件到 Issue
+- `<$CNB_CLI_CMD$> issues upload-image --file 图片路径` — 上传图片到 Issue
 
 pulls 快捷命令：
 - `<$CNB_CLI_CMD$> pulls get` — 获取 PR 详情
 - `<$CNB_CLI_CMD$> pulls list-files` — 列出 PR 变更文件
 - `<$CNB_CLI_CMD$> pulls list-commits` — 列出 PR 提交记录
 - `<$CNB_CLI_CMD$> pulls list-comments` — 列出 PR 评论
-- `<$CNB_CLI_CMD$> pulls comment --data '{"body":"内容"}'` — 发表 PR 评论
+- `<$CNB_CLI_CMD$> pulls comment --body 内容` — 发表 PR 评论
 - `<$CNB_CLI_CMD$> pulls list-labels` — 列出 PR 标签
-- `<$CNB_CLI_CMD$> pulls add-labels --data '{"labels":["标签"]}'` — 添加 PR 标签
+- `<$CNB_CLI_CMD$> pulls add-labels --labels ready --labels approved` — 添加 PR 标签
 - `<$CNB_CLI_CMD$> pulls check-status` — 查看 CI 状态
 - `<$CNB_CLI_CMD$> pulls list-reviews` — 查看评审列表
 - `<$CNB_CLI_CMD$> pulls list-assignees` — 查看 PR 处理人
-- `<$CNB_CLI_CMD$> pulls add-assignees --data '{"assignees":["用户名"]}'` — 添加 PR 处理人
-- `<$CNB_CLI_CMD$> pulls upload-file --data '{"file":"本地文件路径"}'` — 上传文件到 PR
-- `<$CNB_CLI_CMD$> pulls upload-image --data '{"file":"本地图片路径"}'` — 上传图片到 PR
+- `<$CNB_CLI_CMD$> pulls upload-file --file 文件路径` — 上传文件到 PR
+- `<$CNB_CLI_CMD$> pulls upload-image --file 图片路径` — 上传图片到 PR
 
 注意：
 - **路径参数自动注入**：仓库 slug、Issue/PR 编号优先从环境变量自动获取，无需额外传入任何其他参数

package/client/modules.help.ts

@@ -1,49 +0,0 @@
-/**
- * 去除 summary 中的英文部分（保留中文句号前的内容）
- */
-function trimSummary(summary: string): string {
-  if (!summary) return '';
-  // 匹配中文句号"。"后面跟英文的模式，只保留中文部分
-  const match = summary.match(/^(.*?[\u4e00-\u9fff].*?)[。.]\s*[A-Z]/);
-  if (match) return match[1];
-  // 没有匹配到则返回原文
-  return summary;
-}
-
-/**
- * 显示模块帮助文档
- * @param helpData 帮助数据
- * @param moduleName 模块名称
- */
-export function showModuleHelp(helpData: any, moduleName: string): void {
-  const moduleHelpData = helpData.modulesHelp[moduleName];
-  if (!moduleHelpData) {
-    console.error(`模块 ${moduleName} 不存在`);
-    process.exit(1);
-  }
-
-  const cliCmd = process.env.CNB_CLI_CMD || 'cnb';
-
-  const entries = Object.values(moduleHelpData).map((info: any) => ({
-    name: info.filename as string,
-    summary: trimSummary(info.summary || ''),
-  }));
-  const maxNameLen = Math.max(...entries.map((e) => e.name.length));
-  const pad = maxNameLen + 2;
-
-  let toolListMsg = '';
-  for (const { name, summary } of entries) {
-    toolListMsg += `  ${name.padEnd(pad)} ${summary}\n`;
-  }
-
-  const helpMsg = `
-${moduleName} 模块
-
-工具:
-${toolListMsg}
-用法: ${cliCmd} ${moduleName} <tool> --help
-`;
-  console.log(helpMsg);
-}
-
-export { trimSummary };