sino-bc-cli 1.8.2 → 1.8.3

package/README.md

@@ -141,14 +141,12 @@ sino-bc-cli/
 │   │
 │   ├── commands/                 # 📦 命令实现层（每命令一个文件，可独立扩展）
 │   │   ├── index.ts              # 命令批量注册入口
-│   │   ├── init.command.ts       # /init 命令实现（注册 Agent 技能 + 初始化变量配置 + 拉取启动 MCP）
-│   │   ├── api-list.command.ts   # /api-list 命令实现（列出接口、给出调用命令并打开文档）
+│   │   ├── init.command.ts       # /init 命令实现（注册 Agent 技能 + 初始化变量配置）
 │   │   ├── bc-api.command.ts     # /bc-api 已下线，仅打印迁移提示并非 0 退出
-│   │   ├── get-config.command.ts # /get-config 命令实现（查看变量配置与 MCP 配置）
+│   │   ├── get-config.command.ts # /get-config 命令实现（查看变量配置）
 │   │   ├── set-config.command.ts # /set-config 命令实现（修改变量配置）
-│   │   ├── mcp-reload.command.ts # /mcp-reload 命令实现（按 mcp.json 重启 MCP）
 │   │   ├── skill.command.ts      # /skill 命令实现（列出包内技能或打开 SKILL.md）
-│   │   └── uninstall.command.ts  # /uninstall 命令实现（关闭 MCP、清理技能目录与配置并卸载）
+│   │   └── uninstall.command.ts  # /uninstall 命令实现（清理技能目录与配置并卸载）
 │   │
 │   ├── shortcuts/                # ⚡ Shortcut 执行面（业务命令，域 + `+cmd`）
 │   │   ├── index.ts              # 注册表与执行器（flag 解析、输出格式、写确认门）
@@ -156,7 +154,7 @@ sino-bc-cli/
 │   │   ├── types.ts              # Shortcut 声明与执行上下文类型
 │   │   └── biz-line/             # biz-line 域
 │   │       ├── index.ts          # 该域全部 Shortcut 登记处
-│   │       ├── read.ts           # 只读 Shortcut（+channels/+categories/+list/+strategies/+top）
+│   │       ├── read.ts           # 只读 Shortcut（+channels/+categories/+list/+strategies）
 │   │       ├── write.ts          # 写 Shortcut（+save/+update/+status/+delete/+strategy-*）
 │   │       ├── raw-api.ts        # biz-line api <name> 点名调用
 │   │       └── helpers.ts        # 按名解析业务线、字典名称映射等编排
@@ -174,8 +172,6 @@ sino-bc-cli/
 │   │   ├── prompt.ts             # 终端交互（复用单一 readline 会话：提问、选择、确认）
 │   │   ├── config-store.ts       # 变量配置读写（字段元信息 + 读 / 写 / 删）
 │   │   ├── config-prompt.ts      # 变量配置交互采集（/init 与 /set-config 共用）
-│   │   ├── mcp-store.ts          # ~/.sino-bc-cli/mcp.json 读写
-│   │   ├── mcp-service.ts        # MCP 同步到 Cursor / Codex / Claude / VS Code 并握手
 │   │   └── skill-install.ts      # Agent 技能目录的写入与清理
 │   │
 │   ├── types/                    # 📝 类型定义层
@@ -304,7 +300,7 @@ npm i sino-bc-cli -g
 ```bash
 sino-bc-cli --help
 sino-bc-cli /init
-sino-bc-cli /api-list
+sino-bc-cli biz-line --help
 sino-bc-cli biz-line +list --name <业务线名称>
 ```
 
@@ -326,13 +322,11 @@ sino-bc-cli /init
 
 | 命令        | 说明                                                                                          |
 | :---------- | :-------------------------------------------------------------------------------------------- |
-| `/init`       | 注册 `sino-bc-shared` / `sino-bc-biz-line` 到 Agent 技能目录（并删除旧 `sino-bc-cli/`），交互设置环境 / `API_KEY`，并拉取启动 MCP |
+| `/init`       | 注册 `sino-bc-shared` / `sino-bc-biz-line` 到 Agent 技能目录（并删除旧 `sino-bc-cli/`），交互设置环境 / `API_KEY` |
 | `/skill`      | 列出包内 Agent 技能；传入 name 打开对应 `SKILL.md` |
