sino-bc-cli 1.2.0 → 1.3.1

package/README.md

@@ -141,6 +141,7 @@ sino-bc-cli/
 │   ├── commands/                 # 📦 命令实现层（每命令一个文件，可独立扩展）
 │   │   ├── index.ts              # 命令批量注册入口
 │   │   ├── init.command.ts       # /init 命令实现（注册 Agent 技能）
+│   │   ├── api-list.command.ts   # /api-list 命令实现（列出接口并打开文档）
 │   │   ├── api-endpoint.command.ts # 接口调用类命令基类（选择接口 → 发起调用 → 打印响应）
 │   │   ├── ic-api.command.ts     # /ic-api 命令实现（调用 iCenter 接口地址）
 │   │   └── bc-api.command.ts     # /bc-api 命令实现（调用业务线查询 / 业务线策略接口）
@@ -259,6 +260,7 @@ npm i sino-bc-cli -g
 ```bash
 sino-bc-cli --help
 sino-bc-cli /init
+sino-bc-cli /api-list
 sino-bc-cli /ic-api
 ```
 
@@ -276,11 +278,12 @@ sino-bc-cli /init
 
 ### 可用命令一览
 
-| 命令      | 说明                                                                                          |
-| :-------- | :-------------------------------------------------------------------------------------------- |
-| `/init`   | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别 |
-| `/ic-api` | 交互选择并调用 iCenter 接口地址；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量                 |
-| `/bc-api` | 交互选择并调用业务线查询 / 业务线策略接口（共 22 个，路径统一带 `/sino-opti-hive` 前缀）        |
+| 命令        | 说明                                                                                          |
+| :---------- | :-------------------------------------------------------------------------------------------- |
+| `/init`     | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别 |
+| `/api-list` | 列出全部可调用接口；Cursor / VS Code 终端中 Ctrl+单击接口名或文档路径打开本地文档，也可输入序号或传入 name |
+| `/ic-api`   | 交互选择并调用 iCenter 接口地址（路径统一带 `/sino-icenter` 前缀）；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量 |
+| `/bc-api`   | 交互选择并调用业务线查询 / 业务线策略接口（共 22 个，路径统一带 `/sino-opti-hive` 前缀）        |
 
 ### 全局选项
 
@@ -304,16 +307,26 @@ sino-bc-cli --help
 sino-bc-cli -h
 ```
 
-#### ② 调用 iCenter 接口地址
+#### ② 列出可调用接口并打开文档
+
+```bash
+sino-bc-cli /api-list
+sino-bc-cli /api-list 3
+sino-bc-cli /api-list biz-line-open-list
+```
+
+执行效果：按「iCenter MCP / 业务线查询 / 业务线策略」分组列出全部接口。接口名是终端超链接，文档路径可 Ctrl+单击打开对应 markdown；交互终端也可输入序号。传入序号或接口 `name` 则直接打开该文档。
+
+#### ③ 调用 iCenter 接口地址
 
 ```bash
 sino-bc-cli /ic-api
 sino-bc-cli /ic-api test
 ```
 
-执行效果：交互选择接口后，向对应环境的 iCenter 接口地址发起请求。
+执行效果：交互选择接口后，向对应环境的 iCenter 接口地址发起请求。所有路径带 `/sino-icenter` 前缀。
 
-#### ③ 调用业务线查询 / 业务线策略接口
+#### ④ 调用业务线查询 / 业务线策略接口
 
 ```bash
 sino-bc-cli /bc-api
@@ -324,7 +337,7 @@ sino-bc-cli /bc-api test
 
 > ⚠️ 业务线策略组含新建 / 编辑 / 删除等写操作接口，会按文档示例请求体直接发起调用，执行前请确认环境。
 
