sino-bc-cli 1.0.0-beta.0

package/dist/affordance/tenant.md

@@ -0,0 +1,17 @@
+# tenant 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +list
+
+- **WHEN**：查询用户签约主体列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli tenant +list`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli tenant api <name> --data '{...}'`

package/dist/affordance/user.md

@@ -0,0 +1,41 @@
+# user 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +tenant-info-batch
+
+- **WHEN**：批量查询租户用户信息
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +tenant-info-batch --data '{...}'`
+
+## +tenant-info
+
+- **WHEN**：查询租户用户信息
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +tenant-info --data '{...}'`
+
+## +sso-info
+
+- **WHEN**：查询SSO用户信息(用户ID)
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +sso-info --data '{...}'`
+
+## +sso-info-batch
+
+- **WHEN**：批量查询SSO用户信息(用户ID)
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +sso-info-batch --data '{...}'`
+
+## +sso-list
+
+- **WHEN**：查询SSO用户列表（支持名称模糊）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +sso-list --data '{...}'`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli user api <name> --data '{...}'`

package/dist/affordance/wallet.md

@@ -0,0 +1,100 @@
+# wallet 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +own
+
+- **WHEN**：钱包首页
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +own --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +change-recent
+
+- **WHEN**：最近钱包流水
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +change-recent --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +recharge-recent
+
+- **WHEN**：最近充值记录
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +recharge-recent --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +currency
+
+- **WHEN**：钱包币种列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +currency --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +cash-accounts
+
+- **WHEN**：现金账务类型
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +cash-accounts --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +cash-change
+
+- **WHEN**：现金收支明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +cash-change --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +change-accounts
+
+- **WHEN**：钱包账务类型
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +change-accounts --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +quota-type
+
+- **WHEN**：钱包额度类型
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +quota-type --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +change
+
+- **WHEN**：钱包消费明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +change --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +recharge
+
+- **WHEN**：充值明细
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +recharge --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +currency-amount
+
+- **WHEN**：币种可用额度
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +currency-amount --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +exchange-rate
+
+- **WHEN**：币种汇率
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli wallet +exchange-rate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli wallet api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/api-doc/README.md