-| `/api-list`   | 列出全部可调用接口及其调用命令，Shortcut 行带一句 WHEN；Cursor / VS Code 终端中 Ctrl+单击接口名或文档路径打开本地文档，也可输入序号或传入 name |
-| `/get-config` | 查看变量配置与 `mcp.json`；密钥默认打码，`--show-secret` 显示明文，`--json` 输出 JSON |
+| `/get-config` | 查看变量配置；密钥默认打码，`--show-secret` 显示明文，`--json` 输出 JSON |
 | `/set-config` | 修改变量配置（环境 / API_KEY）；不带参数时逐项交互修改 |
-| `/mcp-reload` | 重新读取 `~/.sino-bc-cli/mcp.json`，同步到 Cursor / Codex / Claude / VS Code 并重新握手 |
-| `/uninstall`  | 关闭本 CLI 写入的 MCP，删除技能目录与变量配置文件，并从全局 npm 卸载本 CLI |
+| `/uninstall`  | 删除技能目录与变量配置文件，并从全局 npm 卸载本 CLI |
 | `/bc-api`     | **已下线**。只打印迁移提示并非 0 退出，改用 `biz-line +<shortcut>` 或 `biz-line api <name>` |
 
 ### 业务命令（`biz-line`）
@@ -341,14 +335,13 @@ sino-bc-cli /init
 | :--- | :--- |
 | `biz-line +channels` | 查询投放渠道列表（`code` 即业务线里的 `mediaChannelId`） |
 | `biz-line +categories` | 查询投放行业与品类字典树 |
-| `biz-line +list` | 查询业务线；`--name` / `--id` / `--channel` / `--industry` / `--category`，不传即查全部 |
-| `biz-line +strategies` | 查周策略与表现；`--name` 会先解析业务线 ID，也可直接 `--id` |
-| `biz-line +top` | 行业 / 品类 Top 业务线；两者至少传一个，同时传则只按行业 |
+| `biz-line +list` | 查询业务线；`--name` / `--id` / `--category`，不传即查全部（`pagination: false`） |
+| `biz-line +strategies` | 查周策略与表现；`--name` 会先解析业务线 ID，或传单个 `--id` |
 | `biz-line +save` / `+update` / `+status` / `+delete` | ⚠️ 业务线写操作 |
 | `biz-line +strategy-save` / `+strategy-update` / `+strategy-delete` | ⚠️ 周策略写操作 |
 | `biz-line api <name> --data '<json>'` | 按接口 `name` 点名调用，覆盖导出、对比、消耗等长尾接口 |
 
-`--channel` / `--industry` / `--category` 同时接受数字 ID 与名称（如 `--channel TikTok`）；传名称时会先查字典再映射，映射不到会报错并列出可选值。
+`+list --category` 同时接受数字 ID 与名称；传名称时会先查品类字典再映射，映射不到会报错并列出可选值。`+list` 不再接受 `--channel` / `--industry`。行业 / 品类 Top 没有 Shortcut。
 
 ### Shortcut 面公共参数
 
@@ -379,8 +372,6 @@ sino-bc-cli /init
 
 环境、`API_KEY` 存放在 `<用户主目录>/.sino-bc-cli/config.json`。`X-GATEWAY-TYPE` 固定为 `A2C-CLI`，不开放配置。
 
-MCP Server 存放在 `<用户主目录>/.sino-bc-cli/mcp.json`，结构与 Cursor 的 `mcp.json` 一致。用户自行增删后执行 `/mcp-reload`，CLI 会同步到 Cursor、Codex、Claude Code、VS Code。
-
 | 字段 | 命令行键名 | 默认值 | 说明 |
 | :--- | :--------- | :----- | :--- |
 | `env` | `env` | `prod` | 目标环境，可选 `test` / `pre` / `prod` |
@@ -397,27 +388,9 @@ sino-bc-cli /set-config --env=test
 
 # 不带参数则逐项交互修改，直接回车保留当前值
 sino-bc-cli /set-config
