siluzan-tso-cli 1.1.29-beta.2 → 1.1.29-beta.21

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 (169) hide show
  1. package/README.md +1 -1
  2. package/dist/index.js +3174 -867
  3. package/dist/skill/AGENTS.md +30 -31
  4. package/dist/skill/SKILL.md +16 -33
  5. package/dist/skill/_meta.json +2 -2
  6. package/dist/skill/assets/campaign-create-keyword-test.fixed.json +10 -33
  7. package/dist/skill/assets/campaign-create-template.json +2 -0
  8. package/dist/skill/assets/campaign-create-template.md +114 -99
  9. package/dist/skill/assets/market-analysis-rules.md +55 -55
  10. package/dist/skill/assets/meta-period-report-rules.md +61 -60
  11. package/dist/skill/assets/pmax-asset-group-template.json +12 -4
  12. package/dist/skill/assets/pmax-asset-group-template.md +25 -0
  13. package/dist/skill/assets/pmax-brand-assets-template.json +25 -0
  14. package/dist/skill/assets/pmax-brand-assets-template.md +22 -0
  15. package/dist/skill/assets/pmax-brand-guidelines-enable-template.json +24 -0
  16. package/dist/skill/assets/pmax-brand-guidelines-enable-template.md +22 -0
  17. package/dist/skill/assets/pmax-create-template.json +41 -2
  18. package/dist/skill/assets/pmax-create-template.md +84 -51
  19. package/dist/skill/assets/pmax-lead-form-template.json +36 -0
  20. package/dist/skill/assets/pmax-lead-form-template.md +70 -0
  21. package/dist/skill/assets/pmax-signals-template.json +2 -6
  22. package/dist/skill/assets/pmax-whatsapp-template.json +26 -0
  23. package/dist/skill/assets/pmax-whatsapp-template.md +45 -0
  24. package/dist/skill/assets/website-diagnosis-rules.md +67 -67
  25. package/dist/skill/references/README.md +78 -65
  26. package/dist/skill/references/accounts/accounts.md +99 -105
  27. package/dist/skill/references/accounts/finance.md +23 -79
  28. package/dist/skill/references/accounts/open-account-by-media.md +84 -81
  29. package/dist/skill/references/accounts/open-account-google-ui.md +24 -24
  30. package/dist/skill/references/analytics/account-analytics.md +94 -103
  31. package/dist/skill/references/analytics/facebook-analysis-guide.md +61 -61
  32. package/dist/skill/references/analytics/google-analysis-batch.md +2 -2
  33. package/dist/skill/references/analytics/keyword-planner-workflows.md +22 -23
  34. package/dist/skill/references/analytics/market-analysis-guide.md +31 -25
  35. package/dist/skill/references/analytics/rag.md +20 -20
  36. package/dist/skill/references/analytics/reporting.md +4 -4
  37. package/dist/skill/references/analytics/website-diagnosis-guide.md +24 -24
  38. package/dist/skill/references/core/agent-conventions.md +136 -106
  39. package/dist/skill/references/core/cli-enums.md +47 -53
  40. package/dist/skill/references/core/playbooks.md +42 -41
  41. package/dist/skill/references/core/subagent-orchestration.md +40 -40
  42. package/dist/skill/references/core/tips.md +18 -61
  43. package/dist/skill/references/core/workflows.md +36 -29
  44. package/dist/skill/references/google-ads/google-ads-campaign-plan.md +25 -24
  45. package/dist/skill/references/google-ads/google-ads.md +81 -57
  46. package/dist/skill/references/google-ads/pmax-api.md +138 -34
  47. package/dist/skill/references/google-ads/rules/README.md +15 -15
  48. package/dist/skill/references/google-ads/rules/google-ads-account-audit.md +22 -22
  49. package/dist/skill/references/google-ads/rules/google-ads-compliance.md +27 -27
  50. package/dist/skill/references/google-ads/rules/google-ads-keyword-strategy.md +15 -15
  51. package/dist/skill/references/google-ads/rules/google-ads-keyword-taxonomy.md +32 -22
  52. package/dist/skill/references/google-ads/rules/google-ads-launch-plan-template.md +32 -30
  53. package/dist/skill/references/google-ads/rules/google-ads-pmax-guide.md +3 -1
  54. package/dist/skill/references/misc/tso-home.md +8 -8
  55. package/dist/skill/references/operations/clue.md +1 -1
  56. package/dist/skill/references/operations/forewarning.md +1 -1
  57. package/dist/skill/references/operations/hosted-automation-optimize-index.md +2 -2
  58. package/dist/skill/references/operations/hosted-automation-scenarios.md +5 -5
  59. package/dist/skill/references/operations/hosted-automation-self-control.md +15 -15
  60. package/dist/skill/references/operations/hosted-automation-user-catalog.md +13 -13
  61. package/dist/skill/references/operations/optimize.md +8 -8
  62. package/dist/skill/references/report-templates/README.md +45 -0
  63. package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +114 -0
  64. package/dist/skill/references/report-templates/bing-period-report.md +65 -0
  65. package/dist/skill/references/report-templates/google-account-diagnosis-report.md +83 -0
  66. package/dist/skill/references/report-templates/google-ads-diagnosis.md +378 -0
  67. package/dist/skill/references/report-templates/google-inquiry-analysis.md +543 -0
  68. package/dist/skill/references/report-templates/google-period-report-excel.md +126 -0
  69. package/dist/skill/references/report-templates/google-period-report.md +60 -0
  70. package/dist/skill/references/report-templates/market-analysis-report.md +40 -0
  71. package/dist/skill/references/report-templates/meta-account-diagnosis-report.md +74 -0
  72. package/dist/skill/references/report-templates/meta-period-report-excel.md +230 -0
  73. package/dist/skill/references/report-templates/meta-period-report.md +219 -0
  74. package/dist/skill/references/report-templates/okki-weekly-google-client.md +217 -0
  75. package/dist/skill/references/report-templates/tiktok-period-report.md +56 -0
  76. package/dist/skill/references/report-templates/website-diagnosis-report.md +79 -0
  77. package/dist/skill/report-templates/README.md +16 -14
  78. package/dist/skill/report-templates/REPORT-WORKFLOW.md +13 -13
  79. package/dist/skill/report-templates/google-account-diagnosis-report.md +1 -1
  80. package/dist/skill/report-templates/google-ads-diagnosis.md +21 -21
  81. package/dist/skill/report-templates/google-inquiry-analysis.md +44 -44
  82. package/dist/skill/report-templates/google-period-report-excel.md +24 -24
  83. package/dist/skill/report-templates/google-period-report.md +23 -23
  84. package/dist/skill/report-templates/market-analysis-report.md +1 -1
  85. package/dist/skill/report-templates/meta-period-report-excel.md +72 -64
  86. package/dist/skill/report-templates/meta-period-report.html +706 -428
  87. package/dist/skill/report-templates/meta-period-report.md +61 -60
  88. package/dist/skill/report-templates/okki-weekly-google-client.md +26 -26
  89. package/dist/skill/report-templates/report-template-academic.html +1 -1
  90. package/dist/skill/report-templates/report-template-dark.html +1 -1
  91. package/dist/skill/report-templates/report-template-formal.html +1 -1
  92. package/dist/skill/report-templates/report-template-mobile.html +1 -1
  93. package/dist/skill/report-templates/report-template-onepager.html +1 -1
  94. package/dist/skill/report-templates/report-template-print.html +1 -1
  95. package/dist/skill/report-templates/report-template.html +1 -1
  96. package/dist/skill/report-templates/website-diagnosis-report.html +1731 -1653
  97. package/dist/skill/report-templates/website-diagnosis-report.md +21 -23
  98. package/dist/skill/scripts/install.ps1 +1 -1
  99. package/dist/skill/scripts/install.sh +1 -1
  100. package/dist/skill/snippets/handoff-p7-inquiry.md +5 -5
  101. package/eval/cases/accounts-entityid-vs-mediaccustomerid.scenario.json +2 -14
  102. package/eval/cases/accounts-mcc-bind-inquiry.scenario.json +1 -3
  103. package/eval/cases/accounts-single-balance-not-bulk.scenario.json +3 -14
  104. package/eval/cases/budget-display-not-raw-micros.scenario.json +1 -8
  105. package/eval/cases/clue-meta-leads-json.scenario.json +2 -14
  106. package/eval/cases/clue-tiktok-leads-json.scenario.json +2 -11
  107. package/eval/cases/destructive-account-delink-needs-confirm.scenario.json +3 -9
  108. package/eval/cases/destructive-forewarning-delete-needs-confirm.scenario.json +3 -9
  109. package/eval/cases/destructive-invoice-apply-needs-confirm.scenario.json +3 -9
  110. package/eval/cases/facebook-analysis-google-section-aliases.scenario.json +2 -11
  111. package/eval/cases/facebook-analysis-not-google-keywords.scenario.json +3 -10
  112. package/eval/cases/facebook-analysis-period-default.scenario.json +2 -14
  113. package/eval/cases/finance-invoice-info-list.scenario.json +3 -11
  114. package/eval/cases/forewarning-list-google.scenario.json +3 -14
  115. package/eval/cases/google-ads-no-structural-without-confirm.scenario.json +2 -6
  116. package/eval/cases/google-analysis-keywords-route.scenario.json +2 -14
  117. package/eval/cases/human-p1-multiturn.scenario.json +1 -5
  118. package/eval/cases/meta-single-balance-not-bulk.scenario.json +3 -17
  119. package/eval/cases/no-legacy-json-flag.scenario.json +2 -6
  120. package/eval/cases/open-account-google-noninteractive.scenario.json +1 -3
  121. package/eval/cases/open-account-tiktok-license-file.scenario.json +1 -3
  122. package/eval/cases/optimize-list-by-account.scenario.json +3 -11
  123. package/eval/cases/p1-single-account-profile.scenario.json +1 -11
  124. package/eval/cases/p2-balance-scan-bulk.scenario.json +2 -9
  125. package/eval/cases/p3-accounts-digest.scenario.json +1 -5
  126. package/eval/cases/p4-fb-meta-period-report.scenario.json +2 -12
  127. package/eval/cases/p4-period-report-window.scenario.json +1 -8
  128. package/eval/cases/pmax-asset-group-create-with-bg.scenario.json +15 -0
  129. package/eval/cases/pmax-brand-edit-routing.scenario.json +12 -0
  130. package/eval/cases/pmax-edit-not-campaign-edit.scenario.json +15 -0
  131. package/eval/cases/pmax-enable-brand-guidelines.scenario.json +15 -0
  132. package/eval/cases/pmax-no-assets-update-brand-fields.scenario.json +12 -0
  133. package/eval/cases/rag-before-keyword-expand.scenario.json +1 -11
  134. package/eval/cases/rag-list-then-query.scenario.json +2 -14
  135. package/eval/cases/report-list-google.scenario.json +2 -11
  136. package/eval/cases/report-push-list-google.scenario.json +2 -11
  137. package/eval/cases/setup-login-or-env.scenario.json +1 -3
  138. package/eval/cases/setup-siluzan-data-permission-env.scenario.json +1 -3
  139. package/eval/cases/tiktok-bc-bind-inquiry.scenario.json +2 -6
  140. package/eval/cases/time-range-user-delegates-default.scenario.json +1 -8
  141. package/eval/cases/tips-json-out-filtering.scenario.json +1 -3
  142. package/eval/cases/tips-large-json-pagination.scenario.json +1 -3
  143. package/eval/cases/uj-ad-campaign-validate-before-create-stub.scenario.json +2 -11
  144. package/eval/cases/uj-ad-outdoor-campgear-search-plan.scenario.json +1 -3
  145. package/eval/cases/uj-analytics-30d-pdf-campaign-device-geo.scenario.json +6 -18
  146. package/eval/cases/uj-analytics-compare-google-tiktok-last-month-roi.scenario.json +1 -8
  147. package/eval/cases/uj-analytics-google-weekly-trends-campaigns-keywords.scenario.json +2 -11
  148. package/eval/cases/uj-analytics-report-push-weekly-email.scenario.json +1 -3
  149. package/eval/cases/uj-finance-invoice-records-this-month.scenario.json +2 -11
  150. package/eval/cases/uj-life-newbie-siluzan-google-end-to-end.scenario.json +1 -4
  151. package/eval/cases/uj-ops-google-accounts-list-normal.scenario.json +2 -17
  152. package/eval/cases/uj-ops-google-yesterday-spend-conversions.scenario.json +2 -14
  153. package/eval/cases/uj-ops-pause-worst-adgroup-confirm.scenario.json +2 -6
  154. package/eval/cases/uj-ops-tiktok-leads-last-week.scenario.json +3 -17
  155. package/eval/cases/uj-patrol-cpc-spike-adgroups-over-15.scenario.json +1 -5
  156. package/eval/cases/uj-patrol-forewarning-create-daily-cap-3000.scenario.json +1 -3
  157. package/eval/cases/uj-patrol-forewarning-trigger-records.scenario.json +3 -17
  158. package/eval/cases/uj-patrol-google-balances-low.scenario.json +2 -11
  159. package/eval/cases/uj-roi-optimize-records-then-execute-cautiously.scenario.json +3 -14
  160. package/eval/cases/uj-roi-search-terms-add-negative-keywords.scenario.json +2 -14
  161. package/eval/stub-fixtures/facebook-analysis.json +24 -4
  162. package/eval/stub-fixtures/meta-overview.json +4 -1
  163. package/eval/stub-fixtures/pmax-asset-group-create-ok.json +12 -0
  164. package/eval/stub-fixtures/pmax-brand-assets-edit-ok.json +11 -0
  165. package/eval/stub-fixtures/pmax-brand-guidelines-enable-ok.json +11 -0
  166. package/eval/stub-fixtures/pmax-edit-ok.json +11 -0
  167. package/eval/stub-fixtures/pmax-get-bg-on.json +20 -0
  168. package/package.json +1 -1
  169. package/dist/skill/references/core/deliverable-preflight.md +0 -109
