sino-bc-cli 1.8.29 → 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 (99) hide show
  1. package/README.md +4 -3
  2. package/dist/affordance/{file.md → bill.md} +21 -18
  3. package/dist/affordance/biz-line-ai-strategy.md +35 -0
  4. package/dist/affordance/biz-line-metrics.md +47 -0
  5. package/dist/affordance/biz-line.md +6 -60
  6. package/dist/affordance/document.md +25 -29
  7. package/dist/affordance/im.md +21 -0
  8. package/dist/affordance/invoice.md +49 -0
  9. package/dist/affordance/project.md +76 -17
  10. package/dist/affordance/quota.md +19 -0
  11. package/dist/affordance/{project-stage.md → reconciliation.md} +15 -16
  12. package/dist/affordance/{delivery.md → report.md} +29 -37
  13. package/dist/affordance/wallet.md +0 -109
  14. package/dist/api-doc/README.md +28 -22
  15. package/dist/api-doc/oapi/auth.md +1 -1
  16. package/dist/api-doc/oapi/{wallet-bill.md → bill.md} +6 -6
  17. package/dist/api-doc/oapi/biz-line-ai-strategy.md +1 -1
  18. package/dist/api-doc/oapi/{biz-line-strategy.md → biz-line-metrics.md} +8 -360
  19. package/dist/api-doc/oapi/biz-line.md +394 -0
  20. package/dist/api-doc/oapi/common-file.md +1 -1
  21. package/dist/api-doc/oapi/dict.md +2 -2
  22. package/dist/api-doc/oapi/document.md +61 -85
  23. package/dist/api-doc/oapi/im.md +67 -0
  24. package/dist/api-doc/oapi/{wallet-invoice.md → invoice.md} +6 -6
  25. package/dist/api-doc/oapi/media.md +1 -1
  26. package/dist/api-doc/oapi/project-analysis.md +1 -1
  27. package/dist/api-doc/oapi/project.md +312 -69
  28. package/dist/api-doc/oapi/{wallet-quota.md → quota.md} +2 -2
  29. package/dist/api-doc/oapi/{wallet-reconciliation.md → reconciliation.md} +5 -5
  30. package/dist/api-doc/oapi/{delivery.md → report.md} +82 -104
  31. package/dist/api-doc/oapi/task.md +1 -1
  32. package/dist/api-doc/oapi/tenant.md +1 -1
  33. package/dist/generated/api-catalog.json +5273 -4546
  34. package/dist/generated/api-directory-index.json +1425 -0
  35. package/dist/index.js +1 -1
  36. package/dist/skill-manifest.json +109 -71
  37. package/dist/skills/biz-line-strategy-generate/SKILL.md +9 -7
  38. package/dist/skills/biz-line-strategy-generate/references/ai-strategy-prompt.md +4 -2
  39. package/dist/skills/biz-line-strategy-generate/references/api-flow.md +13 -12
  40. package/dist/skills/biz-line-strategy-generate/references/output-excel.md +1 -1
  41. package/dist/skills/biz-line-strategy-generate/references/runtime.md +45 -14
  42. package/dist/skills/biz-line-strategy-generate/references/spec.md +92 -31
  43. package/dist/skills/biz-line-strategy-generate/scripts/fetch_data.py +29 -8
  44. package/dist/skills/biz-line-strategy-generate/scripts/run_workflow.py +89 -13
  45. package/dist/skills/biz-line-strategy-generate/scripts/strategy_output.py +232 -64
  46. package/dist/skills/biz-line-strategy-generate/scripts/submit_tags.py +32 -0
  47. package/dist/skills/biz-line-strategy-generate/scripts/test_database_output.py +203 -48
  48. package/dist/skills/biz-line-strategy-generate/scripts/test_pipeline.py +253 -0
  49. package/dist/skills/biz-line-strategy-generate/scripts/test_tag_submission.py +238 -0
  50. package/dist/skills/biz-line-strategy-generate/scripts/test_workflow.py +132 -6
  51. package/dist/skills/sino-bc-cli/SKILL.md +25 -11
  52. package/dist/skills/sino-bc-cli/domains/sino-bc-auth/SKILL.md +3 -1
  53. package/dist/skills/sino-bc-cli/domains/sino-bc-bill/SKILL.md +48 -0
  54. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/SKILL.md +8 -17
  55. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/references/common-mistakes.md +0 -2
  56. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line/references/enums.md +1 -1
  57. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line-ai-strategy/SKILL.md +46 -0
  58. package/dist/skills/sino-bc-cli/domains/sino-bc-biz-line-metrics/SKILL.md +46 -0
  59. package/dist/skills/sino-bc-cli/domains/sino-bc-common-file/SKILL.md +4 -2
  60. package/dist/skills/sino-bc-cli/domains/sino-bc-dashboard/SKILL.md +3 -1
  61. package/dist/skills/sino-bc-cli/domains/sino-bc-dict/SKILL.md +3 -1
  62. package/dist/skills/sino-bc-cli/domains/sino-bc-document/SKILL.md +14 -12
  63. package/dist/skills/sino-bc-cli/domains/sino-bc-im/SKILL.md +13 -3
  64. package/dist/skills/sino-bc-cli/domains/sino-bc-invoice/SKILL.md +48 -0
  65. package/dist/skills/sino-bc-cli/domains/sino-bc-media/SKILL.md +3 -1
  66. package/dist/skills/sino-bc-cli/domains/sino-bc-organization/SKILL.md +3 -1
  67. package/dist/skills/sino-bc-cli/domains/sino-bc-project/SKILL.md +40 -12
  68. package/dist/skills/sino-bc-cli/domains/sino-bc-project-analysis/SKILL.md +3 -1
  69. package/dist/skills/sino-bc-cli/domains/sino-bc-quota/SKILL.md +44 -0
  70. package/dist/skills/sino-bc-cli/domains/sino-bc-reconciliation/SKILL.md +47 -0
  71. package/dist/skills/sino-bc-cli/domains/{sino-bc-delivery → sino-bc-report}/SKILL.md +17 -17
  72. package/dist/skills/sino-bc-cli/domains/sino-bc-task/SKILL.md +3 -1
  73. package/dist/skills/sino-bc-cli/domains/sino-bc-tenant/SKILL.md +3 -1
  74. package/dist/skills/sino-bc-cli/domains/sino-bc-user/SKILL.md +9 -2
  75. package/dist/skills/sino-bc-cli/domains/sino-bc-wallet/SKILL.md +8 -25
  76. package/dist/skills/sino-bc-cli/references/domain-index/module-8534789.md +44 -0
  77. package/dist/skills/sino-bc-cli/references/domain-index/module-8551546.md +70 -0
  78. package/dist/skills/sino-bc-cli/references/domain-index/module-8562638.md +13 -0
  79. package/dist/skills/sino-bc-cli/references/domain-index/module-8566367.md +13 -0
  80. package/dist/skills/sino-bc-cli/references/domain-index/module-8581524.md +17 -0
  81. package/dist/skills/sino-bc-cli/references/domain-index/module-8601540.md +13 -0
  82. package/dist/skills/sino-bc-cli/references/domain-index/module-8614891.md +33 -0
  83. package/dist/skills/sino-bc-cli/references/domain-index/module-8621792.md +17 -0
  84. package/package.json +1 -1
  85. package/dist/affordance/sso.md +0 -17
  86. package/dist/api-doc/oapi/biz-line-query.md +0 -30
  87. package/dist/api-doc/oapi/file.md +0 -98
  88. package/dist/api-doc/oapi/project-stage.md +0 -94
  89. package/dist/api-doc/oapi/sso.md +0 -17
  90. package/dist/skills/sino-bc-cli/domains/sino-bc-file/SKILL.md +0 -47
  91. package/dist/skills/sino-bc-cli/domains/sino-bc-project-stage/SKILL.md +0 -47
  92. package/dist/skills/sino-bc-cli/domains/sino-bc-sso/SKILL.md +0 -32
  93. package/dist/skills/sino-bc-cli/references/domain-index/advertising.md +0 -27
  94. package/dist/skills/sino-bc-cli/references/domain-index/analytics.md +0 -25
  95. package/dist/skills/sino-bc-cli/references/domain-index/collaboration.md +0 -59
  96. package/dist/skills/sino-bc-cli/references/domain-index/files.md +0 -15
  97. package/dist/skills/sino-bc-cli/references/domain-index/finance.md +0 -11
  98. package/dist/skills/sino-bc-cli/references/domain-index/identity.md +0 -43
  99. /package/dist/api-doc/oapi/{wallet-prepaid.md → wallet.md} +0 -0
