siluzan-tso-cli 1.1.25-beta.2 → 1.1.25
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 -2
- package/dist/index.js +1 -1
- package/dist/skill/_meta.json +2 -2
- package/dist/skill/references/accounts/accounts.md +1 -1
- package/dist/skill/references/accounts/finance.md +68 -18
- package/dist/skill/references/accounts/open-account-by-media.md +1 -1
- package/dist/skill/references/accounts/open-account-google-ui.md +1 -1
- package/dist/skill/references/analytics/rag.md +1 -1
- package/dist/skill/references/analytics/reporting.md +2 -2
- package/dist/skill/references/core/setup.md +5 -5
- package/dist/skill/references/core/skill-authoring.md +1 -1
- package/dist/skill/references/core/workflows.md +2 -2
- package/dist/skill/scripts/install.ps1 +3 -3
- package/dist/skill/scripts/install.sh +3 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -43,7 +43,7 @@ HTML 报告模板引用以下 CDN:`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
|
|
|
43
43
|
在**用户的目标项目根目录**执行(根据用户使用的助手选择 `--ai`):
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
npm install -g siluzan-tso-cli
|
|
46
|
+
npm install -g siluzan-tso-cli
|
|
47
47
|
siluzan-tso init --ai cursor # 写入 Cursor(默认)
|
|
48
48
|
siluzan-tso init --ai cursor,claude # 同时写入多个平台
|
|
49
49
|
siluzan-tso init --ai all # 写入所有支持的平台
|
|
@@ -51,7 +51,6 @@ 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`。
|
|
55
54
|
|
|
56
55
|
| 助手 | 建议 `--ai` |
|
|
57
56
|
| ----------------------- | ------------------------------------ |
|
package/dist/index.js
CHANGED
package/dist/skill/_meta.json
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
|
|
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
|
---
|
|
@@ -105,36 +105,86 @@ siluzan-tso config show
|
|
|
105
105
|
|
|
106
106
|
### 功能总览
|
|
107
107
|
|
|
108
|
-
| 功能 | 引导用户打开的网页路径
|
|
109
|
-
| ---------------------------- |
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
| 丝路赞钱包(充值/提现/明细) | `/recharge/siluzanWallet`
|
|
114
|
-
| 媒体转账记录 | `/recharge/accountTransfer`
|
|
115
|
-
| 开票记录 | `/recharge/invoiceList`
|
|
116
|
-
| 开票申请列表 | `/recharge/invoicingApplicationList`
|
|
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
|
-
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
128
|
-
-
|
|
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
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
177
|
+
- Google 充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
|
|
178
|
+
- TikTok 充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=TikTok
|
|
179
|
+
- Meta 充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MetaAd
|
|
180
|
+
- Microsoft/Bing 充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=MicrosoftAd
|
|
181
|
+
- Google 批量充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=Google
|
|
182
|
+
- TikTok 批量充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay_batch?mediaType=TikTok
|
|
183
|
+
- Google 月结充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=Google
|
|
184
|
+
- TikTok 月结充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=TikTok
|
|
185
|
+
- Meta 月结充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MetaAd
|
|
186
|
+
- Microsoft/Bing 月结充值:https://www.siluzan.com/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=MicrosoftAd
|
|
187
|
+
- 丝路赞钱包:https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet
|
|
138
188
|
```
|
|
139
189
|
|
|
140
190
|
---
|
|
@@ -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`
|
|
@@ -207,8 +207,8 @@ siluzan-tso report list -m Google --json-out ./snap
|
|
|
207
207
|
|
|
208
208
|
# 第二步:查看 webUrl
|
|
209
209
|
siluzan-tso config show
|
|
210
|
-
# webUrl: https://www
|
|
210
|
+
# webUrl: https://www.siluzan.com
|
|
211
211
|
|
|
212
212
|
# 第三步:拼接链接(Google 日报)
|
|
213
|
-
# https://www
|
|
213
|
+
# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
|
|
214
214
|
```
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
## 安装 CLI
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
|
-
npm install -g siluzan-tso-cli
|
|
13
|
+
npm install -g siluzan-tso-cli
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
---
|
|
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key> # 或 config 直接写入
|
|
|
64
64
|
siluzan-tso config set --token <Token> # 备用:设置 JWT Token
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
-
API Key 获取入口:`https://www
|
|
67
|
+
API Key 获取入口:`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
|
|
68
68
|
|
|
69
69
|
```bash
|
|
70
70
|
# 第 1 步:让用户报出手机号后,立刻发码(命令立即返回,不会等待输入)
|
|
@@ -129,9 +129,9 @@ siluzan-tso config show
|
|
|
129
129
|
|
|
130
130
|
```
|
|
131
131
|
构建环境 : production
|
|
132
|
-
apiBaseUrl : https://tso-api
|
|
133
|
-
googleApiUrl : https://googleapi
|
|
134
|
-
webUrl : https://www
|
|
132
|
+
apiBaseUrl : https://tso-api.siluzan.com
|
|
133
|
+
googleApiUrl : https://googleapi.mysiluzan.com
|
|
134
|
+
webUrl : https://www.siluzan.com
|
|
135
135
|
apiKey : abcd****1234
|
|
136
136
|
```
|
|
137
137
|
|
|
@@ -53,7 +53,7 @@ siluzan-tso/ # 安装后目录名
|
|
|
53
53
|
|
|
54
54
|
- 从 SKILL.md **只链接一层**(`references/foo.md`),避免 A→B→C 链式引用。
|
|
55
55
|
- 路径用正斜杠,不用 Windows 反斜杠。
|
|
56
|
-
- 占位符 `https://www
|
|
56
|
+
- 占位符 `https://www.siluzan.com`、`https://tso-api.siluzan.com`、`npm install -g siluzan-tso-cli` 由构建脚本替换,文档中禁止硬编码环境 URL。
|
|
57
57
|
|
|
58
58
|
---
|
|
59
59
|
|
|
@@ -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
|
---
|
|
@@ -9,11 +9,11 @@ $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
|
|
12
|
+
$PKG_VERSION = '1.1.25'
|
|
13
13
|
$CLI_BIN = 'siluzan-tso'
|
|
14
14
|
$SKILL_LABEL = 'Siluzan TSO'
|
|
15
|
-
$INSTALL_CMD = 'npm install -g siluzan-tso-cli
|
|
16
|
-
$WEB_BASE = 'https://www
|
|
15
|
+
$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
|
|
16
|
+
$WEB_BASE = 'https://www.siluzan.com'
|
|
17
17
|
|
|
18
18
|
# -- Constants ----------------------------------------------------------------
|
|
19
19
|
$NODE_MAJOR_MIN = 18
|
|
@@ -9,11 +9,11 @@ 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
|
|
12
|
+
readonly PKG_VERSION="1.1.25"
|
|
13
13
|
readonly CLI_BIN="siluzan-tso"
|
|
14
14
|
readonly SKILL_LABEL="Siluzan TSO"
|
|
15
|
-
readonly INSTALL_CMD="npm install -g siluzan-tso-cli
|
|
16
|
-
readonly WEB_BASE="https://www
|
|
15
|
+
readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
|
|
16
|
+
readonly WEB_BASE="https://www.siluzan.com"
|
|
17
17
|
|
|
18
18
|
# -- Constants ----------------------------------------------------------------
|
|
19
19
|
readonly NODE_MAJOR_MIN=18
|