sino-bc-cli 1.8.8 → 1.8.10

package/README.md

@@ -322,10 +322,10 @@ sino-bc-cli /init
 
 | 命令        | 说明                                                                                          |
 | :---------- | :-------------------------------------------------------------------------------------------- |
-| `/init`       | 注册唯一技能 `sino-bc-cli` 到 Agent 技能目录（并删除旧平级 `sino-bc-shared` / `sino-bc-<domain>`），交互设置环境 / `API_KEY` |
+| `/init`       | 注册唯一技能 `sino-bc-cli` 到 Agent 技能目录（并删除旧平级 `sino-bc-shared` / `sino-bc-<domain>`），交互设置环境 / `API_KEY` / `APIFOX_TOKEN` |
 | `/skill`      | 列出包内 Agent 技能；传入 name 打开对应 `SKILL.md` |
 | `/get-config` | 查看变量配置；密钥默认打码，`--show-secret` 显示明文，`--json` 输出 JSON |
-| `/set-config` | 修改变量配置（环境 / API_KEY / 维护者的 `apifox-token`）；不带参数时逐项交互修改环境与 API_KEY |
+| `/set-config` | 修改变量配置（环境 / API_KEY / 维护者的 `APIFOX_TOKEN`）；不带参数时逐项交互修改环境与 API_KEY；`/set-config APIFOX_TOKEN` 省略取值写入内置默认 |
 | `/uninstall`  | 删除技能目录与变量配置文件，并从全局 npm 卸载本 CLI |
 | `/bc-api`     | **已下线**。只打印迁移提示并非 0 退出，改用 `biz-line +<shortcut>` 或 `biz-line api <name>` |
 
@@ -348,8 +348,8 @@ sino-bc-cli /init
 | 参数 | 说明 |
 | :--- | :--- |
 | `--format json\|table` | 输出格式。TTY 默认 `table`，非 TTY 默认 `json` |
-| `--dry-run` | 只打印将要发起的 method / URL / 请求体，不发请求 |
-| `--yes` | 跳过写操作确认，直接发起请求 |
+| `--dry-run` | 走与真实请求相同的本地 dry-run，只打印将要发起的 method / URL / 请求体，不发请求 |
+| `--yes` | 跳过写操作确认；本地 dry-run 通过后发起请求 |
 
 ### 输出契约与退出码
 
@@ -376,7 +376,7 @@ sino-bc-cli /init
 | :--- | :--------- | :----- | :--- |
 | `env` | `env` | `prod` | 目标环境，可选 `test` / `pre` / `prod` |
 | `apiKey` | `api-key` | 内置默认 Key | 网关鉴权用的 API Key（业务命令使用） |
-| `apifoxToken` | `apifox-token` | 空 | 仅维护者同步接口文档用（`npm run sync-api-doc`），与业务调用无关；`/init` 不会询问它 |
+| `apifoxToken` | `apifox-token` / `APIFOX_TOKEN` | 未配置为空；`/init` 或 `/set-config` 省略取值时写入内置默认 | 仅维护者同步接口文档用（`npm run sync-api-doc`），与业务调用无关；`/init` 会询问，裸 `/set-config` 不问 |
 
 ```bash
 # 查看（密钥打码）
@@ -390,11 +390,12 @@ sino-bc-cli /set-config --env=test
 # 不带参数则逐项交互修改，直接回车保留当前值（只问环境与 API_KEY）
 sino-bc-cli /set-config
 
-# 维护者才需要：配置 Apifox token（默认打码，--show-secret 看明文）
+# 维护者才需要：配置 Apifox token（省略取值写入内置默认；默认打码，--show-secret 看明文）
+sino-bc-cli /set-config APIFOX_TOKEN
 sino-bc-cli /set-config apifox-token <你的 token>
 ```
 