-
-# 改 MCP：编辑文件后重启
-# %USERPROFILE%\.sino-bc-cli\mcp.json
-sino-bc-cli /mcp-reload
-```
-
-```json
-{
-  "mcpServers": {
-    "example": {
-      "type": "streamable-http",
-      "url": "https://your-mcp-gateway/mcp/",
-      "headers": {
-        "Authorization": "Bearer <token>"
-      }
-    }
-  }
-}
 ```
 
-> `/init` 结束时自动拉取并启动 `mcp.json`（文件不存在则创建空清单，已存在不覆盖）。非交互环境（npm `postinstall`、CI、Agent 调用）下不提问。MCP 失败只警告。
+> `/init` 在非交互环境（npm `postinstall`、CI、Agent 调用）下不提问：配置文件已存在则保持不变，不存在则按默认值创建。
 
 ### 全局选项
 
@@ -429,7 +402,7 @@ sino-bc-cli /mcp-reload
 
 ### 环境与请求网关
 
-业务命令的请求地址由 [`src/constants/gateway.ts`](./src/constants/gateway.ts) 的 `GATEWAY_CONFIG` 决定，统一走 `joinGatewayUrl(env, path)` 拼接，实际请求由 [`src/utils/gateway-client.ts`](./src/utils/gateway-client.ts) 这一个出口发出。业务线路径带 `/sino-opti-hive`。iCenter 请写入 `mcp.json` 后 `/mcp-reload`。
+业务命令的请求地址由 [`src/constants/gateway.ts`](./src/constants/gateway.ts) 的 `GATEWAY_CONFIG` 决定，统一走 `joinGatewayUrl(env, path)` 拼接，实际请求由 [`src/utils/gateway-client.ts`](./src/utils/gateway-client.ts) 这一个出口发出。业务线路径带 `/sino-opti-hive`。
 
 | `ENV`  | 说明     | 网关地址                             |
 | :----- | :------- | :----------------------------------- |
@@ -453,40 +426,26 @@ sino-bc-cli --help
 sino-bc-cli -h
 ```
 
-#### ② 列出可调用接口并打开文档
+#### ② 查看某域何时用哪条命令
 
 ```bash
-sino-bc-cli /api-list
-sino-bc-cli /api-list 3
-sino-bc-cli /api-list biz-line-open-list
+sino-bc-cli biz-line --help
 ```
 
-执行效果：按「业务线查询 / 业务线策略」分组列出全部接口。接口名是终端超链接，文档路径可 Ctrl+单击打开对应 markdown；交互终端也可输入序号。传入序号或接口 `name` 则直接打开该文档。
+接口字段口径见 [`src/api-doc/README.md`](./src/api-doc/README.md)。
 
-#### ③ 配置并重启 MCP
-
-```bash
-# 编辑 %USERPROFILE%\.sino-bc-cli\mcp.json 后
-sino-bc-cli /mcp-reload
-```
-
-执行效果：把 `mcp.json` 里的 Server 同步到 Cursor（`~/.cursor/mcp.json`）、Codex（`~/.codex/config.toml`）、Claude Code（`~/.claude.json`）、VS Code 用户级 `mcp.json`，并对带 `url` 的 Server 做 initialize 握手。
-
-#### ④ 查询业务线数据
+#### ③ 查询业务线数据
 
 ```bash
 # 按名称查业务线
 sino-bc-cli biz-line +list --name <业务线名称>
 
-# 按渠道筛选（接受名称或 ID）
-sino-bc-cli biz-line +list --channel TikTok
+# 按品类筛选（接受名称或 ID）
+sino-bc-cli biz-line +list --category <品类>
 
 # 查某条业务线的周策略与表现
 sino-bc-cli biz-line +strategies --name <业务线名称>
 
-# 行业 Top
-sino-bc-cli biz-line +top --industry APP --top-n 5
-
 # 没有 Shortcut 的长尾接口
 sino-bc-cli biz-line api biz-line-strategy-compare \
   --data '{"bizLineId":123,"currentId":2,"prevId":1}'
@@ -494,7 +453,7 @@ sino-bc-cli biz-line api biz-line-strategy-compare \
 
 执行效果：向配置文件指定环境的网关发起请求，路径统一带 `/sino-opti-hive` 前缀，自动注入 `Authorization` 与 `X-GATEWAY-TYPE: A2C-CLI`。接口清单见 [`src/api-doc/README.md`](./src/api-doc/README.md)。
 
-#### ⑤ 执行写操作（需确认）
+#### ④ 执行写操作（需确认）
 
 ```bash
 # 先预览请求，不会真正发起
@@ -506,12 +465,12 @@ sino-bc-cli biz-line +status --id 123 --status 3 --yes
 
 > ⚠️ 写操作会变更线上数据。不加 `--yes` 时：交互式终端会展示环境与关键参数并询问；非交互式环境以退出码 `10` 返回 `confirmation_required`，需人工确认后再重试。
 
