@cnbcool/cnb-cli 1.1.0 → 1.2.0

package/skills/cnb-api/scripts/core/lib/summary-extractors.js

@@ -0,0 +1,181 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.summarizeResponse = summarizeResponse;
+/**
+ * 摘要输出
+ * 对返回数据量大的快捷命令，默认只输出核心字段，减少 token 消耗
+ */
+
+/**
+ * 摘要提取器配置
+ * key: "module/tool"，value: 摘要提取函数
+ * - 对象响应：直接对 data 应用提取函数
+ * - 数组响应：对 data 中每个元素应用提取函数
+ */
+const SUMMARY_EXTRACTORS = {
+  // 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 评论列表摘要：只保留作者用户名、内容和创建时间
+  // 过滤: 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 => ({
+      username: a.username,
+      nickname: a.nickname
+    })).filter(a => 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 => 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 => ({
+      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) || []
+  })
+};
+
+/**
+ * 对响应数据应用摘要提取（如果当前 tool 配置了摘要提取器）
+ * @param data 原始 data（对象或数组）
+ * @param toolKey 当前 tool 标识，格式为 "module/tool"
+ * @returns 摘要后的 data，如果无匹配提取器则返回 null
+ */
+function summarizeResponse(data, toolKey) {
+  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/skills/cnb-api/scripts/core/lib/trim-summary.js

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

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

@@ -6,7 +6,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.detectEventContext = detectEventContext;
 exports.resolveShortcut = resolveShortcut;
 exports.showShort = showShort;
-exports.summarizeResponse = summarizeResponse;
 /**
  * 快捷命令模块
  *
@@ -53,7 +52,7 @@ const ISSUE_SHORTCUTS = [{
   shortName: 'comment',
   realTool: 'post-issue-comment',
   description: '评论',
-  dataTip: "--data '{\"body\":\"内容\"}'"
+  dataTip: "--body 内容"
 }, {
   shortName: 'close',
   realTool: 'update-issue',
@@ -78,7 +77,7 @@ const ISSUE_SHORTCUTS = [{
   shortName: 'add-labels',
   realTool: 'post-issue-labels',
   description: '添加标签',
-  dataTip: "--data '{\"labels\":[\"bug\",\"feature\"]}'"
+  dataTip: "--labels bug --labels feature"
 }, {
   shortName: 'list-assignees',
   realTool: 'list-issue-assignees',
@@ -87,19 +86,19 @@ const ISSUE_SHORTCUTS = [{
   shortName: 'add-assignees',
   realTool: 'post-issue-assignees',
   description: '添加处理人',
-  dataTip: "--data '{\"assignees\":[\"username\"]}'"
+  dataTip: "--assignees username"
 }, {
   shortName: 'upload-file',
   realTool: 'post-issue-file-asset-upload-url',
   description: '上传文件',
   upload: true,
-  dataTip: "--data '{\"file\":\"文件路径\"}'"
+  dataTip: "--file 文件路径"
 }, {
   shortName: 'upload-image',
   realTool: 'post-issue-image-asset-upload-url',
   description: '上传图片',
   upload: true,
-  dataTip: "--data '{\"file\":\"图片路径\"}'"
+  dataTip: "--file 图片路径"
 }];
 const PR_SHORTCUTS = [{
   shortName: 'get',
@@ -121,7 +120,7 @@ const PR_SHORTCUTS = [{
   shortName: 'comment',
   realTool: 'post-pull-comment',
   description: '评论',
-  dataTip: "--data '{\"body\":\"内容\"}'"
+  dataTip: "--body 内容"
 }, {
   shortName: 'list-labels',
   realTool: 'list-pull-labels',
@@ -130,7 +129,7 @@ const PR_SHORTCUTS = [{
   shortName: 'add-labels',
   realTool: 'post-pull-labels',
   description: '添加标签',
-  dataTip: "--data '{\"labels\":[\"ready\",\"approved\"]}'"
+  dataTip: "--labels ready --labels approved"
 }, {
   shortName: 'check-status',
   realTool: 'list-pull-commit-statuses',
@@ -149,14 +148,14 @@ const PR_SHORTCUTS = [{
   description: '上传文件',
   repoOnly: true,
   upload: true,
-  dataTip: "--data '{\"file\":\"文件路径\"}'"
+  dataTip: "--file 文件路径"
 }, {
   shortName: 'upload-image',
   realTool: 'upload-imgs',
   description: '上传图片',
   repoOnly: true,
   upload: true,
-  dataTip: "--data '{\"file\":\"图片路径\"}'"
+  dataTip: "--file 图片路径"
 }];
 
 // ============================================================
@@ -234,7 +233,7 @@ ${prList}
   CNB_ISSUE_IID          - Issue 编号（Issue 相关快捷命令）
   CNB_PULL_REQUEST_IID   - PR 编号（PR 相关快捷命令）
 
-  默认只输出摘要信息，添加 --verbose 可输出全部信息
+  默认只输出摘要信息，添加 --v 可输出全部信息
 `);
   }
 }
@@ -273,179 +272,4 @@ function resolveShortcut(moduleName, toolName) {
     autoData: matched.autoData || null,
     upload: !!matched.upload
   };
-}
-
-// ============================================================
-// 摘要输出
-// 对返回数据量大的快捷命令，默认只输出核心字段，减少 token 消耗
-// ============================================================
-
-/**
- * 摘要提取器配置
- * key: "module/tool"，value: 摘要提取函数
- * - 对象响应：直接对 data 应用提取函数
- * - 数组响应：对 data 中每个元素应用提取函数
- */
-const SUMMARY_EXTRACTORS = {
-  // 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 评论列表摘要：只保留作者用户名、内容和创建时间
-  // 过滤: 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 => ({
-      username: a.username,
-      nickname: a.nickname
-    })).filter(a => 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 => 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 => ({
-      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) || []
-  })
-};
-
-/**
- * 对响应数据应用摘要提取（如果当前 tool 配置了摘要提取器）
- * @param data 原始 data（对象或数组）
- * @param toolKey 当前 tool 标识，格式为 "module/tool"
- * @returns 摘要后的 data，如果无匹配提取器则返回 null
- */
-function summarizeResponse(data, toolKey) {
-  const extractor = SUMMARY_EXTRACTORS[toolKey];
-  if (!extractor) return null;
-  if (Array.isArray(data)) {
-    return data.map(extractor);
-  }
-  return extractor(data);
 }