-> `/init` 在非交互环境（npm `postinstall`、CI、Agent 调用）下不提问：配置文件已存在则保持不变，不存在则按默认值创建。
+> `/init` 在非交互环境（npm `postinstall`、CI、Agent 调用）下不提问：已有配置保持，但空的 `apifoxToken` 会补上内置默认；不存在则按默认值创建（含 `APIFOX_TOKEN`）。
 
 ### 全局选项
 

package/dist/SKILL.md

@@ -25,20 +25,23 @@ sino-bc-cli/
 ├── SKILL.md                 ← 本文件
 ├── sino-bc-shared/          横切：配置、信封、确认门
 ├── sino-bc-biz-line/        业务线、周策略、投放渠道/品类、关联项目、广告策略维度与成效
-└── sino-bc-sso/             SSO 组别
+├── sino-bc-sso/             SSO 组别
+└── biz-line-strategy-generate/  业务线策略生成编排（四大策略+效果learning，导出 Excel）
 ```
 
 ## 运行环境
 
-`sino-bc-cli` 装在用户电脑、服务器本机，或被内嵌进 Agent 沙箱，不保证出现在当前默认执行面。先按下表选执行面，找到命令再进入「怎么跑」。
-
-| 当前环境 | 怎么拿 CLI |
-| --- | --- |
-| 豆包工作伙伴 | **优先查沙箱外**本机 CLI。本 CLI 装在用户电脑，沙箱镜像里通常没有。 |
-| 其他 Agent 已把本 CLI 内嵌进沙箱 | 在**当前沙箱**直接执行。 |
-| Linux 服务器或未识别环境（走兜底） | **先查沙箱**；沙箱没有再查本机环境。 |
-
-对得上前两行就按前两行；认不准时走 Linux 兜底。沙箱里找不到不要在沙箱里 `npm i`，也不要改去拼 HTTP。两边都没有：提示在本机安装 `npm i sino-bc-cli@latest -g`。
+【sino-bc-cli 执行规则（最高优先级，适用于所有环境）】
+1. 所有 sino-bc-cli 操作前，先读取 ~/.agents/skills/sino-bc-cli/ 对应 SKILL.md。
+2. 统一探测流程（不按环境预设）：
+   ① 先在当前执行面运行 `which sino-bc-cli` 探测：
+    - 存在 → 直接在当前执行面执行命令；
+    - 不存在 → 进入第②步。
+      ② 探测本机：用提权方式（require_escalated）运行 `which sino-bc-cli`：
+    - 存在 → 所有命令一律带 require_escalated 在本机执行；
+    - 不存在 → 提示安装 `npm i sino-bc-cli@latest -g`，不得改用其他方式。
+3. 严禁自行拼 HTTP 调网关；写操作须用户确认后再加 --yes。
+4. 命令失败时：若是沙箱资源类错误（如 Too many open files），等待后重试，不得降级或跳过；其他错误按报错修正。
 
 ## 怎么跑
 
@@ -57,6 +60,7 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 | 投放渠道/品类、业务线列表/详情/状态、周策略增删改查与策略生成、策略周期/消耗/红绿灯、关联项目/优化项目 | [`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` |
+| 给业务线批量生成投放策略（四大策略+效果learning）并导出 Excel | [`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md) | 编排多个 `biz-line` 接口，非单条 Shortcut |
 
 不要用本技能处理：本仓库源码开发、扩展命令、npm 发版（见仓库 `README.md` / `ReleaseSteps.md`）。
 

package/dist/affordance/biz-line.md

@@ -22,13 +22,13 @@
 
 ## +update
 
-- **WHEN**：编辑业务线 （写操作需 --yes）
+- **WHEN**：更新业务线 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +update --data '{...}'`
 
 ## +status
 
-- **WHEN**：切换业务线状态 （写操作需 --yes）
+- **WHEN**：更新业务线状态 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +status --data '{...}'`
 
