sino-bc-cli 1.8.28 → 1.8.29

package/dist/affordance/task.md

@@ -2,54 +2,56 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +action-log
 
 - **WHEN**：任务操作日志列表（全量）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +action-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +adjust
 
 - **WHEN**：调整任务(编辑任务基本信息、成员等，状态重新流转)
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +adjust --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 条件索引读取主体参考。
 
 ## +approve-review
 
 - **WHEN**：审核通过
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +approve-review --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 条件索引读取主体参考。
 
 ## +confirm
 
 - **WHEN**：确认通过
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +confirm --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 条件索引读取主体参考。
 
 ## +create
 
 - **WHEN**：创建任务
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +create --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 条件索引读取主体参考。
 
 ## +delete
 
 - **WHEN**：删除任务
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +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 条件索引读取主体参考。
 
 ## +detail
 
 - **WHEN**：协同任务详情
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +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。
 
 ## +edit
@@ -57,53 +59,53 @@
 - **WHEN**：编辑任务（修改基本信息、所属阶段、成员、附件，状态不变更，仅限待执行/待确认）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +edit --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 条件索引读取主体参考。
 
 ## +list
 
 - **WHEN**：协同任务列表（全量）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +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 task +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 条件索引读取主体参考。
 
 ## +pause
 
 - **WHEN**：暂停任务
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +pause --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 条件索引读取主体参考。
 
 ## +reject-modify
 
 - **WHEN**：需修改（驳回）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +reject-modify --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 条件索引读取主体参考。
 
 ## +reject-review
 
 - **WHEN**：审核需修改
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +reject-review --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 条件索引读取主体参考。
 
 ## +submit-delivery
 
 - **WHEN**：去完成（提交交付）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli task +submit-delivery --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 task 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/tenant.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**：查询用户签约主体列表

package/dist/affordance/user.md

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

package/dist/affordance/wallet.md

@@ -2,19 +2,21 @@
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +bill-original
@@ -22,28 +24,28 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +invoice-list
@@ -51,14 +53,14 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +invoice-download
@@ -66,42 +68,42 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +credit
@@ -109,21 +111,21 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--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>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `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。
 
 ## +recharge-recent
@@ -131,7 +133,7 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## +currency
@@ -139,56 +141,56 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--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>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `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 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--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>`
-- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `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。
 
 ## +exchange-rate
@@ -196,7 +198,7 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## api
@@ -204,4 +206,4 @@
 - **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

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` 列出全部入口。
+
 ## 按业务域查看
 
 | 域 | 用途 | 接口文档 |
@@ -23,6 +25,7 @@
 | project | 营销协同项目、成员、分组 | [项目](oapi/project.md) |
 | project-stage | 营销协同项目阶段 | [阶段](oapi/project-stage.md) |
 | task | 营销协同任务 | [任务](oapi/task.md) |
+| dict | 营销协同字典场景、下拉选项与条目 | [通用字典](oapi/dict.md) |
 | document | 文档中心与项目文档 | [文档](oapi/document.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) |
@@ -48,6 +51,8 @@ CLI 从平台密钥存储读取身份令牌（macOS/Linux 为 AES 密文，Windo
 
 TTY 默认表格，非 TTY 默认 JSON 信封。成功 stdout，失败 stderr；参数/配置错误退出码 2，一般 API 错误 1。上游响应由 CLI 解包到 data，不需要调用者重复解包。
 
+先读 [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

@@ -2,6 +2,8 @@
 
 对应命令：`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`
@@ -10,6 +12,8 @@
 
 角色范围：`未声明`。
 
+风险：`read`。
+
 CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一 deviceCode 未过期重复调用返回原链接且不延长 TTL。已落库的 deviceCode 不能重新申请，返回 DENIED。本接口免登录，由 deviceCode 校验。
 
 **输入参数（--data）**
@@ -28,6 +32,8 @@ CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一
 
 角色范围：`未声明`。
 
+风险：`read`。
+
 按设备凭证查询授权状态或领取首代凭证。未确认返回 PENDING；申请过期或领取恢复窗口已过返回 EXPIRED；确认后首次领取写入授权及首代 token，宽限 300 秒内可恢复同一代结果。本接口免登录，由 deviceCode 校验。
 
 **输入参数（--data）**
@@ -44,6 +50,8 @@ CLI 生成浏览器授权链接。尚未确认时只保存短期申请；同一
 
 角色范围：`未声明`。
 
+风险：`read`。
+
 轮换刷新凭证。刷新凭证不存在、已删除、已失效或宽限外重试返回 INVALID_GRANT；首次轮换签发下一代 token 对，宽限内重试返回同一代结果，不产生分支、不延长到期。
 
 **输入参数（--data）**

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

@@ -2,6 +2,8 @@
 
 对应命令：`biz-line +<shortcut>` 与 `biz-line 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`
@@ -10,6 +12,8 @@
 
 角色范围：`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。
@@ -43,3 +47,73 @@
 | `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） |

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

@@ -2,13 +2,17 @@
 
 对应命令：`biz-line +<shortcut>` 与 `biz-line api <name>`。
 
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
 ## 1. 查询业务线字典和策略标签
 
 `GET /sino-opti-hive/dict/items`
 
 主体上下文：`tenant=false`。
 
-角色范围：`sso`。
+角色范围：`sso/system`。
+
+风险：`read`。
 
 按sceneCode查询业务字典，使用GET Query参数，不传JSON请求体。sceneCode必填，不存在的场景返回空数组。