sino-bc-cli 1.8.9 → 1.8.11

package/dist/affordance/project.md

@@ -0,0 +1,199 @@
+# project 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+## +page-by-project
+
+- **WHEN**：按项目查询最新操作日志（分页倒序）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +page-by-project --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +budget-field-config
+
+- **WHEN**：预算分布动态字段配置（按签约主体解析：主体 > 行业 > 不展示）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +budget-field-config --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +create
+
+- **WHEN**：创建对客项目
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +delete
+
+- **WHEN**：删除对客项目
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +detail
+
+- **WHEN**：对客项目详情（平铺 JSON：ext_json values + 业务组装字段）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +industry-options
+
+- **WHEN**：项目字段字典-下拉选项（按行业类型，适用于 SOURCE/GOAL/REGION/COUNTRY/MEDIA；industryType 可空，空则取当前签约主体行业）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +industry-options --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。
+
+## +industry-resolve
+
+- **WHEN**：项目字段字典-批量解析 code->name（按行业类型）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +industry-resolve --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +options
+
+- **WHEN**：项目字段字典-下拉选项（按签约主体，适用于 STATUS/TYPE/BUSINESS_LINE/MARKET_SCOPE）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +options --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。
+
+## +resolve
+
+- **WHEN**：项目字段字典-批量解析 code->name（按签约主体）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +resolve --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-create
+
+- **WHEN**：Formily 平铺 JSON 创建对客项目（从 body 取 templateType/templateId；响应同详情平铺）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +form-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +form-update
+
+- **WHEN**：Formily 平铺 JSON 编辑对客项目（从 body 取 id/templateType/templateId；响应同详情平铺）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +form-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +batch-update-projects
+
+- **WHEN**：批量修改项目分组（将指定项目移动到目标分组）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +batch-update-projects --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +group-create
+
+- **WHEN**：创建项目分组
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +group-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +group-delete
+
+- **WHEN**：删除项目分组
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +group-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +group-detail
+
+- **WHEN**：分组详情
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +group-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +group-list
+
+- **WHEN**：分组列表（全量）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +group-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +group-update
+
+- **WHEN**：更新项目分组名称
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +group-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +list
+
+- **WHEN**：对客项目列表（全量）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +invite
+
+- **WHEN**：邀请项目成员
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +invite --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +member-list
+
+- **WHEN**：项目成员列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +member-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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +projects
+
+- **WHEN**：指定用户关联项目列表（项目成员+任务成员）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +projects --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。
+
+## +remove
+
+- **WHEN**：移除项目成员
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +remove --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +tasks
+
+- **WHEN**：项目成员参与任务
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +page
+
+- **WHEN**：对客项目列表（分页）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +status
+
+- **WHEN**：更新对客项目状态
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +status --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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +update
+
+- **WHEN**：编辑对客项目
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli project api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。

package/dist/affordance/sso.md

@@ -10,6 +10,6 @@
 
 ## api
 
-- **WHEN**：没有 `+` 的接口按 name 点名调用。
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
 - **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
 - **示例**：`sino-bc-cli sso api <name> --data '{...}'`

package/dist/affordance/task.md

@@ -0,0 +1,109 @@
+# task 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +edit
+
+- **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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## +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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+
+## 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`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。

package/dist/affordance/tenant.md