-#### ④ 启用 Debug 模式运行
+#### ⑤ 启用 Debug 模式运行
 
 ```bash
 sino-bc-cli --debug /ic-api
@@ -405,6 +418,7 @@ import { ExampleCommand } from "./example.command"; // 新增导入
 
 export const commands: ICommand[] = [
   new InitCommand(),
+  new ApiListCommand(),
   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 /ic-api /bc-api、
+  Use when 开发或使用 sino-bc-cli、执行 /init /api-list /ic-api /bc-api、
   把技能注册到飞书豆包工作 / Cursor / Claude / Codex、扩展命令、
   npm publish、release:patch/minor/major、切 registry、排查 ENEEDAUTH/E403/EPUBLISHCONFLICT，
   或发布到私有 Nexus / 企业私服。
@@ -133,6 +133,7 @@ npm i sino-bc-cli -g
 ```bash
 sino-bc-cli --help
 sino-bc-cli /init
+sino-bc-cli /api-list
 sino-bc-cli /ic-api
 ```
 
@@ -156,11 +157,12 @@ npm run rebuild            # clean + tsc
 
 ### 可用命令
 
-| 命令      | 说明                                                                                                               |
-| :-------- | :----------------------------------------------------------------------------------------------------------------- |
-| `/init`   | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别           |
-| `/ic-api` | 交互选择并调用 iCenter 接口地址；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量                                      |
-| `/bc-api` | 交互选择并调用业务线查询（5 个）/ 业务线策略（17 个）接口；路径统一带 `/sino-opti-hive` 前缀，参数同 `/ic-api`        |
+| 命令        | 说明                                                                                                               |
+| :---------- | :----------------------------------------------------------------------------------------------------------------- |
+| `/init`     | 将本包 `SKILL.md` 复制到用户主目录下的 Agent 技能目录，供飞书豆包工作 / Cursor / Claude / Codex 自动识别           |
+| `/api-list` | 列出全部可调用接口；Cursor / VS Code 终端中 Ctrl+单击接口名或文档路径打开本地文档，也可输入序号或传入 name         |
+| `/ic-api`   | 交互选择并调用 iCenter 接口地址；路径统一带 `/sino-icenter` 前缀；`ENV` 默认 `prod`，`API_KEY` 默认使用网关常量 |
+| `/bc-api`   | 交互选择并调用业务线查询（5 个）/ 业务线策略（17 个）接口；路径统一带 `/sino-opti-hive` 前缀，参数同 `/ic-api`        |
 
 ### 全局选项
 
@@ -176,6 +178,8 @@ npm run rebuild            # clean + tsc
 sino-bc-cli --version
 sino-bc-cli --help
 sino-bc-cli /init
+sino-bc-cli /api-list
+sino-bc-cli /api-list 3
 sino-bc-cli /ic-api
 sino-bc-cli /ic-api test
 sino-bc-cli /bc-api
@@ -185,7 +189,8 @@ 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`。
-- `/ic-api`：交互选择并调用 iCenter 接口地址（默认 `prod` + 内置 API Key）
+- `/api-list`：按「iCenter MCP / 业务线查询 / 业务线策略」分组列出全部可调用接口。接口名是终端超链接，文档路径可 Ctrl+单击；交互终端也可输入序号打开。传入序号或 `name` 则直接打开对应 markdown（`src/api-doc/`，安装后为 `dist/api-doc/`）。Agent 展示结果时，请把文档路径写成 Markdown 链接，方便用户点击打开。
+- `/ic-api`：交互选择并调用 iCenter 接口地址（默认 `prod` + 内置 API Key）。所有路径带 `/sino-icenter` 前缀
 - `/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 会输出参数解析、命令注册、接口调用过程
 

package/dist/api-doc/README.md

@@ -0,0 +1,80 @@
+# 接口文档索引
+
+本目录汇总 CLI 可交互调用的接口。浏览清单用 `/api-list`（可点击打开本文档），发起调用用 `/ic-api` 与 `/bc-api`。
+
+| 分组 | 命令 | 接口数 | 文档 |
+| --- | --- | --- | --- |
+| iCenter MCP | `/ic-api` | 3 | 见下方「iCenter MCP 接口」 |
+| 业务线查询 | `/bc-api` | 5 | [biz-line-query.md](./biz-line-query.md) |
+| 业务线策略 | `/bc-api` | 17 | [biz-line-strategy.md](./biz-line-strategy.md) |
+
+---
+
+## iCenter MCP 接口
+
+数据来源：[ContextForge MCP Gateway Admin - Tools](https://o-test-sino-mcp-gateway.meetsocial.cn/admin/?tools_page=2&tools_size=10&tools_inactive=false#tools)
+
+筛选规则：`name` 以 `icenter-mcp-` 开头。当前共 **3** 个接口，每个接口一份独立文档。所有路径经网关调用时统一带 `/sino-icenter` 路由前缀，例如 `/sino-icenter/version`。
+
+| 文档 | name | 展示名 | 方法 | 说明 |
+| --- | --- | --- | --- | --- |
+| [icenter-mcp-strategy-dimension-facebook-ad-list.md](./icenter-mcp-strategy-dimension-facebook-ad-list.md) | `icenter-mcp-strategy-dimension-facebook-ad-list` | Facebook广告策略维度数据 | POST | 查询广告策略配置（不含成效指标） |
+| [icenter-mcp-strategy-metrics-facebook-ad-list.md](./icenter-mcp-strategy-metrics-facebook-ad-list.md) | `icenter-mcp-strategy-metrics-facebook-ad-list` | Facebook广告策略成效数据 | POST | 查询策略维度 + 成效指标（最多近 21 天） |
+| [icenter-mcp-version-query.md](./icenter-mcp-version-query.md) | `icenter-mcp-version-query` | 查询git最新提交版本 | GET | 查询 iCenter 服务 git 最新提交版本 |
+
+对应命令：`/ic-api`，接口清单定义在 `src/constants/api-doc.ts`。
+
+---
+
+## 业务线接口（sino-opti-hive）
+
+数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html)
+
+共 **22** 个接口，分两组。所有路径经网关调用时统一带 `/sino-opti-hive` 路由前缀，例如 `/sino-opti-hive/biz-line-open/channels`。
+
+| 文档 | 分组 | 接口数 | 说明 |
+| --- | --- | --- | --- |
+| [biz-line-query.md](./biz-line-query.md) | 业务线查询 | 5 | 对外开放的只读查询：渠道、品类字典、业务线列表、策略及表现、Top 业务线 |
+| [biz-line-strategy.md](./biz-line-strategy.md) | 业务线策略 | 17 | 业务线主数据与周策略的增删改查、导出 |
+
+对应命令：`/bc-api`，接口清单定义在 `src/constants/biz-line-api-doc.ts`。
+
+> ⚠️ 业务线策略组含新建 / 编辑 / 删除等写操作接口，`/bc-api` 会按文档示例请求体直接发起调用，调用前请确认环境。
+
+---
+
+## 命令调用
+
+浏览全部接口并打开本文档：
+
+```bash
+sino-bc-cli /api-list
+sino-bc-cli /api-list 1
+sino-bc-cli /api-list biz-line-open-channels
+```
+
+`/ic-api` 与 `/bc-api` 用法一致：交互选择接口后，向所选环境的网关地址发起请求。请求体默认使用各文档「请求示例」中的参数；`GET` 接口无请求体。
+
+```bash
+# iCenter 接口（默认生产环境 + 内置 API Key）
+sino-bc-cli /ic-api
+
+# 业务线接口
+sino-bc-cli /bc-api
+
+# 指定环境（test / pre / prod）
+sino-bc-cli /bc-api test
+
+# 指定环境和 API Key
+sino-bc-cli /bc-api pre sk-your-api-key
+
+# 选项写法
+sino-bc-cli /bc-api --env=test --api-key=sk-your-api-key
+```
+
+| 参数 | 是否必传 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `ENV` | 否 | `prod` | `test` / `pre` / `prod`，用于取 `src/constants/gateway.ts` 中的网关地址 |
+| `API_KEY` | 否 | `src/constants/gateway.ts` 的 `DEFAULT_API_KEY` | 注入请求头 `Authorization: Bearer ${API_KEY}`；同时固定注入 `X-GATEWAY-TYPE: A2C-CLI` |
+
+执行后会按分组列出接口，输入序号后按所选环境网关发起调用，并打印响应。

package/dist/api-doc/biz-line-query.md

@@ -0,0 +1,212 @@
+# 业务线查询（Biz Line Open）
+
+数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html#/default/%E4%B8%9A%E5%8A%A1%E7%BA%BF%E6%9F%A5%E8%AF%A2/channelsUsingGET)
+
+对外开放的只读查询接口，共 **5** 个，均不涉及数据变更。
+
+> **路由前缀**：经网关调用时所有路径需带 `/sino-opti-hive`，例如 `/sino-opti-hive/biz-line-open/channels`。
+
+| # | name | 展示名 | 方法 | 路径（含前缀） |
+| --- | --- | --- | --- | --- |
+| 1 | `biz-line-open-channels` | 查询投放渠道列表 | GET | `/sino-opti-hive/biz-line-open/channels` |
+| 2 | `biz-line-open-placement-categories` | 查询投放品类字典树 | GET | `/sino-opti-hive/biz-line-open/placement-categories` |
+| 3 | `biz-line-open-list` | 查询业务线列表（不分页） | POST | `/sino-opti-hive/biz-line-open/list` |
+| 4 | `biz-line-open-strategies` | 查询业务线投放策略及表现 | POST | `/sino-opti-hive/biz-line-open/strategies` |
+| 5 | `biz-line-open-strategy-top` | 查询投放表现 Top 业务线 | POST | `/sino-opti-hive/biz-line-open/strategy-top` |
+
+所有接口统一返回 `RestResponseVO` 包装：`success`、`code`、`message`、`result`、`traceId`。下文只描述 `result`。
+
+---
+
+## 1. 查询投放渠道列表
+
+`GET /sino-opti-hive/biz-line-open/channels`
+
+无入参，返回 `ChannelEnum` 全量。`code` 即业务线列表中的 `mediaChannelId`。
+
+**响应 `result`：`ChannelOpenVO[]`**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `code` | int | 渠道 code（= `ChannelEnum.id`），用于筛选业务线 `mediaChannelId` |
+| `name` | string | 渠道名称 |
+
+示例片段：`{"code":1,"name":"Facebook"}`、`{"code":3,"name":"Google"}`、`{"code":18,"name":"TikTok"}`。
+
+---
+
+## 2. 查询投放品类字典树
+
+`GET /sino-opti-hive/biz-line-open/placement-categories`
+
+无入参，`sceneCode` 固定 `PLACEMENT_CATEGORY`。一级节点 = 投放行业，二级节点（`children`）= 投放品类，分别对应筛选参数 `adCategoryIndustryId` / `adCategoryProjectId`。
+
+**响应 `result`：`DictItemVO[]`**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | long | 字典项 ID |
+| `name` | string | 字典项名称 |
+| `itemCode` | string | 字典项编码 |
+| `description` | string | 描述 |
+| `isEnable` | int | 是否启用 |
+| `isOther` | int | 是否为「其他」项 |
+| `sortOrder` | int | 排序值 |
+| `children` | `DictItemVO[]` | 二级节点（投放品类） |
+
+当前一级行业为：`1 = APP`、`2 = ECBR`、`3 = 游戏`。
+
+---
+
+## 3. 查询业务线列表（不分页）
+
+`POST /sino-opti-hive/biz-line-open/list`
+
+按条件检索业务线主数据及关联主体、项目。入参均可选、多条件 AND，body 可为空表示查全部；无命中返回 `[]`。
+
+**请求体：`BizLineOpenListReqVO`（可选）**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | long | 业务线主键 ID，精确匹配 |
+| `idList` | long[] | 业务线 ID 多选；与 `id` 同时传时两者都生效（AND） |
+| `name` | string | 业务/产品线名称，模糊匹配 |
+| `mediaChannelId` | int | 投放渠道 ID，取值见 `/biz-line-open/channels` 的 `code` |
+| `adCategoryIndustryId` | long | 投放行业字典项 ID（品类树一级节点） |
+| `adCategoryProjectId` | long | 投放品类字典项 ID（二级节点）。传 `-1` 表示品类未选/其他 |
+
+请求示例（空对象 = 查全部）：
+
+```json
+{}
+```
+
+**响应 `result`：`BizLineOpenListItemVO[]`**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | long | 业务线主键 ID |
+| `name` | string | 业务/产品线名称 |
+| `mediaChannelIds` / `mediaChannelNames` | int[] / string[] | 投放渠道 ID 与名称，下标一一对应 |
+| `adCategoryIndustryIds` / `adCategoryIndustryDescs` | long[] / string[] | 投放行业 ID 与展示文案 |
+| `adCategoryProjectIds` / `adCategoryProjectDescs` | long[] / string[] | 投放品类 ID 与展示文案 |
+| `adCategoryOther` | string | 投放品类「其他」自定义文案 |
+| `corporationIds` / `corporationNames` | string[] / string[] | 关联主体 ID 与名称 |
+| `projectIds` / `projectNames` | long[] / string[] | 关联项目 ID 与名称 |
+| `customerTypeIds` / `customerTypeDescs` | long[] / string[] | 客户类型 ID 与展示文案 |
+| `customerInfrastructure` / `customerInfrastructureDescs` | int[] / string[] | 客户基建情况枚举与文案 |
+| `projectRating` / `projectRatingDesc` | string / string | 项目评级（`ProjectRatingEnum`：S/A/B/C）与文案 |
+| `strategyControlDegree` / `strategyControlDegreeDesc` | int / string | 策略掌控程度与文案 |
+| `coreIndex` | string | 核心指标（原文） |
+| `monthlyMaterialCount` | string | 月度上新素材量（原文） |
+
+---
+
+## 4. 查询业务线投放策略及表现（不分页）
+
+`POST /sino-opti-hive/biz-line-open/strategies`
+
+按业务线 ID 集合查其全部未删除周策略及策略回顾，按 `year`、`weekOfYear` 倒序。不存在的 ID 静默忽略。周消耗、客户满意度与效果细节均在 `effectSummary`（无回顾时内部字段可能为 `null`）。
+
+**请求体：`BizLineOpenStrategyReqVO`（必填）**
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `bizLineIds` | long[] | 是 | 业务线 ID 集合，非空。不存在的 ID 被忽略，不报错 |
+
+请求示例：
+
+```json
+{ "bizLineIds": [1251, 1250] }
+```
+
+**响应 `result`：`BizLineOpenStrategyVO[]`**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `bizLineId` / `bizLineName` | long / string | 所属业务线 ID 与名称 |
+| `strategyWeek` | int | 策略归属年周，`year × 100 + weekOfYear`，如 2026 年第 1 周 = `202601` |
+| `budgetStrategyTagDescs` / `budgetStrategySupplement` | string[] / string | 预算策略标签文案、补充说明 |
+| `audienceStrategyTagDescs` / `audienceStrategySupplement` | string[] / string | 受众定位策略标签文案、补充说明 |
+| `mediaStrategyTagDescs` / `mediaStrategySupplement` | string[] / string | 媒介产品策略标签文案、补充说明 |
+| `creativeStrategy` | string | 素材创意策略说明（原文） |
+| `effectSummary` | object | 投放策略效果总结：周消耗、客户满意度、红绿灯、核心问题、各维度效果及 Learning |
+
+---
+
+## 5. 查询投放表现 Top 业务线
+
+`POST /sino-opti-hive/biz-line-open/strategy-top`
+
+在指定投放行业 / 投放品类范围内排出 Top N 业务线，并给出其表现最好那段窗口期采用的投放策略。
+
+- **筛选**：`adCategoryIndustryId`、`adCategoryProjectId` 至少传一个；**行业优先**——传了行业则按整个行业横向比较并忽略品类，只传品类时才按品类比较。`excludeBizLineIds` 可选。
+- **口径**：默认回溯最近 52 周，按连续策略记录滑动 4 期窗口打分，取历史最佳窗口成绩，故「前期长期良好、最近一两期回落」仍能上榜；最近 2 期出现红灯或客户不满意时总分打 9 折（`recentDeclined` / `penaltyApplied` 标记）。
+- **出参**：计数与占比均为最佳窗口内口径；策略标签与补充说明为窗口内各期聚合去重，`periods` 给出逐期明细。范围内无数据返回 `[]`。
+- **分值表与排名规则**：见[飞书接口文档](https://q6y68vu0j8.feishu.cn/wiki/HboRwmijkiAa1wktfvSclyXxntg)。
+
+**请求体：`BizLineStrategyTopReqVO`（必填）**
+
+| 字段 | 类型 | 默认 | 说明 |
+| --- | --- | --- | --- |
+| `adCategoryIndustryId` | long | — | 投放行业字典 ID（一级）。传入时按整个行业比较，并忽略 `adCategoryProjectId` |
+| `adCategoryProjectId` | long | — | 投放品类字典 ID（二级）。仅在未传 `adCategoryIndustryId` 时生效 |
+| `excludeBizLineIds` | long[] | — | 排除的业务线 ID，不参与排名 |
+| `topN` | int | `5` | 返回条数，取值 1~50 |
+| `windowWeeks` | int | `4` | 滑动窗口期数，取值 2~12 |
+| `lookbackWeeks` | int | `52` | 回溯周数（含当前周），取值 4~104 |
+| `minReviewedPeriods` | int | `1` | 样本门槛：窗口内至少几期有回顾数据，取值 1~12 |
+
+请求示例：
+
+```json
+{
+  "adCategoryIndustryId": 1,
+  "topN": 5,
+  "windowWeeks": 4,
+  "lookbackWeeks": 52,
+  "minReviewedPeriods": 1
+}
+```
+
+**响应 `result`：`BizLineStrategyTopItemVO[]`**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `rank` | int | 排名，从 1 开始 |
+| `bizLineId` / `bizLineName` | long / string | 业务线 ID 与名称 |
+| `score` | number | 最终得分（排序主键）：`rawScore`，近期回落时乘 0.9，保留两位小数 |
+| `rawScore` | int | 最佳窗口原始得分（未打折） |
+| `penaltyApplied` | boolean | 是否已按近期回落打 9 折 |
+| `recentDeclined` | boolean | 回溯范围内最后 2 期是否出现红灯或客户不满意 |
+| `bestWindowStartWeek` / `bestWindowEndWeek` | int / int | 最佳窗口起止周 `yyyyW` |
+| `windowPeriods` / `reviewedPeriods` / `lookbackPeriods` | int | 窗口内策略期数 / 有回顾期数 / 回溯范围内总期数 |
+| `greenCount` / `yellowCount` / `redCount` | int | 窗口内绿灯 / 黄灯 / 红灯期数 |
+| `greenRate` | number | 绿灯占比（%）= `greenCount ÷ reviewedPeriods × 100`；分母为 0 返回 `null` |
+| `maxConsecutiveGreenPeriods` | int | 窗口内最长连续绿灯期数 |
+| `satisfiedCount` / `unsatisfiedCount` | int | 窗口内客户满意 / 不满意期数 |
+| `satisfiedRate` | number | 满意占比（%）；分母为 0 返回 `null` |
+| `adCategoryIndustryDescs` / `adCategoryProjectDescs` | string[] | 投放行业 / 品类展示文案 |
+| `budgetStrategyTagDescs` / `budgetStrategySupplements` | string[] | 最佳窗口内预算策略标签与补充说明（去重合并） |
+| `audienceStrategyTagDescs` / `audienceStrategySupplements` | string[] | 最佳窗口内受众定位策略标签与补充说明（去重合并） |
+| `mediaStrategyTagDescs` / `mediaStrategySupplements` | string[] | 最佳窗口内媒介产品策略标签与补充说明（去重合并） |
+| `creativeStrategies` | string[] | 最佳窗口内素材创意策略说明（去重合并） |
+| `periods` | object[] | 最佳窗口内逐期策略明细，按周升序（含当期红绿灯与满意度） |
+
+**红绿灯枚举（`TrafficLightEnum`）**：`1` KPI 达标、`2` 距 GAP 20% 内、`3` 距 GAP 20% 以上、`4` 已暂停、`5` 存在风险、`6` KPI 达标且项目顺利。绿灯 = `1`/`6`，黄灯 = `2`/`5`，红灯 = `3`/`4`。
+
+**客户满意度枚举（`CustomerSatisfactionEnum`）**：`1` 满意、`2` 不满意。
+
+---
+
+## 命令调用
+
+```bash
+# 默认生产环境 + 内置 API Key，交互选择接口
+sino-bc-cli /bc-api
+
+# 指定环境（test / pre / prod）
+sino-bc-cli /bc-api test
+```
+
+详见 [README.md](./README.md)。