sino-bc-cli 1.1.0 → 1.2.0

package/README.md

@@ -91,7 +91,7 @@ sino-bc-cli /init
 ### ⑥ 免安装临时执行
 
 ```bash
-npx sino-bc-cli /homepage
+npx sino-bc-cli --help
 ```
 
 注意 `npx` 方式不会持久注册 Agent 技能，需要技能能力时仍请走全局安装 + `/init`。
@@ -140,9 +140,10 @@ sino-bc-cli/
 │   │
 │   ├── commands/                 # 📦 命令实现层（每命令一个文件，可独立扩展）
 │   │   ├── index.ts              # 命令批量注册入口
-│   │   ├── homepage.command.ts   # /homepage 命令实现（打开业务平台主页）
-│   │   ├── nexus-swagger.command.ts # /nexus-swagger 命令实现（打开 Nexus Swagger 文档页）
-│   │   └── ic-api.command.ts     # /ic-api 命令实现（调用 iCenter 接口地址）
+│   │   ├── init.command.ts       # /init 命令实现（注册 Agent 技能）
+│   │   ├── api-endpoint.command.ts # 接口调用类命令基类（选择接口 → 发起调用 → 打印响应）
+│   │   ├── ic-api.command.ts     # /ic-api 命令实现（调用 iCenter 接口地址）
+│   │   └── bc-api.command.ts     # /bc-api 命令实现（调用业务线查询 / 业务线策略接口）
 │   │
 │   ├── utils/                    # 🛠 工具类层（高内聚的可复用工具）
 │   │   ├── index.ts              # 工具模块统一导出
@@ -156,7 +157,7 @@ sino-bc-cli/
 │   │   └── index.ts              # 全局接口、枚举定义（ICommand、LogLevel 等）
 │   │
 │   └── constants/                # 🔧 常量配置层
-│       └── index.ts              # CLI 配置、URL 配置、命令名称、默认值
+│       └── index.ts              # CLI 配置、命令名称、默认值
 │
 ├── dist/                         # 📤 编译输出目录（编译后自动生成）
 │   └── ...                       # JavaScript 编译产物 + 类型声明 + SourceMap
@@ -235,8 +236,8 @@ npm run dev -- [参数]
 # 示例：查看帮助
 npm run dev -- --help
 
-# 示例：执行 /homepage 命令
-npm run dev -- /homepage
+# 示例：执行 /ic-api 命令
+npm run dev -- /ic-api
 ```
 
 ### 5. 全局安装（推荐）
@@ -257,7 +258,8 @@ npm i sino-bc-cli -g
 
 ```bash
 sino-bc-cli --help
-sino-bc-cli /homepage
+sino-bc-cli /init
+sino-bc-cli /ic-api
 ```
 
 `npm i sino-bc-cli -g` 完成后会自动执行 `/init`，把 `SKILL.md` 写到用户主目录的 Agent 技能目录（`~/.agents/skills/sino-bc-cli` 等）。飞书豆包工作：技能·连接器 → 管理 → **本地** → 刷新。若未出现，手动执行：
@@ -274,11 +276,11 @@ sino-bc-cli /init
 
 ### 可用命令一览
 
-| 命令             | 说明                                                                                                               |
-| :--------------- | :----------------------------------------------------------------------------------------------------------------- |
-| `/homepage`      | 使用默认浏览器打开 BeyondClick 业务平台主页 (`https://business.beyondclick.com/`)                                  |
-| `/nexus-swagger` | 使用默认浏览器打开 BeyondClick Nexus Swagger 文档页 (`https://o-test-sino-bc-nexus.meetsocial.com/doc.html#/home`) |
-| `/ic-api`        | 交互选择并调用 iCenter 接口地址；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量                                      |
+| 命令      | 说明                                                                                          |
+| :-------- | :-------------------------------------------------------------------------------------------- |
+| `/init`   | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别 |
+| `/ic-api` | 交互选择并调用 iCenter 接口地址；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量                 |
+| `/bc-api` | 交互选择并调用业务线查询 / 业务线策略接口（共 22 个，路径统一带 `/sino-opti-hive` 前缀）        |
 
 ### 全局选项
 