@@ -1,42 +1,41 @@
1
- # project-stage 命令何时用
1
+ # reconciliation 命令何时用
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
5
  执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
6
 
7
- ## +list-with-task-count
7
+ ## +reconciliation
8
8
 
9
- - **WHEN**:查询项目阶段列表(含可见任务数)
9
+ - **WHEN**:月度对账单列表
10
10
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
11
- - **示例**:`sino-bc-cli project-stage +list-with-task-count --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
11
+ - **示例**:`sino-bc-cli reconciliation +reconciliation --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
12
12
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
13
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
14
13
 
15
- ## +listByProjectId
14
+ ## +reconciliation-log
16
15
 
17
- - **WHEN**:查询项目阶段列表
16
+ - **WHEN**:月度对账单发送记录
18
17
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
19
- - **示例**:`sino-bc-cli project-stage +listByProjectId --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
18
+ - **示例**:`sino-bc-cli reconciliation +reconciliation-log --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
20
19
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
21
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
22
20
 
23
- ## +save
21
+ ## +reconciliation-preview
24
22
 
25
- - **WHEN**:批量保存项目阶段
23
+ - **WHEN**:对账邮件预览
26
24
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
27
- - **示例**:`sino-bc-cli project-stage +save --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
25
+ - **示例**:`sino-bc-cli reconciliation +reconciliation-preview --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
28
26
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
29
27
 