@@ -105,87 +105,31 @@ siluzan-tso config show
105
105
 
106
106
  ### 功能总览
107
107
 
108
- | 功能 | 引导用户打开的网页路径 | CLI 支持 |
109
- | ---------------------------- | ----------------------------------------------------------------------- | --------------------------------------- |
110
- | 传统充值/现金充值(单笔,仅 Google/TikTok/Meta/Microsoft) | `/v3/foreign_trade/tso/recharge/pay?mediaType=<mediaType>` | ❌ 引导网页 |
111
- | 现金充值(批量,仅 Google/TikTok) | `/v3/foreign_trade/tso/recharge/pay_batch?mediaType=<Google|TikTok>` | ❌ 引导网页 |
112
- | 月结充值(仅 Google/TikTok/Meta/Microsoft) | `/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=<mediaType>` | ❌ 引导网页 |
113
- | 丝路赞钱包(充值/提现/明细) | `/v3/foreign_trade/tso/recharge/siluzanWallet` | ❌ 引导网页 |
114
- | 媒体转账记录 | `/v3/foreign_trade/tso/recharge/accountTransfer` | ✅ `transfer` 命令 |
115
- | 开票记录 | `/v3/foreign_trade/tso/recharge/invoiceList` | ✅ `invoice list` |
116
- | 开票申请列表 | `/v3/foreign_trade/tso/recharge/invoicingApplicationList` | ✅ `invoice billable` / `invoice apply` |
108
+ | 功能 | 引导用户打开的网页路径 | CLI 支持 |
109
+ | ---------------------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------- | ----------- |
110
+ | 传统充值/现金充值(单笔,仅 Google/TikTok/Meta/Microsoft) | `/v3/foreign_trade/tso/recharge/pay?mediaType=<mediaType>` | ❌ 引导网页 |
111
+ | 现金充值(批量,仅 Google/TikTok) | `/v3/foreign_trade/tso/recharge/pay_batch?mediaType=<Google | TikTok>` | ❌ 引导网页 |
112
+ | 月结充值(仅 Google/TikTok/Meta/Microsoft) | `/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=<mediaType>` | ❌ 引导网页 |
113
+ | 丝路赞钱包(充值/提现/明细) | `/v3/foreign_trade/tso/recharge/siluzanWallet` | ❌ 引导网页 |
114
+ | 媒体转账记录 | `/v3/foreign_trade/tso/recharge/accountTransfer` | ✅ `transfer` 命令 |
115
+ | 开票记录 | `/v3/foreign_trade/tso/recharge/invoiceList` | ✅ `invoice list` |
116
+ | 开票申请列表 | `/v3/foreign_trade/tso/recharge/invoicingApplicationList` | ✅ `invoice billable` / `invoice apply` |
117
117
 