@@ -0,0 +1,15 @@
+# tenant 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+## +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,33 @@
+# user 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+## +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用户信息
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +sso-info --data '{...}'`
+
+## +sso-info-batch
+
+- **WHEN**：批量查询SSO用户信息
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli user +sso-info-batch --data '{...}'`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli user api <name> --data '{...}'`

package/dist/api-doc/README.md

@@ -0,0 +1,51 @@
+# 接口文档索引
+
+本目录描述 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 同名文件会优先展示，只有确需完整覆盖生成文档时才使用；一般业务工作流放 `skills/default/sino-bc-<domain>/references/`。
+
+## 按业务域查看
+
+| 域 | 用途 | 接口文档 |
+| --- | --- | --- |
+| biz-line | 业务线、周策略、渠道、品类、优化项目及广告成效 | [查询](oapi/biz-line-query.md)、[策略](oapi/biz-line-strategy.md) |
+| project-analysis | 优化项目月度分析、消耗/工时趋势、人效与 Excel 导出 | [项目分析](oapi/project-analysis.md) |
+| sso | SSO 组别 | [SSO](oapi/sso.md) |
+| project | 营销协同项目、成员、分组 | [项目](oapi/project.md) |
+| project-stage | 营销协同项目阶段 | [阶段](oapi/project-stage.md) |
+| task | 营销协同任务 | [任务](oapi/task.md) |
+| document | 文档中心与项目文档 | [文档](oapi/document.md) |
+| file | 文件上传与对象存储记录 | [文件](oapi/file.md) |
+| delivery | Campaign 归集与投放阶段指标 | [投放](oapi/delivery.md) |
+| dashboard | 看板 | [看板](oapi/dashboard.md) |
+| organization | 组织架构、团队成员与当前用户 | [组织用户](oapi/organization.md) |
+| user | SSO 与签约主体（租户）用户资料 | [用户信息](oapi/user.md) |
+| im | 飞书群消息 | [消息](oapi/im.md) |
+| tenant | 用户签约主体列表 | [租户](oapi/tenant.md) |
+| auth | CLI 设备授权协议；日常登录优先 `/auth login` | [授权](oapi/auth.md) |
+
+接口名称和数量以 `src/generated/api-catalog.json` 为唯一运行时依据；name 来自 OpenAPI 的 `x-cli-name`，不能从路由自行拼造。新开发者接入流程见 [bc-develop](../../.cursor/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，不需要调用者重复解包。
+
+## 维护同步
+
+运行 `npm run sync-api-doc`，自动发现所有模块，分别导出、解析 OpenAPI，全部成功后统一替换生成物。token 只取环境变量 `APIFOX_TOKEN`；禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证，不能只看 catalog 新增数量。

package/dist/api-doc/custom/cli-oauth.md

@@ -0,0 +1,19 @@
+# CLI 设备授权与自动刷新
+
+交互 `/set-config` 的身份令牌项直接回车，保留完整 OAuth 凭证；显式输入 AT 才清除原 RT 并切换为手动模式，随后可空询问 RT。`/init` 只装技能，不问令牌。`auth login/logout/status` 支持省略 `/`，`auth +<shortcut>` 与 `auth api <name>` 则调用接口目录。
+
+认证与业务共用生效网关根（缺省 `https://agent.beyondclick.com`，可用 `/set-config gateway-url` 改写），拼接 `/platform/auth/cli/...`。认证 HTTP 不跟随重定向。浏览器确认页打开服务端返回的 `verificationUrl` 原值，不再校验 origin。不可把私密设备码传入浏览器。`/auth login` 领取成功后进度流写出「授权成功，本机身份已就绪」；json 信封 `data.message` 为同文案并含 `data.configured: true`；TTY table 下 stdout 为含相同字段的结果对象。DENIED / EXPIRED 不写该成功文案。不输出 AT/RT。
+
+| 操作 | POST path | JSON 请求体 |
+| --- | --- | --- |
+| 申请网页授权码 | `/platform/auth/cli/device/oauth/code` | `{deviceCode,clientId:"sino-bc-cli",accessType:"offline_access"}` |
+| 交换凭证 | `/platform/auth/cli/device/oauth/exchange` | `{deviceCode}` |
+| 刷新 | `/platform/auth/cli/oauth/refresh` | `{refreshToken}` |
+
+CLI 用 `randomBytes(32).toString('base64url')` 生成私密 deviceCode。申请响应为独立网页 `code` 与 `verificationUrl`；设备码不得拼入授权地址。成功业务信封为 `{code:0,result:{...}}`（兼容 `data` 包装）。交换状态为 `PENDING`（3 秒后继续）、`EXPIRED`/`DENIED`（终止）或 `SUCCESS`。刷新状态为 `SUCCESS` 或 `INVALID_GRANT`（清除对应旧凭证并要求重新授权）。
+
+令牌字段：`accessToken`、`refreshToken`、`tokenType:"Bearer"`、`accessExpiresAt`、`refreshExpiresAt`。两个 ExpiresAt 字段均为绝对过期时间（毫秒时间戳）；CLI 校验为未过期的安全整数后直接保存，不按请求或响应时间重新计算。重复领取返回相同截止时间。
+
+整套 OAuth 凭证存在平台密钥存储中，与环境无关；旧记录若仍带 `env` 字段则忽略。macOS/Linux 令牌本体为 `~/.sino-bc-cli/secrets/authToken.enc`（AES-256-GCM）；macOS Keychain 只存 32 字节主密钥，可用 `/auth keychain-downgrade` 抄到文件。Windows 仍为当前用户凭据库 JSON。空凭证删除密文并留下无秘密的 `authToken.rev` 墓碑。旧 raw AT 兼容读取。AT 剩余超过 300 秒直接使用，否则在跨进程刷新锁内重读、校验 RT 并刷新。锁使用 `fs-native-extensions` 的 OS 文件描述符排他锁，目录在 `<home>/.sino-bc-cli/locks`。活进程锁不会按时间拆除，进程退出时由内核释放。所有凭证修改使用短临界区锁及版本比较交换，避免旧刷新/旧登录覆盖手动 AT、退出、新登录。`/auth logout` 清整份身份面（密文、墓碑、主密钥、遗留 keychain `authToken`）。网络或服务暂时错误保留凭证。exchange 遇到传输错误、HTTP 5xx/429 时保持同一 deviceCode 每 3 秒重试，服务端提交成功但响应丢失时可在授权后的 300 秒领取窗口恢复同代令牌；其它协议错误明确终止。
+
+`GatewayClient.call` 从配置携带的内存解析器取得最新 AT；`prepare`/dry-run 不联网。请求日志不包含认证请求体或原始上游错误。

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

