npm - sino-bc-cli - Versions diffs - 1.8.24 → 1.8.25 - Mend

sino-bc-cli 1.8.24 → 1.8.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (31) hide show

package/dist/SKILL.md CHANGED Viewed

@@ -1,16 +1,18 @@
 ---
 name: sino-bc-cli
 description: >
-  Use when 查询或操作 BeyondClick 业务线、周策略、投放品类、关联项目、广告策略维度与成效、广告投放媒体渠道，或配置 sino-bc-cli：
+  Use when 查询或操作 BeyondClick 业务线、周策略、投放品类、策略标签、AI策略、关联项目、广告策略维度与成效、广告投放媒体渠道，或配置 sino-bc-cli：
   投放品类、业务线列表/详情/状态、周策略增删改查、策略周期/消耗/红绿灯、优化项目、投放渠道；
   生成业务线投放策略并导出 Excel（预算/广告产品/受众/素材及 learning）；
+  保存业务线 AI 策略；通用文件上传与按 storageKey 取下载链接；
   Facebook / Google / TikTok 广告策略维度（目标、出价、定向等配置分布）
   与广告策略成效（消耗、曝光、点击等）；
   SSO 组别；  以及 /init、/update、/get-config、/set-config、/schema。
   也用于优化项目月度分析、消耗与工时趋势、优化师人效、Excel 报表导出（project-analysis），
-  以及营销协同项目、阶段、任务、文档、文件、投放数据、看板、飞书消息、组织用户、租户和用户资料接口。
-  用户提到业务线、周策略、策略生成、广告结构、广告层级、广告成效、广告策略维度、biz-line、
-  Meta、Facebook、Google、TikTok、sso、user、sino-opti-hive、sino-bc-nexus、营销协同时也必须用本技能，不要自己拼 HTTP。
+  以及营销协同项目、阶段、任务、文档、文件、投放数据、看板、飞书消息、组织用户、租户和用户资料接口，
+  以及财务对账单、发票结算、月度对账、后付额度与预付钱包。
+  用户提到业务线、周策略、策略生成、AI策略、策略标签、通用文件、对账单、钱包、广告结构、广告层级、广告成效、广告策略维度、biz-line、
+  Meta、Facebook、Google、TikTok、sso、user、sino-opti-hive、sino-bc-nexus、bc-business-pu、营销协同时也必须用本技能，不要自己拼 HTTP。
   完整规则在子技能 sino-bc-shared、sino-bc-<domain> 与额外专家技能。
 metadata:
   requires:
@@ -28,8 +30,9 @@ sino-bc-cli/
 ├── SKILL.md                   ← 本文件
 ├── sino-bc-shared/            横切：配置、信封、确认门
 ├── sino-bc-auth/              身份令牌与浏览器授权
-├── sino-bc-biz-line/          业务线、周策略、投放品类、广告策略维度与成效
+├── sino-bc-biz-line/          业务线、周策略、投放品类、策略标签、AI策略、广告策略维度与成效
 ├── biz-line-strategy-generate/ 编排：四大策略 + Excel
+├── sino-bc-common-file/       通用文件上传与下载链接
 ├── sino-bc-media/             广告投放媒体：投放渠道等媒体字典
 ├── sino-bc-sso/               SSO 组别
 ├── sino-bc-tenant/            签约主体
@@ -39,6 +42,7 @@ sino-bc-cli/
 ├── sino-bc-task/              营销协同任务交付闭环
 ├── sino-bc-document/          营销协同文档中心与项目文档
 ├── sino-bc-file/              营销协同文件上传
+├── sino-bc-wallet/            财务对账单、发票、钱包
 ├── sino-bc-delivery/          营销协同投放数据与 Campaign 归集
 ├── sino-bc-dashboard/         营销协同看板
 ├── sino-bc-im/                营销协同飞书群消息
