sino-bc-cli 1.8.28-beta.2 → 1.8.28-beta.3

package/README.md

@@ -56,7 +56,11 @@ flowchart TB
 
 ## 代码执行流程
 
-进程入口创建应用、跑完 `argv`、按退出码结束。全局选项（`--version` / `--help`）先扫一遍；是否走业务只看**位置参数**。每次运行会把 JSON 审计行追加到本机 `~/.sino-bc-cli/logs/`，成功/失败信封里的 `ddtraceId` 与请求头 `x-datadog-trace-id` 是同一枚。
+进程入口创建应用、跑完 `argv`、按退出码结束。全局选项（`--version` / `--help`）先扫一遍；是否走业务只看**位置参数**。每次运行会尝试记录 JSON 审计日志，成功/失败信封里的 `ddtraceId` 与请求头 `x-datadog-trace-id` 是同一枚。
+
+日志按文件日期最长保留 7 天，总容量上限 6 GiB，单文件 200 MiB，单条完整 JSON（含换行）最多 64 KiB；过长详情先脱敏再截断。每次写入前从旧到新清理，不启动后台任务。容量优先于保留期限，因此高频调用时可能不足 7 天；未运行 CLI 时不会主动清理。
+
+删除失败会停止本次后续淘汰；无法腾出足够空间、写锁忙或写盘失败时跳过本条，业务继续，stderr 每进程最多提示一次，后续日志仍可重试。旧大文件不拆分、不追加，按正常规则淘汰；全部写入进程升级后才保证协作容量上限。
 
 ### 1. 路由
 
@@ -124,6 +128,21 @@ flowchart TD
 - 只有清单标成高风险写的接口才要 `--yes`；普通写操作直接执行。
 - 没有分页声明却传了翻页参数：直接校验失败，不发请求。
 - 成功看退出码 `0` 或 JSON 的 `ok`，不要看上游业务 `code`。
+- 网关明确拒绝过期或无效令牌且有可用刷新令牌时，CLI 自动续期，只重试当前失败请求一次。主体探查、资料补查与该请求共用这一次机会；已成功的业务步骤和分页不会从头重跑。
+- 无权限时联系管理员；没有可用 RT、RT 失效或重试仍被拒绝时按提示重新授权，需要主体时重新绑定。普通 HTTP 401、网络故障和服务故障保留凭证，不自动重放请求。
+
+收到 `corporation_required`（17000048）时，先用 `/auth status` 和 `/tenant list` 查看当前身份及可用主体，成对补齐本次 `--corporation-id` 与 `--auth-context-id`，只继续当前失败操作。已带齐仍失败时，核对 `/schema` 与更新接口清单，不要反复选择主体；CLI 不自动选择、刷新、重试或改变接口的 `tenant` 标识。
+
+鉴权失败仍输出一份 JSON 到 stderr，`error.type` 为 `api`、退出码为 `1`。`error.code` 给出恢复类别，`error.businessCode` 保留上游业务码；未知业务码保留原消息和业务码。排障字段仍是 `ddtraceId` 与 `appTrace`。
+
+| error.code | 处理方式 |
+| --- | --- |
+| `token_expired` | CLI 已按信封业务码判断能否自动续期；仍失败时按 hint 继续当前失败步骤 |
+| `token_invalid` | 先用 RT 刷新并重试一次；无可用 RT、RT 失效或重试仍被拒绝时重新授权 |
+| `corporation_forbidden` | 用 `/tenant list` 选择有权限的主体，或联系管理员 |
+| `corporation_required` | 查看当前身份及可用主体，补齐本次主体绑定；已带齐仍失败则核对接口清单 |
+| `api_forbidden` | 联系管理员核对接口登记及权限 |
+| `authorization_unavailable` | 稍后重试当前失败步骤，保留已有授权 |
 
 ## 安装
 
