sino-bc-cli 1.8.29 → 1.8.31-beta.0

package/README.md

@@ -29,6 +29,7 @@ node -v    # 需要 v24.x 或更高
 2. **请求编排集中**：鉴权头、主体绑定、确认门、分页、输出信封由公共层做。域代码只回答「调哪条接口、请求体是什么」。
 3. **Shortcut 三层**：手写（名称解析、默认值）优先；其余一对一由清单生成薄命令；长尾用 `api <name>` 点名。
 4. **生成物与手写分层**：同步只覆盖生成层；专家口径和横切规则不随同步被冲掉。
+5. **目录归属一致**：Apifox 模块形成业务域导航，一级业务目录对应一个 API Skill 和命令域，子目录在 Skill 内按功能分组。目录改名保留稳定英文命令域；接口跨一级目录迁移后使用新域前缀，旧调用不保留别名。
 
 ```mermaid
 flowchart TB
@@ -47,7 +48,7 @@ flowchart TB
   end
 
   subgraph maintainer [维护者同步 不在运行时触发]
-    AF[Apifox OpenAPI] --> SYNC[生成 catalog / 文档 / 技能]
+    AF[Apifox OpenAPI 与目录结构] --> SYNC[生成 catalog / 文档 / 技能]
     SYNC --> CAT
   end
 ```
@@ -158,7 +159,7 @@ sino-bc-cli --help
 sino-bc-cli /init
 ```
 
-`/init` 安装同一包中的导航、shared、API 域与专家技能，API 域位于 `sino-bc-cli/domains/<name>/`，通过业务分类按需读取；shared 和专家是顶层完整入口。默认写入 `~/.agents/skills`；本机存在 `~/.claude` 时也写入 `~/.claude/skills`。需要其它目录时使用 `/skill target add <目录>` 显式登记。它不写入令牌。飞书豆包：技能·连接器 → 管理 → **本地** → 刷新。
+`/init` 安装同一包中的导航、shared、API 域与专家技能，API 域位于 `sino-bc-cli/domains/<name>/`，通过与 Apifox 模块对应的业务域导航按需读取；shared 和专家是顶层完整入口。默认写入 `~/.agents/skills`；本机存在 `~/.claude` 时也写入 `~/.claude/skills`。需要其它目录时使用 `/skill target add <目录>` 显式登记。它不写入令牌。飞书豆包：技能·连接器 → 管理 → **本地** → 刷新。
 
 每次安装或刷新都会整目录替换 `sino-bc-cli`、`sino-bc-shared`。专家按旧安装记录中的有效名单与当前包名单的并集清理，再整目录安装当前包的专家；旧名单不存在、损坏、无法读取或无法识别时，改用当前包的专家名单。同名专家和两个固定目录中的本地修改也会被替换，缺失目录会重新安装；其它技能保留，不按名称前缀扫描删除。降级时无法识别当前包已不包含的旧专家，这些目录会保留。
 
@@ -172,7 +173,7 @@ sino-bc-cli /init
 
 上手顺序：安装 → `/init` → `/auth login` → 需要主体时 `/tenant list` → 业务命令或 `/schema`。
 
-Agent 在 API 域未知或有歧义时从业务分类选择并读取完整域 Skill；已用当前依赖说明、CLI 帮助或 schema 核实域及能力时直接读取。完成策略生成等任务时直接选择专家 Skill；各入口按需读取 shared 和依赖域。`sino-bc-cli/SKILL.md` 只提供概览、shared 及 API 分类导航；专家不在业务导航中，`/skill` 仍列出全部入口。全部技能随同一个 npm 包安装、升级和卸载。仓库开发看源码根目录 `AGENTS.md`（不随 npm 包分发）。
+Agent 在 API 域未知或有歧义时先选业务域，再选择一级目录对应的完整 API Skill；已用当前依赖说明、CLI 帮助或 schema 核实域及能力时直接读取。完成策略生成等任务时直接选择专家 Skill；各入口按需读取 shared 和依赖域。`sino-bc-cli/SKILL.md` 只提供概览、shared 及 API 分类导航；专家不在业务导航中，`/skill` 仍列出全部入口。全部技能随同一个 npm 包安装、升级和卸载。仓库开发看源码根目录 `AGENTS.md`（不随 npm 包分发）。
 
 ## 斜杠命令
 

package/dist/affordance/{file.md → bill.md}

@@ -1,45 +1,48 @@
-# file 命令何时用
+# bill 命令何时用
 
 字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
 
 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
 
-## +upload-info-by-record
+## +bill-list
 
-- **WHEN**：根据上传记录ID获取上传文件信息
+- **WHEN**：对账单列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli file +upload-info-by-record --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli bill +bill-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +upload-info
+## +bill-detail
 
-- **WHEN**：获取上传文件信息
+- **WHEN**：对账单基本信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli file +upload-info --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli bill +bill-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +upload
+## +bill-original
 
-- **WHEN**：文件上传
+- **WHEN**：对账单明细
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli file +upload --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli bill +bill-original --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-- **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
 
-## +url
+## +bill-operate
 
-- **WHEN**：获取上传文件链接
+- **WHEN**：对账单操作历史
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli file +url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli bill +bill-operate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +bill-enum
+
+- **WHEN**：对账单与发票枚举
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli bill +bill-enum --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 file api <name> --data '{...}'`
+- **示例**：`sino-bc-cli bill api <name> --data '{...}'`
 - **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/biz-line-ai-strategy.md

