siluzan-tso-cli 1.1.25-beta.2 → 1.1.25-beta.3

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 (10) hide show
  1. package/README.md +1 -1
  2. package/dist/skill/_meta.json +2 -2
  3. package/dist/skill/references/accounts/accounts.md +1 -1
  4. package/dist/skill/references/accounts/finance.md +68 -18
  5. package/dist/skill/references/accounts/open-account-by-media.md +1 -1
  6. package/dist/skill/references/accounts/open-account-google-ui.md +1 -1
  7. package/dist/skill/references/core/workflows.md +2 -2
  8. package/dist/skill/scripts/install.ps1 +1 -1
  9. package/dist/skill/scripts/install.sh +1 -1
  10. package/package.json +1 -1
package/README.md CHANGED
@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
51
51
  siluzan-tso init --force # 强制覆盖已存在文件
52
52
  ```
53
53
 
54
- > **注意**：当前为测试版（1.1.25-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
54
+ > **注意**：当前为测试版（1.1.25-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
55
55
 
56
56
  | 助手 | 建议 `--ai` |
57
57
  | ----------------------- | ------------------------------------ |
package/dist/skill/_meta.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.1.25-beta.2",
4
- "publishedAt": 1780469383389
3
+ "version": "1.1.25-beta.3",
4
+ "publishedAt": 1780474555353
5
5
  }
package/dist/skill/references/accounts/accounts.md CHANGED
@@ -257,7 +257,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
257
257
  | 状态 | 含义 | 下一步操作 |
258
258
  | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
259
259
  | `Pending` | 审核中 | 等待，可反复运行此命令轮询；审核周期因媒体而异 |
260
- | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，打开 `{webUrl}/v3/foreign_trade/tso/recharge`） |
260
+ | `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
261
261
  | `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |
262
262
 
263
263
  ---
package/dist/skill/references/accounts/finance.md CHANGED
@@ -105,36 +105,86 @@ siluzan-tso config show
105
105
 
106
106
  ### 功能总览
107
107
 
108
- | 功能 | 引导用户打开的网页路径 | CLI 支持 |
109
- | ---------------------------- | ------------------------------------ | --------------------------------------- |
110
- | 现金充值（单笔） | `/recharge/pay` | ❌ 引导网页 |
111
- | 现金充值（批量） | `/recharge/pay_batch` | ❌ 引导网页 |
112
- | 月结充值 | `/recharge/accountBillingQuota` | ❌ 引导网页 |
113
- | 丝路赞钱包（充值/提现/明细） | `/recharge/siluzanWallet` | ❌ 引导网页 |
114
- | 媒体转账记录 | `/recharge/accountTransfer` | ✅ `transfer` 命令 |
115
- | 开票记录 | `/recharge/invoiceList` | ✅ `invoice list` |
116
- | 开票申请列表 | `/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
+
118
+ ### 充值页媒体参数
119
+
120
+ 当用户指明媒体平台时，优先给出对应媒体的传统充值/现金充值直达页：
121
+
122
+ | 媒体 | `mediaType` 参数 | 传统充值/现金充值链接 |
123
+ | ---- | ---------------- | ------------ |
124
+ | Google | `Google` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google` |
125
+ | TikTok | `TikTok` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok` |
126
+ | Meta / Facebook | `MetaAd` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd` |
127
+ | Microsoft / Bing | `MicrosoftAd` | `{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd` |
128
+
129
+ > Yandex、Kwai 当前没有传统充值/现金充值界面；用户询问这些媒体充值时，不要拼接充值页链接，应说明当前网页不提供对应充值入口，并建议联系丝路赞客服或业务负责人确认处理方式。
130
+
131
+ 批量充值页面当前仅支持 Google 和 TikTok：
132
+
133
+ | 媒体 | 批量充值链接 |
134
+ | ---- | ------------ |
135
+ | Google | `{webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google` |
136
+ | TikTok | `{webUrl}/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 | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google` |
145
+ | TikTok | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok` |
146
+ | Meta / Facebook | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd` |
147
+ | Microsoft / Bing | `{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd` |
148
+
149
+ > Yandex、Kwai 当前不要引导到月结充值页。
117
150
 
118
151
  ### 引导用户的标准话术
119
152
 
120
- 当用户需要充值/查看钱包时，先取 `webUrl`，再给出完整链接：
153
+ 当用户需要充值/查看钱包时，先取 `webUrl`，再给出完整链接。用户已指定媒体时，优先给对应媒体的单笔充值链接；未指定媒体时，先询问媒体或给出下列通用入口：
121
154
 
122
155
  ```
123
156
  需要进行充值，请访问丝路赞平台对应页面完成操作：
124
157
 
125
- - 现金充值（单笔）：{webUrl}/recharge/pay
126
- - 现金充值（批量）：{webUrl}/recharge/pay_batch
127
- - 月结充值： {webUrl}/recharge/accountBillingQuota
128
- - 丝路赞钱包： {webUrl}/recharge/siluzanWallet
158
+ - Google 充值： {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
159
+ - TikTok 充值： {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok
160
+ - Meta 充值： {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd
161
+ - Microsoft/Bing 充值：{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd
162
+ - Google 批量充值： {webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google
163
+ - TikTok 批量充值： {webUrl}/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok
164
+ - Google 月结充值： {webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google
165
+ - TikTok 月结充值： {webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok
166
+ - Meta 月结充值： {webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd
167
+ - Microsoft/Bing 月结充值：{webUrl}/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd
168
+ - 丝路赞钱包： {webUrl}/v3/foreign_trade/tso/recharge/siluzanWallet
169
+
170
+ Yandex、Kwai 当前没有传统充值/现金充值和月结充值界面，需联系丝路赞客服或业务负责人确认处理方式。
171
+ 批量充值当前仅支持 Google 和 TikTok；Meta、Microsoft/Bing、Yandex、Kwai 不要引导到批量充值页。
129
172
  ```
130
173
 
131
174
  **示例：**
132
175
 
133
176
  ```
134
- - 现金充值（单笔）：https://www-ci.siluzan.com/recharge/pay
135
- - 现金充值（批量）：https://www-ci.siluzan.com/recharge/pay_batch
136
- - 月结充值： https://www-ci.siluzan.com/recharge/accountBillingQuota
137
- - 丝路赞钱包： https://www-ci.siluzan.com/recharge/siluzanWallet
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
138
188
  ```
139
189
 
140
190
  ---
package/dist/skill/references/accounts/open-account-by-media.md CHANGED
@@ -282,7 +282,7 @@ siluzan-tso list-accounts -m MetaAd
282
282
  | 状态 | 含义 | 下一步 |
283
283
  | ---- | ---- | ------ |
284
284
  | 审核中 | 等待媒体审核 | 继续 `account-history` 轮询 |
285
- | 已通过 | 账户可用 | `list-accounts` 确认 + 网页充值 |
285
+ | 已通过 | 账户可用 | `list-accounts` 确认 + 按 `finance.md` 打开对应媒体充值页（传统充值/月结充值仅 Google/TikTok/Meta/Microsoft 有页面；Kwai、Yandex 当前没有对应充值界面） |
286
286
  | 已拒绝 | 资料问题 | 查看拒绝原因，修正后重新提交 |
287
287
 
288
288
  完整参数：`siluzan-tso open-account <subcommand> -h`
package/dist/skill/references/accounts/open-account-google-ui.md CHANGED
@@ -60,7 +60,7 @@ siluzan-tso open-account google-wizard
60
60
 
61
61
  ```bash
62
62
  siluzan-tso account-history -m Google
63
- # 审核通过后：config show → {webUrl}/v3/foreign_trade/tso/recharge
63
+ # 审核通过后：config show → {webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
64
64
  ```
65
65
 
66
66
  ---
package/dist/skill/references/core/workflows.md CHANGED
@@ -70,7 +70,7 @@ siluzan-tso account-history -m Google
70
70
  siluzan-tso list-accounts -m Google
71
71
 
72
72
  # 第四步：充值激活（必须网页完成）
73
- # siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge
73
+ # siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
74
74
  # 美元账户最低约 100 USD，人民币账户约 700 CNY
75
75
  ```
76
76
 
@@ -197,7 +197,7 @@ siluzan-tso account-history -m Google
197
197
  | 状态 | 含义 | 下一步 |
198
198
  | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
199
199
  | `Pending` | 审核中 | 等待，可反复轮询 |
200
- | `Approved` | 审核通过 | `list-accounts` 确认账户出现；引导用户充值激活（见各媒体第四步） |
200
+ | `Approved` | 审核通过 | `list-accounts` 确认账户出现；按 `accounts/finance.md` 引导用户打开对应媒体充值页（传统充值/月结充值仅 Google/TikTok/Meta/Microsoft 有页面；Kwai、Yandex 当前没有对应充值界面） |
201
201
  | `Rejected` | 被拒 | 查看拒绝原因（`account-history --json-out ./snap` 的 `reason` 字段）；修改资料后重新提交；如无法确定原因，引导用户联系丝路赞客服 |
202
202
 
203
203
  ---
package/dist/skill/scripts/install.ps1 CHANGED
@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
9
9
  # -- Package info (injected at build time) ------------------------------------
10
10
  $PKG_NAME = 'siluzan-tso-cli'
11
11
  # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
12
- $PKG_VERSION = '1.1.25-beta.2'
12
+ $PKG_VERSION = '1.1.25-beta.3'
13
13
  $CLI_BIN = 'siluzan-tso'
14
14
  $SKILL_LABEL = 'Siluzan TSO'
15
15
  $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
package/dist/skill/scripts/install.sh CHANGED
@@ -9,7 +9,7 @@ set -euo pipefail
9
9
  # -- Package info (injected at build time) ------------------------------------
10
10
  readonly PKG_NAME="siluzan-tso-cli"
11
11
  # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
12
- readonly PKG_VERSION="1.1.25-beta.2"
12
+ readonly PKG_VERSION="1.1.25-beta.3"
13
13
  readonly CLI_BIN="siluzan-tso"
14
14
  readonly SKILL_LABEL="Siluzan TSO"
15
15
  readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.1.25-beta.2",
3
+ "version": "1.1.25-beta.3",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
5
5
  "keywords": [
6
6
  "ad-account",