@@ -38,39 +38,33 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +delete --data '{...}'`
 
-## +period-list
-
-- **WHEN**：策略周期列表
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +period-list --data '{...}'`
-
 ## +strategies
 
-- **WHEN**：查询策略分页列表
+- **WHEN**：查询投放策略分页列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategies --data '{...}'`
 
 ## +spend
 
-- **WHEN**：策略周期内关联项目周表消耗汇总
+- **WHEN**：查询投放策略消耗信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +spend --data '{...}'`
 
 ## +strategy-save
 
-- **WHEN**：新建策略 （写操作需 --yes）
+- **WHEN**：新建投放策略 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-save --data '{...}'`
 
 ## +strategy-update
 
-- **WHEN**：编辑策略 （写操作需 --yes）
+- **WHEN**：更新投放策略 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-update --data '{...}'`
 
 ## +strategy-delete
 
-- **WHEN**：删除策略 （写操作需 --yes）
+- **WHEN**：删除投放策略 （写操作需 --yes）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +strategy-delete --data '{...}'`
 
@@ -82,19 +76,19 @@
 
 ## +categories
 
-- **WHEN**：查询投放品类字典树
+- **WHEN**：查询投放品类字典
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +categories`
 
 ## +project-list
 
-- **WHEN**：业务线关联项目列表
+- **WHEN**：查询业务线关联项目和广告账号
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +project-list --data '{...}'`
 
 ## +queryByPage
 
-- **WHEN**：查询优化项目分页列表
+- **WHEN**：查询项目分页列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +queryByPage --data '{...}'`
 

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

@@ -10,10 +10,10 @@
 
 `GET /sino-opti-hive/biz-line-open/channels`
 
-无入参，返回 ChannelEnum 全量：code = 枚举 id（即 list 的 mediaChannelId），name = 渠道名称。
+查询投放渠道列表
 
-## 2. 查询投放品类字典树
+## 2. 查询投放品类字典
 
 `GET /sino-opti-hive/biz-line-open/placement-categories`
 
-无入参，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。
+查询投放品类字典，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。

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

@@ -10,11 +10,7 @@
 
 `POST /sino-opti-hive/biz-line/list`
 
-result 为公司分页对象：total=总条数，result=当前页的 BizLineListVO 列表。
-
-核心指标字段有两个，含义不同不要混用：coreIndex = 业务线核心指标（业务线维度的 KPI 口径说明，来源业务线配置，与策略周期无关）；coreEffectIndex = 当期策略回顾里的核心效果指标（随策略周期变化，另有 prevCoreEffectIndex 为上期值）。
-
-需要查看某条业务线下挂了哪些项目及其广告账号时，用 result.result[].id 调 POST /sino-opti-hive/biz-line/project-list。
+查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。
 
 **请求体**
 
@@ -42,7 +38,13 @@ result 为公司分页对象：total=总条数，result=当前页的 BizLineList
 
 `POST /sino-opti-hive/biz-line/detail`
 
-result 为 BizLineDetailVO。
+业务线详情
+
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer |  |
 
 ## 3. 新建业务线
 
@@ -50,35 +52,96 @@ result 为 BizLineDetailVO。
 
 ⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。
 
-## 4. 编辑业务线
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `name` | string | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
+| `strategyControlDegree` | integer | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
+| `adCategoryProjectIds` | array | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | 投放品类-其他说明 |
+| `customerTypeIds` | array | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | 客户类型-其他说明 |
+| `amUserIds` | array | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | 核心指标 |
+| `monthlyMaterialCount` | string | 月度上新素材量 |
+| `projectInitStatus` | string | 项目初始化状态 |
+| `projectBrief` | string | 项目 Brief |
+| `corporationIds` | array | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | 关联项目 ID |
+| `ssoTeamCode` | string | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+
+## 4. 更新业务线
 
 `POST /sino-opti-hive/biz-line/update`
 
