sino-bc-cli 1.8.28 → 1.8.30

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 (144) hide show
  1. package/README.md +38 -9
  2. package/dist/affordance/auth.md +4 -0
  3. package/dist/affordance/bill.md +48 -0
  4. package/dist/affordance/biz-line-ai-strategy.md +35 -0
  5. package/dist/affordance/biz-line-metrics.md +47 -0
  6. package/dist/affordance/biz-line.md +8 -42
  7. package/dist/affordance/common-file.md +2 -0
  8. package/dist/affordance/dashboard.md +12 -10
  9. package/dist/affordance/dict.md +28 -0
  10. package/dist/affordance/document.md +34 -36
  11. package/dist/affordance/im.md +32 -9
  12. package/dist/affordance/invoice.md +49 -0
  13. package/dist/affordance/media.md +2 -0
  14. package/dist/affordance/organization.md +8 -6
  15. package/dist/affordance/project-analysis.md +2 -0
  16. package/dist/affordance/project.md +155 -44
  17. package/dist/affordance/quota.md +19 -0
  18. package/dist/affordance/reconciliation.md +41 -0
  19. package/dist/affordance/report.md +75 -0
  20. package/dist/affordance/task.md +17 -15
  21. package/dist/affordance/tenant.md +2 -0
  22. package/dist/affordance/user.md +2 -0
  23. package/dist/affordance/wallet.md +14 -121
  24. package/dist/api-doc/README.md +31 -20
  25. package/dist/api-doc/oapi/auth.md +9 -1
  26. package/dist/api-doc/oapi/bill.md +130 -0
  27. package/dist/api-doc/oapi/biz-line-ai-strategy.md +75 -1
  28. package/dist/api-doc/oapi/{biz-line-strategy.md → biz-line-metrics.md} +27 -343
  29. package/dist/api-doc/oapi/biz-line.md +394 -0
  30. package/dist/api-doc/oapi/common-file.md +7 -1
  31. package/dist/api-doc/oapi/dashboard.md +29 -9
  32. package/dist/api-doc/oapi/dict.md +49 -0
  33. package/dist/api-doc/oapi/document.md +78 -84
  34. package/dist/api-doc/oapi/im.md +93 -8
  35. package/dist/api-doc/oapi/invoice.md +129 -0
  36. package/dist/api-doc/oapi/media.md +5 -1
  37. package/dist/api-doc/oapi/organization.md +17 -5
  38. package/dist/api-doc/oapi/project-analysis.md +45 -15
  39. package/dist/api-doc/oapi/project.md +547 -80
  40. package/dist/api-doc/oapi/quota.md +21 -0
  41. package/dist/api-doc/oapi/reconciliation.md +98 -0
  42. package/dist/api-doc/oapi/{delivery.md → report.md} +104 -104
  43. package/dist/api-doc/oapi/task.md +45 -15
  44. package/dist/api-doc/oapi/tenant.md +5 -1
  45. package/dist/api-doc/oapi/user.md +12 -0
  46. package/dist/api-doc/oapi/{wallet-prepaid.md → wallet.md} +50 -24
  47. package/dist/generated/api-catalog.json +8508 -6036
  48. package/dist/generated/api-directory-index.json +1425 -0
  49. package/dist/index.js +1 -1
  50. package/dist/skill-manifest.json +325 -0
  51. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/SKILL.md +10 -8
  52. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/ai-strategy-prompt.md +4 -2
  53. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/api-flow.md +13 -12
  54. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/output-excel.md +1 -1
  55. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/runtime.md +45 -14
  56. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/spec.md +92 -31
  57. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/fetch_data.py +29 -8
  58. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/run_workflow.py +89 -13
  59. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/strategy_output.py +235 -64
  60. package/dist/skills/biz-line-strategy-generate/scripts/submit_tags.py +32 -0
  61. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/test_database_output.py +206 -48
  62. package/dist/skills/biz-line-strategy-generate/scripts/test_pipeline.py +253 -0
  63. package/dist/skills/biz-line-strategy-generate/scripts/test_tag_submission.py +238 -0
  64. package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/test_workflow.py +132 -6
  65. package/dist/skills/sino-bc-cli/SKILL.md +62 -0
  66. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-auth/SKILL.md +6 -4
  67. package/dist/skills/sino-bc-cli/domains/sino-bc-bill/SKILL.md +48 -0
  68. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/SKILL.md +59 -0
  69. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-biz-line/references/common-mistakes.md +0 -2
  70. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-biz-line/references/enums.md +1 -1
  71. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line-ai-strategy/SKILL.md +46 -0
  72. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line-metrics/SKILL.md +46 -0
  73. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-common-file/SKILL.md +7 -5
  74. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-dashboard/SKILL.md +7 -5
  75. package/dist/skills/sino-bc-cli/domains/sino-bc-dict/SKILL.md +48 -0
  76. package/dist/skills/sino-bc-cli/domains/sino-bc-document/SKILL.md +53 -0
  77. package/dist/skills/sino-bc-cli/domains/sino-bc-im/SKILL.md +59 -0
  78. package/dist/skills/sino-bc-cli/domains/sino-bc-invoice/SKILL.md +48 -0
  79. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-media/SKILL.md +6 -4
  80. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-organization/SKILL.md +7 -5
  81. package/dist/skills/sino-bc-cli/domains/sino-bc-project/SKILL.md +108 -0
  82. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-project-analysis/SKILL.md +20 -18
  83. package/dist/skills/sino-bc-cli/domains/sino-bc-quota/SKILL.md +44 -0
  84. package/dist/skills/sino-bc-cli/domains/sino-bc-reconciliation/SKILL.md +47 -0
  85. package/dist/skills/sino-bc-cli/domains/sino-bc-report/SKILL.md +53 -0
  86. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-task/SKILL.md +7 -5
  87. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-tenant/SKILL.md +6 -4
  88. package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-user/SKILL.md +13 -6
  89. package/dist/skills/sino-bc-cli/domains/sino-bc-wallet/SKILL.md +55 -0
  90. package/dist/skills/sino-bc-cli/references/domain-index/module-8534789.md +44 -0
  91. package/dist/skills/sino-bc-cli/references/domain-index/module-8551546.md +70 -0
  92. package/dist/skills/sino-bc-cli/references/domain-index/module-8562638.md +13 -0
  93. package/dist/skills/sino-bc-cli/references/domain-index/module-8566367.md +13 -0
  94. package/dist/skills/sino-bc-cli/references/domain-index/module-8581524.md +17 -0
  95. package/dist/skills/sino-bc-cli/references/domain-index/module-8601540.md +13 -0
  96. package/dist/skills/sino-bc-cli/references/domain-index/module-8614891.md +33 -0
  97. package/dist/skills/sino-bc-cli/references/domain-index/module-8621792.md +17 -0
  98. package/dist/skills/sino-bc-shared/SKILL.md +31 -0
  99. package/dist/skills/sino-bc-shared/references/auth-recovery.md +22 -0
  100. package/dist/skills/sino-bc-shared/references/config-and-env.md +32 -0
  101. package/dist/skills/{default/sino-bc-shared → sino-bc-shared}/references/output-contract.md +22 -5
  102. package/dist/skills/sino-bc-shared/references/skill-lifecycle.md +17 -0
  103. package/dist/skills/sino-bc-shared/references/tenant-context.md +21 -0
  104. package/dist/skills/sino-bc-shared/references/write-approval.md +16 -0
  105. package/package.json +6 -3
  106. package/scripts/postinstall.cjs +11 -3
  107. package/dist/SKILL.md +0 -151
  108. package/dist/affordance/delivery.md +0 -81
  109. package/dist/affordance/file.md +0 -43
  110. package/dist/affordance/project-stage.md +0 -40
  111. package/dist/affordance/sso.md +0 -15
  112. package/dist/api-doc/oapi/biz-line-query.md +0 -26
  113. package/dist/api-doc/oapi/file.md +0 -88
  114. package/dist/api-doc/oapi/project-stage.md +0 -84
  115. package/dist/api-doc/oapi/sso.md +0 -13
  116. package/dist/api-doc/oapi/wallet-bill.md +0 -118
  117. package/dist/api-doc/oapi/wallet-invoice.md +0 -117
  118. package/dist/api-doc/oapi/wallet-quota.md +0 -17
  119. package/dist/api-doc/oapi/wallet-reconciliation.md +0 -88
  120. package/dist/skills/default/sino-bc-shared/SKILL.md +0 -43
  121. package/dist/skills/default/sino-bc-shared/references/config-and-env.md +0 -18
  122. package/dist/skills/default/sino-bc-shared/references/write-approval.md +0 -20
  123. package/dist/skills/oapi/sino-bc-biz-line/SKILL.md +0 -63
  124. package/dist/skills/oapi/sino-bc-delivery/SKILL.md +0 -53
  125. package/dist/skills/oapi/sino-bc-document/SKILL.md +0 -51
  126. package/dist/skills/oapi/sino-bc-file/SKILL.md +0 -47
  127. package/dist/skills/oapi/sino-bc-im/SKILL.md +0 -49
  128. package/dist/skills/oapi/sino-bc-project/SKILL.md +0 -69
  129. package/dist/skills/oapi/sino-bc-project-stage/SKILL.md +0 -47
  130. package/dist/skills/oapi/sino-bc-sso/SKILL.md +0 -32
  131. package/dist/skills/oapi/sino-bc-wallet/SKILL.md +0 -72
  132. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/four-strategies.md +0 -0
  133. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/references/metrics.md +0 -0
  134. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/ai_strategy.py +0 -0
  135. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/build_report.py +0 -0
  136. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/cleanup.py +0 -0
  137. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/cli_json.py +0 -0
  138. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/summarize.py +0 -0
  139. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/test_ai_strategy.py +0 -0
  140. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/test_cli_json.py +0 -0
  141. /package/dist/skills/{custom/biz-line-strategy-generate → biz-line-strategy-generate}/scripts/test_strategy_rules.py +0 -0
  142. /package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-project-analysis/references/analysis-workflow.md +0 -0
  143. /package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-project-analysis/references/filters-and-metrics.md +0 -0
  144. /package/dist/skills/{oapi → sino-bc-cli/domains}/sino-bc-task/references/state-machine.md +0 -0