@@ -302,40 +304,35 @@ sino-bc-cli --help
 sino-bc-cli -h
 ```
 
-#### ② 打开 BeyondClick 业务平台主页
+#### ② 调用 iCenter 接口地址
 
 ```bash
-sino-bc-cli /homepage
+sino-bc-cli /ic-api
+sino-bc-cli /ic-api test
 ```
 
-执行效果：自动调用系统默认浏览器打开 `https://business.beyondclick.com/`。
+执行效果：交互选择接口后，向对应环境的 iCenter 接口地址发起请求。
 
-#### ③ 打开 BeyondClick Nexus Swagger 文档页
+#### ③ 调用业务线查询 / 业务线策略接口
 
 ```bash
-sino-bc-cli /nexus-swagger
+sino-bc-cli /bc-api
+sino-bc-cli /bc-api test
 ```
 
-执行效果：自动调用系统默认浏览器打开 Nexus Swagger 文档页。
-
-#### ④ 调用 iCenter 接口地址
+执行效果：按「业务线查询（5 个）」「业务线策略（17 个）」两组列出接口，输入序号后向对应环境网关发起请求。所有路径统一带 `/sino-opti-hive` 路由前缀，接口清单见 [`src/api-doc/README.md`](./src/api-doc/README.md)。
 
-```bash
-sino-bc-cli /ic-api
-sino-bc-cli /ic-api test
-```
-
-执行效果：交互选择接口后，向对应环境的 iCenter 接口地址发起请求。
+> ⚠️ 业务线策略组含新建 / 编辑 / 删除等写操作接口，会按文档示例请求体直接发起调用，执行前请确认环境。
 
-#### ⑤ 启用 Debug 模式运行
+#### ④ 启用 Debug 模式运行
 
 ```bash
-sino-bc-cli --debug /homepage
+sino-bc-cli --debug /ic-api
 # 或使用短选项
-sino-bc-cli -d /nexus-swagger
+sino-bc-cli -d /ic-api
 ```
 
-Debug 模式会输出详细的日志，包括参数解析、命令注册、URL 打开过程等信息，便于排查问题。
+Debug 模式会输出详细的日志，包括参数解析、命令注册、接口调用过程等信息，便于排查问题。
 
 ---
 