-⚠️ 写操作。成功时 result 为 Boolean，表示是否更新成功。
+更新业务线信息
 
-## 5. 切换业务线状态
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `status` | integer | 状态：1进行中 2已完成 3已暂停 |
+| `name` | string | 业务线名称，业务/产品线名称不可重复 |
+| `mediaChannels` | array | 投放渠道 code。通过 GET /sino-opti-hive/biz-line-open/channels 取 code；名称见同接口 name |
+| `strategyControlDegree` | integer | 策略掌控程度：1弱（以客户策略为主） 2强（以我方提供策略） 3中（与客户共创） |
+| `adCategoryIndustryIds` | array | 投放行业 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取一级节点 id |
+| `adCategoryProjectIds` | array | 投放品类 ID。通过 GET /sino-opti-hive/biz-line-open/placement-categories 取二级 children.id；选其他时可为空，改填 adCategoryOther |
+| `adCategoryOther` | string | 投放品类-其他说明 |
+| `customerTypeIds` | array | 客户类型 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=CUSTOMER_TYPE 取 id |
+| `customerTypeOther` | string | 客户类型-其他说明 |
+| `amUserIds` | array | AM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `pmUserIds` | array | PM 用户 ID。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId；也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `customerInfrastructure` | array | 1=数据追踪方式：AdJust，2=数据追踪方式：AF，3=数据追踪方式：其他MMP，4=数据追踪方式：客户BI，5=数据追踪方式：媒体后台，6=素材产出方式：CB，7=素材产出方式：客户提供，8=素材产出方式：内部设计师制作，9=素材产出方式：无需素材（ASA、推流等），10=基建情况：基建完善，11=基建情况：三方回传数据异常，12=基建情况：APP埋点异常 |
+| `coreIndex` | string | 核心指标 |
+| `monthlyMaterialCount` | string | 月度上新素材量 |
+| `projectInitStatus` | string | 项目初始化状态 |
+| `projectBrief` | string | 项目 Brief |
+| `corporationIds` | array | 关联签约主体 ID（字符串）。通过 POST /sino-opti-hive/corporation/page 获取签约主体 ID |
+| `projectIds` | array | 关联项目 ID。通过 POST /sino-opti-hive/optimize/project/queryByPage 获取；按 ID 反查名称用 POST /sino-opti-hive/optimize/project/listByIds |
+| `ssoTeamCode` | string | 组别 code，单选，必填。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `businessRegion` | string | EAST_CHINA=华东，SOUTH_CHINA=华南，NORTH_CHINA=华北。必填 |
+| `projectRating` | string | S、A、B、C。非新客必填 |
+| `newCustomerTag` | string | NEW_TAG=是（新客），NONE_NEW_TAG=否（非新客） |
+
+## 5. 更新业务线状态
 
 `POST /sino-opti-hive/biz-line/status/update`
 
 ⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。
 
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer |  |
+| `status` | integer | 状态：1进行中 2已完成 3已暂停；对应 BizLineStatusEnum |
+
 ## 6. 删除业务线
 
 `POST /sino-opti-hive/biz-line/del`
 
 ⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
 
-## 7. 策略周期列表
-
-`POST /sino-opti-hive/biz-line/strategy/period-list`
+**请求体**
 
-result 为 BizLineStrategyPeriodListVO，含 items 与 total。
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer |  |
 
-## 8. 查询策略分页列表
+## 7. 查询投放策略分页列表
 
 `POST /sino-opti-hive/biz-line/strategy/list`
 
-result 为公司分页对象：total=总条数，result=当前页的 BizLineStrategyDetailVO 列表。
+查询投放策略分页列表
 
 **请求体**
 
@@ -86,67 +149,174 @@ result 为公司分页对象：total=总条数，result=当前页的 BizLineStra
 | --- | --- | --- |
 | `pageNum` | integer | 页码，从 1 开始 |
 | `pageSize` | integer | 每页条数 |
