@cnbcool/cnb-cli 1.0.1 → 1.0.3

package/README.md

@@ -2,32 +2,13 @@
 
 CNB 平台技能集合，在一个仓库中维护多个 CodeBuddy Skill，可通过 `npx skills` 便捷安装。
 
-## 包含的 Skills
-
-| Skill | 描述 |
-|-------|------|
-| **cnb-skill** | 提供与 CNB OpenAPI 的完整交互能力，支持项目、组织、代码仓库、Issue、PR、流水线、制品库等操作 |
-| **cnb-code-import** | 批量迁移代码仓库到 CNB 平台，支持 GitHub、GitLab、CODING、Gitee 等主流平台 |
-| **artifact-migrate** | CNB 制品批量迁移工具，支持 Maven、NPM、Docker 等多种制品类型迁移 |
-| **code-review** | PR 代码评审，提供标准化评审流程和行级评论 |
-| **pr-diff** | 获取 PR 的 diff 变更信息 |
-| **pr-summary** | PR 变更总结，生成结构化的变更说明 |
-| **auto-code** | 自动编码并创建/更新 PR |
-| **dialog-ci-log** | 查询 CI 流水线的错误日志 |
-| **diagnose-pr-pipeline** | 获取 PR 触发的 CI 报错详细信息 |
-| **tapd-saas-resource-fetcher-skills** | 获取 Tapd SaaS 资源（需求、缺陷、任务、迭代） |
-| **CNB-Text-Relative-Path-Converter** | 将 ISSUE/PR 内容中的相对路径转换为绝对路径 |
-
-## 运行环境要求
-
-- Node.js 20.x 及以上版本
-
 ## 安装方式
 
-### 一键安装所有 Skill
+### 安装 skills
 
 ```bash
-npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill '*' --agent codebuddy -y
+# 一键安装所有 Skill
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y
 ```
 
 ### 只安装指定的 Skill
@@ -37,15 +18,18 @@ npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill '*' --agent cod
 npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --list
 
 # 安装单个 Skill
-npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-skill --agent codebuddy -y
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-api --agent codebuddy -y
 
 # 安装多个指定 Skill
-npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-skill --skill code-review --skill pr-diff --agent codebuddy -y
+npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-api --skill code-review --skill pr-diff --agent codebuddy -y
 ```
 
-### 使用 cnb-skill 还需安装 cnb-cli
+### 安装 cnb-cli
+
+使用 cnb-skills 还需安装 cnb-cli
 
 ```bash
+# 运行环境要求 Node.js 20.x 及以上版本
 npm install @cnbcool/cnb-cli -g
 ```
 
@@ -66,19 +50,17 @@ npm install @cnbcool/cnb-cli -g
    npm install skills -g
 
 3. 通过 skills 工具安装所有 skill 到当前工作目录：
-   npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill '*' --agent codebuddy -y --copy
+   npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y --copy
 
 每一步执行完后告诉我结果，如果有报错请帮我解决。
 ```
 
 ## 环境变量
 
-| 变量名 | 描述 | 是否必需 | 示例值 |
-|--------|------|----------|--------|
-| CNB_TOKEN | 访问凭证 | 必须 | - |
-| CNB_API_ENDPOINT | API端点地址 | 必须 | https://api.cnb.cool |
-| CNB_BRANCH | 默认分支 | 选填 | main |
+- **CNB_TOKEN** — 访问凭证（必须）
+- **CNB_API_ENDPOINT** — API 端点地址（必须），示例：`https://api.cnb.cool`
+- **CNB_BRANCH** — 默认分支（选填），示例：`main`
 
 ## 关键词
 
-CNB、云原生构建、组织、代码仓库、Issue、PR、合并请求、流水线、制品库、代码迁移、制品迁移、代码评审、CI/CD
+CNB、云原生构建、组织、代码仓库、Issue、PR、合并请求、流水线、代码评审、CI/CD

