sino-bc-cli 1.8.3 → 1.8.5

package/dist/SKILL.md

@@ -1,27 +1,73 @@
----
-name: sino-bc-cli
-description: >
-  Use when 查询或操作 BeyondClick 业务线，或配置 sino-bc-cli。
-  完整规则在 sino-bc-shared 与 sino-bc-biz-line；本文件只做入口。
-metadata:
-  requires:
-    bins: ["sino-bc-cli"]
----
-
-# sino-bc-cli
-
-Agent 技能已拆成多份，**不要只读这一页**。
-
-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/` 技能目录）：
-
-```bash
-sino-bc-cli /init
-sino-bc-cli /skill
-```
-
-列出包内技能：`sino-bc-cli /skill`。查看某条命令何时用：`sino-bc-cli biz-line --help`。
-升级 CLI 后请再跑一次 `/init`。
+---
+name: sino-bc-cli
+description: >
+  Use when 查询或操作 BeyondClick 业务线、周策略生成、广告结构、广告成效，或配置 sino-bc-cli：
+  投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯/客户满意度/ROAS；
+  Facebook / Google / TikTok 广告结构（账户、广告系列、广告组、广告、目标、出价、定向）
+  与广告成效（消耗、曝光、点击、购买、安装）；
+  SSO 组别；以及 /init、/get-config、/set-config。
+  用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、biz-line、
+  Meta、Facebook、Google、TikTok、sso、sino-opti-hive 时也必须用本技能，不要自己拼 HTTP。
+  完整规则在子技能 sino-bc-shared 与 sino-bc-<domain>。
+metadata:
+  requires:
+    bins: ["sino-bc-cli"]
+---
+
+# sino-bc-cli
+
+用全局 CLI `sino-bc-cli` 查询或操作 BeyondClick。本文件是**唯一对外技能**，也是决策页：按用户意图只读一份子技能，再执行命令。不要自己拼网关 HTTP，也不要一次读完全部子技能。
+
+`/init` 之后本机目录是 `~/.agents/skills/sino-bc-cli/`，子技能嵌在其下（没有 `system/` / `custom/` 这一层）：
+
+```text
+sino-bc-cli/
+├── SKILL.md                 ← 本文件
+├── sino-bc-shared/          横切：配置、信封、确认门
+├── sino-bc-biz-line/        业务线、周策略、广告结构、广告成效
+└── sino-bc-sso/             SSO 组别
+```
+
+## 怎么跑
+
+1. 用 Read 打开 [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)：禁止拼 HTTP、成功看 `ok` / 退出码、写操作退出码 10、配置。
+2. 按下表再读**一份**域技能。Shortcut、组参、枚举、长尾 `api <name>` 都在那份里。
+3. 有 Shortcut 用 `sino-bc-cli <domain> +<shortcut>`；没有再用 `sino-bc-cli <domain> api <name> --data '<json>'`。
+4. 写操作先停下确认环境和意图，用户同意后再加 `--yes`。**不要自行补 `--yes`。**
+
+不确定哪条命令：`sino-bc-cli biz-line --help` 或 `sino-bc-cli sso --help`。
+
+CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出现或升级 CLI 后：`sino-bc-cli /init`。
+
+## 意图 → 子技能
+
+| 用户在问 | 读 | 命令入口 |
+| --- | --- | --- |
+| 环境、API_KEY、成功/失败怎么看、写操作要不要确认 | [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md) | `/init` `/get-config` `/set-config` |
+| 投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、红绿灯/消耗/ROAS | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
+| Facebook / Google / TikTok 广告结构（账户、系列、组、广告、目标、出价、定向）或广告成效（消耗、曝光、点击、购买、安装） | 同上 | `biz-line +<shortcut>`（维度 / 成效） |
+| SSO 组别 | [`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md) | `sso +group-list` |
+
+不要用本技能处理：本仓库源码开发、扩展命令、npm 发版（见仓库 `README.md` / `ReleaseSteps.md`）。
+
+## 子技能索引
+
+Agent 先读子技能 `sino-bc-shared`，再按意图读域技能。
+
+1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/custom/sino-bc-shared/SKILL.md`](skills/custom/sino-bc-shared/SKILL.md)）
+2. 业务线、周策略生成、广告结构、广告成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/system/sino-bc-biz-line/SKILL.md`](skills/system/sino-bc-biz-line/SKILL.md)）
+3. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/system/sino-bc-sso/SKILL.md`](skills/system/sino-bc-sso/SKILL.md)）
+
+安装与刷新（会写入上面列出的子技能到本机 `sino-bc-cli/`，并删除旧的平级 `sino-bc-shared` / `sino-bc-<domain>` 技能目录）：
+
+```bash
+sino-bc-cli /init
+sino-bc-cli /skill
+```
+
+列出包内技能：`sino-bc-cli /skill`（只有这一条）。查看某条命令何时用：`sino-bc-cli biz-line --help`。
+升级 CLI 后请再跑一次 `/init`。
+
+> 仓库里子技能分两层：`skills/system/sino-bc-<domain>/` 由 `npm run sync-api-doc` 生成；`skills/custom/sino-bc-shared/` 与 `skills/custom/sino-bc-<domain>/references/` 手写且不会被同步覆盖。每个子技能都是标准目录：`SKILL.md` + `references/`。
+> `/init` 把根 `SKILL.md` 与两层子技能嵌进 `~/.agents/skills/sino-bc-cli/`。
+> 上面的索引由同步脚本维护，改它请改 `src/api-utils/render-skills.ts`。

package/dist/affordance/biz-line.md

@@ -1,57 +1,129 @@
-# biz-line 命令何时用
-
-字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
-
-## +channels
-
-- **WHEN**：用户问有哪些投放渠道、mediaChannelId 怎么填。
-- **别用**：查业务线列表（用 `+list`）。
-- **示例**：`sino-bc-cli biz-line +channels`
-
-## +categories
-
-- **WHEN**：用户问投放行业 / 品类树，或要把名称映射成字典 ID。
-- **别用**：已经有品类 ID 且只要业务线（直接 `+list --category`）。
-- **示例**：`sino-bc-cli biz-line +categories`
-
-## +list
-
-- **WHEN**：按名称、ID、品类筛业务线；不传条件 = 全部。
-- **别用**：只要某一条的周策略（用 `+strategies`）。渠道或行业条件请走 `biz-line api`。
-- **示例**：`sino-bc-cli biz-line +list --name <业务线名称>`
-
-## +strategies
-
-- **WHEN**：查某条业务线的周策略和表现。
-- **别用**：`--name` 可能命中多条时不要猜，先 `+list` 收窄或改单个 `--id`。
-- **示例**：`sino-bc-cli biz-line +strategies --name <业务线名称>`
-
-## +save / +update
-
-- **WHEN**：新建或编辑业务线主数据。字段多用 `--data`。
-- **别用**：只改状态用 `+status`；没确认环境和意图不要加 `--yes`。
-- **示例**：`sino-bc-cli biz-line +save --data '{...}' --dry-run`
-
-## +status
-
-- **WHEN**：切换业务线状态（进行中 / 已完成 / 已暂停）。
-- **别用**：改名称或渠道用 `+update`。
-- **示例**：`sino-bc-cli biz-line +status --id 123 --status 3 --yes`
-
-## +delete
-
-- **WHEN**：删除业务线。
-- **别用**：只想停投放用 `+status --status 3`。
-- **示例**：`sino-bc-cli biz-line +delete --id 123 --dry-run`
-
-## +strategy-save / +strategy-update / +strategy-delete
-
-- **WHEN**：新建、编辑或删除周策略。编辑必须带 `version`。
-- **别用**：只对比两期用 `biz-line api biz-line-strategy-compare`。
-- **示例**：`sino-bc-cli biz-line +strategy-update --data '{...}' --yes`
-
-## api
-
-- **WHEN**：导出、对比、消耗、周期列表、上期摘要等没有 `+` 的接口。行业 / 品类 Top 目前没有 Shortcut。
-- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
-- **示例**：`sino-bc-cli biz-line api biz-line-strategy-compare --data '{"bizLineId":123,"currentId":2,"prevId":1}'`
+# biz-line 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+## +list
+
+- **WHEN**：查询业务线分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +list --data '{...}'`
+
+## +detail
+
+- **WHEN**：业务线详情
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +detail --data '{...}'`
+
+## +save
+
+- **WHEN**：新建业务线 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +save --data '{...}'`
+
+## +update
+
+- **WHEN**：编辑业务线 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +update --data '{...}'`
+
+## +status
+
+- **WHEN**：切换业务线状态 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +status --data '{...}'`
+
+## +delete
+
+- **WHEN**：删除业务线 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +delete --data '{...}'`
+
+## +period-list
+
+- **WHEN**：策略周期列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +period-list --data '{...}'`
+
+## +strategies
+
+- **WHEN**：查询策略分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +strategies --data '{...}'`
+
+## +spend
+
+- **WHEN**：策略周期内关联项目周表消耗汇总
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +spend --data '{...}'`
+
+## +strategy-save
+
+- **WHEN**：新建策略 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +strategy-save --data '{...}'`
+
+## +strategy-update
+
+- **WHEN**：编辑策略 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +strategy-update --data '{...}'`
+
+## +strategy-delete
+
+- **WHEN**：删除策略 （写操作需 --yes）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +strategy-delete --data '{...}'`
+
+## +channels
+
+- **WHEN**：查询投放渠道列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +channels`
+
+## +categories
+
+- **WHEN**：查询投放品类字典树
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +categories`
+
+## +facebook-dimension
+
+- **WHEN**：Facebook广告策略维度数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +facebook-dimension --data '{...}'`
+
+## +google-dimension
+
+- **WHEN**：Google广告策略维度数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +google-dimension --data '{...}'`
+
+## +tiktok-dimension
+
+- **WHEN**：TikTok广告策略维度数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +tiktok-dimension --data '{...}'`
+
+## +facebook-metrics
+
+- **WHEN**：Facebook广告策略成效数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +facebook-metrics --data '{...}'`
+
+## +google-metrics
+
+- **WHEN**：Google广告策略成效数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +google-metrics --data '{...}'`
+
+## +tiktok-metrics
+
+- **WHEN**：TikTok广告策略成效数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +tiktok-metrics --data '{...}'`
+
+## api
+
+- **WHEN**：没有 `+` 的接口按 name 点名调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli biz-line api <name> --data '{...}'`

