@cnbcool/cnb-api-generate 2.4.1 → 2.4.3

package/client/core.ts

@@ -4,6 +4,7 @@ import os from 'os';
 import { fetchResponseHandler } from "./fetch-response-handler";
 import { generateUniqueId } from './utils/generate-unique-id';
 import { resolveToken } from './utils/resolve-token';
+import { resolveApiDomain } from './utils/resolve-api-domain';
 
 /**
  * 格式化 API 响应
@@ -118,7 +119,7 @@ async function formatResponse(data: any, response: any) {
 
 async function clientFetch(data: any): Promise<any> {
   const token = await resolveToken();
-  const domain = process.env.CNB_API_ENDPOINT || 'https://api.cnb.cool'
+  const domain = resolveApiDomain()
   const url = `${domain}${data.url}`
   const urlParse = new URL(url);
   if (data.params) {

package/client/index.ts

@@ -5,6 +5,8 @@ import { getExtraHelpText } from './lib/extra-help';
 import { registerModuleCommands } from './lib/register-modules';
 import { registerFallbackAction } from './lib/register-fallback';
 import { registerLoginCommand } from './lib/login';
+import { registerLogoutCommand } from './lib/logout';
+import { registerStatusCommand } from './lib/status';
 
 // ============================================================
 // Commander 程序定义
@@ -26,6 +28,8 @@ program
 // ============================================================
 
 registerLoginCommand(program);
+registerLogoutCommand(program);
+registerStatusCommand(program);
 registerModuleCommands(program);
 registerFallbackAction(program);
 

package/client/lib/build-helpers.ts

@@ -7,6 +7,7 @@
  */
 
 import { resolveToken } from '../utils/resolve-token';
+import { resolveApiDomain } from '../utils/resolve-api-domain';
 
 /** CNB 构建号格式：cnb-xxx-xxxxxxxxx（字母/数字组成的两段） */
 export const SN_PATTERN = /^cnb-[a-z0-9]+-[a-z0-9]+$/i;