@@ -2,65 +2,88 @@
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
+ 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
5
7
  ## +members
6
8
 
7
9
  - **WHEN**:查询会话成员
8
10
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
9
11
  - **示例**:`sino-bc-cli im +members --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
10
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
12
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
11
13
 
12
14
  ## +list
13
15
 
14
16
  - **WHEN**:查询任务或项目日志关联的飞书聊天记录
15
17
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
16
18
  - **示例**:`sino-bc-cli im +list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
17
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
19
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
18
20
 
19
21
  ## +cursor
20
22
 
21
23
  - **WHEN**:锚点翻页查询群消息
22
24
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
23
25
  - **示例**:`sino-bc-cli im +cursor --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
24
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
26
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
25
27
 
26
28
  ## +detail
27
29
 
28
30
  - **WHEN**:按 chatId + messageId 查询消息明细
29
31
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
30
32
  - **示例**:`sino-bc-cli im +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
31
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
33
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
32
34
 
33
35
  ## +page
34
36
 
35
37
  - **WHEN**:分页查询群消息
36
38
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
37
39
  - **示例**:`sino-bc-cli im +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
38
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
40
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
39
41
 
40
42
  ## +replies
41
43
 
42
44
  - **WHEN**:按引用链根查询根消息及全部回复
43
45
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
44
46
  - **示例**:`sino-bc-cli im +replies --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