30
- ## +stage-name-list
28
+ ## +reconciliation-url
31
29
 
32
- - **WHEN**:项目阶段名称列表
30
+ - **WHEN**:月度对账单下载链接
33
31
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
34
- - **示例**:`sino-bc-cli project-stage +stage-name-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
32
+ - **示例**:`sino-bc-cli reconciliation +reconciliation-url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
35
33
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
34
+ - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
36
35
 
37
36
  ## api
38
37
 
39
38
  - **WHEN**:需要原始 JSON 字段,或没有合适的便捷 Shortcut 时按 name 调用。
40
39
  - **别用**:已有 Shortcut 的高频查询仍应走 `+xxx`。
41
- - **示例**:`sino-bc-cli project-stage api <name> --data '{...}'`
40
+ - **示例**:`sino-bc-cli reconciliation api <name> --data '{...}'`
42
41
  - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
@@ -1,83 +1,75 @@
1
- # delivery 命令何时用
1
+ # report 命令何时用
2
2
 
3
3
  字段口径在 `src/api-doc/`,这里只写 WHEN / 别用 / 示例。
4
4
 
5
5
  执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
6
 
7
- ## +campaign-page
8
-
9
- - **WHEN**:分页查询项目自动归集广告系列
10
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
11
- - **示例**:`sino-bc-cli delivery +campaign-page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
12
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
13
-
14
- ## +campaign-get
7
+ ## +detail-choose-list
15
8
 
16
- - **WHEN**:查询广告系列设置
9
+ - **WHEN**:查询项目维度筛选列表
17
10
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
18
- - **示例**:`sino-bc-cli delivery +campaign-get --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
11
+ - **示例**:`sino-bc-cli report +detail-choose-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
19
12
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
20
13
 
21
- ## +campaign-save
14
+ ## +detail-list
22
15
 
23
- - **WHEN**:保存广告系列设置
16
+ - **WHEN**:查询项目成效列表
24
17
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
25
- - **示例**:`sino-bc-cli delivery +campaign-save --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
18
+ - **示例**:`sino-bc-cli report +detail-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
26
19
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
27
20
 
28
- ## +core-metrics
21
+ ## +dimension-module
29
22
 
30
- - **WHEN**:核心指标卡
23
+ - **WHEN**:维度分布
31
24
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
32
- - **示例**:`sino-bc-cli delivery +core-metrics --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
25
+ - **示例**:`sino-bc-cli report +dimension-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
33
26
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
34
27
 
35
- ## +detail-choose-list
28
+ ## +kpi-module
36
29
 
37
- - **WHEN**:查询项目维度筛选列表
30
+ - **WHEN**:KPI 进度与走势
38
31
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
39
- - **示例**:`sino-bc-cli delivery +detail-choose-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
32
+ - **示例**:`sino-bc-cli report +kpi-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
40
33
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
41
34
 
42
- ## +detail-list
35
+ ## +spend-module
43
36
 
44
- - **WHEN**:查询项目成效列表
37
+ - **WHEN**:消耗分析
45
38
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
46
- - **示例**:`sino-bc-cli delivery +detail-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
39
+ - **示例**:`sino-bc-cli report +spend-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
47
40
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
48
41
 
49
- ## +dimension-module
42
+ ## +core-metrics
50
43
 
51
- - **WHEN**:维度分布
44
+ - **WHEN**:核心指标卡
52
45
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
53
- - **示例**:`sino-bc-cli delivery +dimension-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
46
+ - **示例**:`sino-bc-cli report +core-metrics --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
54
47
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
55
48
 
56
- ## +kpi-module
49
+ ## +campaign-page
57
50
 
58
- - **WHEN**:KPI 进度与走势
51
+ - **WHEN**:分页查询项目自动归集广告系列
59
52
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
60
- - **示例**:`sino-bc-cli delivery +kpi-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
53
+ - **示例**:`sino-bc-cli report +campaign-page --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
61
54
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
62
55
 
63
- ## +spend-module
56
+ ## +campaign-get
64
57
 
65
- - **WHEN**:消耗分析
58
+ - **WHEN**:查询广告系列设置
66
59
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
67
- - **示例**:`sino-bc-cli delivery +spend-module --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
60
+ - **示例**:`sino-bc-cli report +campaign-get --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
68
61
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
69
62
 
70
- ## +stage-tabs
63
+ ## +campaign-save
71
64
 
72
- - **WHEN**:投放阶段 Tab 下拉(含起止时间)
65
+ - **WHEN**:保存广告系列设置
73
66
  - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
74
- - **示例**:`sino-bc-cli delivery +stage-tabs --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
67
+ - **示例**:`sino-bc-cli report +campaign-save --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
75
68
  - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
76
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
77
69
 
78
70
  ## api
79
71
 
80
72
  - **WHEN**:需要原始 JSON 字段,或没有合适的便捷 Shortcut 时按 name 调用。
81
73
  - **别用**:已有 Shortcut 的高频查询仍应走 `+xxx`。
82
- - **示例**:`sino-bc-cli delivery api <name> --data '{...}'`
74
+ - **示例**:`sino-bc-cli report api <name> --data '{...}'`
83
75
  - **主体要求**:先查 `/schema <name>` 的 `_meta.tenant`;为 true 时,主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
@@ -4,115 +4,6 @@
4
4
 
5
5
  执行前 MUST 读取 [sino-bc-shared](../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
6
 
7
- ## +bill-list
8
-
9
- - **WHEN**:对账单列表
10
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
11
- - **示例**:`sino-bc-cli wallet +bill-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
12
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
13
-
14
- ## +bill-detail
15
-
16
- - **WHEN**:对账单基本信息
17
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
18
- - **示例**:`sino-bc-cli wallet +bill-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
19
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
20
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
21
-
22
- ## +bill-original
23
-
24
- - **WHEN**:对账单明细
25
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
26
- - **示例**:`sino-bc-cli wallet +bill-original --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
27
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
28
-
29
- ## +bill-operate
30
-
31
- - **WHEN**:对账单操作历史
32
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
33
- - **示例**:`sino-bc-cli wallet +bill-operate --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
34
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
35
-
36
- ## +bill-enum
37
-
38
- - **WHEN**:对账单与发票枚举
39
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
40
- - **示例**:`sino-bc-cli wallet +bill-enum --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
41
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
42
-
43
- ## +bill-settlements
44
-
45
- - **WHEN**:对账单关联结算单
46
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
47
- - **示例**:`sino-bc-cli wallet +bill-settlements --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
48
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
49
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
50
-
51
- ## +invoice-list
52
-
53
- - **WHEN**:发票结算单列表
54
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
55
- - **示例**:`sino-bc-cli wallet +invoice-list --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
56
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
57
-
58
- ## +invoice-detail
59
-
60
- - **WHEN**:发票结算单详情
61
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
62
- - **示例**:`sino-bc-cli wallet +invoice-detail --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
63
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
64
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
65
-
66
- ## +invoice-download
67
-
68
- - **WHEN**:下载发票
69
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
70
- - **示例**:`sino-bc-cli wallet +invoice-download --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
71
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
72
-
73
- ## +invoice-payments
74
-
75
- - **WHEN**:结算单还款记录
76
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
77
- - **示例**:`sino-bc-cli wallet +invoice-payments --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
78
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
79
-
80
- ## +reconciliation
81
-
82
- - **WHEN**:月度对账单列表
83
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
84
- - **示例**:`sino-bc-cli wallet +reconciliation --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
85
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
86
-
87
- ## +reconciliation-log
88
-
89
- - **WHEN**:月度对账单发送记录
90
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
91
- - **示例**:`sino-bc-cli wallet +reconciliation-log --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
92
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
93
-
94
- ## +reconciliation-preview
95
-
96
- - **WHEN**:对账邮件预览
97
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
98
- - **示例**:`sino-bc-cli wallet +reconciliation-preview --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
99
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
100
-
101
- ## +reconciliation-url
102
-
103
- - **WHEN**:月度对账单下载链接
104
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
105
- - **示例**:`sino-bc-cli wallet +reconciliation-url --data '{...}' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
106
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
107
- - **参数**:`--data` 中的 query 字段按接口定义编码到 URL。
108
-
109
- ## +credit
110
-
111
- - **WHEN**:后付信用额度
112
- - **别用**:已有更贴切的 Shortcut 时不要用本命令凑合。
113
- - **示例**:`sino-bc-cli wallet +credit --corporation-id <主体ID> --auth-context-id <认证上下文ID>`
114
- - **主体上下文**:主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
115
-
116
7
  ## +own
117
8
 
118
9
  - **WHEN**:钱包首页
@@ -12,30 +12,36 @@
12
12
 
13
13
  同名文档按 custom → oapi → 目录根解析。custom 同名文件会优先展示,只有确需完整覆盖生成文档时才使用。这是接口文档的按文件查找,不是技能安装方式。域工作流写在 `src/catalog/sync/domains/`(同步进 `skills/oapi/`);额外专家技能放 `skills/custom/<技能名>/`,必须自带完整 `SKILL.md`。
14
14
 
15
- Skill 安装保留三类职责:shared 管共用规则,API 域管单域能力,专家编排已有能力形成任务产物。完整 custom 可整域替换 oapi;独立专家顶层分发,依赖域位于导航 domains 内,不替换依赖域。根 Skill 只概览、shared 和非空业务分类;分类页列 API 域能力,已核实域及能力可直读完整域。专家不进业务导航,`/skill` 列出全部入口。
15
+ Skill 安装保留三类职责:shared 管共用规则,API 域管单域能力,专家编排已有能力形成任务产物。完整 custom 可整域替换 oapi;独立专家顶层分发,依赖域位于导航 domains 内,不替换依赖域。根 Skill 只概览、shared 和非空 Apifox 模块;模块页列一级目录对应的 API Skill 能力,已核实域及能力可直读完整域。专家不进业务导航,`/skill` 列出全部入口。
16
16
 
17
- ## 按业务域查看
17
+ ## 按功能模块查看
18
18
 
19
- | 域 | 用途 | 接口文档 |
19
+ Apifox 模块组织业务域导航,一级目录对应下表的 API Skill 与命令域,子目录在 Skill 内作为功能分组。
20
+
21
+ | 命令域 | 用途 | 接口文档 |
20
22
  | --- | --- | --- |
21
- | biz-line | 业务线、周策略、品类、策略标签、AI策略、优化项目及广告成效 | [查询](oapi/biz-line-query.md)、[策略](oapi/biz-line-strategy.md)、[AI策略](oapi/biz-line-ai-strategy.md) |
22
- | common-file | 通用文件上传与按 storageKey 取下载链接 | [通用文件](oapi/common-file.md) |
23
- | project-analysis | 优化项目月度分析、消耗/工时趋势、人效与 Excel 导出 | [项目分析](oapi/project-analysis.md) |
24
- | sso | SSO 组别 | [SSO](oapi/sso.md) |
25
- | project | 营销协同项目、成员、分组 | [项目](oapi/project.md) |
26
- | project-stage | 营销协同项目阶段 | [阶段](oapi/project-stage.md) |
27
- | task | 营销协同任务 | [任务](oapi/task.md) |
28
- | dict | 营销协同字典场景、下拉选项与条目 | [通用字典](oapi/dict.md) |
29
- | document | 文档中心与项目文档 | [文档](oapi/document.md) |
30
- | file | 营销协同文件上传与对象存储记录 | [文件](oapi/file.md) |
31
- | wallet | 对账单、发票结算、月度对账、后付额度与预付钱包 | [对账单](oapi/wallet-bill.md)、[发票](oapi/wallet-invoice.md)、[月度对账](oapi/wallet-reconciliation.md)、[额度](oapi/wallet-quota.md)、[钱包](oapi/wallet-prepaid.md) |
32
- | delivery | Campaign 归集与投放阶段指标 | [投放](oapi/delivery.md) |
33
- | dashboard | 看板 | [看板](oapi/dashboard.md) |
34
- | organization | 组织架构、团队成员与当前用户 | [组织用户](oapi/organization.md) |
35
- | user | SSO 与签约主体(租户)用户资料 | [用户信息](oapi/user.md) |
36
- | im | 飞书群消息 | [消息](oapi/im.md) |
37
- | tenant | 用户签约主体列表 | [租户](oapi/tenant.md) |
38
- | auth | CLI 设备授权协议;日常登录优先 `/auth login` | [授权](oapi/auth.md) |
23
+ | biz-line | 业务线、周策略、投放品类、策略标签、关联项目与 SSO 组别 | [接口文档](oapi/biz-line.md) |
24
+ | biz-line-metrics | 广告策略维度与成效数据 | [接口文档](oapi/biz-line-metrics.md) |
25
+ | project-analysis | 优化项目月度分析、工时系统原始表、消耗与工时趋势、优化师人效及 Excel 导出 | [接口文档](oapi/project-analysis.md) |
26
+ | biz-line-ai-strategy | AI 策略保存、历史记录、使用日志与正式策略快照 | [接口文档](oapi/biz-line-ai-strategy.md) |
27
+ | project | 营销协同项目生命周期、成员、阶段、项目文档、投放阶段Tab及群关系 | [接口文档](oapi/project.md) |
28
+ | task | 营销协同任务:交付闭环与操作日志 | [接口文档](oapi/task.md) |
29
+ | document | 营销协同文档中心、文件上传与对象存储记录 | [接口文档](oapi/document.md) |
30
+ | dashboard | 营销协同看板:预算分布、项目分布与关键项目时间轴 | [接口文档](oapi/dashboard.md) |
31
+ | organization | 组织架构、团队成员与当前用户 | [接口文档](oapi/organization.md) |
32
+ | im | 营销协同飞书群消息 | [接口文档](oapi/im.md) |
33
+ | dict | 营销协同通用字典:按用途查询场景与按场景查询条目 | [接口文档](oapi/dict.md) |
34
+ | report | 营销协同Campaign归集、投放阶段指标、花费、KPI与维度下钻 | [接口文档](oapi/report.md) |
35
+ | tenant | 签约主体 | [接口文档](oapi/tenant.md) |
36
+ | auth | 身份令牌与浏览器授权 | [接口文档](oapi/auth.md) |
37
+ | user | SSO 用户资料、按姓名模糊列表与签约主体(租户)用户资料 | [接口文档](oapi/user.md) |
38
+ | media | 广告投放媒体:投放渠道等媒体字典 | [接口文档](oapi/media.md) |
39
+ | bill | 财务对账单查询 | [接口文档](oapi/bill.md) |
40
+ | invoice | 发票结算单与发票文件下载 | [接口文档](oapi/invoice.md) |
41
+ | reconciliation | 月度对账文件与邮件记录 | [接口文档](oapi/reconciliation.md) |
42
+ | quota | 后付额度查询 | [接口文档](oapi/quota.md) |
43
+ | wallet | 预付钱包、充值与流水查询 | [接口文档](oapi/wallet.md) |
44
+ | common-file | 通用文件上传与按 storageKey 取下载链接 | [接口文档](oapi/common-file.md) |
39
45
 
40
46
  接口名称和数量以 `src/generated/api-catalog.json` 为唯一运行时依据;name 来自 OpenAPI 的 `x-cli-name`,不能从路由自行拼造。新开发者接入流程见 [bc-develop](../../.agents/skills/bc-develop/SKILL.md),完整样例见 [项目分析接入](../../developer-doc/07-project-analysis-onboarding.md)。
41
47
 
@@ -55,4 +61,4 @@ TTY 默认表格,非 TTY 默认 JSON 信封。成功 stdout,失败 stderr;
55
61
 
56
62
  ## 维护同步
57
63
 
58
- 运行 `npm run sync-api-doc`,自动发现所有模块,分别导出、解析 OpenAPI,全部成功后统一替换生成物。token 只取环境变量 `APIFOX_TOKEN`;禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证,不能只看 catalog 新增数量。
64
+ 运行 `npm run sync-api-doc`,自动发现所有模块,分别读取并核对 OpenAPI 和原生目录树,全部成功后同事务替换目录索引与生成物。token 只取环境变量 `APIFOX_TOKEN`;禁止进入仓库、用户配置或日志。业务技能入口、帮助和字段文档应同时验证,不能只看 catalog 新增数量。
@@ -1,4 +1,4 @@
1
- # CLI设备授权
1
+ # 访问凭证管理
2
2
 
3
3
  对应命令:`auth +<shortcut>` 与 `auth api <name>`。
4
4
 
@@ -1,6 +1,6 @@
1
1
  # 对账单
2
2
 
3
- 对应命令:`wallet +<shortcut>` 与 `wallet api <name>`。
3
+ 对应命令:`bill +<shortcut>` 与 `bill api <name>`。
4
4
 
5
5
  执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
6
 
@@ -16,7 +16,7 @@
16
16
 
17
17
  主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
18
18
 
19
- 调用示例:`sino-bc-cli wallet api bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
19
+ 调用示例:`sino-bc-cli bill api bill-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
20
20
 
21
21
  按生成时间查当前主体的账单聚合列表(BillAggregation)。响应只保留列表,不含待还汇总。
22
22
 
@@ -49,7 +49,7 @@
49
49
 
50
50
  主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
51
51
 
52
- 调用示例:`sino-bc-cli wallet api bill-detail-basic --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
52
+ 调用示例:`sino-bc-cli bill api bill-detail-basic --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
53
53
 
54
54
  按 billId 查单条对账单金额、渠道、类型、开票状态。
55
55
 
@@ -71,7 +71,7 @@
71
71
 
72
72
  主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
73
73
 
74
- 调用示例:`sino-bc-cli wallet api bill-original-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
74
+ 调用示例:`sino-bc-cli bill api bill-original-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
75
75
 
76
76
  按对账单类型返回媒体 / 服务费 / Credit Memo / 服务费红冲其中一类明细。
77
77
 
@@ -95,7 +95,7 @@
95
95
 
96
96
  主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
97
97
 
98
- 调用示例:`sino-bc-cli wallet api bill-operate-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
98
+ 调用示例:`sino-bc-cli bill api bill-operate-list --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
99
99
 
100
100
  分页查对账单操作记录。
101
101
 
@@ -119,7 +119,7 @@
119
119
 
120
120
  主体必填:每次传入 `--corporation-id` 与 `--auth-context-id`,两者不放进 `--data`;绑定与恢复按 shared 条件索引读取主体参考。
121
121
 
122
- 调用示例:`sino-bc-cli wallet api bill-invoice-enum --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
122
+ 调用示例:`sino-bc-cli bill api bill-invoice-enum --data '<json>' --corporation-id <主体ID> --auth-context-id <认证上下文ID>`。
123
123
 
124
124
  按 types 批量取渠道、开票/还款状态、账单类型等枚举。type 必须用原文,含拼写。
125
125
 
@@ -1,6 +1,6 @@
1
1
  # 业务线AI策略
2
2
 
3
- 对应命令:`biz-line +<shortcut>` 与 `biz-line api <name>`。
3
+ 对应命令:`biz-line-ai-strategy +<shortcut>` 与 `biz-line-ai-strategy api <name>`。
4
4
 
5
5
  执行前 MUST 读取 [sino-bc-shared](../../skills/sino-bc-shared/SKILL.md) 轻量入口,再按命中条件读取其 references;当前上下文已读且仍适用时可复用。可用 `sino-bc-cli /skill` 查询真实路径。
6
6