118
- ### 充值页媒体参数
118
+ ### 充值页链接(按媒体 × 类型)
119
119
 
120
- 当用户指明媒体平台时,优先给出对应媒体的传统充值/现金充值直达页:
120
+ 链接模式:`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`;丝路赞钱包:`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`(无媒体参数)。
121
121
 
122
- | 媒体 | `mediaType` 参数 | 传统充值/现金充值链接 |
123
- | ---- | ---------------- | ------------ |
124
- | Google | `Google` | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google` |
125
- | TikTok | `TikTok` | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok` |
126
- | Meta / Facebook | `MetaAd` | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd` |
127
- | Microsoft / Bing | `MicrosoftAd` | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd` |
122
+ | 充值类型 | `<page>` | 支持媒体(`mediaType` 参数) |
123
+ | ------------------------- | --------------------- | ------------------------------------------- |
124
+ | 传统充值/现金充值(单笔) | `pay` | `Google`、`TikTok`、`MetaAd`、`MicrosoftAd` |
125
+ | 现金充值(批量) | `pay_batch` | `Google`、`TikTok` |
126
+ | 月结充值 | `accountBillingQuota` | `Google`、`TikTok`、`MetaAd`、`MicrosoftAd` |
128
127
 
129
- > Yandex、Kwai 当前没有传统充值/现金充值界面;用户询问这些媒体充值时,不要拼接充值页链接,应说明当前网页不提供对应充值入口,并建议联系丝路赞客服或业务负责人确认处理方式。
130
-
131
- 批量充值页面当前仅支持 Google 和 TikTok:
132
-
133
- | 媒体 | 批量充值链接 |
134
- | ---- | ------------ |
135
- | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google` |
136
- | TikTok | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok` |
137
-
138
- > Meta、Microsoft/Bing、Yandex、Kwai 当前不要引导到批量充值页。
139
-
140
- 月结充值页面当前仅支持 Google、TikTok、Meta 和 Microsoft/Bing:
141
-
142
- | 媒体 | 月结充值链接 |
143
- | ---- | ------------ |
144
- | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google` |
145
- | TikTok | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok` |
146
- | Meta / Facebook | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd` |
147
- | Microsoft / Bing | `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd` |
148
-
149
- > Yandex、Kwai 当前不要引导到月结充值页。
128
+ > **Yandex、Kwai** 当前没有任何充值页面:不要拼接链接,说明网页暂不提供对应入口,建议联系丝路赞客服或业务负责人。不支持的「媒体 × 类型」组合(如 Meta 批量充值)同样不要引导。
150
129
 
151
130
  ### 引导用户的标准话术
152
131
 
153
- 当用户需要充值/查看钱包时,先取 `webUrl`,再给出完整链接。用户已指定媒体时,优先给对应媒体的单笔充值链接;未指定媒体时,先询问媒体或给出下列通用入口:
154
-
155
- ```
156
- 需要进行充值,请访问丝路赞平台对应页面完成操作:
157
-
158
- - Google 充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
159
- - TikTok 充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok
160
- - Meta 充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd
161
- - Microsoft/Bing 充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd
162
- - Google 批量充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google
163
- - TikTok 批量充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok
164
- - Google 月结充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google
165
- - TikTok 月结充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok
166
- - Meta 月结充值: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd
167
- - Microsoft/Bing 月结充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd
168
- - 丝路赞钱包: https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet
169
-
170
- Yandex、Kwai 当前没有传统充值/现金充值和月结充值界面,需联系丝路赞客服或业务负责人确认处理方式。
171
- 批量充值当前仅支持 Google 和 TikTok;Meta、Microsoft/Bing、Yandex、Kwai 不要引导到批量充值页。
172
- ```
173
-
174
- **示例:**
175
-
176
- ```
177
- - Google 充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
178
- - TikTok 充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok
179
- - Meta 充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd
180
- - Microsoft/Bing 充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd
181
- - Google 批量充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google
182
- - TikTok 批量充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok
183
- - Google 月结充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google
184
- - TikTok 月结充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok
185
- - Meta 月结充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd
186
- - Microsoft/Bing 月结充值:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd
187
- - 丝路赞钱包:https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet
188
- ```
132
+ 当用户需要充值/查看钱包时,先取 `webUrl`,再按上表拼出**完整链接**。用户已指定媒体时,只给对应媒体的单笔充值链接(按需补批量/月结);未指定媒体时,先询问媒体,或列出全部支持媒体的单笔充值链接 + 丝路赞钱包链接,并附 Yandex/Kwai 的说明。
189
133
 
190
134
  ---
191
135
 
@@ -201,7 +145,7 @@ siluzan-tso transfer list [选项]
201
145
  | `-n, --number <no>` | 转账单号 |
202
146
  | `-s, --status <status>` | 到账状态 |
203
147
  | `--start / --end <date>` | 日期范围(YYYY-MM-DD) |
204
- | `--json-out` | 输出原始 JSON |
148
+ | `--json-out` | 输出原始 JSON |
205
149
 
206
150
  **示例:**
207
151
 
@@ -236,7 +180,7 @@ siluzan-tso transfer create -m <媒体> --out <转出ID> --in <转入ID> --amoun
236
180
  | `--in <id>` | 转入账户 `mediaCustomerId` | ✅ |
237
181
  | `--amount <amount>` | 转账金额(与账户货币单位一致) | ✅ |
238
182
  | `--customer-name <name>` | 客户名称备注(可选) | |
239
- | `--json-out` | 输出原始 JSON | |
183
+ | `--json-out` | 输出原始 JSON | |
240
184
 
241
185
  **示例:**
242
186
 
@@ -264,7 +208,7 @@ siluzan-tso invoice list [选项]
264
208
  | ------------------------ | ---------------------- |
265
209
  | `-k, --keyword <text>` | 发票号/关键字 |
266
210
  | `--start / --end <date>` | 日期范围(YYYY-MM-DD) |
267
- | `--json-out` | 输出原始 JSON |
211
+ | `--json-out` | 输出原始 JSON |
268
212
 
269
213
  **示例:**
270
214
 
@@ -298,7 +242,7 @@ siluzan-tso invoice billable [选项]
298
242
  | `-c, --currency <code>` | 币种,如 `USD \| CNY` |
299
243
  | `--wallet` | 查询钱包充值可开票记录 |
300
244
  | `--start / --end <date>` | 日期范围 |
301
- | `--json-out` | 输出原始 JSON |
245
+ | `--json-out` | 输出原始 JSON |
302
246
 
303
247
  **示例:**
304
248
 
@@ -359,7 +303,7 @@ siluzan-tso invoice apply \
359
303
 
360
304
  | 选项 | 说明 | 必填 |
361
305
  | ------------------------- | ----------------------------------------------------------------------------------- | -------------- |
362
- | `--bill-ids` | 可开票订单 `entityId`,逗号分隔(来自 `invoice billable --json-out ./snap`) | ✅ |
306
+ | `--bill-ids` | 可开票订单 `entityId`,逗号分隔(来自 `invoice billable --json-out ./snap`) | ✅ |
363
307
  | `--bill-type` | 账单来源类型:`AmountAccount`(充值开票)\| `WalletRecharge`(钱包开票) | ✅ |
364
308
  | `--invoice-type` | 发票格式:`PI`(形式发票,境外英文)\| `VATI`(增值税普票)\| `VATSI`(增值税专票) | ✅ |
365
309
  | `--recipient-name` | 收件人姓名 | ✅ |
@@ -1,20 +1,22 @@
1
1
  # 各媒体开户
2
2
 
3
- > 网页链接:`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
3
+ > 网页链接:`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
4
4
  > 多命令串联见 `references/core/workflows.md` § 流程一。
5
5
 
6
6
  ## 首次响应硬规范(必读)
7
7
 
8
8
  用户提出开户(或本轮对话**首次**进入开户话题)时,Agent **必须先输出完整必填清单**,再收集资料或执行 CLI。**禁止**在未列清单的情况下直接 `open-account …` 或只问一两个字段。
9
9
 
10
- | 用户说法 | 首次回复必须包含 |
11
- | -------- | ---------------- |
12
- | 未指明媒体 / 「开个户」/ 「各平台开户」 | 下文 **§ 全平台必填总览** 六张表(或等价完整列表) |
13
- | 已指明单一媒体(如「Google 开户」) | 该媒体 **§ 必填字段** 表 + 辅助查询命令(若有)+ 资料类说明(执照路径等) |
14
- | 多媒体同时开 | 每个目标媒体各一张必填表,**禁止**混用字段 |
10
+ | 用户说法 | 首次回复必须包含 |
11
+ | --------------------------------------- | ------------------------------------------------------------------------- |
12
+ | 未指明媒体 / 「开个户」/ 「各平台开户」 | 下文 **§ 全平台必填总览** 六张表(或等价完整列表) |
13
+ | 已指明单一媒体(如「Google 开户」) | 该媒体 **§ 必填字段** 表 + 辅助查询命令(若有)+ 资料类说明(执照路径等) |
14
+ | 多媒体同时开 | 每个目标媒体各一张必填表,**禁止**混用字段 |
15
15
 
16
16
  清单须写清:**业务含义**、**CLI 选项名**、**格式/枚举**、**是否需本地文件路径**。用户补齐后再确认并提交;写入前仍须用户确认(见 `references/core/agent-conventions.md`)。
17
17
 
18
+ 只有Google开户时需要询问用户账户币种(USD|CNY),其他广告平台禁止询问用户币种因为都仅支持USD一种
19
+
18
20
  不确定字段时:先 `siluzan-tso open-account <subcommand> -h`,再以本文件与 CLI 为准,勿猜。
19
21
 
20
22
  ---
@@ -35,83 +37,82 @@
35
37
 
36
38
  ### Google(`open-account google`,无需图片)
37
39
 
38
- | 业务项 | CLI 选项 | 说明 |
39
- | ------ | -------- | ---- |
40
- | 公司名称 | `--company` | 用于匹配/创建广告主组 |
41
- | 推广链接 | `--promotion-link` | 可只写域名,CLI 补 `https://` |
42
- | 推广类型 | `--promotion-type` | `b2b` \| `b2c` \| `app` |
43
- | 账户名称 | `--account-name` | 建议 ≤22 字 |
44
- | 币种 | `--currency` | `USD` \| `CNY` |
45
- | 时区 | `--timezone` | IANA;列表:`open-account google-timezones` |
46
- | 邀请邮箱 | `--invite-email` | 账户邀请发往此邮箱 |
40
+ | 业务项 | CLI 选项 | 说明 |
41
+ | -------- | ------------------ | ------------------------------------------- |
42
+ | 公司名称 | `--company` | 用于匹配/创建广告主组 |
43
+ | 推广链接 | `--promotion-link` | 可只写域名,CLI 补 `https://` |
44
+ | 推广类型 | `--promotion-type` | `b2b` \| `b2c` \| `app` |
45
+ | 账户名称 | `--account-name` | 建议 ≤22 字 |
46
+ | 币种 | `--currency` | `USD` \| `CNY` |
47
+ | 时区 | `--timezone` | IANA;列表:`open-account google-timezones` |
48
+ | 邀请邮箱 | `--invite-email` | 账户邀请发往此邮箱 |
47
49
 
