siluzan-tso-cli 1.1.31-beta.3 → 1.1.31
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/assets/pmax-asset-group-template.json +7 -1
- package/dist/skill/assets/pmax-asset-group-template.md +2 -0
- package/dist/skill/assets/pmax-create-template.json +4 -1
- package/dist/skill/assets/pmax-create-template.md +4 -4
- package/dist/skill/references/accounts/accounts.md +3 -3
- package/dist/skill/references/accounts/finance.md +1 -1
- 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 +5 -5
- package/dist/skill/references/core/setup.md +5 -5
- package/dist/skill/references/google-ads/rules/google-ads-creative-optimization.md +8 -6
- package/dist/skill/references/google-ads/rules/google-ads-pmax-guide.md +1 -1
- package/dist/skill/references/misc/tso-home.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 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
|
|
|
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.31-beta.3），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
55
54
|
|
|
56
55
|
| 助手 | 建议 `--ai` |
|
|
57
56
|
| ----------------------- | ------------------------------------ |
|
package/dist/index.js
CHANGED
package/dist/skill/_meta.json
CHANGED
|
@@ -16,7 +16,13 @@
|
|
|
16
16
|
"finalUrls": ["https://www.example.com/landing"],
|
|
17
17
|
"headlines": ["Headline one ok", "Headline two ok", "Headline three ok"],
|
|
18
18
|
"longHeadlines": ["Long headline for performance max"],
|
|
19
|
-
"descriptions": [
|
|
19
|
+
"descriptions": [
|
|
20
|
+
"Description one ok",
|
|
21
|
+
"Description two ok",
|
|
22
|
+
"Description three ok",
|
|
23
|
+
"Description four ok",
|
|
24
|
+
"Description five ok"
|
|
25
|
+
],
|
|
20
26
|
"imagePaths": {
|
|
21
27
|
"marketing": "./images/marketing.jpg",
|
|
22
28
|
"square": "./images/square.jpg"
|
|
@@ -35,7 +35,10 @@
|
|
|
35
35
|
"longHeadlines": ["Long headline text for performance max campaign asset group"],
|
|
36
36
|
"descriptions": [
|
|
37
37
|
"Description one text for the asset group here",
|
|
38
|
-
"Description two text for the asset group here"
|
|
38
|
+
"Description two text for the asset group here",
|
|
39
|
+
"Description three text for the asset group here",
|
|
40
|
+
"Description four text for the asset group here",
|
|
41
|
+
"Description five text for the asset group here"
|
|
39
42
|
],
|
|
40
43
|
"imagePaths": {
|
|
41
44
|
"marketing": "./REPLACE_marketing_1200x628.png",
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
| 图片 | **只填 `imagePaths`** 指向本地 PNG/JPEG；`pmax-create` 会自动 multipart 上传并用 assetId 创建（勿把 Base64 提交进 Git） |
|
|
19
19
|
| 视频 | JSON 填 **`videoPath`**（别名 `video` 亦可）；`pmax-create` 成功后 **必定**经 PyAPI 上传并链接（含 `--json-out`）。已有 YouTube 用 `youtubeUrlOrId` |
|
|
20
20
|
| 附加资产 | **必填** `campaignExtensions`：宣传信息 ≥20、结构化摘要 ≥20、站内链接 ≥6、leadForm、WhatsApp |
|
|
21
|
-
| 文案数量 | 短标题 15
|
|
21
|
+
| 文案数量 | 短标题 15、长标题 5（Google API 上限，须填满）、描述 5 |
|
|
22
22
|
| Lead Gen 方案 | **默认**在 `campaignExtensions` 含 **`leadForm`**（B2B/询盘/留资）；仅 callouts/snippets 不算完整方案；用户明确不要才省略 |
|
|
23
23
|
| 存量补表单 | 活动已创建时用 `ad extension lead-form`（见 `pmax-lead-form-template.md` 方式 B） |
|
|
24
24
|
| 改已上线 PMax | 先 `ad pmax-get` 看 `_brandGuidelinesActive`；改品牌见 `pmax-api.md` § Brand Guidelines |
|
|
@@ -61,9 +61,9 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
|
|
|
61
61
|
| `assetGroupName` | string | | 首个资产组名称；缺省由服务端生成 |
|
|
62
62
|
| `finalUrls` | string[] | ✅ | 至少 1 个 `https://` 落地页 |
|
|
63
63
|
| `businessName` | string | ✅ | BUSINESS_NAME：1 条，≤25 字符 |
|
|
64
|
-
| `headlines` | string[] | ✅ | HEADLINE：
|
|
65
|
-
| `longHeadlines` | string[] | ✅ | LONG_HEADLINE：
|
|
66
|
-
| `descriptions` | string[] | ✅ | DESCRIPTION：
|
|
64
|
+
| `headlines` | string[] | ✅ | HEADLINE：15 条（须填满），每条 ≤30 字符（CJK×2） |
|
|
65
|
+
| `longHeadlines` | string[] | ✅ | LONG_HEADLINE：5 条（须填满），每条 ≤90 字符 |
|
|
66
|
+
| `descriptions` | string[] | ✅ | DESCRIPTION：5 条（须填满），每条 ≤90 字符 |
|
|
67
67
|
| `imagePaths.marketing` | string | ✅\* | MARKETING_IMAGE 横图 1.91:1，≤5MB（创建 JSON 1 张；资产组 API 最多 20） |
|
|
68
68
|
| `imagePaths.square` | string | ✅\* | SQUARE_MARKETING_IMAGE 方图 1:1，≤5MB（创建 1 张；最多 20） |
|
|
69
69
|
| `imagePaths.logo` | string | ✅\* | LOGO 方图 1:1，≤5MB（创建 1 张；最多 5） |
|
|
@@ -280,7 +280,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
|
|
|
280
280
|
| 状态 | 含义 | 下一步操作 |
|
|
281
281
|
| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
282
282
|
| `Pending` | 审核中 | 等待，可反复运行此命令轮询；审核周期因媒体而异 |
|
|
283
|
-
| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www
|
|
283
|
+
| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
|
|
284
284
|
| `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |
|
|
285
285
|
|
|
286
286
|
---
|
|
@@ -854,7 +854,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
|
|
|
854
854
|
|
|
855
855
|
| 功能 | 媒体 | 网页路径 |
|
|
856
856
|
| --------------------------------------- | ------ | ------------------------------------------------- |
|
|
857
|
-
| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www
|
|
857
|
+
| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
|
|
858
858
|
|
|
859
859
|
**Agent 建议话术**：
|
|
860
860
|
|
|
@@ -863,5 +863,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
|
|
|
863
863
|
siluzan-tso config show # 查看 webUrl 字段
|
|
864
864
|
|
|
865
865
|
# 账户激活（Google）→ 引导至账户管理页
|
|
866
|
-
# https://www
|
|
866
|
+
# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
|
|
867
867
|
```
|
|
@@ -117,7 +117,7 @@ siluzan-tso config show
|
|
|
117
117
|
|
|
118
118
|
### 充值页链接（按媒体 × 类型）
|
|
119
119
|
|
|
120
|
-
链接模式：`https://www
|
|
120
|
+
链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
|
|
121
121
|
|
|
122
122
|
| 充值类型 | `<page>` | 支持媒体（`mediaType` 参数） |
|
|
123
123
|
| ------------------------- | --------------------- | ------------------------------------------- |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 各媒体开户
|
|
2
2
|
|
|
3
|
-
> 网页链接：`https://www
|
|
3
|
+
> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`
|
|
4
4
|
> 多命令串联见 `references/core/workflows.md` § 流程一。
|
|
5
5
|
|
|
6
6
|
## 首次响应硬规范（必读）
|
|
@@ -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 → https://www
|
|
63
|
+
# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
|
|
64
64
|
```
|
|
65
65
|
|
|
66
66
|
---
|
|
@@ -192,9 +192,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
|
|
|
192
192
|
|
|
193
193
|
| 媒体 | 报告类型 | URL 模板 |
|
|
194
194
|
| ------ | ---------------- | ----------------------------------------------------------- |
|
|
195
|
-
| Google | 日报（Daily） | `https://www
|
|
196
|
-
| Google | 小时报（Hourly） | `https://www
|
|
197
|
-
| TikTok | 日报 | `https://www
|
|
195
|
+
| Google | 日报（Daily） | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
|
|
196
|
+
| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN` |
|
|
197
|
+
| TikTok | 日报 | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
|
|
198
198
|
|
|
199
199
|
`entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
|
|
200
200
|
|
|
@@ -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
|
|
|
@@ -331,12 +331,14 @@
|
|
|
331
331
|
|
|
332
332
|
### 8.1 文本素材要求
|
|
333
333
|
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
|
337
|
-
|
|
|
338
|
-
|
|
|
339
|
-
|
|
|
334
|
+
> **siluzan-tso CLI 门禁**（`pmax-validate` / `pmax-create`）：短标题、长标题、描述均须**填满 Google API 上限**（15 / 5 / 5），低于 Google 官方最低条数也会报错。Google 官方最低要求见括号内说明。
|
|
335
|
+
|
|
336
|
+
| 类型 | siluzan-tso 门禁（须填满） | Google 官方最低 | 字符限制 |
|
|
337
|
+
| -------- | -------------------------- | --------------- | -------- |
|
|
338
|
+
| 短标题 | 15 条 | 3 条 | ≤ 30 |
|
|
339
|
+
| 长标题 | 5 条 | 1 条 | ≤ 90 |
|
|
340
|
+
| 描述 | 5 条 | 2 条 | ≤ 90 |
|
|
341
|
+
| 商家名称 | 1 条 | 1 条 | ≤ 25 |
|
|
340
342
|
|
|
341
343
|
### 8.2 图片要求
|
|
342
344
|
|
|
@@ -126,7 +126,7 @@ Asset Group 是 PMax 中素材与受众信号的组合单元。**推荐分组维
|
|
|
126
126
|
|
|
127
127
|
### 3.5 每个素材组的完整性要求
|
|
128
128
|
|
|
129
|
-
|
|
129
|
+
每个素材组必须包含**完整素材套件**：短标题 × 15、长标题 × 5、描述 × 5（siluzan-tso `pmax-validate` 须填满）；横版图 (1.91:1) × 4+、方形图 (1:1) × 4+、竖版图 (4:5) × 2+；视频 × 1+（建议 3 个）；商家名称、Logo、最终网址、行动号召。
|
|
130
130
|
|
|
131
131
|
## 4. 素材（Asset）诊断与优化
|
|
132
132
|
|
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
siluzan-tso config show # 取 webUrl
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
首页地址：`https://www
|
|
9
|
+
首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
@@ -25,7 +25,7 @@ siluzan-tso config show # 取 webUrl
|
|
|
25
25
|
|
|
26
26
|
## 推荐话术
|
|
27
27
|
|
|
28
|
-
1. **「和首页一样的总览」** → 打开 `https://www
|
|
28
|
+
1. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/v3/foreign_trade/tso/home`。
|
|
29
29
|
2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
|
|
30
30
|
3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。
|
|
31
31
|
|
|
@@ -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.31
|
|
12
|
+
$PKG_VERSION = '1.1.31'
|
|
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.31
|
|
12
|
+
readonly PKG_VERSION="1.1.31"
|
|
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
|