-| `sortDirection` | string | DESC 或 ASC，默认 DESC |
-| `bizLineId` | integer | 可选。不传则按权限查全部可见业务线。通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `sortDirection` | string | 创建日期排序 DESC 或 ASC，默认 DESC |
+| `bizLineId` | integer | 可选，不传则按权限查全部可见业务线。 |
 | `trafficLight` | integer | 红绿灯筛选（策略表现）：1=绿灯KPI达标，2=黄灯距KPIGAP20%内，3=红灯距KPIGAP20%以上，4=红灯已暂停，5=黄灯存在风险，6=绿灯KPI达标且项目顺利。 |
 
-## 9. 策略周期内关联项目周表消耗汇总
+## 8. 查询投放策略消耗信息
 
 `POST /sino-opti-hive/biz-line/strategy/spend`
 
-result 为 BizLineStrategySpendVO，含 totalSpend。
+查询投放策略消耗信息
+
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `strategyId` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
-## 10. 新建策略
+## 9. 新建投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/save`
 
-⚠️ 写操作。成功时 result 为 Boolean，表示是否保存成功。
+新建投放策略，投放策略按周填写
 
-## 11. 编辑策略
+**请求体**
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `bizLineId` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `periodStart` | string | 策略周期起（日期） |
+| `periodEnd` | string | 策略周期止（日期） |
+| `budgetStrategyTags` | array | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | 预算策略补充说明 |
+| `mediaStrategyTags` | array | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | 受众策略补充说明 |
+| `creativeStrategy` | string | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | 项目问题&机会，最大 5000 字 |
+| `spend` | string | 周期投放消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | 预算策略 learning |
+| `mediaStrategyEffect` | integer | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | 受众策略 learning |
+| `creativeStrategyEffect` | integer | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | 素材策略 learning |
+
+## 10. 更新投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/update`
 
-⚠️ 写操作。成功时 result 为 Boolean。version 为乐观锁；overwrite=true 强制覆盖。
+更新投放策略
+
+**请求体**
 