45
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
47
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
46
48
 
47
49
  ## +scope
48
50
 
49
51
  - **WHEN**:查询消息归属(主群或话题)
50
52
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
51
53
  - **示例**:`sino-bc-cli im +scope --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
52
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
54
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
53
55
 
54
56
  ## +send
55
57
 
56
58
  - **WHEN**:应用机器人发送消息(卡片)
57
59
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
58
60
  - **示例**:`sino-bc-cli im +send --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
59
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
61
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
62
+
63
+ ## +notify
64
+
65
+ - **WHEN**:机器人通知飞书员工
66
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
67
+ - **示例**:`sino-bc-cli im +notify --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
68
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
69
+
70
+ ## +switch
71
+
72
+ - **WHEN**:查询群自动汇总全局开关
73
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
74
+ - **示例**:`sino-bc-cli im +switch --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
75
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
76
+
77
+ ## +alert
78
+
79
+ - **WHEN**:业务项目告警
80
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
81
+ - **示例**:`sino-bc-cli im +alert --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
82
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
60
83
 
61
84
  ## api
62
85
 
63
86
  - **WHEN**:需要原始 JSON 字段,或没有合适的便捷 Shortcut 时按 name 调用。
64
87
  - **别用**:已有 Shortcut 的高频查询仍应走 `+xxx`。
65
88
  - **示例**:`sino-bc-cli im api <name> --data '{...}'`
66
- - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
89
+ - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
@@ -0,0 +1,49 @@
1
+ # invoice 命令何时用
2
+
3
+ 字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
+
5
+ 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
7
+ ## +bill-settlements
8
+
9
+ - **WHEN**:对账单关联结算单
10
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
11
+ - **示例**:`sino-bc-cli invoice +bill-settlements --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
12
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
13
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
14
+
15
+ ## +invoice-list
16
+
17
+ - **WHEN**:发票结算单列表
18
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
19
+ - **示例**:`sino-bc-cli invoice +invoice-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
20
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
21
+
22
+ ## +invoice-detail
23
+
24
+ - **WHEN**:发票结算单详情
25
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
26
+ - **示例**:`sino-bc-cli invoice +invoice-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
27
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
28
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
29
+
30
+ ## +invoice-download
31
+
32
+ - **WHEN**:下载发票
33
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
34
+ - **示例**:`sino-bc-cli invoice +invoice-download --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
35
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
36
+
37
+ ## +invoice-payments
38
+
39
+ - **WHEN**:结算单还款记录
40
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
41
+ - **示例**:`sino-bc-cli invoice +invoice-payments --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
42
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
43
+
44
+ ## api
45
+
46
+ - **WHEN**:需要原始 JSON 字段,或没有合适的便捷 Shortcut 时按 name 调用。
47
+ - **别用**:已有 Shortcut 的高频查询仍应走 `+xxx`。
48
+ - **示例**:`sino-bc-cli invoice api <name> --data '{...}'`
49
+ - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
@@ -2,6 +2,8 @@
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
+ 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
5
7
  ## +channels