@@ -0,0 +1,35 @@
+# biz-line-ai-strategy 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +ai-strategy-save
+
+- **WHEN**：保存业务线AI策略
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-ai-strategy +ai-strategy-save --data '{...}'`
+
+## +list
+
+- **WHEN**：业务线AI策略分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-ai-strategy +list --data '{...}'`
+
+## +use-log-list
+
+- **WHEN**：业务线AI策略使用日志分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-ai-strategy +use-log-list --data '{...}'`
+
+## +snapshot-list
+
+- **WHEN**：用户填写原始策略快照分页列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-ai-strategy +snapshot-list --data '{...}'`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli biz-line-ai-strategy api <name> --data '{...}'`

package/dist/affordance/biz-line-metrics.md

@@ -0,0 +1,47 @@
+# biz-line-metrics 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +facebook-dimension
+
+- **WHEN**：Facebook广告策略维度数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-metrics +facebook-dimension --data '{...}'`
+
+## +google-dimension
+
+- **WHEN**：Google广告策略维度数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-metrics +google-dimension --data '{...}'`
+
+## +tiktok-dimension
+
+- **WHEN**：TikTok广告策略维度数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-metrics +tiktok-dimension --data '{...}'`
+
+## +facebook-metrics
+
+- **WHEN**：Facebook广告策略成效数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-metrics +facebook-metrics --data '{...}'`
+
+## +google-metrics
+
+- **WHEN**：Google广告策略成效数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-metrics +google-metrics --data '{...}'`
+
+## +tiktok-metrics
+
+- **WHEN**：TikTok广告策略成效数据
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line-metrics +tiktok-metrics --data '{...}'`
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli biz-line-metrics api <name> --data '{...}'`

package/dist/affordance/biz-line.md

@@ -65,6 +65,12 @@
 - **示例**：`sino-bc-cli biz-line +categories --data '{...}'`
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
+## +group-list
+
+- **WHEN**：查询组别列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli biz-line +group-list`
+
 ## +project-list
 
 - **WHEN**：查询业务线关联项目和广告账号
@@ -77,66 +83,6 @@
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli biz-line +queryByPage --data '{...}'`
 
-## +facebook-dimension
-
-- **WHEN**：Facebook广告策略维度数据
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +facebook-dimension --data '{...}'`
-
-## +google-dimension
-
-- **WHEN**：Google广告策略维度数据
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +google-dimension --data '{...}'`
-
-## +tiktok-dimension
-
-- **WHEN**：TikTok广告策略维度数据
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +tiktok-dimension --data '{...}'`
-
-## +facebook-metrics
-
-- **WHEN**：Facebook广告策略成效数据
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +facebook-metrics --data '{...}'`
-
-## +google-metrics
-
-- **WHEN**：Google广告策略成效数据
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +google-metrics --data '{...}'`
-
-## +tiktok-metrics
-
-- **WHEN**：TikTok广告策略成效数据
-- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli biz-line +tiktok-metrics --data '{...}'`
-
-## +ai-strategy-save
-
-- **WHEN**：保存业务线AI策略
-- **别用**：已有更贴切的 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/document.md

@@ -4,64 +4,60 @@
 
 执行前 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>`
-- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-
-## +linked-tasks
+## +detail
 
-- **WHEN**：查询项目文档已关联任务列表（同项目同 storage_key 的 TASK 文档行）
+- **WHEN**：协同文档详情
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +linked-tasks --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +project-list
+## +list
 
-- **WHEN**：查询项目文档
+- **WHEN**：协同文档列表（全量）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +project-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
-## +update-stage
+## +page
 
-- **WHEN**：修改项目文档所属阶段
+- **WHEN**：协同文档列表（分页）
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +update-stage --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
-## +project-upload
+## +upload-info-by-record
 
-- **WHEN**：上传项目文档（multipart/form-data：projectId项目ID，file 为文件 part）
+- **WHEN**：根据上传记录ID获取上传文件信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +project-upload --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +upload-info-by-record --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
-- **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
 
-## +detail
+## +upload-info
 
-- **WHEN**：协同文档详情
+- **WHEN**：获取上传文件信息
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +upload-info --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +list
+## +upload
 
-- **WHEN**：协同文档列表（全量）
+- **WHEN**：文件上传
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +upload --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+- **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
 
-## +page
+## +url
 
-- **WHEN**：协同文档列表（分页）
+- **WHEN**：获取上传文件链接
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli document +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli document +url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
 ## api
 

package/dist/affordance/im.md

@@ -60,6 +60,26 @@
 - **示例**：`sino-bc-cli im +send --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