-## 12. 删除策略
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
+| `version` | integer | 乐观锁版本号 |
+| `overwrite` | boolean | 默认 false：版本冲突则报错；true 强制覆盖 |
+| `bizLineId` | integer | 通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+| `periodStart` | string | 策略周期起（日期） |
+| `periodEnd` | string | 策略周期止（日期） |
+| `budgetStrategyTags` | array | 预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `budgetStrategySupplement` | string | 预算策略补充说明 |
+| `mediaStrategyTags` | array | 媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `mediaStrategySupplement` | string | 媒介策略补充说明 |
+| `audienceStrategyTags` | array | 受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `audienceStrategySupplement` | string | 受众策略补充说明 |
+| `creativeStrategy` | string | 素材创意策略说明，最大 5000 字 |
+| `previewPeriodStart` | string | 上期（preview）策略周期起；缺省为本期 periodStart 的上一自然周周一 |
+| `previewPeriodEnd` | string | 上期（preview）策略周期止；缺省为 previewPeriodStart+6（周日） |
+| `previewBudgetStrategyTags` | array | 上期预算策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY 取 id |
+| `previewBudgetStrategySupplement` | string | 上期预算策略补充说明 |
+| `previewMediaStrategyTags` | array | 上期媒介策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=MEDIA_STRATEGY 取 id |
+| `previewMediaStrategySupplement` | string | 上期媒介策略补充说明 |
+| `previewAudienceStrategyTags` | array | 上期受众策略标签 ID。通过 GET /sino-opti-hive/dict/items?sceneCode=AUDIENCE_STRATEGY 取 id |
+| `previewAudienceStrategySupplement` | string | 上期受众策略补充说明 |
+| `previewCreativeStrategy` | string | 上期素材创意策略说明，最大 5000 字 |
+| `trafficLight` | integer | 红绿灯：1 KPI达标、2 距GAP 20%内、3 距GAP 20%以上、4 已暂停、5 存在风险、6 KPI达标且项目顺利 |
+| `coreIssueCategories` | array | 1=受众策略问题，2=跨媒介策略问题，3=媒介广告产品使用策略问题，4=出价策略问题，5=素材策略问题，6=素材执行问题，7=素材管理问题，8=投放规划问题，9=媒体素材政策/尺度/风控问题，10=媒体适配/潜力问题，11=市场选择/竞争问题，12=客户对接不顺畅，13=客户侧：数据对接问题，14=客户侧：产品问题/投放生命周期问题，15=客户侧：运营/基建问题，16=客户侧：存在投放限制，17=客户侧：转自投，18=客户侧：需求临时无规划，19=客户侧：KPI不合理，20=投放生命周期问题/素材疲劳问题，21=内部团队人员调配问题，22=其他 |
+| `issuesAndOpportunities` | string | 项目问题&机会，最大 5000 字 |
+| `spend` | string | 周期消耗（回顾，展示用字符串），最大 50 字 |
+| `customerSatisfaction` | integer | 客户满意度：1满意 2不满意 |
+| `satisfactionReason` | string | 满意度原因说明，最大 5000 字 |
+| `coreEffectIndex` | string | 核心效果指标，最大 5000 字 |
+| `budgetStrategyEffect` | integer | 预算策略效果：1有效 2无效 3待观察 |
+| `budgetStrategyLearning` | string | 预算策略 learning |
+| `mediaStrategyEffect` | integer | 媒介策略效果：1有效 2无效 3待观察 |
+| `mediaStrategyLearning` | string | 媒介策略 learning |
+| `audienceStrategyEffect` | integer | 受众策略效果：1有效 2无效 3待观察 |
+| `audienceStrategyLearning` | string | 受众策略 learning |
+| `creativeStrategyEffect` | integer | 素材策略效果：1有效 2无效 3待观察 |
+| `creativeStrategyLearning` | string | 素材策略 learning |
+
+## 11. 删除投放策略
 
 `POST /sino-opti-hive/biz-line/strategy/del`
 
-⚠️ 写操作。成功时 result 为 Boolean，表示是否删除成功。
+删除投放策略
 
-## 13. 业务线关联项目列表
+**请求体**
 
-`POST /sino-opti-hive/biz-line/project-list`
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `id` | integer | 通过 POST /sino-opti-hive/biz-line/strategy/list 取 result.id，或 POST /sino-opti-hive/biz-line/strategy/period-list 取 items.id |
 
-按业务线 ID 查询该业务线绑定的项目列表，每个项目附带其绑定的广告账号。
+## 12. 查询业务线关联项目和广告账号
 
-用途：已知业务线时，查看它下面挂了哪些项目、每个项目在投哪些渠道的哪些广告账号。常用于业务线消耗/成效数据的下钻，或校对业务线与项目的关联关系。
+`POST /sino-opti-hive/biz-line/project-list`
 
-入参：bizLineId（必填，业务线 ID）。业务线 ID 从 POST /sino-opti-hive/biz-line/list 的 result.result[].id 获得。
+根据业务线 ID 查询业务线关联项目和广告账号
 
-返回：result 为项目数组，不分页、返回全量，元素含 projectId、projectName、adAccounts（广告账号列表，元素含 adAccountId、channelId、channelName）。
 
-注意事项：
-1. 只返回未删除的关联关系，且项目本身已删除的会被过滤，因此返回的项目数可能少于业务线实际配置过的项目数。
-2. adAccounts 只含分配状态为「已绑定」且未删除的广告账号；项目没有绑定账号时 adAccounts 为空数组，不是 null。
-3. channelName 由服务端按 channelId 从渠道缓存解析，缓存未命中时为 null，此时以 channelId 为准（取值同 GET /sino-opti-hive/biz-line-open/channels 的 code）。
-4. 业务线不存在、或没有任何有效关联项目时，返回空数组而不是报错。
+**请求体**
 