@@ -0,0 +1,67 @@
+# 接口文档索引
+
+本目录描述 CLI catalog 中的接口字段。查看命令用途用 `sino-bc-cli <domain> --help`；查看某接口的完整输入和输出 schema 用 `sino-bc-cli /schema <name>`。便捷命令负责常见任务，原始 JSON 调用用 `<domain> api <name> --data '<json>'`。
+
+## 文档分层
+
+| 位置 | 来源与维护方式 |
+| --- | --- |
+| 本文件 | 手写导航，同步保留 |
+| `oapi/` | Apifox 全模块同步生成，整层替换，禁止手改 |
+| `custom/` | 手写字段说明或文档覆盖，同步只读 |
+
+同名文档按 custom → oapi → 目录根解析。custom 同名文件会优先展示，只有确需完整覆盖生成文档时才使用。这是接口文档的按文件查找，不是技能安装方式。域工作流写在 `src/catalog/sync/domains/`（同步进 `skills/oapi/`）；额外专家技能放 `skills/custom/<技能名>/`，必须自带完整 `SKILL.md`。
+
+Skill 安装保留三类职责：shared 管共用规则，API 域管单域能力，专家编排已有能力形成任务产物。完整 custom 可整域替换 oapi；独立专家顶层分发，依赖域位于导航 domains 内，不替换依赖域。根 Skill 只概览、shared 和非空 Apifox 模块；模块页列一级目录对应的 API Skill 能力，已核实域及能力可直读完整域。专家不进业务导航，`/skill` 列出全部入口。
+
+## 按功能模块查看
+
+Apifox 模块组织业务域导航，一级目录对应下表的 API Skill 与命令域，子目录在 Skill 内作为功能分组。
+
+| 命令域 | 用途 | 接口文档 |
+| --- | --- | --- |
+| biz-line | 业务线、周策略、投放品类、策略标签与关联项目 | [接口文档](oapi/biz-line.md) |
+| sso-team-group | 优化组别选项、组长、成员与行业信息 | [接口文档](oapi/sso-team-group.md) |
+| biz-line-metrics | 广告策略维度与成效数据 | [接口文档](oapi/biz-line-metrics.md) |
+| project-analysis | 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出 | [接口文档](oapi/project-analysis.md) |
+| biz-line-ai-strategy | AI 策略保存、历史记录、使用日志与正式策略快照 | [接口文档](oapi/biz-line-ai-strategy.md) |
+| project | 营销协同项目生命周期、成员、阶段、项目文档、投放阶段Tab及群关系 | [接口文档](oapi/project.md) |
+| task | 营销协同任务：交付闭环与操作日志 | [接口文档](oapi/task.md) |
+| document | 营销协同文档中心、文件上传与对象存储记录 | [接口文档](oapi/document.md) |
+| dashboard | 营销协同看板：预算分布、项目分布与关键项目时间轴 | [接口文档](oapi/dashboard.md) |
+| organization | 组织架构、团队成员与当前用户 | [接口文档](oapi/organization.md) |
+| im | 营销协同飞书群消息 | [接口文档](oapi/im.md) |
+| dict | 营销协同通用字典：按用途查询场景与按场景查询条目 | [接口文档](oapi/dict.md) |
+| report | 营销协同Campaign归集、投放阶段指标、花费、KPI与维度下钻 | [接口文档](oapi/report.md) |
+| tenant | 签约主体 | [接口文档](oapi/tenant.md) |
+| auth | 身份令牌与浏览器授权 | [接口文档](oapi/auth.md) |
+| user | SSO 用户资料、按姓名模糊列表与签约主体（租户）用户资料 | [接口文档](oapi/user.md) |
+| media | 广告投放媒体：投放渠道等媒体字典 | [接口文档](oapi/media.md) |
+| bill | 财务对账单查询 | [接口文档](oapi/bill.md) |
+| invoice | 发票结算单与发票文件下载 | [接口文档](oapi/invoice.md) |
+| reconciliation | 月度对账文件与邮件记录 | [接口文档](oapi/reconciliation.md) |
+| quota | 后付额度查询 | [接口文档](oapi/quota.md) |
+| wallet | 预付钱包、充值与流水查询 | [接口文档](oapi/wallet.md) |
+| common-file | 通用文件上传与按 storageKey 取下载链接 | [接口文档](oapi/common-file.md) |
+
+接口名称和数量以 `src/generated/api-catalog.json` 为唯一运行时依据；name 来自 OpenAPI 的 `x-cli-name`，不能从路由自行拼造。新开发者接入流程见 [bc-develop](../../.agents/skills/bc-develop/SKILL.md)，完整样例见 [项目分析接入](../../developer-doc/07-project-analysis-onboarding.md)。
+
+## 请求与输出约定
+
+业务请求只走生效网关根（缺省 `https://agent.beyondclick.com`，可用 `/set-config gateway-url`），路径保持 OpenAPI 的完整路由。例如 `/sino-opti-hive/project/analysis/getSummaryData` 不能剥掉或重复追加服务前缀。认证与业务共用该根；不能把文档来源服务地址当业务请求地址。
+
+CLI 从平台密钥存储读取身份令牌（macOS/Linux 为 AES 密文，Windows 为凭据库），固定携带 `Authorization: Bearer …` 和 `X-GATEWAY-TYPE: A2C-CLI`。只有 catalog 声明 tenant=true 的业务接口才要求本次调用传入 `--corporation-id` 与 `--auth-context-id`，并注入 `x-corporation-id`。项目分析的 corporationIdList 是可选业务筛选，和网关主体上下文分开。
+
+参数以实际输入为准，文档示例不会被当作默认请求体。GET query 同样通过 `--data` 提供；multipart 文件字段传本地路径，由 CLI 读取文件上传。`--dry-run` 校验并预览，不发业务请求。
+
+仅 high-risk-write 要求确认：非交互未传 --yes 时返回 confirmation_required、退出码 10。普通 write 直接执行；项目分析三个导出属于普通 write，会生成文件并返回 URL。不能把 URL 响应称为本地下载完成。
+
+TTY 默认表格，非 TTY 默认 JSON 信封。成功 stdout，失败 stderr；参数/配置错误退出码 2，一般 API 错误 1。上游响应由 CLI 解包到 data，不需要调用者重复解包。
+
+查看本地身份状态使用 `sino-bc-cli /auth status --json`，从成功信封的 `data.localStatus`、`data.message`、`data.authContextId` 读取。状态不验证服务端授权；正常业务调用会自动尝试续期，无需每次先查状态。资料为空或配置文件不存在均不能单独证明未登录；失败优先按最终 `error.params[].reason` 处理，完整规则见下方 shared。
+
+先读 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取主体绑定、高风险写确认或鉴权恢复等 references；`--yes` 不绕过身份或主体校验。可用 `sino-bc-cli /skill` 查询 shared 的真实文件路径。
+
+## 维护同步
+
+运行 `npm run sync-api-doc`，自动发现所有模块，分别读取并核对 OpenAPI 和原生目录树，全部成功后同事务替换目录索引与生成物。token 只取环境变量 `APIFOX_TOKEN`；禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证，不能只看 catalog 新增数量。

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