@@ -111,7 +112,7 @@ export async function resolveBuildContext(
   | { ok: true; ctx: ResolvedContext }
   | { ok: false; message: string }
 > {
-  const domain = process.env.CNB_API_ENDPOINT || 'https://api.cnb.cool';
+  const domain = resolveApiDomain();
   const { repo } = options;
   let sn = options.sn;
 

package/client/lib/login.ts

@@ -16,12 +16,13 @@ export function registerLoginCommand(program: Command): void {
     .description('通过 OAuth2 设备授权流登录 CNB，获取并保存 access_token')
     .option('--client-id <string>', 'OAuth2 client_id', process.env.OAUTH2_CLIENT_ID || 'cnb_cli')
     .option('--woa', '使用内网环境 (https://cnb.woa.com)', false)
+    .option('--host <string>', '指定自定义域名 (优先级高于 --woa)')
     .option('--debug', '打印调试信息', false)
     .helpOption('-h, --help', '显示帮助文档')
     .action(async (opts) => {
       const cfg: LoginConfig = {
         clientID: opts.clientId,
-        platformURL: opts.woa ? 'https://cnb.woa.com' : 'https://cnb.cool',
+        platformURL: opts.host ? opts.host : opts.woa ? 'https://cnb.woa.com' : 'https://cnb.cool',
         debug: opts.debug,
       };
 
@@ -77,11 +78,15 @@ export function registerLoginCommand(program: Command): void {
         }
         // 持久化 token
         const nowSec = Math.floor(Date.now() / 1000);
+        // 从 platformURL 推导 API 域名，例如 https://cnb.cool -> https://api.cnb.cool
+        const platformHost = new URL(cfg.platformURL).hostname;
+        const loginHost = `https://api.${platformHost}`;
         const store: TokenStore = {
           access_token: tok.access_token,
           expires_at: nowSec + tok.expires_in,
           platform_url: cfg.platformURL,
           client_id: cfg.clientID,
+          login_host: loginHost,
         };
         if (tok.refresh_token) {
           store.refresh_token = tok.refresh_token;

package/client/lib/logout.ts

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import fs from 'fs';
+import { getTokenPath } from '../utils/token-path';
+import { loadToken } from '../utils/load-token';
+
+export function registerLogoutCommand(program: Command): void {
+  program
+    .command('logout')
+    .description('退出登录，删除本地保存的 access_token')
+    .option('--debug', '打印调试信息', false)
+    .helpOption('-h, --help', '显示帮助文档')
+    .action(async (opts) => {
+      const tokenPath = getTokenPath();
+      const token = loadToken();
+
+      if (!token) {
+        console.log('当前未登录，无需退出。');
+        return;
+      }
+
+      if (opts.debug) {
+        console.log(`Token 文件路径: ${tokenPath}`);
+        console.log(`Platform URL : ${token.platform_url}`);
+        console.log(`Client ID    : ${token.client_id}`);
+      }
+
+      try {
+        fs.unlinkSync(tokenPath);
+        console.log('已成功退出登录。');
+      } catch (err: any) {
+        console.error(`退出登录失败: ${err.message}`);
+        process.exit(1);
+      }
+    });
+}

package/client/lib/status.ts

@@ -0,0 +1,59 @@
+import { Command } from 'commander';
+import { getTokenPath } from '../utils/token-path';
+import { loadToken } from '../utils/load-token';
+import { refreshAccessToken } from '../utils/refresh-token';
+
+export function registerStatusCommand(program: Command): void {
+  program
+    .command('status')
+    .description('检查当前登录状态（token 是否存在、是否过期）')
+    .option('--debug', '打印调试信息', false)
+    .helpOption('-h, --help', '显示帮助文档')
+    .action(async (opts) => {
+      const tokenPath = getTokenPath();
+      const token = loadToken();
+
+      if (!token) {
+        console.log('⚠️  未登录，请执行 `cnb login` 进行授权。');
+        return;
+      }
+
+      if (opts.debug) {
+        console.log(`Token 文件路径 : ${tokenPath}`);
+        console.log(`Platform URL  : ${token.platform_url || '未知'}`);
+        console.log(`Client ID     : ${token.client_id || '未知'}`);
+        console.log(`Expires At    : ${new Date(token.expires_at * 1000).toLocaleString()}`);
+      }
+
+      const nowSec = Math.floor(Date.now() / 1000);
+      const isExpired = nowSec >= token.expires_at;
+
+      if (isExpired) {
+        // 尝试使用 refresh_token 刷新
+        if (token.refresh_token) {
+          if (opts.debug) {
+            console.log('Token 已过期，尝试使用 refresh_token 刷新...');
+          }
+          try {
+            await refreshAccessToken(token);
+            const refreshedToken = loadToken();
+            if (refreshedToken) {
+              console.log('✅ 已登录。');
+              if (opts.debug) {
+                console.log('   （Token 已自动刷新）');
+              }
+            }
+          } catch (err: any) {
+            if (opts.debug) {
+              console.log(`刷新失败: ${err.message}`);
+            }
+            console.log('⚠️  未登录，请执行 `cnb login` 重新授权。');
+          }
+        } else {
+          console.log('⚠️  未登录，请执行 `cnb login` 重新授权。');
+        }
+      } else {
+        console.log('✅ 已登录。');
+      }
+    });
+}

package/client/utils/resolve-api-domain.ts

@@ -0,0 +1,26 @@
+import { loadToken } from './load-token';
+
+/**
+ * 获取 API 域名。
+ *
+ * 优先级：
+ * 1. 如果设置了环境变量 CNB_TOKEN（即非 OAuth 登录），使用 CNB_API_ENDPOINT 或默认值
+ * 2. 如果是 OAuth 登录（token 文件中有 login_host），使用登录时记录的域名
+ * 3. 兜底使用 CNB_API_ENDPOINT 或默认值 https://api.cnb.cool
+ */
+export function resolveApiDomain(): string {
+  const defaultDomain = process.env.CNB_API_ENDPOINT || 'https://api.cnb.cool';
+
+  // 如果使用环境变量 token，直接走 CNB_API_ENDPOINT
+  if (process.env.CNB_TOKEN_FOR_CODEBUDDY || process.env.CNB_TOKEN) {
+    return defaultDomain;
+  }
+
+  // OAuth 登录场景：优先使用登录时记录的域名
+  const store = loadToken();
+  if (store?.login_host) {
+    return store.login_host;
+  }
+
+  return defaultDomain;
+}

package/client/utils/types.ts

@@ -42,4 +42,6 @@ export interface TokenStore {
   platform_url?: string;
   /** 用于 refresh 时携带 client_id */
   client_id?: string;
+  /** 登录时使用的 API 域名（如 https://api.cnb.cool），用于后续 CLI 调用 */
+  login_host?: string;
 }

package/package.json

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

package/skills-template/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cnb-api
-description: CNB OpenAPI 交互能力，支持仓库、Issue、PR、流水线、制品库等操作。
+description: CNB 平台交互命令，支持仓库、Issue、PR、流水线、制品库等操作。
 ---
 
 # cnb-api
@@ -38,16 +38,14 @@ pulls:
 - `<$CNB_CLI_CMD$> pulls upload-image --file 图片路径` — 上传图片到当前 PR
 
 注意事项：
-- **路径参数自动识别**：快捷命令中的 Issue/PR 编号会自动从环境变量识别，无需额外传递。
-- **默认只输出摘要**：默认会精简响应输出结果，只返回核心字段。添加 `--verbose` 输出完整数据。
-- **多行文本传参使用单引号**：传递多行文本参数时，使用单引号可防止命令注入攻击，并减少不必要的转义。
-- **快捷命令范围** 快捷命令只能操作当前仓库的当前 Issue/PR，跨仓库或跨编号操作请使用其他 API 命令。
+- **参数自动识别**：快捷命令中的 Issue/PR 编号会自动从环境变量识别，无需额外传递。
+- **默认仅需摘要**：默认会精简响应输出结果，只返回核心字段。添加 `--verbose` 输出完整数据。
+- **单引号传参**：传递多行文本参数时，使用单引号可防止命令注入攻击，并减少不必要的转义。
+- **快捷命令适用范围**: 快捷命令只能操作当前仓库的当前 Issue/PR，跨仓库或跨编号操作请参考 `更多 API`。
+- **npc提及和召唤的区别**: 评论中直接 @npc 会召唤 npc 干活，如果只提及不召唤，应该去掉 `@` 符号，或使用反引号包裹 `@npc`。 
 
 ## 更多 API
 
-优先使用快捷命令，不满足时才使用以下这些命令
-
 1. `<$CNB_CLI_CMD$> --help` 查看所有模块
 2. `<$CNB_CLI_CMD$> <module> --help` 查看模块下的工具列表
 3. `<$CNB_CLI_CMD$> <module> <tool> --help` 查看工具参数
-4. 按帮助文档操作，禁止猜测