48
50
  ### TikTok(`open-account tiktok`,需营业执照图片)
49
51
 
50
- | 业务项 | CLI 选项 | 说明 |
51
- | ------ | -------- | ---- |
52
- | 公司名称 | `--company` | 无 OCR,须用户手填 |
53
- | 账户名称 | `--account-name` | |
54
- | 时区 | `--timezone` | 列表:`open-account tiktok-timezones` |
55
- | 行业 ID | `--industry-id` | **叶子节点**数字;列表:`open-account tiktok-industries` |
56
- | 注册地 | `--registered-area` | 国家代码如 `CN`;列表:`open-account tiktok-areas` |
57
- | 推广链接 | `--promotion-link` | |
58
- | 执照编号 | `--license-no` | 统一社会信用代码 |
59
- | 执照图片 | `--license-file` | 本地 JPG/PNG 路径 |
60
- | 法人姓名 | `--representative-name` | CLI 必填 |
61
- | 法人身份证 | `--representative-id` | CLI 必填 |
62
- | 法人银联账号 | `--unionpay-account` | CLI 必填 |
63
- | 法人手机 | `--representative-phone` | CLI 必填 |
64
-
65
- > 币种由 CLI 固定为 USD,无需 `--currency`。
52
+ | 业务项 | CLI 选项 | 说明 |
53
+ | ------------ | ----------------------------- | -------------------------------------------------------- |
54
+ | 公司名称 | `--company` | 无 OCR,须用户手填 |
55
+ | 账户名称 | `--account-name` | |
56
+ | 时区 | `--timezone` | 列表:`open-account tiktok-timezones` |
57
+ | 行业 ID | `--industry-id` | **叶子节点**数字;列表:`open-account tiktok-industries` |
58
+ | 注册地 | `--registered-area` | 国家代码如 `CN`;列表:`open-account tiktok-areas` |
59
+ | 推广链接 | `--promotion-link` | |
60
+ | 执照编号 | `--license-no` | 统一社会信用代码 |
61
+ | 执照图片 | `--license-file` | 本地 JPG/PNG 路径 |
62
+ | 法人姓名 | `--representative-name` | CLI 必填 |
63
+ | 法人身份证 | `--representative-id` | CLI 必填 |
64
+ | 法人银联账号 | `--unionpay-account` | CLI 必填 |
65
+ | 法人手机 | `--representative-phone` | CLI 必填 |
66
+ | 币种 | 只支持USD, 无需 `--currency` |
66
67
 