-## 14. 查询优化项目分页列表
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `bizLineId` | integer | 业务线 ID，必填 |
 
-`POST /sino-opti-hive/optimize/project/queryByPage`
+## 13. 查询项目分页列表
 
-分页查询优化工作台项目列表。常用于给业务线挑选关联项目：出参 projectId 填入 POST /sino-opti-hive/biz-line/save（或 /update）的 projectIds。
+`POST /sino-opti-hive/optimize/project/queryByPage`
 
-result 为公司分页对象：total=总条数，result=当前页 OptimizeProjectVO。
+查询项目分页列表
 
-注意事项：
-1. userId 由网关注入，不要传。
-2. 不传 serviceCodeList 时，服务端默认只查代投类项目（code=1、85）。
-3. 排序用 sortType（lastWeekSpend / lastWeekSpendQoq / createTime）和 sortDirection（ASC/DESC），默认创建时间倒序。
-4. PageRequest 里 pagination、count、startIndex 等本接口未使用，不要传。
+**请求体**
 
-## 15. Facebook广告策略维度数据
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `pageNum` | integer | 页码，从 1 开始 |
+| `pageSize` | integer | 每页条数 |
+| `sortType` | string | lastWeekSpend=上周消耗；lastWeekSpendQoq=上周消耗环比；createTime=创建时间。不传默认 createTime |
+| `sortDirection` | string | ASC 升序，DESC 降序；默认 DESC |
+| `corporationId` | integer | 签约主体 ID |
+| `corporationIdList` | array | 签约主体 ID 多选 |
+| `projectId` | integer | 项目 ID，精确匹配 |
+| `projectIdList` | array | 项目 ID 多选。已知 ID 时直接传入；本接口出参 projectId 也可回填 |
+| `projectName` | string | 项目名称，模糊查询 |
+| `projectKeyword` | string | 项目 ID 精确，或项目名称分词模糊（空格分词，词之间 AND） |
+| `startDate` | string | 项目周期开始日期 yyyy-MM-dd |
+| `endDate` | string | 项目周期结束日期 yyyy-MM-dd |
+| `projectUserIdList` | array | 项目成员用户 ID 多选。通过 POST /sino-opti-hive/sso-team/getMemberList 取 userId，也可 POST /sino-opti-hive/user/getSsoUserList 按姓名搜 |
+| `ssoTeamCodeList` | array | 组别 code 多选，按该组别下 PM 成员筛项目。通过 GET /sino-opti-hive/sso-team/group-list 取 code |
+| `adAccountId` | string | 广告账号 ID 模糊查询，至少 2 个字符 |
+| `demandOrderKeyword` | string | 需求单编号精确，或需求单名称分词模糊（空格分词） |
+| `signalLightList` | array | 项目红绿灯多选，与出参 signalLight 同值（字符串，不是业务线策略 trafficLight 的整数枚举） |
+| `projectStatusList` | array | 项目执行状态多选。本接口查的是项目（非需求）：4=待分配，5=执行中，6=已暂停，7=已完成，8=终止。出参 projectStatusName 为对应中文名 |
+| `isLast7DSpend` | array | 0=否，1=是。仅传一个值时生效；同时传 0 和 1 等于不筛 |
+| `uploadInfoTypeList` | array | 0=无上传，1=仅上传brief，2=仅上传mediaPlan，3=上传brief和mediaPlan。多选 |
+| `serviceCodeList` | array | 服务/产品 code 多选。不传时服务端默认 1、85（代投类项目） |
+| `bizLineIdList` | array | 按已关联业务线过滤项目。通过 POST /sino-opti-hive/biz-line/list 取 result.id |
+
+## 14. Facebook广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/facebook/ad/list`
 