-#### ⑥ 启用 Debug 模式运行
+#### ⑤ 启用 Debug 模式运行
 
 ```bash
-sino-bc-cli --debug /api-list
+sino-bc-cli --debug biz-line --help
 # 或使用短选项
-sino-bc-cli -d /api-list
+sino-bc-cli -d biz-line --help
 ```
 
 Debug 模式会输出详细的日志，包括参数解析、命令注册、接口调用过程等信息，便于排查问题。
@@ -575,7 +534,7 @@ npm run rebuild
 3. **补测试**：在 `tests/` 下用 HTTP 桩断言请求与输出
 4. **同步文档**：`skills/sino-bc-biz-line` 的意图表、`affordance/biz-line.md` 的 WHEN、`src/api-doc/` 的字段口径；根 `SKILL.md` 只做入口
 
-参数解析、输出格式、写操作确认门、错误归类都由 `src/shortcuts/index.ts` 统一承担，声明里不要自己发 HTTP。接口 `name` 一律取自 `src/constants/biz-line-api-doc.ts`，不要新造。
+参数解析、输出格式、写操作确认门、错误归类都由 `src/shortcuts/index.ts` 统一承担，声明里不要自己发 HTTP。接口 `name` 一律取自 `src/generated/api-catalog.json`，不要新造。维护者同步 Apifox：`APIFOX_TOKEN` 环境变量 + `npm run sync-api-doc`（不要把 token 写入仓库）。
 
 > 只是想调一个已有接口，通常不需要写新 Shortcut——直接 `biz-line api <name> --data '<json>'` 即可。Shortcut 应当带来智能默认值、参数编排或更友好的输出，否则不值得新增。
 
@@ -609,7 +568,6 @@ import { ExampleCommand } from "./example.command"; // 新增导入
 
 export const commands: ICommand[] = [
   new InitCommand(),
-  new ApiListCommand(),
   new GetConfigCommand(),
   new ExampleCommand(), // 新增注册
 ];

package/dist/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: sino-bc-cli
 description: >
-  Use when 查询或操作 BeyondClick 业务线，或配置 sino-bc-cli / MCP。
+  Use when 查询或操作 BeyondClick 业务线，或配置 sino-bc-cli。
   完整规则在 sino-bc-shared 与 sino-bc-biz-line；本文件只做入口。
 metadata:
   requires:
@@ -10,10 +10,11 @@ metadata:
 
 # sino-bc-cli
 
-Agent 技能已拆成两份，**不要只读这一页**。
+Agent 技能已拆成多份，**不要只读这一页**。
 
-1. 配置、信封、确认门、禁止拼 HTTP、MCP：[`skills/sino-bc-shared/SKILL.md`](skills/sino-bc-shared/SKILL.md)
+1. 配置、信封、确认门、禁止拼 HTTP：[`skills/sino-bc-shared/SKILL.md`](skills/sino-bc-shared/SKILL.md)
 2. 业务线意图与 Shortcut：[`skills/sino-bc-biz-line/SKILL.md`](skills/sino-bc-biz-line/SKILL.md)
+3. 其他域：`skills/sino-bc-<domain>/`（由 `npm run sync-api-doc` 生成）
 
 安装与刷新（会写入上述两份并删除旧的 `sino-bc-cli/` 技能目录）：
 

package/dist/affordance/biz-line.md

@@ -11,27 +11,21 @@
 ## +categories
 
 - **WHEN**：用户问投放行业 / 品类树，或要把名称映射成字典 ID。
-- **别用**：已经有行业/品类 ID 且只要业务线（直接 `+list --industry` / `--category`）。
+- **别用**：已经有品类 ID 且只要业务线（直接 `+list --category`）。
 - **示例**：`sino-bc-cli biz-line +categories`
 
 ## +list
 
-- **WHEN**：按名称、ID、渠道、行业、品类筛业务线；不传条件 = 全部。
-- **别用**：只要某一条的周策略（用 `+strategies`）；只要行业 Top（用 `+top`）。
+- **WHEN**：按名称、ID、品类筛业务线；不传条件 = 全部。
+- **别用**：只要某一条的周策略（用 `+strategies`）。渠道或行业条件请走 `biz-line api`。
 - **示例**：`sino-bc-cli biz-line +list --name <业务线名称>`
 
 ## +strategies
 
 - **WHEN**：查某条业务线的周策略和表现。