67
68
  ### Yandex(`open-account yandex`,无需图片)
68
69
 
69
- | 业务项 | CLI 选项 | 说明 |
70
- | ------ | -------- | ---- |
71
- | 公司名称 | `--company` | |
72
- | 联系邮箱 | `--email` | |
73
- | 税号 TIN/INN | `--tin` | 类型固定 `FOREIGN_LEGAL` |
70
+ | 业务项 | CLI 选项 | 说明 |
71
+ | ------------ | ----------- | ------------------------ |
72
+ | 公司名称 | `--company` | |
73
+ | 联系邮箱 | `--email` | |
74
+ | 税号 TIN/INN | `--tin` | 类型固定 `FOREIGN_LEGAL` |
74
75
 
75
76
  ### BingV2(`open-account bing`,需营业执照图片)
76
77
 
77
- | 业务项 | CLI 选项 | 说明 |
78
- | ------ | -------- | ---- |
79
- | 直接/代理 | `--pattern` | `Direct` \| `Agency` |
80
- | 广告主全称 | `--advertiser-name` | 用于匹配/创建广告主组 |
81
- | 公司简称 | `--name-short` | |
82
- | 开户名称 | `--name-remark-list` | 账户显示名 |
83
- | 省份 | `--province` | |
84
- | 城市 | `--city` | |
85
- | 详细地址 | `--address` | |
86
- | 邮编 | `--postcode` | |
87
- | 行业 | `--trade-id` | 先 `bing-industries`;传输出 **id**(与网页下拉 value 一致),勿猜中文名 |
88
- | 推广链接 | `--promotion-link` | |
89
- | 执照图片 | `--license-file` | JPG/PNG/PDF 本地路径 |
78
+ | 业务项 | CLI 选项 | 说明 |
79
+ | ---------- | -------------------- | ------------------------------------------------------------------------ |
80
+ | 直接/代理 | `--pattern` | `Direct` \| `Agency` |
81
+ | 广告主全称 | `--advertiser-name` | 用于匹配/创建广告主组 |
82
+ | 公司简称 | `--name-short` | |
83
+ | 开户名称 | `--name-remark-list` | 账户显示名 |
84
+ | 省份 | `--province` | |
85
+ | 城市 | `--city` | |
86
+ | 详细地址 | `--address` | |
87
+ | 邮编 | `--postcode` | |
88
+ | 行业 | `--trade-id` | 先 `bing-industries`;传输出 **id**(与网页下拉 value 一致),勿猜中文名 |
89
+ | 推广链接 | `--promotion-link` | |
90
+ | 执照图片 | `--license-file` | JPG/PNG/PDF 本地路径 |
90
91
 