@@ -407,8 +404,8 @@ export class ExampleCommand implements ICommand {
 import { ExampleCommand } from "./example.command"; // 新增导入
 
 export const commands: ICommand[] = [
-  new HomepageCommand(),
-  new NexusSwaggerCommand(),
+  new InitCommand(),
+  new IcApiCommand(),
   new ExampleCommand(), // 新增注册
 ];
 ```

package/dist/SKILL.md

@@ -2,7 +2,7 @@
 name: sino-bc-cli
 description: >
   BeyondClick CLI 项目说明、命令用法、扩展新命令与 npm 发布/回滚步骤。
-  Use when 开发或使用 sino-bc-cli、执行 /init /homepage /nexus-swagger /ic-api、
+  Use when 开发或使用 sino-bc-cli、执行 /init /ic-api /bc-api、
   把技能注册到飞书豆包工作 / Cursor / Claude / Codex、扩展命令、
   npm publish、release:patch/minor/major、切 registry、排查 ENEEDAUTH/E403/EPUBLISHCONFLICT，
   或发布到私有 Nexus / 企业私服。
@@ -116,7 +116,7 @@ npm run rebuild    # 清理后重新编译
 
 ```bash
 npm run dev -- --help
-npm run dev -- /homepage
+npm run dev -- /ic-api
 ```
 
 ### 全局安装（推荐）
@@ -132,8 +132,8 @@ npm i sino-bc-cli -g
 
 ```bash
 sino-bc-cli --help
-sino-bc-cli /homepage
 sino-bc-cli /init
+sino-bc-cli /ic-api
 ```
 
 `npm i -g` / `npm link` 后的 postinstall 会自动执行 `/init`，把 `SKILL.md` 写到 `~/.agents/skills/sino-bc-cli/`（以及 Codex / Cursor / Claude 目录）。飞书豆包工作：技能·连接器 → 管理 → **本地** → 刷新。未出现时再手动跑一遍 `/init`。
@@ -156,12 +156,11 @@ npm run rebuild            # clean + tsc
 
 ### 可用命令
 
-| 命令             | 说明                                                                                                               |
-| :--------------- | :----------------------------------------------------------------------------------------------------------------- |
-| `/init`          | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别           |
-| `/homepage`      | 使用默认浏览器打开 BeyondClick 业务平台主页 (`https://business.beyondclick.com/`)                                  |
-| `/nexus-swagger` | 使用默认浏览器打开 BeyondClick Nexus Swagger 文档页 (`https://o-test-sino-bc-nexus.meetsocial.com/doc.html#/home`) |
-| `/ic-api`        | 交互选择并调用 iCenter 接口地址；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量                                      |
+| 命令      | 说明                                                                                                               |
+| :-------- | :----------------------------------------------------------------------------------------------------------------- |
+| `/init`   | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别           |
+| `/ic-api` | 交互选择并调用 iCenter 接口地址；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量                                      |
+| `/bc-api` | 交互选择并调用业务线查询（5 个）/ 业务线策略（17 个）接口；路径统一带 `/sino-opti-hive` 前缀，参数同 `/ic-api`        |
 
 ### 全局选项
 
@@ -177,20 +176,18 @@ npm run rebuild            # clean + tsc
 sino-bc-cli --version
 sino-bc-cli --help
 sino-bc-cli /init
-sino-bc-cli /homepage
-sino-bc-cli /nexus-swagger
 sino-bc-cli /ic-api
 sino-bc-cli /ic-api test
-sino-bc-cli --debug /homepage
-sino-bc-cli -d /nexus-swagger
+sino-bc-cli /bc-api
+sino-bc-cli /bc-api test
+sino-bc-cli --debug /ic-api
+sino-bc-cli -d /ic-api
 ```
 
 - `/init`：把 `SKILL.md` 写到 `~/.agents/skills/sino-bc-cli/`（以及 Codex / Cursor / Claude 对应目录）。`npm i sino-bc-cli -g` 的 postinstall 会自动跑一遍；飞书豆包工作请到「技能·连接器 → 管理 → 本地」刷新。Windows 使用 `%USERPROFILE%`，macOS / Linux 使用 `$HOME`。
-
-- `/homepage`：打开 `https://business.beyondclick.com/`
-- `/nexus-swagger`：打开 Nexus Swagger 文档页
 - `/ic-api`：交互选择并调用 iCenter 接口地址（默认 `prod` + 内置 API Key）
-- Debug 会输出参数解析、命令注册、URL 打开过程
+- `/bc-api`：交互选择并调用 sino-opti-hive 业务线接口，按「业务线查询 / 业务线策略」分组展示。接口清单在 `src/constants/biz-line-api-doc.ts`，文档在 `src/api-doc/biz-line-query.md`、`src/api-doc/biz-line-strategy.md`。所有路径带 `/sino-opti-hive` 前缀；策略组含写操作接口，执行前先确认环境
+- Debug 会输出参数解析、命令注册、接口调用过程
 
 ### 跨平台兼容性
 
@@ -231,14 +228,37 @@ export class ExampleCommand implements ICommand {
 import { ExampleCommand } from "./example.command";
 
 export const commands: ICommand[] = [
-  new HomepageCommand(),
-  new NexusSwaggerCommand(),
+  new InitCommand(),
+  new IcApiCommand(),
   new ExampleCommand(),
 ];
 ```
 
 完成后 `npm run build`，即可使用 `sino-bc-cli /example`。
 
+### 扩展「接口调用类」命令
+
+新增一组接口调用命令（如 `/ic-api`、`/bc-api`）时，不要重复实现调用流程，继承 `BaseApiEndpointCommand` 即可复用「解析环境与 API Key → 分组展示接口 → 发起调用 → 打印响应」：
+
+1. 在 `src/constants/` 下新建接口清单文件，导出 `IApiDocEndpoint[]`（`group` 字段用于分组展示）
+2. 在 `src/commands/` 下继承 `BaseApiEndpointCommand`，只声明 `name`、`description`、`usage`、`endpoints`、`docSource`
+3. 在 `src/constants/index.ts` 的 `COMMAND_NAMES` 中登记命令名并导出清单，再加入 `commands` 数组
+
+```typescript
+// src/commands/example-api.command.ts
+import { IApiDocEndpoint } from "../types";
+import { COMMAND_NAMES, EXAMPLE_APIS } from "../constants";
+import { BaseApiEndpointCommand } from "./api-endpoint.command";
+
+export class ExampleApiCommand extends BaseApiEndpointCommand {
+  public readonly name: string = COMMAND_NAMES.EXAMPLE_API;
+  public readonly description: string = "交互选择并调用示例接口";
+  public readonly usage: string = `/${COMMAND_NAMES.EXAMPLE_API} test`;
+  protected readonly endpoints: IApiDocEndpoint[] = EXAMPLE_APIS;
+  protected readonly docSource: string = "src/api-doc/example.md";
+}
+```
+
 ---
 
 ## npm 发布
@@ -379,7 +399,7 @@ npm view sino-bc-cli version
 ```powershell
 npx sino-bc-cli@latest --version
 npx sino-bc-cli@latest --help
-# npx sino-bc-cli@latest /homepage
+# npx sino-bc-cli@latest /ic-api
 ```
 
 **③ 浏览器打开包页**，确认 README 渲染、Version / License / Keywords、Dependencies（lodash、dayjs、axios、crypto-js、chalk、commander、open）
@@ -469,7 +489,7 @@ npm deprecate sino-bc-cli@* "此包已废弃，请使用 @newscope/sino-bc-cli"
 | 发版白名单 files / publishConfig | `package.json` 的 `files` + `publishConfig` |
 | TypeScript 编译配置 | `tsconfig.json` |
 | CLI 入口（带 shebang） | `src/index.ts` → 编译后 `dist/index.js` |
-| 命令 URL 配置 | `src/constants/index.ts` 的 `PLATFORM_URLS` |
+| 网关 / 命令常量 | `src/constants/index.ts`、`src/constants/gateway.ts` |
 
 ---
 

package/dist/commands/api-endpoint.command.d.ts

@@ -0,0 +1,58 @@
+import { IApiDocEndpoint, ICommand, EnvName } from '../types';
+/**
+ * 接口调用类命令基类
+ * 统一封装「解析环境与 API Key → 交互选择接口 → 按网关地址发起调用 → 打印响应」流程
+ * 子类只需提供命令名、描述与可调用接口清单
+ */
+export declare abstract class BaseApiEndpointCommand implements ICommand {
+    /** 命令名称 */
+    abstract readonly name: string;
+    /** 命令描述 */
+    abstract readonly description: string;
+    /** 命令使用示例 */
+    abstract readonly usage: string;
+    /** 可调用接口清单 */
+    protected abstract readonly endpoints: IApiDocEndpoint[];
+    /** 接口清单来源说明，展示在选择列表标题处 */
+    protected abstract readonly docSource: string;
+    /**
+     * 命令执行函数
+     * @param args 位置参数：[ENV] [API_KEY]
+     * @param options 解析后的选项，支持 --env / --api-key
+     */
+    execute(args: string[], options?: Record<string, unknown>): Promise<void>;
+    /**
+     * 解析环境参数，优先级：--env > 位置参数中的合法 ENV > 默认 prod
+     */
+    protected resolveEnv(args: string[], options?: Record<string, unknown>): EnvName;
+    /**
+     * 解析 API Key，优先级：--api-key > 非 ENV 的位置参数 > 默认值
+     */
+    protected resolveApiKey(args: string[], options?: Record<string, unknown>): string;
+    /**
+     * 从 options 中按候选 key 取第一个有效值
+     */
+    protected pickOption(options: Record<string, unknown> | undefined, keys: string[]): unknown;
+    /**
+     * 打印接口清单并让用户选择
+     * 接口带 group 时按分组分节展示，序号仍为全局连续编号
+     */
+    protected selectApi(): Promise<IApiDocEndpoint>;
+    /**
+     * 打印即将发起的请求概要
+     */
+    protected printRequestPreview(api: IApiDocEndpoint, url: string, apiKey: string): void;
+    /**
+     * 按接口方法发起请求并打印响应
+     */
+    protected callApi(api: IApiDocEndpoint, url: string, apiKey: string): Promise<void>;
+    /**
+     * 将响应格式化为可读 JSON 文本
+     * 部分接口可能返回 text/plain，需兜底解析
+     */
+    protected formatResponse(data: unknown): string;
+    /**
+     * 统一处理 HTTP 失败：优先打印服务端响应体
+     */
+    protected handleRequestError(error: unknown): never;
+}

package/dist/commands/api-endpoint.command.js

@@ -0,0 +1,209 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseApiEndpointCommand = void 0;
+const _ = __importStar(require("lodash"));
+const dayjs_1 = __importDefault(require("dayjs"));
+const chalk_1 = __importDefault(require("chalk"));
+const axios_1 = require("axios");
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
+/**
+ * 接口调用类命令基类
+ * 统一封装「解析环境与 API Key → 交互选择接口 → 按网关地址发起调用 → 打印响应」流程
+ * 子类只需提供命令名、描述与可调用接口清单
+ */
+class BaseApiEndpointCommand {
+    /**
+     * 命令执行函数
+     * @param args 位置参数：[ENV] [API_KEY]
+     * @param options 解析后的选项，支持 --env / --api-key
+     */
+    async execute(args, options) {
+        utils_1.logger.debug(`[${this.name}] 命令执行开始，参数: ${JSON.stringify(args)}`);
+        const startTime = (0, dayjs_1.default)();
+        const env = this.resolveEnv(args, options);
+        const apiKey = this.resolveApiKey(args, options);
+        const gateway = (0, constants_1.getGatewayConfig)(env);
+        utils_1.logger.info(`[${utils_1.CommonUtils.formatDate(startTime)}] 当前环境: ${gateway.label} (${env})，网关: ${gateway.baseUrl}`);
+        const api = await this.selectApi();
+        const url = (0, constants_1.joinGatewayUrl)(env, api.path);
+        this.printRequestPreview(api, url, apiKey);
+        await this.callApi(api, url, apiKey);
+        const durationSec = _.round((0, dayjs_1.default)().diff(startTime) / 1000, 2);
+        utils_1.logger.debug(`[${this.name}] 命令执行完成，耗时: ${durationSec} 秒`);
+    }
+    /**
+     * 解析环境参数，优先级：--env > 位置参数中的合法 ENV > 默认 prod
+     */
+    resolveEnv(args, options) {
+        const optionValue = this.pickOption(options, ['env', 'ENV']);
+        if ((0, constants_1.isEnvName)(optionValue)) {
+            return optionValue;
+        }
+        if (!_.isNil(optionValue) && optionValue !== true) {
+            throw new Error(`无效的 ENV: ${String(optionValue)}，仅支持 test / pre / prod`);
+        }
+        const argEnv = _.find(args, (item) => (0, constants_1.isEnvName)(_.toLower(_.trim(item))));
+        if (!_.isNil(argEnv)) {
+            return _.toLower(_.trim(argEnv));
+        }
+        return types_1.EnvName.PROD;
+    }
+    /**
+     * 解析 API Key，优先级：--api-key > 非 ENV 的位置参数 > 默认值
+     */
+    resolveApiKey(args, options) {
+        const optionValue = this.pickOption(options, ['api-key', 'apiKey', 'API_KEY']);
+        if (_.isString(optionValue) && !_.isEmpty(_.trim(optionValue))) {
+            return _.trim(optionValue);
+        }
+        const argKey = _.find(args, (item) => !(0, constants_1.isEnvName)(_.toLower(_.trim(item))));
+        if (!_.isNil(argKey) && !_.isEmpty(_.trim(argKey))) {
+            return _.trim(argKey);
+        }
+        return constants_1.DEFAULT_API_KEY;
+    }
+    /**
+     * 从 options 中按候选 key 取第一个有效值
+     */
+    pickOption(options, keys) {
+        if (_.isNil(options)) {
+            return undefined;
+        }
+        const matchedKey = _.find(keys, (key) => !_.isUndefined(options[key]));
+        return _.isNil(matchedKey) ? undefined : options[matchedKey];
+    }
+    /**
+     * 打印接口清单并让用户选择
+     * 接口带 group 时按分组分节展示，序号仍为全局连续编号
+     */
+    async selectApi() {
+        process.stdout.write('\n');
+        process.stdout.write(chalk_1.default.bold('📦  可调用接口') + chalk_1.default.gray(`（来源: ${this.docSource}）`) + '\n\n');
+        // 按 group 分组展示；无 group 的接口归入一个匿名分组
+        const grouped = _.groupBy(this.endpoints, (api) => api.group ?? '');
+        let serialNo = 0;
+        _.forEach(grouped, (apis, group) => {
+            if (!_.isEmpty(group)) {
+                process.stdout.write(chalk_1.default.bold.blueBright(`  ── ${group} (${apis.length}) ──`) + '\n\n');
+            }
+            _.forEach(apis, (api) => {
+                serialNo += 1;
+                const serial = chalk_1.default.greenBright(`  ${serialNo}.`);
+                const title = chalk_1.default.whiteBright(` ${api.displayName}`);
+                const meta = chalk_1.default.gray(`     ${api.method}  ${api.path}`);
+                const desc = chalk_1.default.white(`     ${api.description}`);
+                process.stdout.write(`${serial}${title}\n${meta}\n${desc}\n\n`);
+            });
+        });
+        // 分组仅影响展示顺序，需按同样顺序取回选中项
+        const ordered = _.flatMap(grouped, (apis) => apis);
+        const selectedIndex = await utils_1.PromptUtils.selectIndex(ordered.length);
+        return ordered[selectedIndex];
+    }
+    /**
+     * 打印即将发起的请求概要
+     */
+    printRequestPreview(api, url, apiKey) {
+        utils_1.logger.info(`已选择: ${api.displayName} (${api.name})`);
+        utils_1.logger.info(`请求方法: ${api.method}`);
+        utils_1.logger.info(`请求地址: ${url}`);
+        utils_1.logger.debug(`Authorization: Bearer ${apiKey}`);
+        utils_1.logger.tip('已注入请求头 Authorization: Bearer ***');
+        if (!_.isNil(api.defaultBody)) {
+            utils_1.logger.info('请求体（文档默认示例）:');
+            utils_1.logger.info(api.defaultBody);
+        }
+        else {
+            utils_1.logger.info('该接口无请求体');
+        }
+    }
+    /**
+     * 按接口方法发起请求并打印响应
+     */
+    async callApi(api, url, apiKey) {
+        const config = {
+            timeout: api.timeout,
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        };
+        try {
+            utils_1.logger.info('正在发起请求...');
+            const data = api.method === 'GET'
+                ? await utils_1.HttpUtils.get(url, config)
+                : await utils_1.HttpUtils.post(url, api.defaultBody, config);
+            utils_1.logger.success('接口调用成功，响应如下:');
+            process.stdout.write(this.formatResponse(data) + '\n');
+        }
+        catch (error) {
+            this.handleRequestError(error);
+        }
+    }
+    /**
+     * 将响应格式化为可读 JSON 文本
+     * 部分接口可能返回 text/plain，需兜底解析
+     */
+    formatResponse(data) {
+        if (_.isString(data)) {
+            try {
+                return JSON.stringify(JSON.parse(data), null, 2);
+            }
+            catch {
+                return data;
+            }
+        }
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * 统一处理 HTTP 失败：优先打印服务端响应体
+     */
+    handleRequestError(error) {
+        if (error instanceof axios_1.AxiosError && !_.isNil(error.response)) {
+            utils_1.logger.error(`接口调用失败，HTTP 状态码: ${error.response.status}`);
+            process.stdout.write(this.formatResponse(error.response.data) + '\n');
+            throw new Error(`接口调用失败: HTTP ${error.response.status}`);
+        }
+        throw error instanceof Error ? error : new Error(String(error));
+    }
+}
+exports.BaseApiEndpointCommand = BaseApiEndpointCommand;
+//# sourceMappingURL=api-endpoint.command.js.map

package/dist/commands/api-endpoint.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-endpoint.command.js","sourceRoot":"","sources":["../../src/commands/api-endpoint.command.ts"],"names":[],"mappings":"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"}

package/dist/commands/bc-api.command.d.ts

@@ -0,0 +1,20 @@
+import { IApiDocEndpoint } from '../types';
+import { BaseApiEndpointCommand } from './api-endpoint.command';
+/**
+ * 调用 sino-opti-hive 业务线接口命令
+ * 命令名称: /bc-api
+ * 功能: 交互选择「业务线查询 / 业务线策略」接口，向对应接口地址发起调用
+ * 所有路径统一带 /sino-opti-hive 网关路由前缀
+ */
+export declare class BcApiCommand extends BaseApiEndpointCommand {
+    /** 命令名称 */
+    readonly name: string;
+    /** 命令描述 */
+    readonly description: string;
+    /** 命令使用示例 */
+    readonly usage: string;
+    /** 可调用接口清单 */
+    protected readonly endpoints: IApiDocEndpoint[];
+    /** 接口清单来源说明 */
+    protected readonly docSource: string;
+}

package/dist/commands/bc-api.command.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BcApiCommand = void 0;
+const constants_1 = require("../constants");
+const api_endpoint_command_1 = require("./api-endpoint.command");
+/**
+ * 调用 sino-opti-hive 业务线接口命令
+ * 命令名称: /bc-api
+ * 功能: 交互选择「业务线查询 / 业务线策略」接口，向对应接口地址发起调用
+ * 所有路径统一带 /sino-opti-hive 网关路由前缀
+ */
+class BcApiCommand extends api_endpoint_command_1.BaseApiEndpointCommand {
+    /** 命令名称 */
+    name = constants_1.COMMAND_NAMES.BC_API;
+    /** 命令描述 */
+    description = '交互选择并调用业务线查询 / 业务线策略接口（请求体默认使用文档示例）';
+    /** 命令使用示例 */
+    usage = `
+    /${constants_1.COMMAND_NAMES.BC_API}
+    /${constants_1.COMMAND_NAMES.BC_API} test
+    /${constants_1.COMMAND_NAMES.BC_API} prod sk-your-api-key
+    sino-bc-cli /${constants_1.COMMAND_NAMES.BC_API} --env=pre --api-key=sk-xxx
+  `;
+    /** 可调用接口清单 */
+    endpoints = constants_1.BIZ_LINE_APIS;
+    /** 接口清单来源说明 */
+    docSource = 'src/api-doc/biz-line-*.md';
+}
+exports.BcApiCommand = BcApiCommand;
+//# sourceMappingURL=bc-api.command.js.map

package/dist/commands/bc-api.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bc-api.command.js","sourceRoot":"","sources":["../../src/commands/bc-api.command.ts"],"names":[],"mappings":";;;AACA,4CAA4D;AAC5D,iEAAgE;AAEhE;;;;;GAKG;AACH,MAAa,YAAa,SAAQ,6CAAsB;IACtD,WAAW;IACK,IAAI,GAAW,yBAAa,CAAC,MAAM,CAAC;IAEpD,WAAW;IACK,WAAW,GAAW,qCAAqC,CAAC;IAE5E,aAAa;IACG,KAAK,GAAW;OAC3B,yBAAa,CAAC,MAAM;OACpB,yBAAa,CAAC,MAAM;OACpB,yBAAa,CAAC,MAAM;mBACR,yBAAa,CAAC,MAAM;GACpC,CAAC;IAEF,cAAc;IACK,SAAS,GAAsB,yBAAa,CAAC;IAEhE,eAAe;IACI,SAAS,GAAW,2BAA2B,CAAC;CACpE;AApBD,oCAoBC"}