-- **别用**：`--name` 可能命中多条时不要猜，先 `+list` 收窄或改 `--id`。
+- **别用**：`--name` 可能命中多条时不要猜，先 `+list` 收窄或改单个 `--id`。
 - **示例**：`sino-bc-cli biz-line +strategies --name <业务线名称>`
 
-## +top
-
-- **WHEN**：问某行业或品类里表现最好的业务线。
-- **别用**：行业和品类都没有时不要空跑；两个都传则只按行业。
-- **示例**：`sino-bc-cli biz-line +top --industry APP`
-
 ## +save / +update
 
 - **WHEN**：新建或编辑业务线主数据。字段多用 `--data`。
@@ -58,6 +52,6 @@
 
 ## api
 
-- **WHEN**：导出、对比、消耗、周期列表、上期摘要等没有 `+` 的接口。
+- **WHEN**：导出、对比、消耗、周期列表、上期摘要等没有 `+` 的接口。行业 / 品类 Top 目前没有 Shortcut。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli biz-line api biz-line-strategy-compare --data '{"bizLineId":123,"currentId":2,"prevId":1}'`

package/dist/api-doc/README.md

@@ -1,13 +1,13 @@
 # 接口文档索引
 
-本目录汇总 CLI 可调用的业务线接口（字段口径）。浏览清单用 `/api-list`（Shortcut 行带一句 WHEN）；何时用哪条命令见仓库 `affordance/biz-line.md` 或 `sino-bc-cli biz-line --help`。发起调用用 `biz-line +<shortcut>`；没有 Shortcut 的接口用 `biz-line api <name> --data '<json>'`。Agent 技能树在 `skills/`，自省用 `/skill`。
+本目录汇总 CLI 可调用的业务线接口（字段口径）。何时用哪条命令见仓库 `affordance/biz-line.md` 或 `sino-bc-cli biz-line --help`。发起调用用 `biz-line +<shortcut>`；没有 Shortcut 的接口用 `biz-line api <name> --data '<json>'`。Agent 技能树在 `skills/`，自省用 `/skill`。
 
-iCenter 不再随 CLI 提供接口文档。需要 iCenter 时，把 MCP Server 写进 `~/.sino-bc-cli/mcp.json`，再执行 `/init` 或 `/mcp-reload`，CLI 会同步到 Cursor / Codex / Claude / VS Code。
+本 CLI 只覆盖业务线网关接口，不管理 MCP。
 
 | 分组 | 命令 | 接口数 | 文档 |
 | --- | --- | --- | --- |
-| 业务线查询 | `biz-line +channels` / `+categories` / `+list` / `+strategies` / `+top` | 5 | [biz-line-query.md](./biz-line-query.md) |
-| 业务线策略 | `biz-line +save` / `+update` / `+status` / `+delete` / `+strategy-*`，其余 `biz-line api <name>` | 17 | [biz-line-strategy.md](./biz-line-strategy.md) |
+| 业务线查询 | `biz-line +channels` / `+categories` | 2 | [biz-line-query.md](./biz-line-query.md) |
+| 业务线策略 | `biz-line +list` / `+strategies` / `+save` / `+update` / `+status` / `+delete` / `+strategy-*`，其余 `biz-line api <name>` | 17 | [biz-line-strategy.md](./biz-line-strategy.md) |
 
 ---
 
@@ -16,7 +16,6 @@ iCenter 不再随 CLI 提供接口文档。需要 iCenter 时，把 MCP Server
 | 范围 | 通道 |
 | --- | --- |
 | `biz-line-query.md` / `biz-line-strategy.md` 与 `biz-line` 命令 | 固定走网关 HTTP，路径带 `/sino-opti-hive` |
-| iCenter 及其他 MCP | 用户编辑 `~/.sino-bc-cli/mcp.json`，由 `/init`、`/mcp-reload` 同步并启动 |
 
 网关地址的唯一来源是 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`；各文档中出现的上游服务地址（`o-test-sino-opti-hive` 等）仅作接口文档出处，不作为请求地址。
 
@@ -34,14 +33,14 @@ iCenter 不再随 CLI 提供接口文档。需要 iCenter 时，把 MCP Server
 
 数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html)
 
