siluzan-tso-cli 1.0.0-beta.42 → 1.0.0-beta.43

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 CHANGED
@@ -20,7 +20,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
20
20
  siluzan-tso init --force # 强制覆盖已存在文件
21
21
  ```
22
22
 
23
- > **注意**:当前为测试版(1.0.0-beta.42),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
23
+ > **注意**:当前为测试版(1.0.0-beta.43),供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
24
24
 
25
25
  | 助手 | 建议 `--ai` |
26
26
  |------|-------------|
@@ -29,6 +29,7 @@ description: >-
29
29
  ## 使用指南
30
30
  调用本skill前,必须使用-h查看命令行工具的说明
31
31
  为了节省token, 尽量使用--json获取一条数据的数据结构后,再通过编写代码的方式对大量的数据进行操作,而不是直接获取大量的原始json这会造成巨量的token浪费!
32
+ 对于用户侧请不要透露出命令行的任何参数,因为不太友好
32
33
  ## 参考文档导航
33
34
 
34
35
  | 文档 | 内容 |
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "slug": "siluzan-tso",
3
- "version": "1.0.0-beta.42",
4
- "publishedAt": 1774858515423
3
+ "version": "1.0.0-beta.43",
4
+ "publishedAt": 1774860551984
5
5
  }
@@ -2,7 +2,7 @@
2
2
 
3
3
  > 所属 skill:`siluzan-tso`。
4
4
  >
5
- > 用途:AI 根据用户需求生成投放计划 → 以本模板格式呈现给用户确认 → 用户确认后按计划执行 CLI 命令创建广告。
5
+ > 用途:AI 根据用户需求生成投放计划 → 以本模板格式呈现给用户确认 → 用户确认后由助手在后台完成账户内创建。**勿向用户展示命令行或 `siluzan-tso` 等工具细节**(具体命令见文末「助手执行计划」)。
6
6
  > 触发场景:用户要求「帮我投广告」「创建广告系列」「制定投放方案」等。
7
7
 
8
8
  ---
@@ -13,11 +13,12 @@
13
13
  1. 收集信息:向用户了解产品/服务、目标、预算、地域、网站等
14
14
  2. 生成计划:按下方模板格式输出完整方案
15
15
  3. 用户确认:用户逐项审阅,提出修改
16
- 4. 执行创建:确认后按「执行命令」章节的 CLI 命令依次执行
16
+ 4. 执行创建:用户确认后,助手在后台按计划完成创建;**不向用户复述或展示任何命令行**
17
17
  ```
18
18
 
19
19
  **关键原则**:
20
- - 计划中每个字段都必须能直接映射到 CLI 参数,不写无法执行的内容
20
+ - 用户可见正文只写业务字段(预算、地域、文案等),不出现命令行、可执行脚本或工具名称
21
+ - 助手侧须保证每个业务字段可落实为实际创建步骤(映射关系见文末「助手执行计划」)
21
22
  - 关键词和广告文案必须通过合规检查(参考 `google-ads-compliance.md` 第十一章)
22
23
  - 敏感行业须额外标注合规要求(参考 `sensitive-industries.md`)
23
24
 
@@ -81,16 +82,16 @@ AI 生成计划时,按以下格式输出。`{{占位符}}` 由 AI 根据用户
81
82
 
82
83
  **基本设置**
83
84
 
84
- | 参数 | 值 | CLI 映射 |
85
- |---|---|---|
86
- | 系列名称 | {{名称}} | `--name` |
87
- | 日预算 | {{金额}} {{币种}} | `--budget` |
88
- | 出价策略 | {{TARGET_SPEND / MANUAL_CPC / TARGET_CPA / TARGET_ROAS}} | `--bidding` |
89
- | 出价上限/目标 | {{如有:CPC上限/tCPA/tROAS值}} | `--bid-ceiling` / `--target-cpa` / `--target-roas` |
90
- | 投放地域 | {{地域名称}}(ID: {{geo_id}}) | `--location-ids` |
91
- | 投放语言 | {{语言}}(ID: {{lang_id}}) | `--lang-ids` |
92
- | 落地页 | {{URL}} | `--url` |
93
- | 初始状态 | {{Enabled / Paused}} | `--status` |
85
+ | 参数 | 值 |
86
+ |---|---|
87
+ | 系列名称 | {{名称}} |
88
+ | 日预算 | {{金额}} {{币种}} |
89
+ | 出价策略 | {{TARGET_SPEND / MANUAL_CPC / TARGET_CPA / TARGET_ROAS}} |
90
+ | 出价上限/目标 | {{如有:CPC上限/tCPA/tROAS值}} |
91
+ | 投放地域 | {{地域名称}}(ID: {{geo_id}}) |
92
+ | 投放语言 | {{语言}}(ID: {{lang_id}}) |
93
+ | 落地页 | {{URL}} |
94
+ | 初始状态 | {{Enabled / Paused}} |
94
95
 
95
96
  #### 广告组 1-1:{{广告组名称}}
96
97
 
@@ -132,7 +133,7 @@ Descriptions({{N}} 条):
132
133
 
133
134
  Display URL:`{{domain}}/{{path1}}/{{path2}}`
134
135
 
135
- **广告组 CPC**:{{金额}} {{币种}} → `--max-cpc`
136
+ **广告组 CPC**:{{金额}} {{币种}}
136
137
 