6
8
 
7
9
  - **WHEN**:查询投放渠道列表
@@ -2,44 +2,46 @@
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
+ 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
5
7
  ## +list
6
8
 
7
9
  - **WHEN**:获取用户可以查看的签约主体列表
8
10
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
9
11
  - **示例**:`sino-bc-cli organization +list --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
10
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
12
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
11
13
 
12
14
  ## +tree
13
15
 
14
16
  - **WHEN**:人员架构树
15
17
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
16
18
  - **示例**:`sino-bc-cli organization +tree --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
17
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
19
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
18
20
 
19
21
  ## +team-members
20
22
 
21
23
  - **WHEN**:团队成员列表
22
24
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
23
25
  - **示例**:`sino-bc-cli organization +team-members --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
24
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
26
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
25
27
 
26
28
  ## +info
27
29
 
28
30
  - **WHEN**:获取当前用户信息
29
31
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
30
32
  - **示例**:`sino-bc-cli organization +info --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
31
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
33
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
32
34
 
33
35
  ## +listBySourceType
34
36
 
35
37
  - **WHEN**:根据用户来源类型获取用户列表(包含SSO用户则只返回前10条)
36
38
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
37
39
  - **示例**:`sino-bc-cli organization +listBySourceType --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
38
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
40
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
39
41
 
40
42
  ## api
41
43
 
42
44
  - **WHEN**:需要原始 JSON 字段,或没有合适的便捷 Shortcut 时按 name 调用。
43
45
  - **别用**:已有 Shortcut 的高频查询仍应走 `+xxx`。
44
46
  - **示例**:`sino-bc-cli organization api <name> --data '{...}'`
45
- - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
47
+ - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
@@ -2,6 +2,8 @@
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
+ 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
5
7
  ## +export-member-hre
6
8
 
7
9
  - **WHEN**:导出优化师人效列表
@@ -2,113 +2,130 @@
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
+ 执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
+
5
7
  ## +page-by-project
6
8
 
7
9
  - **WHEN**:按项目查询最新操作日志(分页倒序)
8
10
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
9
11
  - **示例**:`sino-bc-cli project +page-by-project --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