-共 **22** 个接口，分两组。所有路径经网关调用时统一带 `/sino-opti-hive` 路由前缀，例如 `/sino-opti-hive/biz-line-open/channels`。
+共 **19** 个接口，分两组。所有路径经网关调用时统一带 `/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 | 业务线主数据与周策略的增删改查、导出 |
+| [biz-line-query.md](./biz-line-query.md) | 业务线查询 | 2 | 对外开放的只读查询：渠道、品类字典 |
+| [biz-line-strategy.md](./biz-line-strategy.md) | 业务线策略 | 17 | 业务线主数据与周策略的增删改查、导出；`+list` / `+strategies` 改绑此组内部接口 |
 
-对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`，接口清单定义在 `src/constants/biz-line-api-doc.ts`。
+对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`，接口清单定义在 `src/generated/api-catalog.json`。维护者同步：`APIFOX_TOKEN` 环境变量 + `npm run sync-api-doc`。
 
 > ⚠️ 业务线策略组含新建 / 编辑 / 删除等写操作接口。写操作必须先确认：不加 `--yes` 时交互式终端会询问，非交互式环境以退出码 `10` 返回 `confirmation_required`；执行前可用 `--dry-run` 预览请求。
 >
@@ -51,15 +50,7 @@ iCenter 不再随 CLI 提供接口文档。需要 iCenter 时，把 MCP Server
 
 ## 命令调用
 
-浏览全部接口并打开本文档：
-
-```bash
-sino-bc-cli /api-list
-sino-bc-cli /api-list 1
-sino-bc-cli /api-list biz-line-open-channels
-```
-
-发起调用经网关 HTTP；环境与鉴权取自变量配置文件，无需在命令上传。
+发起调用经网关 HTTP；环境与鉴权取自变量配置文件，无需在命令上传。字段口径以本目录 markdown 为准。
 
 ```bash
 # 有 Shortcut 的高频查询

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