137
138
  ---
138
139
 
@@ -166,7 +167,7 @@ Display URL:`{{domain}}/{{path1}}/{{path2}}`
166
167
  | 离线转化导入 | {{是否需要,频率建议}} |
167
168
  | 归因模型 | {{DDA(推荐)/ Last-click}} |
168
169
 
169
- > 转化追踪需在 Google Ads 后台或 GTM 中配置,CLI 暂不支持直接设置。
170
+ > 转化追踪需在 Google Ads 后台或 GTM 中配置;本计划仅作策略说明,具体安装与调试在后台完成。
170
171
 
171
172
  ---
172
173
 
@@ -194,9 +195,20 @@ Display URL:`{{domain}}/{{path1}}/{{path2}}`
194
195
 
195
196
  ---
196
197
 
197
- ## 八、执行命令预览
198
+ ## 八、落地与执行说明
199
+
200
+ 确认本计划后,助手将按上述结构在您的广告账户中完成系列、广告组、关键词、创意与附加信息的创建与配置,并在过程中同步进度与结果(如遇审核或平台限制会主动说明)。
201
+
202
+ ---
203
+
204
+ **请确认以上方案,或告知需要调整的部分。确认后我将开始为您落地投放结构。**
205
+ ````
206
+
207
+ ---
208
+
209
+ ## 助手执行计划(内部,勿向用户展示或复述)
198
210
 
199
- 确认后将依次执行以下命令:
211
+ 用户确认方案后,助手在后台按下列顺序执行(参数须与计划正文中的业务字段一致)。**不要**把本节内容粘贴给用户或逐条朗读命令。
200
212
 
201
213
  ```bash
202
214
  # 1. 查询地域 ID(如尚未确认)
@@ -265,11 +277,6 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
265
277
 
266
278
  ---
267
279
 
268
- **请确认以上方案,或告知需要调整的部分。确认后我将立即开始创建。**
269
- ````
270
-
271
- ---
272
-
273
280
  ## AI 填充指引
274
281
 
275
282
  生成计划时遵循以下规则:
@@ -280,12 +287,12 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
280
287
 
281
288
  | 必须 | 信息 | 用途 |
282
289
  |---|---|---|
283
- | ✅ | 账户 ID(`-a`) | 所有命令的前提 |
290
+ | ✅ | 广告账户 ID | 关联投放账户(执行时由助手使用,勿向用户解释命令行) |
284
291
  | ✅ | 推广的产品/服务 | 决定关键词和文案方向 |
285
292
  | ✅ | 目标(线索/销售/曝光) | 决定系列类型和出价策略 |
286
293
  | ✅ | 月度预算 | 计算日预算、系列数量 |
287
- | ✅ | 投放地域 | `--location-ids` |
288
- | ✅ | 落地页 URL | `--url` / `--final-url` |
294
+ | ✅ | 投放地域 | 地域定向与地域 ID |
295
+ | ✅ | 落地页 URL | 落地页与最终到达网址 |
289
296
  | 建议 | 目标 CPA / ROAS | 出价策略参数 |
290
297
  | 建议 | 竞品/行业背景 | 关键词策略 |
291
298
  | 建议 | 已有投放数据 | 优化起点 |
@@ -301,7 +308,7 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
301
308
  | Descriptions | 2-4 条,各自独立可用;至少 1 条含 CTA,1 条含关键词;每条 ≤ 90 字符 |
302
309
  | 否定关键词 | 至少列出明显的品牌保护词和无关意图词 |
303
310
  | 附加信息 | Sitelink ≥ 4 条 + Callout ≥ 4 条 + Snippet ≥ 1 组 |
304
- | 地域 | 先用 `ad geo search` 确认 ID;多数业务建议 Presence only 模式 |
311
+ | 地域 | 助手侧先确认 Google 地域 ID(见上文「助手执行计划」第 1 步);多数业务建议 Presence only 模式 |
305
312
  | 日预算 | ≥ 2-3× 目标 CPA(参考 `google-ads-campaign-optimization.md` 7.1 节) |
306
313
 
307
314
  ### 合规检查
@@ -321,5 +328,5 @@ siluzan-tso ad geo add -a {{CID}} --campaign-id <ID> --location-id <排除地域
321
328
  - 直接输出 Markdown 文本,不需要代码围栏包裹
322
329
  - 所有金额标注币种
323
330
  - 字符数必须实际计算并填入(CJK 字符按 2 计)
324
- - 执行命令区域的参数必须与计划表格中的值完全一致
325
- - 如系列较多(>3),可将命令预览精简为仅展示第一个系列的完整命令 + 其余系列的差异说明
331
+ - **用户可见正文中不得出现**:`siluzan-tso`、shell/bash 代码块、命令行参数(如 `--budget`)、或任何可复制的终端命令;执行细节仅保留在助手侧,对照「助手执行计划」与计划表格保持一致即可
332
+ - 如系列较多(>3),助手侧可按「助手执行计划」分系列执行;用户可见方案仍可写全业务表格,无需展示命令差异说明
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "siluzan-tso-cli",
3
- "version": "1.0.0-beta.42",
3
+ "version": "1.0.0-beta.43",
4
4
  "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据,管理绑定关系与充值。",
5
5
  "type": "module",
6
6
  "bin": {