@@ -149,13 +168,21 @@ sino-bc-cli --help
 sino-bc-cli /init
 ```
 
-`/init` 只注册技能，不写入令牌。技能落在各 Agent 目录下的 `sino-bc-cli/`（`~/.agents/skills` 始终写；Cursor / Claude / Codex 仅在对应 Agent 根已存在时写）。飞书豆包：技能·连接器 → 管理 → **本地** → 刷新。
+`/init` 安装同一包中的导航、shared、API 域与专家技能，API 域位于 `sino-bc-cli/domains/<name>/`，通过业务分类按需读取；shared 和专家是顶层完整入口。默认写入 `~/.agents/skills`；本机存在 `~/.claude` 时也写入 `~/.claude/skills`。需要其它目录时使用 `/skill target add <目录>` 显式登记。它不写入令牌。飞书豆包：技能·连接器 → 管理 → **本地** → 刷新。
+
+每次安装或刷新都会整目录替换 `sino-bc-cli`、`sino-bc-shared`。专家按旧安装记录中的有效名单与当前包名单的并集清理，再整目录安装当前包的专家；旧名单不存在、损坏、无法读取或无法识别时，改用当前包的专家名单。同名专家和两个固定目录中的本地修改也会被替换，缺失目录会重新安装；其它技能保留，不按名称前缀扫描删除。降级时无法识别当前包已不包含的旧专家，这些目录会保留。
+
+新包先校验并暂存，再备份旧目录并替换，成功后保存新的专家名单；安装失败恢复旧内容，恢复未完成则保留备份与恢复信息。任一目标失败，命令都会明确报告未完成。新通用目标安装成功后，清理未登记的历史位置 `~/.codex/skills`、`~/.cursor/skills`：两个固定目录直接整目录清理，专家按有效旧名单与当前包名单的并集清理，旧名单不可用时降级当前名单；仅剩 shared 或专家也会处理。已登记或实际路径属于生效目标的目录按安装规则刷新，不作为旧位置清理。清理失败或中断时保留恢复信息，重试 `/init` 按原记录继续，不扩大删除范围。不同 Agent 的发现规则可能使同一技能显示多份。
+
+`/skill target list` 可查看各目标的完整性及待恢复状态。安装中断后重试原操作；移除目标或卸载失败时，保留登记和恢复记录供重试。`/update` 会先核对 latest 的具体版本与技能安装格式，再安装已核验的版本；无法确认兼容性时停止升级，避免较新的 Beta 布局被旧正式版覆盖。
+
+首次从格式 2 平铺安装迁移到格式 3 时，旧 `/update` 会拒绝未知格式。退出其他生命周期操作后，串行执行 `npm install -g sino-bc-cli@<已确认的新版本> --registry=https://registry.npmjs.org/`，再运行新包的 `/init` 和 `/skill target list`。外部 npm 换包阶段不受 CLI 协调锁保护；新包 init 受锁保护。npm 安装成功仍需检查 Skill 是否完整；安装失败按提示处理后重试 `/init`，不要自动降级旧包。新安装记录应由新版 CLI 继续维护。
 
 命令找不到：`npm prefix -g` 把全局 bin 加入 `PATH` 后重开终端。临时试跑（不注册技能）：`npx sino-bc-cli --help`。
 
 上手顺序：安装 → `/init` → `/auth login` → 需要主体时 `/tenant list` → 业务命令或 `/schema`。
 
-Agent 使用时读本机 `sino-bc-cli/SKILL.md`，再按意图读一份域技能。仓库开发看源码根目录 `AGENTS.md`（不随 npm 包分发）。
+Agent 在 API 域未知或有歧义时从业务分类选择并读取完整域 Skill；已用当前依赖说明、CLI 帮助或 schema 核实域及能力时直接读取。完成策略生成等任务时直接选择专家 Skill；各入口按需读取 shared 和依赖域。`sino-bc-cli/SKILL.md` 只提供概览、shared 及 API 分类导航；专家不在业务导航中，`/skill` 仍列出全部入口。全部技能随同一个 npm 包安装、升级和卸载。仓库开发看源码根目录 `AGENTS.md`（不随 npm 包分发）。
 
 ## 斜杠命令
 