91
92
  ### Kwai(`open-account kwai`,需营业执照图片)
92
93
 
93
- | 业务项 | CLI 选项 | 说明 |
94
- | ------ | -------- | ---- |
95
- | 营业执照号 | `--licence-id` | |
96
- | 注册国家 | `--licence-country` | 如 `CN` |
97
- | 注册地址 | `--licence-location` | 省市区详细地址 |
98
- | 营业范围 | `--business-scope` | |
99
- | 产品/品牌名 | `--product` | |
100
- | 账户类型 | `--ad-type` | `1` 效果 / `2` 品牌 |
101
- | 产品网址 | `--product-url` | |
102
- | 实体类型 | `--licence-id-type` | `INDIVIDUAL` \| `ENTERPRISE` |
103
- | 账户名称 | `--account-name` | |
104
- | 公司主体名 | `--company-name` | |
105
- | 一级行业 ID | `--industry-id1` | |
106
- | 二级行业 ID | `--industry-id2` | |
107
- | 有效期类型 | `--expire-type` | `1` 有限期(须 `--expire-at`)/ `2` 长期 |
108
- | 投放地区 | `--target-country` | ISO 如 `US` |
109
- | 执照图片 | `--license-file` | 本地路径 |
94
+ | 业务项 | CLI 选项 | 说明 |
95
+ | ------------- | -------------------- | ------------------------------------------------------------------------------------------ |
96
+ | 营业执照号 | `--licence-id` | |
97
+ | 注册国家 | `--licence-country` | 如 `CN` |
98
+ | 注册地址 | `--licence-location` | 省市区详细地址 |
99
+ | 营业范围 | `--business-scope` | |
100
+ | 产品/品牌名 | `--product` | |
101
+ | 账户类型 | `--ad-type` | `1` 效果 / `2` 品牌 |
102
+ | 产品网址 | `--product-url` | |
103
+ | 执照/证件类型 | `--licence-id-type` | `1` 统一社会信用代码 / `2` DUNS / `3` CNPJ(与网页下拉 value 一致;**勿用** `ENTERPRISE`) |
104
+ | 账户名称 | `--account-name` | |
105
+ | 公司主体名 | `--company-name` | |
106
+ | 一级行业 ID | `--industry-id1` | |
107
+ | 二级行业 ID | `--industry-id2` | |
108
+ | 有效期类型 | `--expire-type` | `1` 有限期(须 `--expire-at`)/ `2` 长期 |
109
+ | 投放地区 | `--target-country` | ISO 如 `US` |
110
+ | 执照图片 | `--license-file` | 本地路径 |
110
111
 
