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.
- package/README.md +1 -1
- package/dist/index.js +3174 -867
- package/dist/skill/AGENTS.md +30 -31
- package/dist/skill/SKILL.md +16 -33
- package/dist/skill/_meta.json +2 -2
- package/dist/skill/assets/campaign-create-keyword-test.fixed.json +10 -33
- package/dist/skill/assets/campaign-create-template.json +2 -0
- package/dist/skill/assets/campaign-create-template.md +114 -99
- package/dist/skill/assets/market-analysis-rules.md +55 -55
- package/dist/skill/assets/meta-period-report-rules.md +61 -60
- package/dist/skill/assets/pmax-asset-group-template.json +12 -4
- package/dist/skill/assets/pmax-asset-group-template.md +25 -0
- package/dist/skill/assets/pmax-brand-assets-template.json +25 -0
- package/dist/skill/assets/pmax-brand-assets-template.md +22 -0
- package/dist/skill/assets/pmax-brand-guidelines-enable-template.json +24 -0
- package/dist/skill/assets/pmax-brand-guidelines-enable-template.md +22 -0
- package/dist/skill/assets/pmax-create-template.json +41 -2
- package/dist/skill/assets/pmax-create-template.md +84 -51
- package/dist/skill/assets/pmax-lead-form-template.json +36 -0
- package/dist/skill/assets/pmax-lead-form-template.md +70 -0
- package/dist/skill/assets/pmax-signals-template.json +2 -6
- package/dist/skill/assets/pmax-whatsapp-template.json +26 -0
- package/dist/skill/assets/pmax-whatsapp-template.md +45 -0
- package/dist/skill/assets/website-diagnosis-rules.md +67 -67
- package/dist/skill/references/README.md +78 -65
- package/dist/skill/references/accounts/accounts.md +99 -105
- package/dist/skill/references/accounts/finance.md +23 -79
- package/dist/skill/references/accounts/open-account-by-media.md +84 -81
- package/dist/skill/references/accounts/open-account-google-ui.md +24 -24
- package/dist/skill/references/analytics/account-analytics.md +94 -103
- package/dist/skill/references/analytics/facebook-analysis-guide.md +61 -61
- package/dist/skill/references/analytics/google-analysis-batch.md +2 -2
- package/dist/skill/references/analytics/keyword-planner-workflows.md +22 -23
- package/dist/skill/references/analytics/market-analysis-guide.md +31 -25
- package/dist/skill/references/analytics/rag.md +20 -20
- package/dist/skill/references/analytics/reporting.md +4 -4
- package/dist/skill/references/analytics/website-diagnosis-guide.md +24 -24
- package/dist/skill/references/core/agent-conventions.md +136 -106
- package/dist/skill/references/core/cli-enums.md +47 -53
- package/dist/skill/references/core/playbooks.md +42 -41
- package/dist/skill/references/core/subagent-orchestration.md +40 -40
- package/dist/skill/references/core/tips.md +18 -61
- package/dist/skill/references/core/workflows.md +36 -29
- package/dist/skill/references/google-ads/google-ads-campaign-plan.md +25 -24
- package/dist/skill/references/google-ads/google-ads.md +81 -57
- package/dist/skill/references/google-ads/pmax-api.md +138 -34
- package/dist/skill/references/google-ads/rules/README.md +15 -15
- package/dist/skill/references/google-ads/rules/google-ads-account-audit.md +22 -22
- package/dist/skill/references/google-ads/rules/google-ads-compliance.md +27 -27
- package/dist/skill/references/google-ads/rules/google-ads-keyword-strategy.md +15 -15
- package/dist/skill/references/google-ads/rules/google-ads-keyword-taxonomy.md +32 -22
- package/dist/skill/references/google-ads/rules/google-ads-launch-plan-template.md +32 -30
- package/dist/skill/references/google-ads/rules/google-ads-pmax-guide.md +3 -1
- package/dist/skill/references/misc/tso-home.md +8 -8
- package/dist/skill/references/operations/clue.md +1 -1
- package/dist/skill/references/operations/forewarning.md +1 -1
- package/dist/skill/references/operations/hosted-automation-optimize-index.md +2 -2
- package/dist/skill/references/operations/hosted-automation-scenarios.md +5 -5
- package/dist/skill/references/operations/hosted-automation-self-control.md +15 -15
- package/dist/skill/references/operations/hosted-automation-user-catalog.md +13 -13
- package/dist/skill/references/operations/optimize.md +8 -8
- package/dist/skill/references/report-templates/README.md +45 -0
- package/dist/skill/references/report-templates/REPORT-WORKFLOW.md +114 -0
- package/dist/skill/references/report-templates/bing-period-report.md +65 -0
- package/dist/skill/references/report-templates/google-account-diagnosis-report.md +83 -0
- package/dist/skill/references/report-templates/google-ads-diagnosis.md +378 -0
- package/dist/skill/references/report-templates/google-inquiry-analysis.md +543 -0
- package/dist/skill/references/report-templates/google-period-report-excel.md +126 -0
- package/dist/skill/references/report-templates/google-period-report.md +60 -0
- package/dist/skill/references/report-templates/market-analysis-report.md +40 -0
- package/dist/skill/references/report-templates/meta-account-diagnosis-report.md +74 -0
- package/dist/skill/references/report-templates/meta-period-report-excel.md +230 -0
- package/dist/skill/references/report-templates/meta-period-report.md +219 -0
- package/dist/skill/references/report-templates/okki-weekly-google-client.md +217 -0
- package/dist/skill/references/report-templates/tiktok-period-report.md +56 -0
- package/dist/skill/references/report-templates/website-diagnosis-report.md +79 -0
- package/dist/skill/report-templates/README.md +16 -14
- package/dist/skill/report-templates/REPORT-WORKFLOW.md +13 -13
- package/dist/skill/report-templates/google-account-diagnosis-report.md +1 -1
- package/dist/skill/report-templates/google-ads-diagnosis.md +21 -21
- package/dist/skill/report-templates/google-inquiry-analysis.md +44 -44
- package/dist/skill/report-templates/google-period-report-excel.md +24 -24
- package/dist/skill/report-templates/google-period-report.md +23 -23
- package/dist/skill/report-templates/market-analysis-report.md +1 -1
- package/dist/skill/report-templates/meta-period-report-excel.md +72 -64
- package/dist/skill/report-templates/meta-period-report.html +706 -428
- package/dist/skill/report-templates/meta-period-report.md +61 -60
- package/dist/skill/report-templates/okki-weekly-google-client.md +26 -26
- package/dist/skill/report-templates/report-template-academic.html +1 -1
- package/dist/skill/report-templates/report-template-dark.html +1 -1
- package/dist/skill/report-templates/report-template-formal.html +1 -1
- package/dist/skill/report-templates/report-template-mobile.html +1 -1
- package/dist/skill/report-templates/report-template-onepager.html +1 -1
- package/dist/skill/report-templates/report-template-print.html +1 -1
- package/dist/skill/report-templates/report-template.html +1 -1
- package/dist/skill/report-templates/website-diagnosis-report.html +1731 -1653
- package/dist/skill/report-templates/website-diagnosis-report.md +21 -23
- package/dist/skill/scripts/install.ps1 +1 -1
- package/dist/skill/scripts/install.sh +1 -1
- package/dist/skill/snippets/handoff-p7-inquiry.md +5 -5
- package/eval/cases/accounts-entityid-vs-mediaccustomerid.scenario.json +2 -14
- package/eval/cases/accounts-mcc-bind-inquiry.scenario.json +1 -3
- package/eval/cases/accounts-single-balance-not-bulk.scenario.json +3 -14
- package/eval/cases/budget-display-not-raw-micros.scenario.json +1 -8
- package/eval/cases/clue-meta-leads-json.scenario.json +2 -14
- package/eval/cases/clue-tiktok-leads-json.scenario.json +2 -11
- package/eval/cases/destructive-account-delink-needs-confirm.scenario.json +3 -9
- package/eval/cases/destructive-forewarning-delete-needs-confirm.scenario.json +3 -9
- package/eval/cases/destructive-invoice-apply-needs-confirm.scenario.json +3 -9
- package/eval/cases/facebook-analysis-google-section-aliases.scenario.json +2 -11
- package/eval/cases/facebook-analysis-not-google-keywords.scenario.json +3 -10
- package/eval/cases/facebook-analysis-period-default.scenario.json +2 -14
- package/eval/cases/finance-invoice-info-list.scenario.json +3 -11
- package/eval/cases/forewarning-list-google.scenario.json +3 -14
- package/eval/cases/google-ads-no-structural-without-confirm.scenario.json +2 -6
- package/eval/cases/google-analysis-keywords-route.scenario.json +2 -14
- package/eval/cases/human-p1-multiturn.scenario.json +1 -5
- package/eval/cases/meta-single-balance-not-bulk.scenario.json +3 -17
- package/eval/cases/no-legacy-json-flag.scenario.json +2 -6
- package/eval/cases/open-account-google-noninteractive.scenario.json +1 -3
- package/eval/cases/open-account-tiktok-license-file.scenario.json +1 -3
- package/eval/cases/optimize-list-by-account.scenario.json +3 -11
- package/eval/cases/p1-single-account-profile.scenario.json +1 -11
- package/eval/cases/p2-balance-scan-bulk.scenario.json +2 -9
- package/eval/cases/p3-accounts-digest.scenario.json +1 -5
- package/eval/cases/p4-fb-meta-period-report.scenario.json +2 -12
- package/eval/cases/p4-period-report-window.scenario.json +1 -8
- package/eval/cases/pmax-asset-group-create-with-bg.scenario.json +15 -0
- package/eval/cases/pmax-brand-edit-routing.scenario.json +12 -0
- package/eval/cases/pmax-edit-not-campaign-edit.scenario.json +15 -0
- package/eval/cases/pmax-enable-brand-guidelines.scenario.json +15 -0
- package/eval/cases/pmax-no-assets-update-brand-fields.scenario.json +12 -0
- package/eval/cases/rag-before-keyword-expand.scenario.json +1 -11
- package/eval/cases/rag-list-then-query.scenario.json +2 -14
- package/eval/cases/report-list-google.scenario.json +2 -11
- package/eval/cases/report-push-list-google.scenario.json +2 -11
- package/eval/cases/setup-login-or-env.scenario.json +1 -3
- package/eval/cases/setup-siluzan-data-permission-env.scenario.json +1 -3
- package/eval/cases/tiktok-bc-bind-inquiry.scenario.json +2 -6
- package/eval/cases/time-range-user-delegates-default.scenario.json +1 -8
- package/eval/cases/tips-json-out-filtering.scenario.json +1 -3
- package/eval/cases/tips-large-json-pagination.scenario.json +1 -3
- package/eval/cases/uj-ad-campaign-validate-before-create-stub.scenario.json +2 -11
- package/eval/cases/uj-ad-outdoor-campgear-search-plan.scenario.json +1 -3
- package/eval/cases/uj-analytics-30d-pdf-campaign-device-geo.scenario.json +6 -18
- package/eval/cases/uj-analytics-compare-google-tiktok-last-month-roi.scenario.json +1 -8
- package/eval/cases/uj-analytics-google-weekly-trends-campaigns-keywords.scenario.json +2 -11
- package/eval/cases/uj-analytics-report-push-weekly-email.scenario.json +1 -3
- package/eval/cases/uj-finance-invoice-records-this-month.scenario.json +2 -11
- package/eval/cases/uj-life-newbie-siluzan-google-end-to-end.scenario.json +1 -4
- package/eval/cases/uj-ops-google-accounts-list-normal.scenario.json +2 -17
- package/eval/cases/uj-ops-google-yesterday-spend-conversions.scenario.json +2 -14
- package/eval/cases/uj-ops-pause-worst-adgroup-confirm.scenario.json +2 -6
- package/eval/cases/uj-ops-tiktok-leads-last-week.scenario.json +3 -17
- package/eval/cases/uj-patrol-cpc-spike-adgroups-over-15.scenario.json +1 -5
- package/eval/cases/uj-patrol-forewarning-create-daily-cap-3000.scenario.json +1 -3
- package/eval/cases/uj-patrol-forewarning-trigger-records.scenario.json +3 -17
- package/eval/cases/uj-patrol-google-balances-low.scenario.json +2 -11
- package/eval/cases/uj-roi-optimize-records-then-execute-cautiously.scenario.json +3 -14
- package/eval/cases/uj-roi-search-terms-add-negative-keywords.scenario.json +2 -14
- package/eval/stub-fixtures/facebook-analysis.json +24 -4
- package/eval/stub-fixtures/meta-overview.json +4 -1
- package/eval/stub-fixtures/pmax-asset-group-create-ok.json +12 -0
- package/eval/stub-fixtures/pmax-brand-assets-edit-ok.json +11 -0
- package/eval/stub-fixtures/pmax-brand-guidelines-enable-ok.json +11 -0
- package/eval/stub-fixtures/pmax-edit-ok.json +11 -0
- package/eval/stub-fixtures/pmax-get-bg-on.json +20 -0
- package/package.json +1 -1
- 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
|
-
| 功能
|
|
109
|
-
|
|
|
110
|
-
| 传统充值/现金充值(单笔,仅 Google/TikTok/Meta/Microsoft) | `/v3/foreign_trade/tso/recharge/pay?mediaType=<mediaType>`
|
|
111
|
-
| 现金充值(批量,仅 Google/TikTok)
|
|
112
|
-
| 月结充值(仅 Google/TikTok/Meta/Microsoft)
|
|
113
|
-
| 丝路赞钱包(充值/提现/明细)
|
|
114
|
-
| 媒体转账记录
|
|
115
|
-
| 开票记录
|
|
116
|
-
| 开票申请列表
|
|
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
|
-
|
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
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`
|
|
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`
|
|
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`
|
|
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`
|
|
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
|
-
> 网页链接:`
|
|
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
|
-
| 业务项
|
|
39
|
-
|
|
|
40
|
-
| 公司名称 | `--company`
|
|
41
|
-
| 推广链接 | `--promotion-link` | 可只写域名,CLI 补 `https://`
|
|
42
|
-
| 推广类型 | `--promotion-type` | `b2b` \| `b2c` \| `app`
|
|
43
|
-
| 账户名称 | `--account-name`
|
|
44
|
-
| 币种
|
|
45
|
-
| 时区
|
|
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
|
-
| 业务项
|
|
51
|
-
|
|
|
52
|
-
| 公司名称
|
|
53
|
-
| 账户名称
|
|
54
|
-
| 时区
|
|
55
|
-
| 行业 ID
|
|
56
|
-
| 注册地
|
|
57
|
-
| 推广链接
|
|
58
|
-
| 执照编号
|
|
59
|
-
| 执照图片
|
|
60
|
-
| 法人姓名
|
|
61
|
-
| 法人身份证
|
|
62
|
-
| 法人银联账号 | `--unionpay-account`
|
|
63
|
-
| 法人手机
|
|
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
|
-
| 业务项
|
|
70
|
-
|
|
|
71
|
-
| 公司名称
|
|
72
|
-
| 联系邮箱
|
|
73
|
-
| 税号 TIN/INN | `--tin`
|
|
70
|
+
| 业务项 | CLI 选项 | 说明 |
|
|
71
|
+
| ------------ | ----------- | ------------------------ |
|
|
72
|
+
| 公司名称 | `--company` | |
|
|
73
|
+
| 联系邮箱 | `--email` | |
|
|
74
|
+
| 税号 TIN/INN | `--tin` | 类型固定 `FOREIGN_LEGAL` |
|
|
74
75
|
|
|
75
76
|
### BingV2(`open-account bing`,需营业执照图片)
|
|
76
77
|
|
|
77
|
-
| 业务项
|
|
78
|
-
|
|
|
79
|
-
| 直接/代理
|
|
80
|
-
| 广告主全称 | `--advertiser-name`
|
|
81
|
-
| 公司简称
|
|
82
|
-
| 开户名称
|
|
83
|
-
| 省份
|
|
84
|
-
| 城市
|
|
85
|
-
| 详细地址
|
|
86
|
-
| 邮编
|
|
87
|
-
| 行业
|
|
88
|
-
| 推广链接
|
|
89
|
-
| 执照图片
|
|
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
|
-
| 业务项
|
|
94
|
-
|
|
|
95
|
-
| 营业执照号
|
|
96
|
-
| 注册国家
|
|
97
|
-
| 注册地址
|
|
98
|
-
| 营业范围
|
|
99
|
-
| 产品/品牌名
|
|
100
|
-
| 账户类型
|
|
101
|
-
| 产品网址
|
|
102
|
-
|
|
|
103
|
-
| 账户名称
|
|
104
|
-
| 公司主体名
|
|
105
|
-
| 一级行业 ID
|
|
106
|
-
| 二级行业 ID
|
|
107
|
-
| 有效期类型
|
|
108
|
-
| 投放地区
|
|
109
|
-
| 执照图片
|
|
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`
|
|
130
|
-
| `Asia/Hong_Kong`
|
|
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
|
|
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
|
-
| 已通过 | 账户可用
|
|
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
|
-
| 步骤 | 含义
|
|
4
|
-
| ---- |
|
|
5
|
-
| ①
|
|
6
|
-
| ②
|
|
7
|
-
| ③
|
|
8
|
-
| ④
|
|
9
|
-
| ⑤
|
|
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
|
-
| 字段
|
|
18
|
-
|
|
|
19
|
-
| 公司名称
|
|
20
|
-
| 推广网址
|
|
21
|
-
| 推广类型 B2B/B2C/APP | `--promotion-type`:`b2b` \| `b2c` \| `app`
|
|
22
|
-
| 行业(可选)
|
|
23
|
-
| 账户名称
|
|
24
|
-
| 币种 CNY/USD
|
|
25
|
-
| 时区 IANA
|
|
26
|
-
| 开户数量 1~3
|
|
27
|
-
| 邀请邮箱
|
|
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**。
|