@@ -163,14 +190,18 @@ Agent 使用时读本机 `sino-bc-cli/SKILL.md`，再按意图读一份域技能
 | --- | --- |
 | `/init` | 把 Agent 技能写到本机目标目录 |
 | `/update` | 升级到 npm latest，再执行一次 `/init` |
-| `/skill` | 列出入口技能；`/skill <name>` 打开说明；`target add\|list\|remove` 管理额外安装目录 |
+| `/skill` | 列出导航、shared、API 域及专家技能；`/skill <name>` 打开说明；`target add\|list\|remove` 管理额外安装目录 |
 | `/schema` | 列出可调接口；`/schema <name>` 看入参 |
-| `/get-config` | 查看配置（令牌默认打码，`--show-secret` 明文） |
-| `/set-config` | 写访问令牌或网关地址 |
+| `/get-config` | 查看公开配置及 AT/RT 是否已配置，不显示令牌内容 |
+| `/set-config` | 交互隐藏输入 AT/RT、从非 TTY JSON 标准输入导入令牌，或写网关地址 |
 | `/auth` | `login` 浏览器登录；`status` 查看身份；`logout` 退出 |
 | `/tenant` | 仅 `list`：列出当前身份可用的签约主体 |
 | `/uninstall` | 清理技能、本机配置和身份；默认同时卸载全局包 |
 
+`/auth status` 只查看本地身份，不联网补查资料。本人资料有效期为成功补查后的 24 小时；`profileCache` 标明 `fresh`（有效）、`expired`（过期）或 `missing`（缺失）。过期资料不再作为当前资料展示，下次普通业务调用时按需补查，普通补查失败仍继续业务。主动查询本人或他人的资料只返回查询结果，不更新这份缓存。
+
+新登录成功或手动更换访问令牌会清除旧资料；同一身份续期、仅更新刷新令牌或修改网关地址不清资料，也不延长资料有效期。Passport 各主体独立计时，缓存不会替你选择主体。资料有效期只影响展示，不代表登录或接口权限有效期。
+
 ```bash
 sino-bc-cli /init
 sino-bc-cli /skill
@@ -181,12 +212,15 @@ sino-bc-cli /tenant list
 sino-bc-cli /schema
 sino-bc-cli /schema biz-line-list
 sino-bc-cli /get-config
-sino-bc-cli /set-config auth-token <AT>
+sino-bc-cli /set-config  # 交互终端隐藏输入 AT，RT 可空
+sino-bc-cli /set-config refresh-token --prompt  # 仅更新 RT
 sino-bc-cli /set-config gateway-url https://agent.beyondclick.com
 sino-bc-cli /update
 sino-bc-cli /uninstall --yes
 ```
 
+自动化导入时，由可信凭证提供程序向 `sino-bc-cli /set-config --stdin` 输送 JSON：`{"authToken":"…","refreshToken":"…"}`。也可只传 `authToken`（清除旧 RT），或在已有 AT 时只传 `refreshToken`（空字符串表示清除 RT）。不要把真实令牌放进命令行参数或终端历史。
+
 需要签约主体的接口，把 `/tenant list` 的主体 ID 和 `/auth status` 的认证上下文成对传入 `--corporation-id`、`--auth-context-id`。
 
 ## 调用样例
@@ -216,4 +250,4 @@ MIT
 
 Agent 使用 `biz-line-strategy-generate` 专家技能（需 Python 3），最多并发 3 条业务线。默认每条生成桌面 Excel；明确要求“写入数据库”时，生成并上传 Excel 后删除本地临时文件，将文件 key、四大策略和 learning 一并保存为 AI 策略。
 