@@ -2,7 +2,7 @@
 
 数据来源：[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** 个，均不涉及数据变更。
+对外开放的只读查询接口，共 **2** 个（渠道、品类字典）。业务线列表与周策略已改绑内部接口，见 [biz-line-strategy.md](./biz-line-strategy.md) 的 `biz-line-list` / `biz-line-strategy-list`。
 
 > **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连 sino-opti-hive 服务地址。
 >
@@ -12,9 +12,8 @@
 | --- | --- | --- | --- | --- |
 | 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` |
+
+> `biz-line-open-list` / `biz-line-open-strategies` / `biz-line-open-strategy-top` 已不在现行 catalog。`+list` / `+strategies` 改打 `biz-line-list` / `biz-line-strategy-list`。`+top` 已下线。
 
 所有接口统一返回 `RestResponseVO` 包装：`success`、`code`、`message`、`result`、`traceId`。下文只描述 `result`。
 
@@ -209,7 +208,6 @@ sino-bc-cli biz-line +channels
 sino-bc-cli biz-line +categories
 sino-bc-cli biz-line +list --name <业务线名称>
 sino-bc-cli biz-line +strategies --name <业务线名称>
-sino-bc-cli biz-line +top --industry APP --top-n 5
 
 # 切换环境（test / pre / prod）
 sino-bc-cli /set-config env test

package/dist/generated/api-catalog.json

@@ -0,0 +1,287 @@
+[
+  {
+    "name": "biz-line-open-channels",
+    "displayName": "查询投放渠道列表",
+    "description": "无入参，返回 ChannelEnum 全量：code = 渠道 ID，name = 渠道名称",
+    "group": "业务线查询",
+    "method": "GET",
+    "path": "/sino-opti-hive/biz-line-open/channels",
+    "timeout": 20000,
+    "tag": "业务线查询",
+    "domain": "biz-line",
+    "shortcut": "+channels",
+    "risk": "read",
+    "summary": "查询投放渠道列表",
+    "docFile": "biz-line-query.md"
+  },
+  {
+    "name": "biz-line-open-placement-categories",
+    "displayName": "查询投放品类字典树",
+    "description": "无入参，一级节点 = 投放行业，二级节点 children = 投放品类",
+    "group": "业务线查询",
+    "method": "GET",
+    "path": "/sino-opti-hive/biz-line-open/placement-categories",
+    "timeout": 20000,
+    "tag": "业务线查询",
+    "domain": "biz-line",
+    "shortcut": "+categories",
+    "risk": "read",
+    "summary": "查询投放品类字典树",
+    "docFile": "biz-line-query.md"
+  },
+  {
+    "name": "biz-line-list",
+    "displayName": "业务线分页列表",
+    "description": "result 为分页对象：total = 总条数，result = 当前页 BizLineListVO 列表",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+list",
+    "risk": "read",
+    "summary": "业务线分页列表",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-detail",
+    "displayName": "业务线详情",
+    "description": "按业务线 ID 查详情，result 为 BizLineDetailVO",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/detail",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+detail",
+    "risk": "write",
+    "summary": "业务线详情",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-save",
+    "displayName": "新建业务线",
+    "description": "⚠️ 写操作：新建业务线，成功时 result 为新建业务线详情",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/save",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+save",
+    "risk": "write",
+    "summary": "新建业务线",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-update",
+    "displayName": "编辑业务线",
+    "description": "⚠️ 写操作：按 ID 编辑业务线，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+update",
+    "risk": "write",
+    "summary": "编辑业务线",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-status-update",
+    "displayName": "切换业务线状态",
+    "description": "⚠️ 写操作：仅更新状态与操作人，status 取 1 进行中 / 2 已完成 / 3 已暂停",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/status/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+status",
+    "risk": "write",
+    "summary": "切换业务线状态",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-del",
+    "displayName": "删除业务线",
+    "description": "⚠️ 写操作：按 ID 删除业务线，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/del",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+delete",
+    "risk": "write",
+    "summary": "删除业务线",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-list-export",
+    "displayName": "业务线列表导出",
+    "description": "导出筛选条件下所有业务线数据，result 为 Excel 文件访问 URL",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/list/export",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+export",
+    "risk": "write",
+    "summary": "业务线列表导出",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-list",
+    "displayName": "全部策略分页",
+    "description": "按业务线分页查周策略，result 为 BizLineStrategyDetailVO 分页对象",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategies",
+    "risk": "read",
+    "summary": "全部策略分页",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-detail",
+    "displayName": "策略详情（编辑返显）",
+    "description": "result 为 BizLineStrategyDetailVO，含标签展示文案与乐观锁版本号",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/detail",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-detail",
+    "risk": "write",
+    "summary": "策略详情（编辑返显）",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-period-list",
+    "displayName": "策略周期列表",
+    "description": "按业务线返回全部策略周期，result 含 items 与 total",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/period-list",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+period-list",
+    "risk": "write",
+    "summary": "策略周期列表",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-preview-info",
+    "displayName": "新建策略前置-上期摘要",
+    "description": "按目标周期取上期策略摘要，periodExist 标识目标周期是否已有数据",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/preview-info",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+preview-info",
+    "risk": "write",
+    "summary": "新建策略前置-上期摘要",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-save",
+    "displayName": "新建策略",
+    "description": "⚠️ 写操作：新建业务线周策略，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/save",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-save",
+    "risk": "write",
+    "summary": "新建策略",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-update",
+    "displayName": "编辑策略",
+    "description": "⚠️ 写操作：按策略 ID 编辑，version 为乐观锁，overwrite=true 强制覆盖",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/update",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-update",
+    "risk": "write",
+    "summary": "编辑策略",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-del",
+    "displayName": "删除策略",
+    "description": "⚠️ 写操作：按策略 ID 删除，成功时 result 为 Boolean",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/del",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+strategy-delete",
+    "risk": "write",
+    "summary": "删除策略",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-compare",
+    "displayName": "策略对比",
+    "description": "对比两期策略，diffFields 给出存在差异的字段名列表",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/compare",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+compare",
+    "risk": "write",
+    "summary": "策略对比",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-spend",
+    "displayName": "策略周期消耗汇总",
+    "description": "按策略 ID 汇总周期内关联项目消耗，result 含 totalSpend",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/spend",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+spend",
+    "risk": "write",
+    "summary": "策略周期消耗汇总",
+    "docFile": "biz-line-strategy.md"
+  },
+  {
+    "name": "biz-line-strategy-exprot-all",
+    "displayName": "导出全部策略",
+    "description": "导出该业务线全部策略，result 为文件访问 URL（服务端路径拼写为 exprot-all）",
+    "group": "业务线策略",
+    "method": "POST",
+    "path": "/sino-opti-hive/biz-line/strategy/exprot-all",
+    "timeout": 20000,
+    "tag": "业务线策略",
+    "domain": "biz-line",
+    "shortcut": "+exprot-all",
+    "risk": "write",
+    "summary": "导出全部策略",
+    "docFile": "biz-line-strategy.md"
+  }
+]