@cnbcool/cnb-cli 1.0.2 → 1.0.3

package/README.md

@@ -2,27 +2,12 @@
 
 CNB 平台技能集合，在一个仓库中维护多个 CodeBuddy Skill，可通过 `npx skills` 便捷安装。
 
-## 包含的 Skills
-
-- **cnb-api** — 提供与 CNB OpenAPI 的完整交互能力，支持项目、组织、代码仓库、Issue、PR、流水线、制品库等操作
-- **code-review** — PR 代码评审，提供标准化评审流程和行级评论
-- **pr-diff** — 获取 PR 的 diff 变更信息
-- **pr-summary** — PR 变更总结，生成结构化的变更说明
-- **code-to-pr** — 自动编码并创建/更新 PR
-- **dialog-ci-log** — 查询 CI 流水线的错误日志
-- **diagnose-pr-pipeline** — 获取 PR 触发的 CI 报错详细信息
-- **tapd-saas-resource-fetcher-skills** — 获取 Tapd SaaS 资源（需求、缺陷、任务、迭代）
-- **text-path-converter** — 将 ISSUE/PR 内容中的相对路径转换为绝对路径
-
-## 运行环境要求
-
-- Node.js 20.x 及以上版本
-
 ## 安装方式
 
-### 一键安装所有 Skill
+### 安装 skills
 
 ```bash
+# 一键安装所有 Skill
 npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y
 ```
 
@@ -39,9 +24,12 @@ npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-api --agent
 npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-api --skill code-review --skill pr-diff --agent codebuddy -y
 ```
 
-### 使用 cnb-api 还需安装 cnb-cli
+### 安装 cnb-cli
+
+使用 cnb-skills 还需安装 cnb-cli
 
 ```bash
+# 运行环境要求 Node.js 20.x 及以上版本
 npm install @cnbcool/cnb-cli -g
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cnbcool/cnb-cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "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.0.2",
+    "@cnbcool/cnb-api-generate": "^1.1.2",
     "skills": "^1.4.4"
   }
 }

package/skills/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');