-两种模式的 Excel 均在预算、广告产品、受众策略前展示匹配标签；素材不加标签。运行需提供页面实际的策略字典筛选值。数据库模式先核对全部关联项目的上周消耗，全部为 0 时直接保存无投放数据状态。调用示例与参数见安装后的专家技能说明。
+两种模式的 Excel 均在预算、广告产品、受众策略前展示匹配标签；素材不加标签。标签字典使用真实业务线的首个所属行业，Agent 按策略正文选取匹配标签。数据库模式先核对全部关联项目的上周消耗，全部为 0 时直接保存无投放数据状态。调用示例与参数见安装后的专家技能说明。

package/dist/affordance/auth.md

@@ -2,6 +2,14 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+日常登录用 `sino-bc-cli /auth login`，查看身份用 `/auth status`。网关确认令牌过期或无效且能续期时，CLI 已自动刷新并只重试当前失败请求一次，不需要另调 `+refresh`。仍失败时按 `error.hint` 处理：没有可用 RT、RT 失效或重试仍被拒绝则重新授权；`api_forbidden` 联系管理员核对接口登记及权限；`corporation_forbidden` 重新选择有权限的主体；`authorization_unavailable` 稍后继续失败步骤。普通 HTTP 401 和网络故障保留授权；串行任务不从头重跑已成功的步骤。
+
+收到 `corporation_required`（17000048）时，先用 `/auth status` 和 `/tenant list` 查看当前身份及可用主体，成对补齐本次 `--corporation-id` 与 `--auth-context-id`，只继续当前失败操作。已带齐仍失败时，核对 `/schema` 与更新接口清单，不要反复选择主体；CLI 不自动选择、刷新、重试或改变接口的 `tenant` 标识。
+
+查看本人资料是否可用时读 `/auth status` 的 `data.profileCache`：`sso`、`system` 各有 `status`、`fetchedAt`、`expiresAt`，`passport` 按主体 ID 提供这些字段。`fresh` 表示有效，`expired` 表示已满 24 小时，`missing` 表示缺失且时间为 null；时间单位是毫秒，Passport 未出现的主体键也表示缺失。`data.sso` / `data.system` 仅返回有效资料，否则为 null；`data.passport` 仅保留有效主体资料，不代表默认主体。
+
+`/auth status` 不联网、不补查，也不续期。资料缺失或过期时，下次普通业务调用会按需自动补查；普通补查失败仍继续业务。主动调用用户资料查询接口不会更新本人缓存，即使查询的是本人。新登录成功或手动更换 AT 清旧资料；同身份令牌刷新、只更新 RT 或改网关地址保留原有效期，退出登录或清凭证则删除资料。
+
 ## +code
 
 - **WHEN**：获取授权链接地址

package/dist/affordance/biz-line.md

@@ -117,6 +117,24 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +ai-strategy-save --data '{...}'`
 
+## +ai-strategy-list
+
+- **WHEN**：业务线AI策略分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +ai-strategy-list --data '{...}'`
+
+## +use-log-list
+
+- **WHEN**：业务线AI策略使用日志分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +use-log-list --data '{...}'`
+
+## +snapshot-list
+
+- **WHEN**：用户填写原始策略快照分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +snapshot-list --data '{...}'`
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/affordance/project.md