10
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
12
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
11
13
 
12
14
  ## +budget-field-config
13
15
 
14
16
  - **WHEN**:预算分布动态字段配置(按签约主体解析:主体 > 行业 > 不展示)
15
17
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
16
18
  - **示例**:`sino-bc-cli project +budget-field-config --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
17
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
19
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
18
20
 
19
21
  ## +create
20
22
 
21
23
  - **WHEN**:创建对客项目
22
24
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
23
25
  - **示例**:`sino-bc-cli project +create --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
24
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
26
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
25
27
 
26
28
  ## +delete
27
29
 
28
30
  - **WHEN**:删除对客项目
29
31
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
30
32
  - **示例**:`sino-bc-cli project +delete --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
31
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
33
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
34
+
35
+ ## +stage-tabs
36
+
37
+ - **WHEN**:投放阶段列表
38
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
39
+ - **示例**:`sino-bc-cli project +stage-tabs --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
40
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
41
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
32
42
 
33
43
  ## +detail
34
44
 
35
- - **WHEN**:对客项目详情(平铺 JSON:ext_json values + 业务组装字段)
45
+ - **WHEN**:对客项目详情
36
46
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
37
47
  - **示例**:`sino-bc-cli project +detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
38
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
48
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
39
49
  - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
40
50
 
41
- ## +industry-options
51
+ ## +project-delete
42
52
 
43
- - **WHEN**:项目字段字典-下拉选项(按行业类型,适用于 SOURCE/GOAL/REGION/COUNTRY/MEDIA;industryType 可空,空则取当前签约主体行业)
53
+ - **WHEN**:删除项目文档
44
54
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
45
- - **示例**:`sino-bc-cli project +industry-options --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
46
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
47
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
55
+ - **示例**:`sino-bc-cli project +project-delete --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
56
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
48
57
 
49
- ## +industry-resolve
58
+ ## +linked-tasks
50
59
 
51
- - **WHEN**:项目字段字典-批量解析 code->name(按行业类型)
60
+ - **WHEN**:查询项目文档已关联任务列表
52
61
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
53
- - **示例**:`sino-bc-cli project +industry-resolve --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
54
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
62
+ - **示例**:`sino-bc-cli project +linked-tasks --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
63
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
55
64
 
56
- ## +options
65
+ ## +project-list
57
66
 
58
- - **WHEN**:项目字段字典-下拉选项(按签约主体,适用于 STATUS/TYPE/BUSINESS_LINE/MARKET_SCOPE)
67
+ - **WHEN**:查询项目文档
59
68
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
60
- - **示例**:`sino-bc-cli project +options --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
61
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
62
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
69
+ - **示例**:`sino-bc-cli project +project-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
70
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
63
71
 
64
- ## +resolve
72
+ ## +update-stage
65
73
 
66
- - **WHEN**:项目字段字典-批量解析 code->name(按签约主体)
74
+ - **WHEN**:修改项目文档所属阶段
67
75
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
68
- - **示例**:`sino-bc-cli project +resolve --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
69
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
76
+ - **示例**:`sino-bc-cli project +update-stage --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
77
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
78
+
79
+ ## +project-upload
80
+
81
+ - **WHEN**:上传项目文档
82
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
83
+ - **示例**:`sino-bc-cli project +project-upload --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
84
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
85
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
86
+ - **上传**:`--data` 的文件字段填写本地文件路径;可先 `--dry-run` 预览。
70
87
 