package/bin/cnb.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-require("../skills/cnb-skill/scripts/core/index.js");
+require("../skills/cnb-api/scripts/core/index.js");

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@cnbcool/cnb-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作",
-  "main": "skills/cnb-skill/scripts/core/index.js",
+  "main": "skills/cnb-api/scripts/core/index.js",
   "bin": {
     "cnb": "bin/cnb.js"
   },
   "files": [
     "bin/",
-    "skills/cnb-skill/scripts/"
+    "skills/cnb-api/scripts/"
   ],
   "engines": {
     "node": ">=18.0.0"
@@ -34,7 +34,7 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
-    "@cnbcool/cnb-api-generate": "^1.0.0",
+    "@cnbcool/cnb-api-generate": "^1.1.2",
     "skills": "^1.4.4"
   }
 }

package/skills/{cnb-skill → cnb-api}/scripts/core/config/cag.config.js

@@ -1,6 +1,6 @@
 module.exports = {
   target: 'https://api.cnb.cool/swagger.json',
-  skillsOutputDir: `./skills/cnb-skill`,
+  skillsOutputDir: `./skills/cnb-api`,
   // skillsDev: true,
   skillConfig: {
     fetchConfig: {

package/skills/{cnb-skill → cnb-api}/scripts/core/convertLink.js

@@ -114,7 +114,7 @@ function convertLink(text, repoSlug, branchOrSha) {
 
 /**
  * 相对路径转换为绝对路径
- * 与 codebuddy/skills/cnb-text-relative-path-converter/scripts/convertLink.js 逻辑一致
+ * 与 codebuddy/skills/text-path-converter/scripts/convertLink.js 逻辑一致
  *
  * @param {String} link 待转换的链接
  * @param {String} repoSlug 仓库路径

package/skills/{cnb-skill → cnb-api}/scripts/core/core.js

@@ -10,17 +10,44 @@ var _os = _interopRequireDefault(require("os"));
 var _fetchResponseHandler = require("./fetch-response-handler");
 var _generateUniqueId = require("./utils/generate-unique-id");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * 格式化 API 响应
+ * 构建包含以下字段的响应对象：
+ * - status: HTTP 状态码
+ * - trace: traceparent（用于调试追踪）
+ * - header: 原始分页 header（x-cnb-page 等）
+ * - page/pageSize/total/totalPages: 从 header 计算的分页信息（仅列表 API）
+ * - data: 响应体（JSON/文本/图片路径/base64）
+ * 
+ * 注意：所有字段始终保留，由 index.ts 的输出层决定展示哪些
+ */
 async function formatResponse(data, response) {
+  const status = response.status;
+  const trace = response.headers.get('traceparent');
+  const page = response.headers.get('x-cnb-page');
+  const pageSize = response.headers.get('x-cnb-page-size');
+  const total = response.headers.get('x-cnb-total');
   const responseData = {
-    status: response.status,
-    trace: response.headers.get('traceparent'),
+    status,
+    trace,
     header: {
-      'x-cnb-page': response.headers.get('x-cnb-page'),
-      'x-cnb-page-size': response.headers.get('x-cnb-page-size'),
-      'x-cnb-total': response.headers.get('x-cnb-total')
+      'x-cnb-page': page,
+      'x-cnb-page-size': pageSize,
+      'x-cnb-total': total
     },
     data: null
   };
+
+  // 分页信息（始终计算，输出层决定是否展示）
+  if (total != null) {
+    const pageNum = parseInt(page, 10) || 1;
+    const pageSizeNum = parseInt(pageSize, 10) || 10;
+    const totalNum = parseInt(total, 10) || 0;
+    responseData.page = pageNum;
+    responseData.pageSize = pageSizeNum;
+    responseData.total = totalNum;
+    responseData.totalPages = Math.ceil(totalNum / pageSizeNum);
+  }
   const contentType = response.headers.get('content-type') || '';
   const isJson = ['application/vnd.cnb.api+json', 'application/json', 'text/json'].some(t => contentType.includes(t));
   const isText = contentType.startsWith('text/') || contentType.includes('xml');
@@ -42,7 +69,7 @@ async function formatResponse(data, response) {
       // 构建本地保存路径
       // 注意：请确保 './downloads' 目录存在，或者使用 fs.mkdirSync 创建它
       const tempDir = _os.default.tmpdir();
-      const uploadDir = _path.default.join(tempDir, 'cnb-skill');
+      const uploadDir = _path.default.join(tempDir, 'cnb-api');
       if (!_fs.default.existsSync(uploadDir)) {
         _fs.default.mkdirSync(uploadDir, {
           recursive: true