@@ -191,6 +191,56 @@
 - **示例**：`sino-bc-cli project +update --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
 
+## +form-schema
+
+- **WHEN**：根据签约主体获取创建项目动态表单
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +form-schema --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。
+
+## +actions
+
+- **WHEN**：项目操作权限汇总
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +actions --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +bindings
+
+- **WHEN**：查询项目已绑定飞书群
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +bindings --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +eligible
+
+- **WHEN**：分页查询项目可绑定飞书群
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +eligible --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +bind
+
+- **WHEN**：绑定项目飞书群
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +bind --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +unbind
+
+- **WHEN**：解绑项目飞书群
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +unbind --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +replace
+
+- **WHEN**：换绑项目飞书群
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +replace --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/api-doc/README.md

@@ -12,6 +12,8 @@
 
 同名文档按 custom → oapi → 目录根解析。custom 同名文件会优先展示，只有确需完整覆盖生成文档时才使用。这是接口文档的按文件查找，不是技能安装方式。域工作流写在 `src/catalog/sync/domains/`（同步进 `skills/oapi/`）；额外专家技能放 `skills/custom/<技能名>/`，必须自带完整 `SKILL.md`。
 
+Skill 安装保留三类职责：shared 管共用规则，API 域管单域能力，专家编排已有能力形成任务产物。完整 custom 可整域替换 oapi；独立专家顶层分发，依赖域位于导航 domains 内，不替换依赖域。根 Skill 只概览、shared 和非空业务分类；分类页列 API 域能力，已核实域及能力可直读完整域。专家不进业务导航，`/skill` 列出全部入口。
+
 ## 按业务域查看
 
 | 域 | 用途 | 接口文档 |
@@ -48,6 +50,12 @@ CLI 从平台密钥存储读取身份令牌（macOS/Linux 为 AES 密文，Windo
 
 TTY 默认表格，非 TTY 默认 JSON 信封。成功 stdout，失败 stderr；参数/配置错误退出码 2，一般 API 错误 1。上游响应由 CLI 解包到 data，不需要调用者重复解包。
 
+网关明确确认令牌过期或无效且有可用 RT 时，CLI 强制续期并只重试当前失败请求一次；主体探查、资料补查和最终请求共用预算。没有可用 RT 或 RT 失效时只清理匹配身份，按提示重新授权并重新绑定主体；重试仍被拒绝则停止并提示重新授权。普通 HTTP 401、网络故障、无权限和鉴权服务故障保留凭证，不自动重放；业务重定向也不会自动跟随。串行任务从失败那一步继续，已成功步骤和分页不重跑。
+
+收到 `corporation_required`（17000048）时，先用 `/auth status` 和 `/tenant list` 查看当前身份及可用主体，成对补齐本次 `--corporation-id` 与 `--auth-context-id`，只继续当前失败操作。已带齐仍失败时，核对 `/schema` 与更新接口清单，不要反复选择主体；CLI 不自动选择、刷新、重试或改变接口的 `tenant` 标识。
+
+鉴权失败仍为 `error.type=api`、退出码 1，附 `error.code` 与原始 `businessCode`：17000042=`token_expired`，17000043=`token_invalid`（令牌无效或缺少应用授权），17000044=`corporation_forbidden`，17000045=`api_forbidden`，17000046=`authorization_unavailable`，17000048=`corporation_required`。17000045 同时用于接口未登记或无权限，按原消息排查并联系管理员核对接口登记及权限。未知码只保留原消息和业务码；`ddtraceId`、`appTrace` 沿用原约定。
+
 ## 维护同步
 
 运行 `npm run sync-api-doc`，自动发现所有模块，分别导出、解析 OpenAPI，全部成功后统一替换生成物。token 只取环境变量 `APIFOX_TOKEN`；禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证，不能只看 catalog 新增数量。

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

@@ -43,3 +43,67 @@
 | `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`。
+
+业务线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`。
+
+业务线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`。
+
+用户填写原始策略快照分页列表
+
+**输入参数（--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） |

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

@@ -8,7 +8,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按sceneCode查询业务字典，使用GET Query参数，不传JSON请求体。sceneCode必填，不存在的场景返回空数组。
 

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

@@ -8,7 +8,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询业务线分页列表。需要查询业务线关联项目和广告账号，使用业务线ID查询【业务线关联项目列表】。
 
@@ -40,7 +40,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 业务线详情
 
@@ -56,7 +56,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 ⚠️ 写操作。成功时 result 为新建业务线详情 BizLineDetailVO。
 
@@ -92,7 +92,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 更新业务线信息
 
@@ -130,7 +130,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 ⚠️ 写操作。仅更新状态与操作人；成功时 result 为 Boolean。status：1进行中 2已完成 3已暂停。
 
@@ -147,7 +147,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询投放策略分页列表
 
@@ -167,7 +167,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询投放策略消耗信息
 
@@ -183,7 +183,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 新建投放策略，投放策略按周填写
 
@@ -232,7 +232,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 更新投放策略
 
@@ -284,7 +284,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 根据业务线 ID 查询业务线关联项目和广告账号
 
@@ -301,7 +301,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询项目分页列表
 
@@ -338,7 +338,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询 Facebook（Meta）渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、受众类型、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Facebook广告策略成效数据」接口。
 
@@ -401,7 +401,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询 Google 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（成效目标、创意类型、出价方式、CPC/CPM/CPV 出价、广告系列类型、关键字等），用于分析某批账户在某段时间内各广告的策略配置分布。Google 渠道不支持广告目标和兴趣词包维度，出价字段使用 cpc_bid_amount、cpm_bid_amount、cpv_bid_amount 三个独立维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「Google广告策略成效数据」接口。
 
@@ -464,7 +464,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询 TikTok 渠道的广告策略配置数据。按指定广告账户和日期范围，返回广告的策略设置明细（广告目标、成效目标、创意类型、出价方式、调整出价、转化出价、深度转化出价、兴趣词包、年龄、性别等），用于分析某批账户在某段时间内各广告的策略配置分布。转化出价和深度转化出价是 TikTok 渠道独有的维度。本接口只返回策略维度，不含消耗、点击等成效指标，需要成效数据请改用「TikTok广告策略成效数据」接口。
 
@@ -527,7 +527,7 @@ result.total 为总条数，result.page 和 result.size 为当前分页。
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询 Facebook（Meta）渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、受众定向等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
 
@@ -598,7 +598,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询 Google 渠道广告的策略维度加成效指标数据。在广告策略配置（成效目标、创意类型、出价方式、广告系列类型、关键字等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。Google 渠道不支持广告目标和兴趣词包维度。
 
@@ -669,7 +669,7 @@ result.conflictField 是传入但当前渠道不支持的指标，会被忽略
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 查询 TikTok 渠道广告的策略维度加成效指标数据。在广告策略配置（广告目标、成效目标、创意类型、出价方式、转化出价、深度转化出价、兴趣词包等）的分组下，返回消耗、曝光、点击、购买、安装等成效指标，用于分析哪种策略配置带来更好的投放效果。
 

package/dist/api-doc/oapi/project-analysis.md

@@ -8,7 +8,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 该接口会创建 Excel 并返回文件 URL。
 
@@ -29,7 +29,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 该接口会创建 Excel 并返回文件 URL。
 
@@ -50,7 +50,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 该接口会创建 Excel 并返回文件 URL；导出项目列表由服务端覆盖分页为第一页和 Excel 最大行数。
 
@@ -78,7 +78,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。
 
@@ -99,7 +99,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定，当前默认不超过 2 个月按周，否则按月；以 dateDisplay 为准。
 
@@ -120,7 +120,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定，当前默认不超过 2 个月按周，否则按月；以 dateDisplay 为准。
 
@@ -141,7 +141,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。
 
@@ -162,7 +162,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。
 
@@ -190,7 +190,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定，当前默认不超过 2 个月按周，否则按月；以 dateDisplay 为准。
 
@@ -211,7 +211,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。 趋势粒度由后端配置决定，当前默认不超过 2 个月按周，否则按月；以 dateDisplay 为准。
 
@@ -232,7 +232,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 按月份（含起止月份）与可选行业、项目、PM 组别、签约主体筛选；开始月份不能晚于结束月份。后端按登录用户项目权限查询。
 
@@ -253,7 +253,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 分页查询工时系统项目列表，对应 t_atw_project 单表数据。
 
@@ -276,7 +276,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 分页查询工时系统项目任务列表，对应 t_atw_task 单表数据。
 
@@ -297,7 +297,7 @@
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
 
 分页查询工时系统工时明细，对应 t_atw_timesheet 单表数据。