71
88
  ## +form-create
72
89
 
73
- - **WHEN**:Formily 平铺 JSON 创建对客项目(从 body 取 templateType/templateId;响应同详情平铺)
90
+ - **WHEN**:动态表单创建对客项目
74
91
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
75
92
  - **示例**:`sino-bc-cli project +form-create --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
76
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
93
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
77
94
 
78
95
  ## +form-update
79
96
 
80
- - **WHEN**:Formily 平铺 JSON 编辑对客项目(从 body 取 id/templateType/templateId;响应同详情平铺)
97
+ - **WHEN**:动态表单编辑对客项目
81
98
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
82
99
  - **示例**:`sino-bc-cli project +form-update --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
83
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
100
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
84
101
 
85
102
  ## +batch-update-projects
86
103
 
87
104
  - **WHEN**:批量修改项目分组(将指定项目移动到目标分组)
88
105
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
89
106
  - **示例**:`sino-bc-cli project +batch-update-projects --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
90
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
107
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
91
108
 
92
109
  ## +group-create
93
110
 
94
111
  - **WHEN**:创建项目分组
95
112
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
96
113
  - **示例**:`sino-bc-cli project +group-create --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
97
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
114
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
98
115
 
99
116
  ## +group-delete
100
117
 
101
118
  - **WHEN**:删除项目分组
102
119
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
103
120
  - **示例**:`sino-bc-cli project +group-delete --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
104
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
121
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
105
122
 
106
123
  ## +group-detail
107
124
 
108
125
  - **WHEN**:分组详情
109
126
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
110
127
  - **示例**:`sino-bc-cli project +group-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
111
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
128
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
112
129
  - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
113
130
 
114
131
  ## +group-list
@@ -116,35 +133,35 @@
116
133
  - **WHEN**:分组列表(全量)
117
134
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
118
135
  - **示例**:`sino-bc-cli project +group-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
119
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
136
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
120
137
 
121
138
  ## +group-update
122
139
 
123
140
  - **WHEN**:更新项目分组名称
124
141
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
125
142
  - **示例**:`sino-bc-cli project +group-update --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
126
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
143
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
127
144
 
128
145
  ## +list
129
146
 
130
147
  - **WHEN**:对客项目列表(全量)
131
148
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
132
149
  - **示例**:`sino-bc-cli project +list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
133
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
150
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
134
151
 
135
152
  ## +invite
136
153
 
137
154
  - **WHEN**:邀请项目成员
138
155
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
139
156
  - **示例**:`sino-bc-cli project +invite --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
140
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
157
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
141
158
 
142
159
  ## +member-list
143
160
 
144
161
  - **WHEN**:项目成员列表
145
162
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
146
163
  - **示例**:`sino-bc-cli project +member-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
147
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
164
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
148
165
  - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
149
166
 
150
167
  ## +projects
@@ -152,7 +169,7 @@
152
169
  - **WHEN**:指定用户关联项目列表(项目成员+任务成员)
153
170
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
154
171
  - **示例**:`sino-bc-cli project +projects --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
155
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
172
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
156
173
  - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
157
174
 
158
175
  ## +remove
@@ -160,14 +177,14 @@
160
177
  - **WHEN**:移除项目成员
161
178
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
162
179
  - **示例**:`sino-bc-cli project +remove --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
163
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
180
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
164
181
 
165
182
  ## +tasks
166
183
 
167
184
  - **WHEN**:项目成员参与任务
168
185
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
169
186
  - **示例**:`sino-bc-cli project +tasks --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
170
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
187
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
171
188
  - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
172
189
 
173
190
  ## +page
@@ -175,25 +192,119 @@
175
192
  - **WHEN**:对客项目列表(分页)