111
112
  ### MetaAd(`open-account meta`)
112
113
 
113
- | 业务项 | 说明 |
114
- | ------ | ---- |
114
+ | 业务项 | 说明 |
115
+ | ---------- | -------------------------------------------- |
115
116
  | 用户侧资料 | 在 Meta 官方 OE 网页填写;CLI **无**表单字段 |
116
117
 
117
118
  ---
@@ -124,13 +125,13 @@
124
125
 
125
126
  **常用时区**(完整:`siluzan-tso open-account google-timezones`):
126
127
 
127
- | Code | 含义 |
128
- | ---- | ---- |
129
- | `Asia/Shanghai` | CNY 默认 |
130
- | `Asia/Hong_Kong` | USD 默认 |
131
- | `America/New_York` | 美东 |
132
- | `America/Los_Angeles` | 美西 |
133
- | `Europe/London` | 伦敦 |
128
+ | Code | 含义 |
129
+ | --------------------- | -------- |
130
+ | `Asia/Shanghai` | CNY 默认 |
131
+ | `Asia/Hong_Kong` | USD 默认 |
132
+ | `America/New_York` | 美东 |
133
+ | `America/Los_Angeles` | 美西 |
134
+ | `Europe/London` | 伦敦 |
134
135
 
135
136
  ```bash
136
137
  siluzan-tso open-account google \
@@ -227,6 +228,8 @@ siluzan-tso account-history -m BingV2
227
228
  **必填**:见上表 § Kwai。
228
229
 
229
230
  > **双上传**:CLI 先上传附件得 `imageId`(更新广告主组 MAG),再上传 Kwai 资质得 `blobstoreKey`(写入 `mainCertPhotos`)。二者不可混用。
231
+ >
232
+ > **落库确认**:`AddKwaiAccount` 返回 HTTP 202(异步受理)。CLI 提交后会轮询 `account-history` 同源接口,**仅在查到对应 `--account-name` 后才报成功**;否则 exit 1 并提示核对 `--licence-id-type` 等字段。
230
233
 
231
234
  ```bash
232
235
  siluzan-tso open-account kwai \
@@ -238,7 +241,7 @@ siluzan-tso open-account kwai \
238
241
  --product "品牌A" \
239
242
  --ad-type 1 \
240
243
  --product-url "https://www.brand-a.com" \
241
- --licence-id-type ENTERPRISE \
244
+ --licence-id-type 1 \
242
245
  --account-name "品牌A Kwai账户" \
