sino-bc-cli 1.8.2 → 1.8.4

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

@@ -1,218 +0,0 @@
-# 业务线查询（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** 个，均不涉及数据变更。
-
-> **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连 sino-opti-hive 服务地址。
->
-> **路由前缀**：经网关调用时所有路径需带 `/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
-# 本组接口都有 Shortcut
-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
-```
-
-详见 [README.md](./README.md)。

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

@@ -1,319 +0,0 @@
-# 业务线策略（Biz Line）
-
-数据来源：[sino-opti-hive 接口文档](https://o-test-sino-opti-hive.meetsocial.com/doc.html#/default/%E4%B8%9A%E5%8A%A1%E7%BA%BF%E7%AD%96%E7%95%A5)
-
-业务线主数据与周策略的增删改查，共 **17** 个接口。
-
-> **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连 sino-opti-hive 服务地址。
->
-> **路由前缀**：经网关调用时所有路径需带 `/sino-opti-hive`，例如 `/sino-opti-hive/biz-line/list`。
->
-> ⚠️ 标记为「写操作」的接口会变更线上数据。CLI 会强制确认：不加 `--yes` 时交互式终端询问，非交互式环境以退出码 `10` 返回 `confirmation_required`；执行前可用 `--dry-run` 预览。文档中的「请求示例」只说明字段口径，不会被当作默认请求体发送。
-
-| # | name | 展示名 | 方法 | 路径（含前缀） |
-| --- | --- | --- | --- | --- |
-| 1 | `biz-line-list` | 业务线分页列表 | POST | `/sino-opti-hive/biz-line/list` |
-| 2 | `biz-line-detail` | 业务线详情 | POST | `/sino-opti-hive/biz-line/detail` |
-| 3 | `biz-line-save` | 新建业务线 ⚠️ | POST | `/sino-opti-hive/biz-line/save` |
-| 4 | `biz-line-update` | 编辑业务线 ⚠️ | POST | `/sino-opti-hive/biz-line/update` |
-| 5 | `biz-line-status-update` | 切换业务线状态 ⚠️ | POST | `/sino-opti-hive/biz-line/status/update` |
-| 6 | `biz-line-del` | 删除业务线 ⚠️ | POST | `/sino-opti-hive/biz-line/del` |
-| 7 | `biz-line-list-export` | 业务线列表导出 | POST | `/sino-opti-hive/biz-line/list/export` |
-| 8 | `biz-line-strategy-list` | 全部策略分页 | POST | `/sino-opti-hive/biz-line/strategy/list` |
-| 9 | `biz-line-strategy-detail` | 策略详情（编辑返显） | POST | `/sino-opti-hive/biz-line/strategy/detail` |
-| 10 | `biz-line-strategy-period-list` | 策略周期列表 | POST | `/sino-opti-hive/biz-line/strategy/period-list` |
-| 11 | `biz-line-strategy-preview-info` | 新建策略前置-上期摘要 | POST | `/sino-opti-hive/biz-line/strategy/preview-info` |
-| 12 | `biz-line-strategy-save` | 新建策略 ⚠️ | POST | `/sino-opti-hive/biz-line/strategy/save` |
-| 13 | `biz-line-strategy-update` | 编辑策略 ⚠️ | POST | `/sino-opti-hive/biz-line/strategy/update` |
-| 14 | `biz-line-strategy-del` | 删除策略 ⚠️ | POST | `/sino-opti-hive/biz-line/strategy/del` |
-| 15 | `biz-line-strategy-compare` | 策略对比 | POST | `/sino-opti-hive/biz-line/strategy/compare` |
-| 16 | `biz-line-strategy-spend` | 策略周期消耗汇总 | POST | `/sino-opti-hive/biz-line/strategy/spend` |
-| 17 | `biz-line-strategy-export-all` | 导出全部策略 | POST | `/sino-opti-hive/biz-line/strategy/exprot-all` |
-
-> 第 17 项服务端路径确实拼作 `exprot-all`，与接口文档一致，请勿"修正"为 `export-all`。
-
-所有接口统一返回 `RestResponseVO` 包装，下文只描述 `result`。
-
----
-
-## 业务线主数据
-
-### 1. 业务线分页列表
-
-`POST /sino-opti-hive/biz-line/list`
-
-`result` 为分页对象：`total` = 总条数，`page`、`size`，`result` = 当前页 `BizLineListVO` 列表。
-
-**请求体：`BizLineListReqVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `name` | string | 业务线名称，模糊搜索 |
-| `idList` | long[] | 业务线 ID 列表 |
-| `status` | int | 状态，默认 `1` 进行中 |
-| `ssoTeamCode` | string | 组别 code，精确筛选（单选，兼容旧版） |
-| `ssoTeamCodeList` | string[] | 组别 code 列表，多选 |
-| `pmUserIds` | long[] | PM 用户 ID 多选（OR 语义：命中任一 PM） |
-| `businessRegionList` | string[] | 商务地区多选，取值见 `BusinessRegionEnum` |
-| `projectRatingList` | string[] | 项目评级多选，取值见 `ProjectRatingEnum` |
-| `newCustomerTag` | string | 新客标签单选，取值见 `NewCustomerTagEnum` |
-| `adCategoryProjectId` | long | 投放类型筛选（`-1` 表示其他；其他值按 like 匹配） |
-| `trafficLightList` | int[] | 红绿灯筛选（策略表现），多选 |
-| `weekOverWeekFilter` | string | 周消耗环比筛选，单选，取值见 `WeekOverWeekFilterEnum` |
-| `sortType` | string | 排序字段，见下方说明 |
-| `sortDirection` | string | `ASC` 升序 / `DESC` 降序，默认 `DESC` |
-| `pageNum` / `pageSize` | int | 分页页数 / 每页数量 |
-| `pagination` | boolean | 是否分页，`false` 则不分页 |
-| `count` | boolean | 是否 Count |
-| `startIndex` | int | 起始行 |
-
-**`sortType` 取值**：`SPEND` 按上期周消耗（effective spend）、`WEEK_OVER_WEEK` 按上期周消耗环比、`PERIOD` 按本期策略周期（`week_start`）、`TRAFFIC_LIGHT` 按上期红绿灯（自定义顺序）。不传时默认按业务线 `id` 倒序。
-
-请求示例：
-
-```json
-{ "pageNum": 1, "pageSize": 20, "pagination": true, "count": true, "status": 1 }
-```
-
-### 2. 业务线详情
-
-`POST /sino-opti-hive/biz-line/detail`
-
-请求体：`{ "id": 1251 }`（`id` = 业务线 ID）。
-
-**响应 `result`：`BizLineDetailVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` / `name` | long / string | 业务线 ID 与名称 |
-| `status` | int | 状态：`1` 进行中、`2` 已完成、`3` 已暂停 |
-| `businessRegion` / `businessRegionDesc` | string | 商务地区枚举值与展示文案 |
-| `ssoTeamCode` / `ssoTeamCodeName` | string | 组别 code 与名称 |
-| `projectRating` / `projectRatingDesc` | string | 项目评级与展示文案 |
-| `newCustomerTag` / `newCustomerTagDesc` | string | 新客标签与展示文案 |
-| `strategyControlDegree` | int | 策略掌控程度：`1` 弱、`2` 强、`3` 中 |
-| `adCategoryIndustryIds` / `adCategoryProjectIds` / `adCategoryOther` | long[] / long[] / string | 投放品类行业、项目标签、其他说明 |
-| `mediaChannels` | int[] | 投放渠道 |
-| `pmUserIds` / `pmUserNames` | long[] / string[] | PM 用户 ID 与姓名，顺序对应 |
-| `amUserIds` / `amUserNames` | long[] / string[] | AM 用户 ID 与姓名，顺序对应 |
-| `corporationIds` / `corporationNames` | string[] / string[] | 关联客户公司 ID 与名称 |
-| `projectIds` / `projectNames` | long[] / string[] | 关联项目 ID 与名称 |
-| `customerTypeIds` / `customerTypeItems` / `customerTypeOther` | long[] / object[] / string | 客户类型 |
-| `customerInfrastructure` | int[] | 客户基建情况 |
-| `coreIndex` / `monthlyMaterialCount` / `projectBrief` | string | 核心指标、月度上新素材量、项目 brief |
-| `projectInitStatus` | string | 项目初始状态 |
-| `createBy` / `createByName` / `createTime` | int / string / string | 创建人与创建时间 |
-| `updateBy` / `updateByName` / `updateTime` | int / string / string | 更新人与更新时间 |
-
-### 3. 新建业务线 ⚠️
-
-`POST /sino-opti-hive/biz-line/save`，成功时 `result` 为新建业务线详情（`BizLineDetailVO`）。
-
-**请求体：`BizLineSaveReqVO`**
-
-| 字段 | 类型 | 必填 | 说明 |
-| --- | --- | --- | --- |
-| `name` | string | — | 业务线名称 |
-| `businessRegion` | string | **是** | 商务地区，取值见 `BusinessRegionEnum` |
-| `ssoTeamCode` | string | **是** | 组别 code，单选 |
-| `projectRating` | string | 非新客必填 | 项目评级，取值见 `ProjectRatingEnum` |
-| `newCustomerTag` | string | — | 新客标签，取值见 `NewCustomerTagEnum` |
-| `strategyControlDegree` | int | — | 策略掌控程度 `1` 弱 `2` 强 `3` 中 |
-| `adCategoryIndustryIds` | long[] | — | 投放品类-行业 ID |
-| `adCategoryProjectIds` | long[] | — | 投放品类-项目标签 ID；选其他时可为空 |
-| `adCategoryOther` | string | — | 投放品类-其他说明 |
-| `mediaChannels` | int[] | — | 投放渠道 |
-| `pmUserIds` / `amUserIds` | long[] | — | PM / AM 用户 ID |
-| `corporationIds` | string[] | — | 关联签约主体 ID（字符串，与主体系统一致） |
-| `projectIds` | long[] | — | 关联项目 ID |
-| `customerTypeIds` / `customerTypeOther` | long[] / string | — | 客户类型及其他说明 |
-| `customerInfrastructure` | int[] | — | 客户基建情况枚举列表 |
-| `coreIndex` / `monthlyMaterialCount` / `projectBrief` | string | — | 核心指标、月度上新素材量、项目 Brief |
-| `projectInitStatus` | string | — | 项目初始化状态 |
-
-### 4. 编辑业务线 ⚠️
-
-`POST /sino-opti-hive/biz-line/update`，成功时 `result` 为 `Boolean`。
-
-请求体在「新建业务线」字段基础上增加：`id`（业务线 ID，必填）、`status`（`1` 进行中 `2` 已完成 `3` 已暂停）。
-
-### 5. 切换业务线状态 ⚠️
-
-`POST /sino-opti-hive/biz-line/status/update`，仅更新状态与操作人，`result` 为 `Boolean`。
-
-请求体：`{ "id": 1251, "status": 1 }`，`status` 对应 `BizLineStatusEnum`。
-
-### 6. 删除业务线 ⚠️
-
-`POST /sino-opti-hive/biz-line/del`，请求体 `{ "id": 1251 }`，`result` 为 `Boolean`。
-
-### 7. 业务线列表导出
-
-`POST /sino-opti-hive/biz-line/list/export`
-
-导出筛选条件下所有业务线数据，`result` 为 Excel 文件访问 URL。请求体同「业务线分页列表」的 `BizLineListReqVO`。
-
----
-
-## 周策略
-
-### 8. 全部策略分页
-
-`POST /sino-opti-hive/biz-line/strategy/list`
-
-`result` 为分页对象，`result` 字段是当前页 `BizLineStrategyDetailVO` 列表。
-
-**请求体：`BizLineStrategyListReqVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `bizLineId` | long | 业务线 ID |
-| `trafficLight` | int | 红绿灯筛选 |
-| `sortType` / `sortDirection` | string | 排序方式 `desc` / `asc` |
-| `pageNum` / `pageSize` / `pagination` / `count` / `startIndex` | — | 分页参数，同业务线列表 |
-
-### 9. 策略详情（编辑返显）
-
-`POST /sino-opti-hive/biz-line/strategy/detail`，请求体 `{ "bizLineId": 1251, "id": 1 }`。
-
-**响应 `result`：`BizLineStrategyDetailVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` / `bizLineId` | long | 策略 ID / 所属业务线 ID |
-| `periodStart` / `periodEnd` | string | 策略周期起止（日期） |
-| `trafficLight` / `trafficLightDesc` | int / string | 红绿灯与展示文案 |
-| `customerSatisfaction` / `customerSatisfactionDesc` | int / string | 客户满意度与展示文案 |
-| `satisfactionReason` | string | 满意度原因说明 |
-| `coreEffectIndex` | string | 核心效果指标 |
-| `coreIssueCategories` / `coreIssueCategoryDescs` | int[] / string[] | 核心问题分类与展示文案 |
-| `issuesAndOpportunities` | string | 项目问题 & 机会 |
-| `spend` / `realSpend` / `weekSpendQoq` | string / number / number | 周期消耗（展示用）、媒体统计周消耗、周消耗环比（%） |
-| `budgetStrategyTags` / `budgetStrategyTagDescs` / `budgetStrategySupplement` | int[] / string[] / string | 预算策略标签、文案、补充说明 |
-| `budgetStrategyEffect` / `budgetStrategyEffectDesc` / `budgetStrategyLearning` | int / string / string | 预算策略效果与 Learning |
-| `audienceStrategy*` | — | 受众策略，字段结构同预算策略 |
-| `mediaStrategy*` | — | 媒介策略，字段结构同预算策略 |
-| `creativeStrategy` / `creativeStrategyEffect` / `creativeStrategyEffectDesc` / `creativeStrategyLearning` | — | 素材创意策略说明、效果与 Learning |
-| `version` | int | 乐观锁版本号，编辑时回传 |
-| `createBy` / `createByName` / `updateTime` | — | 创建人与最后更新时间 |
-
-**策略效果枚举**：`1` 有效、`2` 无效、`3` 待观察。
-
-### 10. 策略周期列表
-
-`POST /sino-opti-hive/biz-line/strategy/period-list`，请求体 `{ "bizLineId": 1251 }`。
-
-`result` 为 `BizLineStrategyPeriodListVO`：`items` 策略列表、`total` 策略期数。
-
-### 11. 新建策略前置-上期摘要
-
-`POST /sino-opti-hive/biz-line/strategy/preview-info`
-
-按目标周期取上期策略摘要，用于新建策略时预填。无上期策略时多为空字段。
-
-**请求体：`BizLineStrategyPreviewInfoReqVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `bizLineId` | long | 业务线 ID |
-| `periodStart` | string | 目标周期开始（周一） |
-| `periodEnd` | string | 目标周期结束（周日） |
-
-**响应关键字段**：`periodExist` 标识目标周期是否已有数据；`previewStrategyId` 为上期策略 ID（无上期时为 `null`）；`preview*` 系列字段为上期各维度策略标签与补充说明；`trafficLight`、`customerSatisfaction`、`spend` 为上期回顾数据。
-
-### 12. 新建策略 ⚠️
-
-`POST /sino-opti-hive/biz-line/strategy/save`，成功时 `result` 为 `Boolean`。
-
-**请求体：`BizLineStrategySaveReqVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `bizLineId` | long | 所属业务线 ID |
-| `periodStart` / `periodEnd` | string | 策略周期起止（日期） |
-| `trafficLight` | int | 红绿灯 |
-| `customerSatisfaction` / `satisfactionReason` | int / string | 客户满意度与原因说明 |
-| `coreEffectIndex` | string | 核心效果指标 |
-| `coreIssueCategories` | int[] | 核心问题分类（字典值列表） |
-| `issuesAndOpportunities` | string | 项目问题 & 机会 |
-| `spend` | string | 周期消耗（回顾，展示用字符串） |
-| `budgetStrategyTags` / `budgetStrategySupplement` / `budgetStrategyEffect` / `budgetStrategyLearning` | — | 预算策略标签、补充说明、效果、Learning |
-| `audienceStrategyTags` / `audienceStrategySupplement` / `audienceStrategyEffect` / `audienceStrategyLearning` | — | 受众策略同上 |
-| `mediaStrategyTags` / `mediaStrategySupplement` / `mediaStrategyEffect` / `mediaStrategyLearning` | — | 媒介策略同上 |
-| `creativeStrategy` / `creativeStrategyEffect` / `creativeStrategyLearning` | — | 素材创意策略 |
-| `previewPeriodStart` / `previewPeriodEnd` | string | 上期策略周期起止；缺省为本期 `periodStart` 的上一自然周周一、及其 +6 天 |
-| `previewBudgetStrategyTags` / `previewBudgetStrategySupplement` | — | 上期预算策略标签与补充说明 |
-| `previewAudienceStrategyTags` / `previewAudienceStrategySupplement` | — | 上期受众策略 |
-| `previewMediaStrategyTags` / `previewMediaStrategySupplement` | — | 上期媒介策略 |
-| `previewCreativeStrategy` | string | 上期素材创意策略说明 |
-
-### 13. 编辑策略 ⚠️
-
-`POST /sino-opti-hive/biz-line/strategy/update`，成功时 `result` 为 `Boolean`。
-
-请求体在「新建策略」字段基础上增加：
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `id` | long | 策略 ID |
-| `version` | int | 乐观锁版本号，取自策略详情 |
-| `overwrite` | boolean | 默认 `false`：版本冲突则报错；`true` 强制覆盖 |
-
-### 14. 删除策略 ⚠️
-
-`POST /sino-opti-hive/biz-line/strategy/del`，请求体 `{ "id": 1 }`，`result` 为 `Boolean`。
-
-### 15. 策略对比
-
-`POST /sino-opti-hive/biz-line/strategy/compare`，请求体 `{ "bizLineId": 1251, "currentId": 2, "prevId": 1 }`。
-
-**响应 `result`：`BizLineStrategyCompareVO`**
-
-| 字段 | 类型 | 说明 |
-| --- | --- | --- |
-| `current` | `BizLineStrategyDetailVO` | 当前策略 |
-| `prev` | `BizLineStrategyDetailVO` | 对比策略（无主策略或无上期时可能为 `null`） |
-| `diffFields` | string[] | 存在差异的字段名列表，如 `coreIssueCategories`、`budgetStrategyTags` |
-
-### 16. 策略周期消耗汇总
-
-`POST /sino-opti-hive/biz-line/strategy/spend`，请求体 `{ "strategyId": 1 }`。
-
-`result` 为 `BizLineStrategySpendVO`：`totalSpend` 策略周期内关联项目周表消耗汇总。
-
-### 17. 导出全部策略
-
-`POST /sino-opti-hive/biz-line/strategy/exprot-all`，请求体 `{ "bizLineId": 1251 }`。
-
-`result` 为导出文件的访问 URL 字符串（由 Excel 写入组件返回）。
-
----
-
-## 枚举速查
-
-| 枚举 | 取值 |
-| --- | --- |
-| `BizLineStatusEnum` | `1` 进行中、`2` 已完成、`3` 已暂停 |
-| `TrafficLightEnum` | `1` KPI 达标、`2` 距 GAP 20% 内、`3` 距 GAP 20% 以上、`4` 已暂停、`5` 存在风险、`6` KPI 达标且项目顺利 |
-| `CustomerSatisfactionEnum` | `1` 满意、`2` 不满意 |
-| 策略效果 | `1` 有效、`2` 无效、`3` 待观察 |
-| `strategyControlDegree` | `1` 弱（以客户策略为主）、`2` 强（以我方提供策略）、`3` 中（与客户共创） |
-| `ProjectRatingEnum` | `S` / `A` / `B` / `C` |
-
----
-
-## 命令调用
-
-```bash
-# 写操作有 Shortcut：先预览，确认后追加 --yes
-sino-bc-cli biz-line +status --id <业务线 ID> --status 3 --dry-run
-sino-bc-cli biz-line +status --id <业务线 ID> --status 3 --yes
-
-# 其余接口按 name 点名调用
-sino-bc-cli biz-line api biz-line-strategy-detail --data '{"bizLineId":123,"id":1}'
-
-# 切换环境（test / pre / prod）
-sino-bc-cli /set-config env test
-```
-
-详见 [README.md](./README.md)。

package/dist/skills/sino-bc-biz-line/references/enums.md

@@ -1,7 +0,0 @@
-# 业务线枚举口径
-
-- 红绿灯：`1` / `6` 绿，`2` / `5` 黄，`3` / `4` 红。
-- 客户满意度：`1` 满意，`2` 不满意。
-- 业务线状态：`1` 进行中 / `2` 已完成 / `3` 已暂停。
-
-字段含义与请求体形状以 `src/api-doc/biz-line-query.md`、`biz-line-strategy.md` 为准。

package/dist/skills/sino-bc-biz-line/references/long-tail-api.md

@@ -1,16 +0,0 @@
-# 长尾接口（无 Shortcut）
-
-用 `sino-bc-cli biz-line api <name> --data '<json>'`。`<name>` 取自 `/api-list`，不要发明新 name。
-
-| 用户在问 | name | 注意 |
-| --- | --- | --- |
-| 业务线分页列表 | `biz-line-list` | |
-| 业务线详情 | `biz-line-detail` | `{ "id": <bizLineId> }` |
-| 导出业务线列表 | `biz-line-list-export` | `result` 为文件 URL |
-| 周策略分页 / 详情 / 周期列表 | `biz-line-strategy-list` / `biz-line-strategy-detail` / `biz-line-strategy-period-list` | |
-| 新建策略前看上期摘要 | `biz-line-strategy-preview-info` | 周期为自然周 周一~周日 |
-| 两期策略对比 | `biz-line-strategy-compare` | |
-| 策略周期消耗 | `biz-line-strategy-spend` | |
-| 导出该业务线全部策略 | `biz-line-strategy-export-all` | 路径拼写是 `exprot-all`，不要改成 export |
-
-描述含 ⚠️ 的 name 同样走确认门。请求体按用户条件组装，禁止原样提交文档示例业务线 ID。

package/dist/skills/sino-bc-shared/references/mcp-reload.md

@@ -1,9 +0,0 @@
-# MCP 配置分发
-
-iCenter 及其他 MCP **不走**本 CLI 接口清单。
-
-1. 用户把 Server 写进 `~/.sino-bc-cli/mcp.json`（与 Cursor 同结构）。
-2. 执行 `sino-bc-cli /mcp-reload`（`/init` 结束时也会跑一次）。
-3. CLI 同步到 Cursor / Codex / Claude / VS Code，并对带 `url` 的 Server 做 initialize 握手。
-
-改了 `mcp.json` 却不重启，各 IDE 不会看到新 Server。查 iCenter 广告策略时用已配置的 MCP 工具，不要改走 `biz-line`。