@@ -0,0 +1,61 @@
+# 访问凭证管理
+
+对应命令：`auth +<shortcut>` 与 `auth api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 获取授权链接地址
+
+`POST /platform/auth/cli/device/oauth/code`
+
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
+风险：`read`。
+
+CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一 deviceCode 未过期重复调用返回原链接且不延长 TTL。已落库的 deviceCode 不能重新申请，返回 DENIED。本接口免登录，由 deviceCode 校验。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `deviceCode` | string | body | 是 | CLI 产生至少 32 字节安全随机 device_code（base64url，43 至 64 字符） |
+| `clientId` | string | body | 是 | 固定为 sino-bc-cli |
+| `accessType` | string | body | 是 | 固定为 offline_access |
+
+## 2. 获取访问凭证accessToken和刷新凭证refreshToken
+
+`POST /platform/auth/cli/device/oauth/exchange`
+
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
+风险：`read`。
+
+按设备凭证查询授权状态或领取首代凭证。未确认返回 PENDING；申请过期或领取恢复窗口已过返回 EXPIRED；确认后首次领取写入授权及首代 token，宽限 300 秒内可恢复同一代结果。本接口免登录，由 deviceCode 校验。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `deviceCode` | string | body | 是 | 与auth-cli-device-oauth-code申请时使用的同一 deviceCode |
+
+## 3. 通过刷新凭证refreshToken获取访问凭证accessToken
+
+`POST /platform/auth/cli/oauth/refresh`
+
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
+风险：`read`。
+
+轮换刷新凭证。刷新凭证不存在、已删除、已失效或宽限外重试返回 INVALID_GRANT；首次轮换签发下一代 token 对，宽限内重试返回同一代结果，不产生分支、不延长到期。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `refreshToken` | string | body | 是 | exchange 或上一次 refresh 返回的 refreshToken |

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

@@ -0,0 +1,130 @@
+# 对账单
+
+对应命令：`bill +<shortcut>` 与 `bill api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 对账单列表
+
+`POST /sino-wallet-pu/platform/wallet/bill/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按生成时间查当前主体的账单聚合列表（BillAggregation）。响应只保留列表，不含待还汇总。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `startTime` | string | body | 是 | yyyy-MM-dd |
+| `endTime` | string | body | 是 | yyyy-MM-dd |
+| `billName` | string | body | 否 | 支持模糊 |
+| `channelIdList` | array | body | 否 | 0 代表服务费系统 |
+| `minAmount` | number | body | 否 | 账单金额最小值 |
+| `maxAmount` | number | body | 否 | 账单金额最大值 |
+| `invoiceStatusList` | array | body | 否 | 开票状态 |
+| `billTypeList` | array | body | 否 | 账单类型 |
+| `startMonth` | string | body | 否 | yyyyMM，如 202309 |
+| `endMonth` | string | body | 否 | yyyyMM，如 202310 |
+
+## 2. 对账单基本信息
+
+`GET /sino-wallet-pu/platform/wallet/bill/detail/basic`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-detail-basic --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 billId 查单条对账单金额、渠道、类型、开票状态。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `billId` | string | query | 是 | 对账单id |
+
+## 3. 对账单明细
+
+`POST /sino-wallet-pu/platform/wallet/bill/detail/original/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-original-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按对账单类型返回媒体 / 服务费 / Credit Memo / 服务费红冲其中一类明细。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billId` | string | body | 是 | 对账单id |
+
+## 4. 对账单操作历史
+
+`POST /sino-wallet-pu/platform/wallet/bill/detail/operate/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-operate-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+分页查对账单操作记录。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，从 1 开始 |
+| `pageSize` | integer | body | 否 | 每页条数 |
+| `billId` | string | body | 是 | 对账单id |
+
+## 5. 对账单与发票枚举
+
+`POST /sino-wallet-pu/platform/wallet/enum/bill-invoice/by-type/list`
+
+主体上下文：`tenant=true`。
+
+角色范围：`passport/system`。
+
+风险：`read`。
+
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+调用示例：`sino-bc-cli bill api bill-invoice-enum --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+
+按 types 批量取渠道、开票/还款状态、账单类型等枚举。type 必须用原文，含拼写。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `types` | array | body | 是 | 至少 1 个。INVOICE_E_FILE_TYPE 结果不可靠，下载格式请用 PDF/OFD。 |

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

@@ -0,0 +1,119 @@
+# 业务线AI策略
+
+对应命令：`biz-line-ai-strategy +<shortcut>` 与 `biz-line-ai-strategy api <name>`。
+
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## 1. 保存业务线AI策略
+
+`POST /sino-opti-hive/biz-line/ai-strategy/save`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system`。
+
+风险：`write`。
+
+保存一个业务线、一个完整自然周的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时必填，说明不能生成或生成失败的原因。 |
+
+## 2. 业务线AI策略分页列表
+
+`POST /sino-opti-hive/biz-line/ai-strategy/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+业务线AI策略分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `bizLineId` | integer | body | 否 | 业务线ID |
+| `weekStart` | string | body | 否 | 周期开始日期（周一，yyyy-MM-dd） |
+| `weekEnd` | string | body | 否 | 周期结束日期（周日，yyyy-MM-dd） |
+| `generateCode` | string | body | 否 | 生成结果状态码：READY=生成成功，NO_PROJECT=未关联项目，UNSUPPORTED_CHANNEL=渠道不支持，NO_AD_ACCOUNT=未关联广告账号，NO_DELIVERY_DATA=无投放数据，GENERATION_FAILED=生成失败 |
+
+## 3. 业务线AI策略使用日志分页列表
+
+`POST /sino-opti-hive/biz-line/ai-strategy/use-log/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+业务线AI策略使用日志分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `aiStrategyId` | integer | body | 否 | AI策略ID |
+| `operateType` | string | body | 否 | 操作类型：GET_STRATEGY=获取策略，ADOPT_STRATEGY=采用策略，REJECT_STRATEGY=暂不采用 |
+| `rejectReasonType` | string | body | 否 | 暂不采用原因类型：DATA_INACCURATE=数据不准确，CONTENT_REDUNDANT=内容太过冗余，ACTION_OMISSION_OR_ATTRIBUTION_ERROR=操作遗漏及归因错误，OTHER=其他 |
+
+## 4. 用户填写原始策略快照分页列表
+
+`POST /sino-opti-hive/biz-line/ai-strategy/snapshot/list`
+
+主体上下文：`tenant=false`。
+
+角色范围：`sso/system/passport`。
+
+风险：`read`。
+
+用户填写原始策略快照分页列表
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `pageNum` | integer | body | 否 | 页码，默认1 |
+| `pageSize` | integer | body | 否 | 每页条数，默认10 |
+| `aiStrategyId` | integer | body | 否 | 本次AI策略ID |
+| `strategyId` | integer | body | 否 | 策略ID |
+| `bizLineId` | integer | body | 否 | 业务线ID |
+| `year` | integer | body | 否 | 策略所属ISO周年份（跨年周可能与自然年不同） |
+| `weekStart` | string | body | 否 | 周期开始日期（周一，yyyy-MM-dd） |
+| `weekEnd` | string | body | 否 | 周期结束日期（周日，yyyy-MM-dd） |