npm - sino-bc-cli - Versions diffs - 1.8.28 → 1.8.29 - Mend

sino-bc-cli 1.8.28 → 1.8.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (114) hide show

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

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

package/dist/api-doc/oapi/common-file.md CHANGED Viewed

@@ -2,6 +2,8 @@
 对应命令：`common-file +<shortcut>` 与 `common-file api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 ## 1. 上传文件
 `POST /bc-business-pu/file/fileUpload`
@@ -10,6 +12,8 @@
 角色范围：`sso/system`。
+风险：`write`。
 上传单个私有文件，使用multipart/form-data，file为必填文件part。serviceName可选，未传或为空字符串时默认bc-business-pu，支持的服务名见参数枚举。
 上传文件不能为空，默认最大50MB（52428800字节，含边界），由Apollo配置file.upload.max-size控制。存储目录为服务名/yyyy-MM，文件名使用UUID并保留扩展名。上传返回的私有链接有效期默认3600秒，由file.download.url-expire-seconds控制。
@@ -33,6 +37,8 @@
 角色范围：`sso/system`。
+风险：`read`。
 使用文件上传成功后返回的storageKey获取私有文件下载链接。storageKey必填且不能是空白字符串，请原样传入，不要传已有下载URL。
 成功时result直接返回URL字符串，不执行302重定向。有效期默认3600秒，由Apollo配置file.download.url-expire-seconds控制，与上传返回链接使用同一配置。链接失效后可重新调用本接口生成。生成失败、返回空链接或有效期配置非正数时返回业务错误。本接口不要求业务签约主体参数。

package/dist/api-doc/oapi/dashboard.md CHANGED Viewed

@@ -2,6 +2,8 @@
 对应命令：`dashboard +<shortcut>` 与 `dashboard api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 ## 1. 营销目标预算分布
 `POST /sino-bc-nexus/dashboard/budget-by-marketing-goal`
@@ -10,7 +12,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-budget-by-marketing-goal --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -31,7 +35,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-budget-by-media --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -52,7 +58,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-budget-by-project-type --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -73,7 +81,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-budget-by-region --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -95,7 +105,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-budget-rank --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -118,7 +130,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-budget-source-ratio --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -140,7 +154,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-key-project-timeline --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -162,7 +178,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-metrics --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -183,7 +201,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli dashboard api dashboard-project-distribution --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。

package/dist/api-doc/oapi/delivery.md CHANGED Viewed

@@ -2,6 +2,8 @@
 对应命令：`delivery +<shortcut>` 与 `delivery api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 ## 1. 分页查询项目自动归集广告系列
 `POST /sino-bc-nexus/project/campaign/setting/campaign/page`
@@ -10,7 +12,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-campaign-setting-campaign-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -36,7 +40,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-campaign-setting-get --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -56,7 +62,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-campaign-setting-save --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -90,7 +98,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-core-metrics --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -115,7 +125,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-detail-choose-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -141,7 +153,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-detail-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -166,7 +180,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-dimension-module --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -193,7 +209,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-kpi-module --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -217,7 +235,9 @@ KPI 进度与走势
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-spend-module --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -241,7 +261,9 @@ KPI 进度与走势
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli delivery api project-delivery-data-stage-tabs --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。

package/dist/api-doc/oapi/dict.md ADDED Viewed

@@ -0,0 +1,49 @@
+# 通用字典
+对应命令：`dict +<shortcut>` 与 `dict api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+## 1. 按场景查询字典条目
+`GET /sino-bc-nexus/dict/items`
+主体上下文：`tenant=true`。
+角色范围：`sso/passport/system`。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+调用示例：`sino-bc-cli dict api dict-items --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+只查询启用条目；优先当前登录签约主体私有字典，无私有条目时整体回落corporationId=0全局字典。按场景maxLevel返回扁平列表或children树。场景编码拆逗号、trim、去空白并保序去重；场景不存在或有效编码为空时报错。有场景但无启用条目时保留key并返回空列表。返回Map，key是sceneCode，不是场景名称。下拉提交编码取itemCode；itemValue是条目业务配置值，不应混用。主体从AccessContext取，不额外传corporationId。参数名依据@RequestParam实际Java参数sceneCodes，代码注释中的sceneCode单数不是实际绑定名。
+**输入参数（--data）**
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `sceneCodes` | array | query | 是 | 场景编码列表；实际参数名sceneCodes。可传sceneCodes=TYPE,REGION，或sceneCodes=TYPE&sceneCodes=REGION。 |
+## 2. 按作用域查询字典场景
+`GET /sino-bc-nexus/dict/scenes`
+主体上下文：`tenant=true`。
+角色范围：`sso/passport/system`。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+调用示例：`sino-bc-cli dict api dict-scenes --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
+只查询未删除字典场景。bizScope去空白并转大写，命中该作用域或ALL通用作用域的场景，按sortOrder、id升序；未传bizScope时返回全部场景。此接口只返回场景定义，具体选项调用/dict/items查询；不返回项目表单schema全部字段。这个GET接口的bizScope省略不会默认PROJECT，不要与Aily POST聚合字典接口混淆。
+**输入参数（--data）**
+| 字段 | 类型 | 位置 | 必填 | 说明 |
+| --- | --- | --- | --- | --- |
+| `bizScope` | string | query | 否 | 业务用途筛选，如PROJECT、TASK；省略或空白不筛选。 |

package/dist/api-doc/oapi/document.md CHANGED Viewed

@@ -2,6 +2,8 @@
 对应命令：`document +<shortcut>` 与 `document api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 ## 1. 删除项目文档
 `POST /sino-bc-nexus/project/document/delete`
@@ -10,7 +12,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api project-document-delete --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -30,7 +34,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api project-document-linked-tasks --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -50,7 +56,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api project-document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -72,7 +80,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api project-document-update-stage --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -93,7 +103,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api project-document-upload --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -117,7 +129,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api document-detail --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -137,7 +151,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api document-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -164,7 +180,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli document api document-page --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。

package/dist/api-doc/oapi/file.md CHANGED Viewed

@@ -2,6 +2,8 @@
 对应命令：`file +<shortcut>` 与 `file api <name>`。
+执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 ## 1. 根据上传记录ID获取上传文件信息
 `GET /sino-bc-nexus/file/upload-info-by-record`
@@ -10,7 +12,9 @@
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli file api file-upload-info-by-record --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -31,7 +35,9 @@ preview=true 表示预览文档，不记下载日志
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli file api file-upload-info --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -52,7 +58,9 @@ preview=true 表示预览文档，不记下载日志
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`write`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli file api file-upload --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
@@ -75,7 +83,9 @@ preview=true 表示预览文档，不记下载日志
 角色范围：`sso/passport/system`。
-该接口需要本次调用的主体绑定：先执行 `sino-bc-cli /auth status` 查看认证上下文，再用 `sino-bc-cli /tenant list` 查询当前身份可用主体，按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`，不要放进 `--data`。漏传可补齐已有有效绑定；认证上下文变化时清除旧绑定，重新查询主体并唯一匹配后重新绑定，不能只替换认证标记。
+风险：`read`。
+主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 调用示例：`sino-bc-cli file api file-url --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。