@@ -203,7 +373,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | 页码，从 1 开始，默认 1。 |
 | `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 16. Google广告策略维度数据
+## 15. Google广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/google/ad/list`
 
@@ -229,10 +399,11 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `dimensions` | array | 分组维度，必传且不能为空数组，否则返回结果为空。各维度含义：calendar_date（投放日期）、account_id（广告账户ID）、account_name（广告账户名称）、campaign_id（广告系列ID）、campaign_name（广告系列名称）、adgroup_id（广告组ID）、adgroup_name（广告组名称）、ad_id（广告ID）、ad_name（广告名称）、optimization_goal（成效目标）、ad_format（创意类型）、bid_strategy（出价方式）、audience_type（受众类型）、targeting_age（年龄）、targeting_genders（性别）、cpc_bid_amount（CPC出价）、cpm_bid_amount（CPM出价）、cpv_bid_amount（CPV出价）、advertising_channel_type（广告系列类型）、keywords（关键字）、country_code（国家，必须单独传，不能和其他维度同时传） |
 | `order` | string | 排序字段，填单个 code，取值范围为 dimensions 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
 | `orderType` | string | 排序方向，默认 asc |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"calendar_date":"desc","account_id":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 17. TikTok广告策略维度数据
+## 16. TikTok广告策略维度数据
 
 `POST /sino-icenter/mcp/strategy/dimension/tiktok/ad/list`
 
@@ -289,7 +460,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 | `page` | integer | 页码，从 1 开始，默认 1。 |
 | `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 18. Facebook广告策略成效数据
+## 17. Facebook广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/facebook/ad/list`
 
@@ -351,7 +522,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `page` | integer | 页码，从 1 开始，默认 1。 |
 | `size` | integer | 每页条数，默认 10，建议显式指定。返回的 result.total 为总条数，据此判断是否还有下一页。 |
 
-## 19. Google广告策略成效数据
+## 18. Google广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/google/ad/list`
 
@@ -377,10 +548,11 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `indicators` | array | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
 | `order` | string | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
 | `orderType` | string | 排序方向，默认 asc |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |
 
-## 20. TikTok广告策略成效数据
+## 19. TikTok广告策略成效数据
 
 `POST /sino-icenter/mcp/strategy/metrics/tiktok/ad/list`
 
@@ -406,5 +578,6 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 | `indicators` | array | 成效指标，必传且不能为空数组。各指标含义：spend_usd（消耗金额，美元）、impressions（曝光量）、clicks（点击量）、video_views（视频观看次数）、add_to_cart（添加购物车次数）、checkouts（发起结账次数）、purchase（购买次数）、purchase_value（购买金额，美元）、installs（应用安装量）、complete_registration（完成注册量）、leads（留下潜客信息次数）、engagement（互动次数） |
 | `order` | string | 排序字段，填单个 code，取值范围为 dimensions 或 indicators 的可选值。不必包含在已传的字段中，服务端会自动补入参与排序，但该字段不会作为列返回 |
 | `orderType` | string | 排序方向，默认 asc |
+| `orders` | object | 多字段排序，结构为「字段名 → 排序方向」的有序键值对（Java 类型 LinkedHashMap<String, String>），按 key 的书写顺序依次排序，方向取值 desc 或 asc。示例：{"spend_usd":"desc","clicks":"asc"}。只需单字段排序时用 order + orderType 即可，不必传本字段。 |
 | `page` | integer | 页码，从1开始，默认1 |
 | `size` | integer | 每页条数，默认10，建议显式传且不超过1000 |

package/dist/api-doc/oapi/sso.md

@@ -10,4 +10,4 @@
 
 `GET /sino-opti-hive/sso-team/group-list`
 
-无入参。返回 SSO 组别全量：code = teamCode（业务线 ssoTeamCode / ssoTeamCodeList），name = 组别名称。AccessContext 由网关注入，不出现在协议里。
+查询组别列表