243
246
  --industry-id1 "1234" \
244
247
  --industry-id2 "5678" \
@@ -281,10 +284,10 @@ siluzan-tso list-accounts -m MetaAd
281
284
 
282
285
  ## 审核结果
283
286
 
284
- | 状态 | 含义 | 下一步 |
285
- | ---- | ---- | ------ |
286
- | 审核中 | 等待媒体审核 | 继续 `account-history` 轮询 |
287
- | 已通过 | 账户可用 | `list-accounts` 确认 + 按 `finance.md` 打开对应媒体充值页(传统充值/月结充值仅 Google/TikTok/Meta/Microsoft 有页面;Kwai、Yandex 当前没有对应充值界面) |
288
- | 已拒绝 | 资料问题 | 查看拒绝原因,修正后重新提交 |
287
+ | 状态 | 含义 | 下一步 |
288
+ | ------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
289
+ | 审核中 | 等待媒体审核 | 继续 `account-history` 轮询 |
290
+ | 已通过 | 账户可用 | `list-accounts` 确认 + 按 `finance.md` 打开对应媒体充值页(传统充值/月结充值仅 Google/TikTok/Meta/Microsoft 有页面;Kwai、Yandex 当前没有对应充值界面) |
291
+ | 已拒绝 | 资料问题 | 查看拒绝原因,修正后重新提交 |
289
292
 
290
293
  完整参数:`siluzan-tso open-account <subcommand> -h`
@@ -1,12 +1,12 @@
1
1
  ## 一、开户流程(五步语义)
2
2
 
3
- | 步骤 | 含义 | CLI / Skill |
4
- | ---- | ---- | ----------- |
5
- | ① | 准备资料 | 向用户说明清单;无法代替用户准备资质 |
6
- | ② | 填写并提交 | `open-account google-wizard`(TTY)或 `open-account google` |
7
- | ③ | 等待审核 | `account-history -m Google` |
8
- | ④ | 审核通过 | 同上 |
9
- | ⑤ | 充值激活 | **必须网页**;`config show` → `webUrl` + 充值路径(见 `finance.md`) |
3
+ | 步骤 | 含义 | CLI / Skill |
4
+ | ---- | ---------- | -------------------------------------------------------------------- |
5
+ | ① | 准备资料 | 向用户说明清单;无法代替用户准备资质 |
6
+ | ② | 填写并提交 | `open-account google-wizard`(TTY)或 `open-account google` |
7
+ | ③ | 等待审核 | `account-history -m Google` |
8
+ | ④ | 审核通过 | 同上 |
9
+ | ⑤ | 充值激活 | **必须网页**;`config show` → `webUrl` + 充值路径(见 `finance.md`) |
10
10
 
11
11
  美元账户最低充值约 **100 USD**,人民币约 **700 CNY**(以平台为准)。
12
12
 
@@ -14,17 +14,17 @@
14
14
 
15
15
  ## 二、非交互提交字段
16
16
 
17
- | 字段 | CLI 选项 |
18
- | ---- | -------- |
19
- | 公司名称 | `--company` |
20
- | 推广网址 | `--promotion-link`(可只写域名,CLI 补协议) |
21
- | 推广类型 B2B/B2C/APP | `--promotion-type`:`b2b` \| `b2c` \| `app` |
22
- | 行业(可选) | `--industry1` / `--industry2` |
23
- | 账户名称 | `--account-name` |
24
- | 币种 CNY/USD | `--currency` |
25
- | 时区 IANA | `--timezone`;列表:`open-account google-timezones` |
26
- | 开户数量 1~3 | `--counts` |
27
- | 邀请邮箱 | `--invite-email` |
17
+ | 字段 | CLI 选项 |
18
+ | -------------------- | --------------------------------------------------- |
19
+ | 公司名称 | `--company` |
20
+ | 推广网址 | `--promotion-link`(可只写域名,CLI 补协议) |
21
+ | 推广类型 B2B/B2C/APP | `--promotion-type`:`b2b` \| `b2c` \| `app` |
22
+ | 行业(可选) | `--industry1` / `--industry2` |
23
+ | 账户名称 | `--account-name` |
24
+ | 币种 CNY/USD | `--currency` |
25
+ | 时区 IANA | `--timezone`;列表:`open-account google-timezones` |
26
+ | 开户数量 1~3 | `--counts` |
27
+ | 邀请邮箱 | `--invite-email` |
28
28
 
29
29
  **币种默认时区**:CNY → `Asia/Shanghai`;USD(或其它非 CNY)→ `Asia/Hong_Kong`。其它时区从 `google-timezones` 取 **Code** 列。
30
30
 
@@ -77,11 +77,11 @@ siluzan-tso account-history -m Google
77
77
 
78
78
  ## 五、命令速查
79
79
 
80
- | 命令 | 作用 |
81
- | ---- | ---- |
82
- | `open-account google-wizard` | 交互向导 |
83
- | `open-account google-timezones` | 时区列表 |
84
- | `open-account google` | 非交互提交 |
85
- | `account-history -m Google` | 审核进度 |
80
+ | 命令 | 作用 |
81
+ | ------------------------------- | ---------- |
82
+ | `open-account google-wizard` | 交互向导 |
83
+ | `open-account google-timezones` | 时区列表 |
84
+ | `open-account google` | 非交互提交 |
85
+ | `account-history -m Google` | 审核进度 |
86
86
 
87
87
  完整参数见 `accounts/accounts.md` → **open-account**。