176
193
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
177
194
  - **示例**:`sino-bc-cli project +page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
178
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
195
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
196
+
197
+ ## +list-with-task-count
198
+
199
+ - **WHEN**:查询项目阶段列表(含可见任务数)
200
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
201
+ - **示例**:`sino-bc-cli project +list-with-task-count --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
202
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
203
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
204
+
205
+ ## +listByProjectId
206
+
207
+ - **WHEN**:查询项目阶段列表
208
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
209
+ - **示例**:`sino-bc-cli project +listByProjectId --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
210
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
211
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
212
+
213
+ ## +save
214
+
215
+ - **WHEN**:批量保存项目阶段
216
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
217
+ - **示例**:`sino-bc-cli project +save --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
218
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
219
+
220
+ ## +stage-name-list
221
+
222
+ - **WHEN**:项目阶段名称列表
223
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
224
+ - **示例**:`sino-bc-cli project +stage-name-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
225
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
179
226
 
180
227
  ## +status
181
228
 
182
229
  - **WHEN**:更新对客项目状态
183
230
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
184
231
  - **示例**:`sino-bc-cli project +status --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
185
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
232
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
186
233
 
187
234
  ## +update
188
235
 
189
236
  - **WHEN**:编辑对客项目
190
237
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
191
238
  - **示例**:`sino-bc-cli project +update --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
192
- - **主体上下文**:该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
239
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
240
+
241
+ ## +form-schema
242
+
243
+ - **WHEN**:根据签约主体获取创建项目动态表单
244
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
245
+ - **示例**:`sino-bc-cli project +form-schema --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
246
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
247
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
248
+
249
+ ## +actions
250
+
251
+ - **WHEN**:项目操作权限汇总
252
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
253
+ - **示例**:`sino-bc-cli project +actions --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
254
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
255
+
256
+ ## +bindings
257
+
258
+ - **WHEN**:查询项目已绑定飞书群
259
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
260
+ - **示例**:`sino-bc-cli project +bindings --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
261
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
262
+
263
+ ## +eligible
264
+
265
+ - **WHEN**:分页查询项目可绑定飞书群
266
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
267
+ - **示例**:`sino-bc-cli project +eligible --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
268
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
269
+
270
+ ## +bind
271
+
272
+ - **WHEN**:绑定项目飞书群
273
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
274
+ - **示例**:`sino-bc-cli project +bind --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
275
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
276
+
277
+ ## +unbind
278
+
279
+ - **WHEN**:解绑项目飞书群
280
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
281
+ - **示例**:`sino-bc-cli project +unbind --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
282
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
283
+
284
+ ## +replace
285
+
286
+ - **WHEN**:换绑项目飞书群
287
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
288
+ - **示例**:`sino-bc-cli project +replace --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
289
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
290
+
291
+ ## +chat-projects
292
+
293
+ - **WHEN**:按飞书群查询关联项目
294
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
295
+ - **示例**:`sino-bc-cli project +chat-projects --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
296
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
297
+
298
+ ## +chats
299
+
300
+ - **WHEN**:查询机器人所在飞书群
301
+ - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
302
+ - **示例**:`sino-bc-cli project +chats --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
303
+ - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
193
304
 
194
305
  ## api
195
306
 
196
307
  - **WHEN**:需要原始 JSON 字段,或没有合适的便捷 Shortcut 时按 name 调用。
197
308
  - **别用**:已有 Shortcut 的高频查询仍应走 `+xxx`。
198
309
  - **示例**:`sino-bc-cli project api <name> --data '{...}'`
199
- - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,该接口需要本次调用的主体绑定:先执行 `sino-bc-cli /auth status` 查看认证上下文,再用 `sino-bc-cli /tenant list` 查询当前身份可用主体,按任务明确的主体成对保存 ID 与认证上下文。每次调用传入 `--corporation-id <主体ID> --auth-context-id <认证上下文ID>`,不要放进 `--data`。漏传可补齐已有有效绑定;认证上下文变化时清除旧绑定,重新查询主体并唯一匹配后重新绑定,不能只替换认证标记。
310
+ - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。