sino-bc-cli 1.8.28 → 1.8.29

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. 路由
 
@@ -123,7 +127,12 @@ flowchart TD
 - `--dry-run` 与真实请求做**同一套**本地可组装校验，但不发 HTTP，也不探查主体列表。
 - 只有清单标成高风险写的接口才要 `--yes`；普通写操作直接执行。
 - 没有分页声明却传了翻页参数：直接校验失败，不发请求。
+- 一次 `--page-all` / `--page-limit` 固定首次有效身份，同身份令牌续期可继续；发现换身份则整次失败，不返回部分结果。确认当前身份后可重新完整查询，详见 shared 的自动翻页与鉴权恢复说明。
 - 成功看退出码 `0` 或 JSON 的 `ok`，不要看上游业务 `code`。
+- `--yes` 表示已获得高风险操作的确认，不能绕过身份、主体或其他必要校验。
+- 主体绑定与鉴权恢复由 shared 提供完整指引；鉴权失败按 `error.code`、`error.params` 和 `error.hint` 处理，不盲目重放结果未知的写入。
+
+执行 `sino-bc-cli /skill`，按返回的 `path` 读取 `sino-bc-shared` 轻量入口，再按当前任务或错误命中的条件读取对应 references；主体绑定、确认和鉴权恢复分别维护完整流程，无需预读全部参考。该路径来自当前 CLI 包，可在尚未安装 Agent 技能时查看。
 
 ## 安装
 
@@ -149,13 +158,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 +180,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 +202,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`。
 
 ## 调用样例
@@ -203,6 +227,10 @@ sino-bc-cli organization +info \
   --corporation-id <主体ID> \
   --auth-context-id <认证上下文ID>
 
+sino-bc-cli dict +items --data '{"sceneCodes":["<场景编码>"]}' \
+  --corporation-id <主体ID> \
+  --auth-context-id <认证上下文ID>
+
 sino-bc-cli biz-line +list --data '{"name":"<业务线名称>"}' --dry-run
 ```
 
@@ -216,4 +244,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,10 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+日常登录用 `sino-bc-cli /auth login`，查看身份与本人资料缓存用 `/auth status`；自动令牌恢复由 CLI 处理，不需另调 `+refresh`。本人资料缓存字段与有效期按 shared 的配置参考读取。
+
 ## +code
 
 - **WHEN**：获取授权链接地址

package/dist/affordance/biz-line.md

@@ -2,6 +2,8 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +list
 
 - **WHEN**：查询业务线分页列表
@@ -117,6 +119,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/common-file.md

@@ -2,6 +2,8 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +upload
 
 - **WHEN**：上传文件

package/dist/affordance/dashboard.md

@@ -2,72 +2,74 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +budget-by-marketing-goal
 
 - **WHEN**：营销目标预算分布
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +budget-by-marketing-goal --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +budget-by-media
 
 - **WHEN**：媒体预算占比
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +budget-by-media --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +budget-by-project-type
 
 - **WHEN**：项目类型预算分布
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +budget-by-project-type --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +budget-by-region
 
 - **WHEN**：区域预算占比
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +budget-by-region --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +budget-rank
 
 - **WHEN**：预算排行榜
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +budget-rank --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +budget-source-ratio
 
 - **WHEN**：预算来源占比
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +budget-source-ratio --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +key-project-timeline
 
 - **WHEN**：关键项目时间轴
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +key-project-timeline --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +metrics
 
 - **WHEN**：核心卡片指标
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +metrics --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +project-distribution
 
 - **WHEN**：项目分布
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli dashboard +project-distribution --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli dashboard 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/delivery.md

@@ -2,75 +2,77 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +campaign-page
 
 - **WHEN**：分页查询项目自动归集广告系列
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +campaign-page --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +campaign-get
 
 - **WHEN**：查询广告系列设置
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +campaign-get --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +campaign-save
 
 - **WHEN**：保存广告系列设置
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +campaign-save --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +core-metrics
 
 - **WHEN**：核心指标卡
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +core-metrics --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +detail-choose-list
 
 - **WHEN**：查询项目维度筛选列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +detail-choose-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +detail-list
 
 - **WHEN**：查询项目成效列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +detail-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +dimension-module
 
 - **WHEN**：维度分布
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +dimension-module --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +kpi-module
 
 - **WHEN**：KPI 进度与走势
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +kpi-module --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +spend-module
 
 - **WHEN**：消耗分析
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +spend-module --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +stage-tabs
 
 - **WHEN**：投放阶段 Tab 下拉（含起止时间）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli delivery +stage-tabs --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## api
@@ -78,4 +80,4 @@
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli delivery 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/dict.md

@@ -0,0 +1,28 @@
+# dict 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +items
+
+- **WHEN**：按场景查询字典条目
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli dict +items --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +scenes
+
+- **WHEN**：按作用域查询字典场景
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli dict +scenes --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 dict api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/document.md

@@ -2,40 +2,42 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +project-delete
 
 - **WHEN**：删除项目文档
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +project-delete --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +linked-tasks
 
 - **WHEN**：查询项目文档已关联任务列表（同项目同 storage_key 的 TASK 文档行）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +linked-tasks --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +project-list
 
 - **WHEN**：查询项目文档
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +project-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +update-stage
 
 - **WHEN**：修改项目文档所属阶段
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +update-stage --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +project-upload
 
 - **WHEN**：上传项目文档（multipart/form-data：projectId项目ID，file 为文件 part）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +project-upload --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 - **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
 
@@ -44,7 +46,7 @@
 - **WHEN**：协同文档详情
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +list
@@ -52,18 +54,18 @@
 - **WHEN**：协同文档列表（全量）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +page
 
 - **WHEN**：协同文档列表（分页）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli document +page --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli document 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/file.md

@@ -2,12 +2,14 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +upload-info-by-record
 
 - **WHEN**：根据上传记录ID获取上传文件信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli file +upload-info-by-record --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +upload-info
@@ -15,7 +17,7 @@
 - **WHEN**：获取上传文件信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli file +upload-info --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +upload
@@ -23,7 +25,7 @@
 - **WHEN**：文件上传
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli file +upload --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 - **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
 
@@ -32,7 +34,7 @@
 - **WHEN**：获取上传文件链接
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli file +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## api
@@ -40,4 +42,4 @@
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli file 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。