package/dist/affordance/sso.md

@@ -0,0 +1,15 @@
+# sso 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+## +group-list
+
+- **WHEN**：查询组别列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli sso +group-list`
+
+## api
+
+- **WHEN**：没有 `+` 的接口按 name 点名调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli sso api <name> --data '{...}'`

package/dist/api-doc/{README.md → custom/README.md}

@@ -1,77 +1,92 @@
-# 接口文档索引
-
-本目录汇总 CLI 可调用的业务线接口（字段口径）。何时用哪条命令见仓库 `affordance/biz-line.md` 或 `sino-bc-cli biz-line --help`。发起调用用 `biz-line +<shortcut>`；没有 Shortcut 的接口用 `biz-line api <name> --data '<json>'`。Agent 技能树在 `skills/`，自省用 `/skill`。
-
-本 CLI 只覆盖业务线网关接口，不管理 MCP。
-
-| 分组 | 命令 | 接口数 | 文档 |
-| --- | --- | --- | --- |
-| 业务线查询 | `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) |
-
----
-
-## 调用通道
-
-| 范围 | 通道 |
-| --- | --- |
-| `biz-line-query.md` / `biz-line-strategy.md` 与 `biz-line` 命令 | 固定走网关 HTTP，路径带 `/sino-opti-hive` |
-
-网关地址的唯一来源是 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`；各文档中出现的上游服务地址（`o-test-sino-opti-hive` 等）仅作接口文档出处，不作为请求地址。
-
-| 环境 | 网关地址 |
-| --- | --- |
-| `test` 测试环境 | `https://test-agent.beyondclick.com` |
-| `pre` 预发环境 | `https://test-agent.beyondclick.com` |
-| `prod` 生产环境 | `https://test-agent.beyondclick.com` |
-
-> 当前三环境同一地址；改地址只改 `GATEWAY_CONFIG`，代码通过 `joinGatewayUrl(env, path)` 取值，不要在别处硬编码。
-
----
-
-## 业务线接口（sino-opti-hive）
-
-数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html)
-
-共 **19** 个接口，分两组。所有路径经网关调用时统一带 `/sino-opti-hive` 路由前缀，例如 `/sino-opti-hive/biz-line-open/channels`。
-
-| 文档 | 分组 | 接口数 | 说明 |
-| --- | --- | --- | --- |
-| [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/generated/api-catalog.json`。维护者同步：`APIFOX_TOKEN` 环境变量 + `npm run sync-api-doc`。
-
-> ⚠️ 业务线策略组含新建 / 编辑 / 删除等写操作接口。写操作必须先确认：不加 `--yes` 时交互式终端会询问，非交互式环境以退出码 `10` 返回 `confirmation_required`；执行前可用 `--dry-run` 预览请求。
->
-> 文档中的「请求示例」只用于说明字段口径，**不会**被任何命令当作默认请求体发送。
-
----
-
-## 命令调用
-
-发起调用经网关 HTTP；环境与鉴权取自变量配置文件，无需在命令上传。字段口径以本目录 markdown 为准。
-
-```bash
-# 有 Shortcut 的高频查询
-sino-bc-cli biz-line +list --name <业务线名称>
-sino-bc-cli biz-line +strategies --name <业务线名称>
-
-# 没有 Shortcut 的接口按 name 点名调用
-sino-bc-cli biz-line api biz-line-strategy-compare \
-  --data '{"bizLineId":123,"currentId":2,"prevId":1}'
-
-# 写操作：先预览，确认后追加 --yes
-sino-bc-cli biz-line +delete --id 123 --dry-run
-sino-bc-cli biz-line +delete --id 123 --yes
-
-# 切换环境
-sino-bc-cli /set-config env test
-```
-
-输出格式：TTY 默认表格，非 TTY 默认 JSON 信封（`--format` 可覆盖）。成功 `{ ok: true, data }` 走 stdout，失败 `{ ok: false, error }` 走 stderr；退出码 `0` 成功、`10` 待确认、其余非 0 失败。
-
-| 配置 | 默认值 | 说明 |
-| --- | --- | --- |
-| `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` |
+# 接口文档索引
+
+本目录汇总 CLI 可调用的业务线接口（字段口径）。何时用哪条命令见仓库 `affordance/biz-line.md` 或 `sino-bc-cli biz-line --help`。发起调用用 `biz-line +<shortcut>`；没有 Shortcut 的接口用 `biz-line api <name> --data '<json>'`。Agent 技能树在 `skills/`，自省用 `/skill`。
+
+本 CLI 只覆盖业务线网关接口，不管理 MCP。
+
+## 目录分层
+
+`src/api-doc/` 分两层，`skills/` 同理：
+
+| 目录 | 来源 | 会不会被覆盖 |
+| --- | --- | --- |
+| `system/` | `npm run sync-api-doc` 从 Apifox 全量生成 | **每次同步整层重写**，不要手改 |
+| `custom/` | 手写（本文件就在这里） | 同步脚本只读，不会创建、改写或删除 |
+
+两层出现同名文件时，运行时按 `custom/` → `system/` 顺序取第一个命中，即**手写件优先**。所以在 `custom/` 里放一份与生成文档同名的文件，会让同步结果看起来「没生效」——需要覆盖时才这么做。
+
+| 分组 | 命令 | 接口数 | 文档 |
+| --- | --- | --- | --- |
+| 业务线查询 | `biz-line +channels` / `+categories` | 2 | [biz-line-query.md](../system/biz-line-query.md) |
+| 业务线策略 | `biz-line +list` / `+strategies` / `+save` / `+update` / `+status` / `+delete` / `+strategy-*`，其余 `biz-line api <name>` | 13 | [biz-line-strategy.md](../system/biz-line-strategy.md) |
+| SSO | `sso +group-list` | 1 | [sso.md](../system/sso.md) |
+
+> 接口数随 Apifox 变动，以 `src/generated/api-catalog.json` 为准，本表只作导航。
+
+---
+
+## 调用通道
+
+| 范围 | 通道 |
+| --- | --- |
+| `biz-line-query.md` / `biz-line-strategy.md` 与 `biz-line` 命令 | 固定走网关 HTTP，path 等于接口文档 / OpenAPI 路由 |
+
+网关地址的唯一来源是 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`；各文档中出现的上游服务地址（`o-test-sino-opti-hive` 等）仅作接口文档出处，不作为请求地址。
+
+| 环境 | 网关地址 |
+| --- | --- |
+| `test` 测试环境 | `https://test-agent.beyondclick.com` |
+| `pre` 预发环境 | `https://test-agent.beyondclick.com` |
+| `prod` 生产环境 | `https://test-agent.beyondclick.com` |
+
+> 当前三环境同一地址；改地址只改 `GATEWAY_CONFIG`，代码通过 `joinGatewayUrl(env, path)` 取值，不要在别处硬编码。
+
+---
+
+## 业务线接口（sino-opti-hive）
+
+数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html)
+
+当前 **16** 个接口。请求 path 等于 Apifox / OpenAPI 路由原文，例如 `/sino-opti-hive/biz-line-open/channels`。接口 `name` 由该 path 去掉前导 `/` 并将 `/` 换成 `-`（`sino-opti-hive-biz-line-open-channels`）。
+
+| 文档 | 分组 | 接口数 | 说明 |
+| --- | --- | --- | --- |
+| [biz-line-query.md](../system/biz-line-query.md) | 业务线查询 | 2 | 对外开放的只读查询：渠道、品类字典 |
+| [biz-line-strategy.md](../system/biz-line-strategy.md) | 业务线策略 | 13 | 业务线主数据与周策略的增删改查；`+list` / `+strategies` 改绑此组内部接口 |
+| [sso.md](../system/sso.md) | SSO | 1 | 团队组列表；上游挂在「业务线策略」tag 下，由映射表按 endpoint 拆到独立域 `sso` |
+
+对应命令：`biz-line +<shortcut>` / `sso +<shortcut>` 与 `<domain> api <name>`，接口清单定义在 `src/generated/api-catalog.json`。维护者同步：`npm run sync-api-doc`（token 见下文）。
+
+> ⚠️ 业务线策略组含新建 / 编辑 / 删除等写操作接口。写操作必须先确认：不加 `--yes` 时交互式终端会询问，非交互式环境以退出码 `10` 返回 `confirmation_required`；执行前可用 `--dry-run` 预览请求。
+>
+> 文档中的「请求示例」只用于说明字段口径，**不会**被任何命令当作默认请求体发送。
+
+---
+
+## 命令调用
+
+发起调用经网关 HTTP；环境与鉴权取自变量配置文件，无需在命令上传。字段口径以本目录 markdown 为准。
+
+```bash
+# 有 Shortcut 的高频查询
+sino-bc-cli biz-line +list --name <业务线名称>
+sino-bc-cli biz-line +strategies --name <业务线名称>
+
+# 没有 Shortcut 的接口按 name 点名调用
+sino-bc-cli biz-line api biz-line-strategy-compare \
+  --data '{"bizLineId":123,"currentId":2,"prevId":1}'
+
+# 写操作：先预览，确认后追加 --yes
+sino-bc-cli biz-line +delete --id 123 --dry-run
+sino-bc-cli biz-line +delete --id 123 --yes
+
+# 切换环境
+sino-bc-cli /set-config env test
+```
+
+输出格式：TTY 默认表格，非 TTY 默认 JSON 信封（`--format` 可覆盖）。成功 `{ ok: true, data }` 走 stdout，失败 `{ ok: false, error }` 走 stderr；退出码 `0` 成功、`10` 待确认、其余非 0 失败。
+
+| 配置 | 默认值 | 说明 |
+| --- | --- | --- |
+| `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/system/biz-line-query.md

@@ -0,0 +1,19 @@
+# 业务线查询
+
+> **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连上游服务地址。
+>
+> **调用路径**：等于下方列出的 path（即 OpenAPI / catalog 路由），由 CLI 拼到网关地址后发出。
+
+对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
+
+## 1. 查询投放渠道列表
+
+`GET /sino-opti-hive/biz-line-open/channels`
+
+无入参，返回 ChannelEnum 全量：code = 枚举 id（即 list 的 mediaChannelId），name = 渠道名称。
+
+## 2. 查询投放品类字典树
+
+`GET /sino-opti-hive/biz-line-open/placement-categories`
+
+无入参，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。