package/skills/cnb-api/scripts/core/utils/build-nested-field-map.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildNestedFieldMap = buildNestedFieldMap;
+/**
+ * 递归遍历嵌套对象的 schema，生成所有叶子节点的 flat key 映射
+ * @param props  当前层级的 properties
+ * @param prefix 当前层级的 CLI flat key 前缀（用 @ 连接），如 "testBody"
+ * @param pathKeys 当前层级的 schema 路径数组，如 ["testBody"]
+ * @returns Map<flatKey, NestedFieldMapping>
+ */
+function buildNestedFieldMap(props, prefix, pathKeys) {
+  const map = new Map();
+  for (const [subKey, subProp] of Object.entries(props)) {
+    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/skills/cnb-api/scripts/core/utils/flat-key-from-segments.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.flatKeyFromSegments = flatKeyFromSegments;
+/**
+ * 生成 CLI flat key：按 '@' 连接层级
+ * 例如 "testBody@critical_count@id"
+ * Commander 不会对 '@' 做 camelCase 转换，所以 key 保持原样
+ */
+function flatKeyFromSegments(str) {
+  return str;
+}

package/skills/cnb-api/scripts/core/utils/match-array-object-field.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.matchArrayObjectField = matchArrayObjectField;
+/**
+ * 检测是否为 array<object> 展开字段（格式：bodyArrayKey@subPropName）
+ * Commander 不会对 '@' 做 camelCase，所以直接匹配原始 key
+ */
+function matchArrayObjectField(camelKey, bodyProps) {
+  for (const [rootKey, rootProp] of Object.entries(bodyProps)) {
+    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/skills/cnb-api/scripts/core/utils/restore-original-keys.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.restoreOriginalKeys = restoreOriginalKeys;
+var _keyMappingData = require("../lib/key-mapping-data");
+/**
+ * 将 CLI 传入的带 '-' 的参数名还原为原始的 '_' 或 '@' 参数名
+ * 通过 key-mapping.json 中的映射表进行查找还原
+ */
+function restoreOriginalKeys(params) {
+  const moduleName = params.module;
+  const toolName = params.tool;
+  if (!moduleName || !toolName) return params;
+  const toolMapping = _keyMappingData.keyMappingData[moduleName]?.[toolName];
+  if (!toolMapping) return params;
+  const restored = {};
+  for (const [key, value] of Object.entries(params)) {
+    const originalKey = toolMapping[key];
+    restored[originalKey || key] = value;
+  }
+  return restored;
+}