@@ -79,8 +83,9 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 | --- | --- | --- |
 | 身份令牌、网关地址、成功/失败怎么看、写操作要不要确认 | [`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md) | `/auth login` `/set-config auth-token <AT> [RT]` `/get-config` |
 | 浏览器授权登录、身份令牌状态、清除凭证、查询可用签约主体 | 同上 | `/auth login\|status\|logout` `/tenant list` |
-| 投放品类、业务线列表/详情/状态、周策略增删改查、策略周期/消耗/红绿灯、关联项目/优化项目 | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
+| 投放品类、策略标签、业务线列表/详情/状态、周策略增删改查、保存 AI 策略、策略周期/消耗/红绿灯、关联项目/优化项目 | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>` |
 | 生成业务线投放策略并导出 Excel（预算/广告产品/受众/素材及 learning） | [`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md) | `scripts/run_workflow.py`（Python 3；最多 3 条并发，逐条清理，仅留最终 Excel） |
+| 通用文件上传、按 storageKey 取下载链接（策略 Excel 等） | [`sino-bc-common-file/SKILL.md`](sino-bc-common-file/SKILL.md) | `common-file +upload` / `+url` |
 | 投放渠道、广告投放媒体字典 | [`sino-bc-media/SKILL.md`](sino-bc-media/SKILL.md) | `media +channels` |
 | Facebook / Google / TikTok 广告策略维度（目标、出价、定向等配置分布）或广告策略成效（消耗、曝光、点击等） | [`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md) | `biz-line +<shortcut>`（维度 / 成效） |
 | SSO 组别 | [`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md) | `sso +group-list` |
@@ -90,6 +95,7 @@ CLI 未安装：`npm i sino-bc-cli@latest -g`（Node.js >= 24）。技能未出
 | 营销协同任务交付闭环、审核/确认/暂停 | [`sino-bc-task/SKILL.md`](sino-bc-task/SKILL.md) | `task api <name>` |
 | 营销协同文档中心、项目文档 | [`sino-bc-document/SKILL.md`](sino-bc-document/SKILL.md) | `document api <name>` |
 | 营销协同文件上传与下载链接 | [`sino-bc-file/SKILL.md`](sino-bc-file/SKILL.md) | `file api <name>` |
+| 财务对账单、发票结算、月度对账、后付额度、预付钱包 | [`sino-bc-wallet/SKILL.md`](sino-bc-wallet/SKILL.md) | `wallet +<shortcut>` |
 | 营销协同投放数据、Campaign 归集、阶段指标 | [`sino-bc-delivery/SKILL.md`](sino-bc-delivery/SKILL.md) | `delivery api <name>` |
 | 营销协同看板预算分布与时间轴 | [`sino-bc-dashboard/SKILL.md`](sino-bc-dashboard/SKILL.md) | `dashboard api <name>` |
 | 营销协同飞书群消息 | [`sino-bc-im/SKILL.md`](sino-bc-im/SKILL.md) | `im api <name>` |
@@ -104,22 +110,24 @@ Agent 先读子技能 `sino-bc-shared`，再按意图读域技能或额外专家
 1. 配置、信封、确认门、禁止拼 HTTP：[`sino-bc-shared/SKILL.md`](sino-bc-shared/SKILL.md)（仓库 [`skills/default/sino-bc-shared/SKILL.md`](skills/default/sino-bc-shared/SKILL.md)）
 2. 身份令牌与浏览器授权：[`sino-bc-auth/SKILL.md`](sino-bc-auth/SKILL.md)（仓库 [`skills/oapi/sino-bc-auth/SKILL.md`](skills/oapi/sino-bc-auth/SKILL.md)）
-3. 业务线、周策略、投放品类、关联项目、广告策略维度与成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
-4. 营销协同看板：预算分布、项目分布与关键项目时间轴：[`sino-bc-dashboard/SKILL.md`](sino-bc-dashboard/SKILL.md)（仓库 [`skills/oapi/sino-bc-dashboard/SKILL.md`](skills/oapi/sino-bc-dashboard/SKILL.md)）
-5. 营销协同投放数据：Campaign 归集与投放阶段指标：[`sino-bc-delivery/SKILL.md`](sino-bc-delivery/SKILL.md)（仓库 [`skills/oapi/sino-bc-delivery/SKILL.md`](skills/oapi/sino-bc-delivery/SKILL.md)）
-6. 营销协同文档：文档中心与项目文档：[`sino-bc-document/SKILL.md`](sino-bc-document/SKILL.md)（仓库 [`skills/oapi/sino-bc-document/SKILL.md`](skills/oapi/sino-bc-document/SKILL.md)）
-7. 营销协同文件上传与对象存储记录：[`sino-bc-file/SKILL.md`](sino-bc-file/SKILL.md)（仓库 [`skills/oapi/sino-bc-file/SKILL.md`](skills/oapi/sino-bc-file/SKILL.md)）
-8. 营销协同飞书群消息：[`sino-bc-im/SKILL.md`](sino-bc-im/SKILL.md)（仓库 [`skills/oapi/sino-bc-im/SKILL.md`](skills/oapi/sino-bc-im/SKILL.md)）
-9. 广告投放媒体：投放渠道等媒体字典：[`sino-bc-media/SKILL.md`](sino-bc-media/SKILL.md)（仓库 [`skills/oapi/sino-bc-media/SKILL.md`](skills/oapi/sino-bc-media/SKILL.md)）
-10. 组织架构、团队成员与当前用户：[`sino-bc-organization/SKILL.md`](sino-bc-organization/SKILL.md)（仓库 [`skills/oapi/sino-bc-organization/SKILL.md`](skills/oapi/sino-bc-organization/SKILL.md)）
-11. 营销协同项目：生命周期、成员、分组与建项字段：[`sino-bc-project/SKILL.md`](sino-bc-project/SKILL.md)（仓库 [`skills/oapi/sino-bc-project/SKILL.md`](skills/oapi/sino-bc-project/SKILL.md)）
-12. 优化项目月度分析、消耗与工时趋势、优化师人效及 Excel 导出：[`sino-bc-project-analysis/SKILL.md`](sino-bc-project-analysis/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-analysis/SKILL.md`](skills/oapi/sino-bc-project-analysis/SKILL.md)）
-13. 营销协同项目阶段：[`sino-bc-project-stage/SKILL.md`](sino-bc-project-stage/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-stage/SKILL.md`](skills/oapi/sino-bc-project-stage/SKILL.md)）
-14. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/oapi/sino-bc-sso/SKILL.md`](skills/oapi/sino-bc-sso/SKILL.md)）
-15. 营销协同任务：交付闭环与操作日志：[`sino-bc-task/SKILL.md`](sino-bc-task/SKILL.md)（仓库 [`skills/oapi/sino-bc-task/SKILL.md`](skills/oapi/sino-bc-task/SKILL.md)）
-16. 签约主体：[`sino-bc-tenant/SKILL.md`](sino-bc-tenant/SKILL.md)（仓库 [`skills/oapi/sino-bc-tenant/SKILL.md`](skills/oapi/sino-bc-tenant/SKILL.md)）
-17. SSO 用户与签约主体（租户）用户资料：[`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md)（仓库 [`skills/oapi/sino-bc-user/SKILL.md`](skills/oapi/sino-bc-user/SKILL.md)）
-18. 业务线策略生成：[`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md)（仓库 [`skills/custom/biz-line-strategy-generate/SKILL.md`](skills/custom/biz-line-strategy-generate/SKILL.md)）
+3. 业务线、周策略、投放品类、策略标签、AI策略、关联项目、广告策略维度与成效：[`sino-bc-biz-line/SKILL.md`](sino-bc-biz-line/SKILL.md)（仓库 [`skills/oapi/sino-bc-biz-line/SKILL.md`](skills/oapi/sino-bc-biz-line/SKILL.md)）
+4. 通用文件上传与按 storageKey 取下载链接：[`sino-bc-common-file/SKILL.md`](sino-bc-common-file/SKILL.md)（仓库 [`skills/oapi/sino-bc-common-file/SKILL.md`](skills/oapi/sino-bc-common-file/SKILL.md)）
+5. 营销协同看板：预算分布、项目分布与关键项目时间轴：[`sino-bc-dashboard/SKILL.md`](sino-bc-dashboard/SKILL.md)（仓库 [`skills/oapi/sino-bc-dashboard/SKILL.md`](skills/oapi/sino-bc-dashboard/SKILL.md)）
+6. 营销协同投放数据：Campaign 归集与投放阶段指标：[`sino-bc-delivery/SKILL.md`](sino-bc-delivery/SKILL.md)（仓库 [`skills/oapi/sino-bc-delivery/SKILL.md`](skills/oapi/sino-bc-delivery/SKILL.md)）
+7. 营销协同文档：文档中心与项目文档：[`sino-bc-document/SKILL.md`](sino-bc-document/SKILL.md)（仓库 [`skills/oapi/sino-bc-document/SKILL.md`](skills/oapi/sino-bc-document/SKILL.md)）
+8. 营销协同文件上传与对象存储记录：[`sino-bc-file/SKILL.md`](sino-bc-file/SKILL.md)（仓库 [`skills/oapi/sino-bc-file/SKILL.md`](skills/oapi/sino-bc-file/SKILL.md)）
+9. 营销协同飞书群消息：[`sino-bc-im/SKILL.md`](sino-bc-im/SKILL.md)（仓库 [`skills/oapi/sino-bc-im/SKILL.md`](skills/oapi/sino-bc-im/SKILL.md)）
+10. 广告投放媒体：投放渠道等媒体字典：[`sino-bc-media/SKILL.md`](sino-bc-media/SKILL.md)（仓库 [`skills/oapi/sino-bc-media/SKILL.md`](skills/oapi/sino-bc-media/SKILL.md)）
+11. 组织架构、团队成员与当前用户：[`sino-bc-organization/SKILL.md`](sino-bc-organization/SKILL.md)（仓库 [`skills/oapi/sino-bc-organization/SKILL.md`](skills/oapi/sino-bc-organization/SKILL.md)）
+12. 营销协同项目：生命周期、成员、分组与建项字段：[`sino-bc-project/SKILL.md`](sino-bc-project/SKILL.md)（仓库 [`skills/oapi/sino-bc-project/SKILL.md`](skills/oapi/sino-bc-project/SKILL.md)）
+13. 优化项目月度分析、消耗与工时趋势、优化师人效及 Excel 导出：[`sino-bc-project-analysis/SKILL.md`](sino-bc-project-analysis/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-analysis/SKILL.md`](skills/oapi/sino-bc-project-analysis/SKILL.md)）
+14. 营销协同项目阶段：[`sino-bc-project-stage/SKILL.md`](sino-bc-project-stage/SKILL.md)（仓库 [`skills/oapi/sino-bc-project-stage/SKILL.md`](skills/oapi/sino-bc-project-stage/SKILL.md)）
+15. SSO 组别：[`sino-bc-sso/SKILL.md`](sino-bc-sso/SKILL.md)（仓库 [`skills/oapi/sino-bc-sso/SKILL.md`](skills/oapi/sino-bc-sso/SKILL.md)）
+16. 营销协同任务：交付闭环与操作日志：[`sino-bc-task/SKILL.md`](sino-bc-task/SKILL.md)（仓库 [`skills/oapi/sino-bc-task/SKILL.md`](skills/oapi/sino-bc-task/SKILL.md)）
+17. 签约主体：[`sino-bc-tenant/SKILL.md`](sino-bc-tenant/SKILL.md)（仓库 [`skills/oapi/sino-bc-tenant/SKILL.md`](skills/oapi/sino-bc-tenant/SKILL.md)）
+18. SSO 用户与签约主体（租户）用户资料：[`sino-bc-user/SKILL.md`](sino-bc-user/SKILL.md)（仓库 [`skills/oapi/sino-bc-user/SKILL.md`](skills/oapi/sino-bc-user/SKILL.md)）
+19. 财务对账单、发票结算、月度对账、后付额度与预付钱包：[`sino-bc-wallet/SKILL.md`](sino-bc-wallet/SKILL.md)（仓库 [`skills/oapi/sino-bc-wallet/SKILL.md`](skills/oapi/sino-bc-wallet/SKILL.md)）
+20. 业务线策略生成：[`biz-line-strategy-generate/SKILL.md`](biz-line-strategy-generate/SKILL.md)（仓库 [`skills/custom/biz-line-strategy-generate/SKILL.md`](skills/custom/biz-line-strategy-generate/SKILL.md)）
 安装与刷新：

package/dist/affordance/biz-line.md CHANGED Viewed

@@ -70,7 +70,7 @@
 ## +categories
-- **WHEN**：查询业务线和策略投放品类字典
+- **WHEN**：查询业务线字典和策略标签
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +categories --data '{...}'`
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
@@ -123,6 +123,12 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +tiktok-metrics --data '{...}'`
+## +ai-strategy-save
+- **WHEN**：保存业务线AI策略
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +ai-strategy-save --data '{...}'`
 ## api
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/affordance/common-file.md ADDED Viewed

@@ -0,0 +1,23 @@
+# common-file 命令何时用
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+## +upload
+- **WHEN**：上传文件
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli common-file +upload --data '{...}'`
+- **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
+## +url
+- **WHEN**：获取文件下载链接
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli common-file +url --data '{...}'`
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## api
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli common-file api <name> --data '{...}'`

package/dist/affordance/wallet.md ADDED Viewed

@@ -0,0 +1,215 @@
+# wallet 命令何时用
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+## +bill-list
+- **WHEN**：对账单列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +bill-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +bill-detail
+- **WHEN**：对账单基本信息
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +bill-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +bill-original
+- **WHEN**：对账单明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +bill-original --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +bill-operate
+- **WHEN**：对账单操作历史
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +bill-operate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +bill-enum
+- **WHEN**：对账单与发票枚举
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +bill-enum --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +bill-settlements
+- **WHEN**：对账单关联结算单
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +bill-settlements --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +invoice-list
+- **WHEN**：发票结算单列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +invoice-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +invoice-detail
+- **WHEN**：发票结算单详情
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +invoice-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +invoice-pdf
+- **WHEN**：结算单详情 PDF
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +invoice-pdf --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +invoice-download
+- **WHEN**：下载发票
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +invoice-download --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +invoice-payments
+- **WHEN**：结算单还款记录
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +invoice-payments --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +reconciliation
+- **WHEN**：月度对账单列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +reconciliation --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +reconciliation-log
+- **WHEN**：月度对账单发送记录
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +reconciliation-log --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +reconciliation-preview
+- **WHEN**：对账邮件预览
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +reconciliation-preview --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +reconciliation-url
+- **WHEN**：月度对账单下载链接
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +reconciliation-url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +credit
+- **WHEN**：后付信用额度
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +credit --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +own
+- **WHEN**：钱包首页
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +own --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +change-recent
+- **WHEN**：最近钱包流水
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +change-recent --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +recharge-recent
+- **WHEN**：最近充值记录
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +recharge-recent --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +currency
+- **WHEN**：钱包币种列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +currency --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +cash-accounts
+- **WHEN**：现金账务类型
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +cash-accounts --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +cash-change
+- **WHEN**：现金收支明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +cash-change --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +change-accounts
+- **WHEN**：钱包账务类型
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +change-accounts --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +quota-type
+- **WHEN**：钱包额度类型
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +quota-type --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +change
+- **WHEN**：钱包消费明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +change --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +recharge
+- **WHEN**：充值明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +recharge --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+## +currency-amount
+- **WHEN**：币种可用额度
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +currency-amount --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## +exchange-rate
+- **WHEN**：币种汇率
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +exchange-rate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+## api
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli wallet api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。

package/dist/api-doc/README.md CHANGED Viewed

@@ -16,14 +16,16 @@
 | 域 | 用途 | 接口文档 |
 | --- | --- | --- |
-| biz-line | 业务线、周策略、渠道、品类、优化项目及广告成效 | [查询](oapi/biz-line-query.md)、[策略](oapi/biz-line-strategy.md) |
+| biz-line | 业务线、周策略、品类、策略标签、AI策略、优化项目及广告成效 | [查询](oapi/biz-line-query.md)、[策略](oapi/biz-line-strategy.md)、[AI策略](oapi/biz-line-ai-strategy.md) |
+| common-file | 通用文件上传与按 storageKey 取下载链接 | [通用文件](oapi/common-file.md) |
 | project-analysis | 优化项目月度分析、消耗/工时趋势、人效与 Excel 导出 | [项目分析](oapi/project-analysis.md) |
 | sso | SSO 组别 | [SSO](oapi/sso.md) |
 | project | 营销协同项目、成员、分组 | [项目](oapi/project.md) |
 | project-stage | 营销协同项目阶段 | [阶段](oapi/project-stage.md) |
 | task | 营销协同任务 | [任务](oapi/task.md) |
 | document | 文档中心与项目文档 | [文档](oapi/document.md) |
-| file | 文件上传与对象存储记录 | [文件](oapi/file.md) |
+| file | 营销协同文件上传与对象存储记录 | [文件](oapi/file.md) |
+| wallet | 对账单、发票结算、月度对账、后付额度与预付钱包 | [对账单](oapi/wallet-bill.md)、[发票](oapi/wallet-invoice.md)、[月度对账](oapi/wallet-reconciliation.md)、[额度](oapi/wallet-quota.md)、[钱包](oapi/wallet-prepaid.md) |
 | delivery | Campaign 归集与投放阶段指标 | [投放](oapi/delivery.md) |
 | dashboard | 看板 | [看板](oapi/dashboard.md) |
 | organization | 组织架构、团队成员与当前用户 | [组织用户](oapi/organization.md) |

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

@@ -0,0 +1,45 @@
+# 业务线AI策略
+对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
+## 1. 保存业务线AI策略
+`POST /sino-opti-hive/biz-line/ai-strategy/save`
+主体上下文：`tenant=false`。
+角色范围：`sso/system`。
+保存一个业务线、一个完整自然周的AI策略生成结果，返回新AI策略ID。bizLineId取自业务线列表；周期为已结束的周一至周日，默认支持2026-09-07及之后的周期（以服务配置为准）。仅优化系统管理员可调用，以BizLinePermCacheManager返回结果的admin标记为准：admin=true放行，其他情况拒绝。
+生成成功：generateCode传READY，提交四大策略文本、效果（1有效/2无效/3待观察）、Learning、三类标签ID列表和Excel文件存储key。标签ID从GET /sino-opti-hive/dict/items的对应策略场景查询，列表允许[]，JSON序列化后每类最多500字符；文件先上传，fileStorageKey不是下载URL。
+未生成：generateCode传NO_PROJECT、UNSUPPORTED_CHANNEL、NO_AD_ACCOUNT、NO_DELIVERY_DATA或GENERATION_FAILED，并填写remark；三类展示状态PERIOD_NOT_FINISHED、BEFORE_SUPPORTED_PERIOD、GENERATING不可保存。
+副作用：同业务线同周期的有效旧AI策略逻辑删除后新增记录，并在同一注解事务内批量快照对应正式策略；没有正式策略时不造空快照。重复调用会产生新的AI策略ID，不是原记录更新。历史日志和快照保留，不改写正式策略内容。失败时整个事务回滚。本接口不加锁。
+返回遵循RestResponseVO，成功result为Long型AI策略ID。示例中的ID和文件key须替换为真实数据。
+**输入参数（--data）**
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizLineId` | integer | body | 是 | 必填，正整数；取自业务线列表的id。 |
+| `periodStart` | string | body | 是 | 必填，周一，yyyy-MM-dd。 |
+| `periodEnd` | string | body | 是 | 必填，同一自然周的周日，必须早于当前日期。 |
+| `generateCode` | string | body | 是 | 必填，区分大小写：READY成功；NO_PROJECT无项目；UNSUPPORTED_CHANNEL渠道不支持；NO_AD_ACCOUNT无广告账号；NO_DELIVERY_DATA无投放数据；GENERATION_FAILED生成失败。 |
+| `budgetStrategyTags` | array | body | 否 | READY时必填，允许空数组；取/dict/items的BUDGET_STRATEGY场景返回id，不传名称或itemCode。序列化后不超过500字符。 |
+| `budgetStrategySupplement` | string | body | 否 | READY时必填，非空策略内容。 |
+| `budgetStrategyEffect` | integer | body | 否 | READY时必填：1有效、2无效、3待观察。 |
+| `budgetStrategyLearning` | string | body | 否 | READY时必填，非空的策略效果总结及经验。 |
+| `mediaStrategyTags` | array | body | 否 | READY时必填，允许空数组；取/dict/items的MEDIA_STRATEGY场景返回id，不传名称或itemCode。序列化后不超过500字符。 |
+| `mediaStrategySupplement` | string | body | 否 | READY时必填，非空策略内容。 |
+| `mediaStrategyEffect` | integer | body | 否 | READY时必填：1有效、2无效、3待观察。 |
+| `mediaStrategyLearning` | string | body | 否 | READY时必填，非空的策略效果总结及经验。 |
+| `audienceStrategyTags` | array | body | 否 | READY时必填，允许空数组；取/dict/items的AUDIENCE_STRATEGY场景返回id，不传名称或itemCode。序列化后不超过500字符。 |
+| `audienceStrategySupplement` | string | body | 否 | READY时必填，非空策略内容。 |
+| `audienceStrategyEffect` | integer | body | 否 | READY时必填：1有效、2无效、3待观察。 |
+| `audienceStrategyLearning` | string | body | 否 | READY时必填，非空的策略效果总结及经验。 |
+| `creativeStrategy` | string | body | 否 | READY时必填，非空策略内容。 |
+| `creativeStrategyEffect` | integer | body | 否 | READY时必填：1有效、2无效、3待观察。 |
+| `creativeStrategyLearning` | string | body | 否 | READY时必填，非空的策略效果总结及经验。 |
+| `fileStorageKey` | string | body | 否 | READY时必填；上传策略Excel后返回的存储key，不是下载URL。 |
+| `remark` | string | body | 否 | 非READY时必填，说明不能生成或生成失败的原因。 |

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

@@ -2,7 +2,7 @@
 对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
-## 1. 查询业务线和策略投放品类字典
+## 1. 查询业务线字典和策略标签
 `GET /sino-opti-hive/dict/items`
@@ -10,10 +10,17 @@
 角色范围：`sso`。
-查询投放品类字典，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。
+按sceneCode查询业务字典，使用GET Query参数，不传JSON请求体。sceneCode必填，不存在的场景返回空数组。
+AI策略生成前分别调用三次：BUDGET_STRATEGY（预算）、MEDIA_STRATEGY（媒介产品）、AUDIENCE_STRATEGY（受众定位）。三次都需传非空filterCondition，使用当前业务实际字典配置值；缺少该参数不会报错，而是直接返回[]。匹配规则为filter_condition等于传入值或为NULL（通用项）。不要据空数组自动推断该场景没有标签。
+将返回id分别填入保存接口budgetStrategyTags、mediaStrategyTags、audienceStrategyTags；不要传name或itemCode。此接口也保留PLACEMENT_CATEGORY（投放品类）和CUSTOMER_TYPE（客户类型）用途，二者过滤“其他”项；策略场景不做该过滤。两级场景返回树，叶子children可为null。
+策略调用示例：/sino-opti-hive/dict/items?sceneCode=BUDGET_STRATEGY&filterCondition={{strategyFilterCondition}}。变量必须替换为实际配置值；另外两类策略仅替换sceneCode。投放品类调用示例：/sino-opti-hive/dict/items?sceneCode=PLACEMENT_CATEGORY。
 **输入参数（--data）**
 | 字段 | 类型 | 位置 | 必填 | 说明 |
 | --- | --- | --- | --- | --- |
-| `sceneCode` | string | query | 否 | 查询投放品类时固定传 PLACEMENT_CATEGORY。不传则以后端默认为准。 |
+| `sceneCode` | string | query | 是 | 必填。BUDGET_STRATEGY预算策略、MEDIA_STRATEGY媒介产品策略、AUDIENCE_STRATEGY受众定位策略；同时支持PLACEMENT_CATEGORY投放品类、CUSTOMER_TYPE客户类型。 |
+| `filterCondition` | string | query | 否 | 三类策略场景必须传非空值，否则返回[]；按实际字典配置的filter_condition精确匹配，同时包含filter_condition为NULL的通用项。此值没有固定枚举，不要用场景名或业务线ID臆造；其他场景可不传。 |

package/dist/api-doc/oapi/common-file.md ADDED Viewed

@@ -0,0 +1,44 @@
+# 通用文件管理
+对应命令：`common-file +<shortcut>` 与 `common-file api <name>`。
+## 1. 上传文件
+`POST /bc-business-pu/file/fileUpload`
+主体上下文：`tenant=false`。
+角色范围：`sso/system`。
+上传单个私有文件，使用multipart/form-data，file为必填文件part。serviceName可选，未传或为空字符串时默认bc-business-pu，支持的服务名见参数枚举。
+上传文件不能为空，默认最大50MB（52428800字节，含边界），由Apollo配置file.upload.max-size控制。存储目录为服务名/yyyy-MM，文件名使用UUID并保留扩展名。上传返回的私有链接有效期默认3600秒，由file.download.url-expire-seconds控制。
+成功返回UploadFileResult，请保存result.storageKey供后续获取下载链接或关联业务记录使用。重复上传会生成新的存储文件。服务名非法、文件为空、文件超限、文件名为空或配置非正数时返回业务错误。本接口不要求业务签约主体参数。
+编码：`multipart/form-data`；文件字段填写本地路径，`--dry-run` 只预览、不上传。
+**输入参数（--data）**
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `file` | string | form | 是 | 本地文件路径；发送时读取为文件。待上传文件，非空，默认最大50MB，以Apollo配置为准。 |
+| `serviceName` | string | form | 否 | 来源服务；未传或为空字符串时默认bc-business-pu，用于存储目录隔离。 |
+## 2. 获取文件下载链接
+`GET /bc-business-pu/file/getUrlByKey`
+主体上下文：`tenant=false`。
+角色范围：`sso/system`。
+使用文件上传成功后返回的storageKey获取私有文件下载链接。storageKey必填且不能是空白字符串，请原样传入，不要传已有下载URL。
+成功时result直接返回URL字符串，不执行302重定向。有效期默认3600秒，由Apollo配置file.download.url-expire-seconds控制，与上传返回链接使用同一配置。链接失效后可重新调用本接口生成。生成失败、返回空链接或有效期配置非正数时返回业务错误。本接口不要求业务签约主体参数。
+**输入参数（--data）**
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `storageKey` | string | query | 是 | 上传接口result.storageKey返回的文件标识，非空白字符串。 |