@@ -0,0 +1,57 @@
+# CLI设备授权
+
+> **网关地址**：缺省 `https://agent.beyondclick.com`，可用 `/set-config gateway-url` 改写；业务与登录共用该根。不要直连上游服务地址。
+>
+> **调用路径**：等于下方列出的 path（即 OpenAPI / catalog 路由），由 CLI 拼到网关地址后发出。
+
+对应命令：`auth +<shortcut>` 与 `auth api <name>`。
+
+## 1. 获取授权链接地址
+
+`POST /platform/auth/cli/device/oauth/code`
+
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
+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`。
+
+角色范围：`未声明`。
+
+按设备凭证查询授权状态或领取首代凭证。未确认返回 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`。
+
+角色范围：`未声明`。
+
+轮换刷新凭证。刷新凭证不存在、已删除、已失效或宽限外重试返回 INVALID_GRANT；首次轮换签发下一代 token 对，宽限内重试返回同一代结果，不产生分支、不延长到期。
+
+**输入参数（--data）**
+
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `refreshToken` | string | body | 是 | exchange 或上一次 refresh 返回的 refreshToken |

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

@@ -1,6 +1,6 @@
 # 业务线查询
 
-> **网关地址**：`https://test-agent.beyondclick.com`（三环境同一地址，唯一来源 `src/constants/gateway.ts` 的 `GATEWAY_CONFIG`），不要直连上游服务地址。
+> **网关地址**：缺省 `https://agent.beyondclick.com`，可用 `/set-config gateway-url` 改写；业务与登录共用该根。不要直连上游服务地址。
 >
 > **调用路径**：等于下方列出的 path（即 OpenAPI / catalog 路由），由 CLI 拼到网关地址后发出。
 
@@ -10,10 +10,18 @@
 
 `GET /sino-opti-hive/biz-line-open/channels`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询投放渠道列表
 
 ## 2. 查询投放品类字典
 
 `GET /sino-opti-hive/biz-line-open/placement-categories`
 
+主体上下文：`tenant=false`。
+
+角色范围：`未声明`。
+
 查询投放品类字典，sceneCode 固定 PLACEMENT_CATEGORY。一级节点 = 投放行业，二级节点（children）= 投放品类，分别对应筛选参数 adCategoryIndustryId / adCategoryProjectId。已过滤 isOther=1 的「其他」。叶子节点 children 为 null。