+## +notify
+
+- **WHEN**：机器人通知飞书员工
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli im +notify --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +switch
+
+- **WHEN**：查询群自动汇总全局开关
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli im +switch`
+
+## +alert
+
+- **WHEN**：业务项目告警
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli im +alert --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/affordance/invoice.md

@@ -0,0 +1,49 @@
+# invoice 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +bill-settlements
+
+- **WHEN**：对账单关联结算单
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli invoice +bill-settlements --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +invoice-list
+
+- **WHEN**：发票结算单列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli invoice +invoice-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +invoice-detail
+
+- **WHEN**：发票结算单详情
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli invoice +invoice-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +invoice-download
+
+- **WHEN**：下载发票
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli invoice +invoice-download --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +invoice-payments
+
+- **WHEN**：结算单还款记录
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli invoice +invoice-payments --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli invoice api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。

package/dist/affordance/project.md

@@ -32,54 +32,69 @@
 - **示例**：`sino-bc-cli project +delete --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
+## +stage-tabs
+
+- **WHEN**：投放阶段列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +stage-tabs --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
 ## +detail
 
-- **WHEN**：对客项目详情（平铺 JSON：ext_json values + 业务组装字段）
+- **WHEN**：对客项目详情
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli project +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 - **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +industry-options
+## +project-delete
 
-- **WHEN**：项目字段字典-下拉选项（按行业类型，适用于 SOURCE/GOAL/REGION/COUNTRY/MEDIA；industryType 可空，空则取当前签约主体行业）
+- **WHEN**：删除项目文档
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli project +industry-options --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli project +project-delete --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +industry-resolve
+## +linked-tasks
 
-- **WHEN**：项目字段字典-批量解析 code->name（按行业类型）
+- **WHEN**：查询项目文档已关联任务列表
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli project +industry-resolve --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli project +linked-tasks --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
-## +options
+## +project-list
 
-- **WHEN**：项目字段字典-下拉选项（按签约主体，适用于 STATUS/TYPE/BUSINESS_LINE/MARKET_SCOPE）
+- **WHEN**：查询项目文档
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli project +options --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli project +project-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
-- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
 
-## +resolve
+## +update-stage
 
-- **WHEN**：项目字段字典-批量解析 code->name（按签约主体）
+- **WHEN**：修改项目文档所属阶段
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
-- **示例**：`sino-bc-cli project +resolve --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **示例**：`sino-bc-cli project +update-stage --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
+## +project-upload
+
+- **WHEN**：上传项目文档
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +project-upload --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+- **上传**：`--data` 的文件字段填写本地文件路径；可先 `--dry-run` 预览。
+
 ## +form-create
 
-- **WHEN**：Formily 平铺 JSON 创建对客项目（从 body 取 templateType/templateId；响应同详情平铺）
+- **WHEN**：动态表单创建对客项目
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli project +form-create --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
 ## +form-update
 
-- **WHEN**：Formily 平铺 JSON 编辑对客项目（从 body 取 id/templateType/templateId；响应同详情平铺）
+- **WHEN**：动态表单编辑对客项目
 - **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
 - **示例**：`sino-bc-cli project +form-update --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
@@ -179,6 +194,36 @@
 - **示例**：`sino-bc-cli project +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
+## +list-with-task-count
+
+- **WHEN**：查询项目阶段列表（含可见任务数）
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +list-with-task-count --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +listByProjectId
+
+- **WHEN**：查询项目阶段列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +listByProjectId --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+- **参数**：`--data` 中的 query 字段按接口定义编码到 URL。
+
+## +save
+
+- **WHEN**：批量保存项目阶段
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +save --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +stage-name-list
+
+- **WHEN**：项目阶段名称列表
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +stage-name-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
 ## +status
 
 - **WHEN**：更新对客项目状态
@@ -243,6 +288,20 @@
 - **示例**：`sino-bc-cli project +replace --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
 - **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
 
+## +chat-projects
+
+- **WHEN**：按飞书群查询关联项目
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +chat-projects --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## +chats
+
+- **WHEN**：查询机器人所在飞书群
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli project +chats --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
 ## api
 
 - **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。

package/dist/affordance/quota.md

@@ -0,0 +1,19 @@
+# quota 命令何时用
+
+字段口径在 `src/api-doc/`，这里只写 WHEN / 别用 / 示例。
+
+执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口，再按命中条件读取其 references；当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
+
+## +credit
+
+- **WHEN**：后付信用额度
+- **别用**：已有更贴切的 Shortcut 时不要用本命令凑合。
+- **示例**：`sino-bc-cli quota +credit --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
+- **主体上下文**：主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。
+
+## api
+
+- **WHEN**：需要原始 JSON 字段，或没有合适的便捷 Shortcut 时按 name 调用。
+- **别用**：已有 Shortcut 的高频查询仍应走 `+xxx`。
+- **示例**：`sino-bc-cli quota api <name> --data '{...}'`
+- **主体要求**：先查 `/schema <name>` 的 `_meta.tenant`；为 true 时，主体必填：每次传入 `--corporation-id` 与 `--auth-context-id`，两者不放进 `--data`；绑定与恢复按 shared 条件索引读取主体参考。