siluzan-tso-cli 1.1.13-beta.1 → 1.1.13

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 (46) hide show
  1. package/README.md +34 -31
  2. package/dist/index.js +2226 -1439
  3. package/dist/skill/SKILL.md +77 -51
  4. package/dist/skill/_meta.json +2 -2
  5. package/dist/skill/assets/campaign-create-template.json +96 -101
  6. package/dist/skill/references/account-analytics.md +64 -62
  7. package/dist/skill/references/accounts.md +130 -130
  8. package/dist/skill/references/clue.md +13 -13
  9. package/dist/skill/references/finance.md +67 -66
  10. package/dist/skill/references/forewarning.md +40 -39
  11. package/dist/skill/references/google-ads-rules/google-ads-account-audit.md +165 -161
  12. package/dist/skill/references/google-ads-rules/google-ads-audience-strategy.md +94 -85
  13. package/dist/skill/references/google-ads-rules/google-ads-campaign-optimization.md +97 -85
  14. package/dist/skill/references/google-ads-rules/google-ads-compliance.md +274 -272
  15. package/dist/skill/references/google-ads-rules/google-ads-conversion-architecture.md +97 -82
  16. package/dist/skill/references/google-ads-rules/google-ads-creative-optimization.md +143 -139
  17. package/dist/skill/references/google-ads-rules/google-ads-keyword-optimization.md +131 -128
  18. package/dist/skill/references/google-ads-rules/google-ads-keyword-strategy.md +175 -173
  19. package/dist/skill/references/google-ads-rules/google-ads-launch-plan-template.md +126 -123
  20. package/dist/skill/references/google-ads-rules/google-ads-pmax-guide.md +86 -73
  21. package/dist/skill/references/google-ads-rules/sensitive-industries.md +43 -8
  22. package/dist/skill/references/google-ads.md +201 -196
  23. package/dist/skill/references/open-account-by-media.md +23 -23
  24. package/dist/skill/references/open-account-google-ui.md +26 -26
  25. package/dist/skill/references/optimize.md +8 -8
  26. package/dist/skill/references/reporting.md +30 -30
  27. package/dist/skill/references/setup.md +15 -12
  28. package/dist/skill/references/tso-home.md +12 -12
  29. package/dist/skill/references/workflows.md +28 -26
  30. package/dist/skill/report-templates/README.md +22 -21
  31. package/dist/skill/report-templates/REPORT-WORKFLOW.md +9 -9
  32. package/dist/skill/report-templates/bing-period-report.md +11 -11
  33. package/dist/skill/report-templates/google-ads-diagnosis.md +86 -86
  34. package/dist/skill/report-templates/google-period-report.md +23 -23
  35. package/dist/skill/report-templates/report-template-academic.html +433 -341
  36. package/dist/skill/report-templates/report-template-dark.html +440 -257
  37. package/dist/skill/report-templates/report-template-formal.html +438 -288
  38. package/dist/skill/report-templates/report-template-mobile.html +456 -241
  39. package/dist/skill/report-templates/report-template-onepager.html +452 -240
  40. package/dist/skill/report-templates/report-template-print.html +355 -243
  41. package/dist/skill/report-templates/report-template.html +485 -392
  42. package/dist/skill/report-templates/tiktok-period-report.md +10 -10
  43. package/dist/skill/scripts/install.ps1 +2 -2
  44. package/dist/skill/scripts/install.sh +2 -2
  45. package/package.json +13 -13
  46. package/scripts/postinstall.mjs +3 -1
package/README.md CHANGED
@@ -7,28 +7,32 @@
7
7
  本 Skill 是 **instruction-only**（纯指令型），不包含可执行代码文件。它通过指导 AI 助手调用 `siluzan-tso` CLI 来操作丝路赞广告管理平台。
8
8
 
9
9
  ### 运行时依赖
10
- | 项目 | 说明 |
11
- |------|------|
12
- | **Node.js 18+** | CLI 运行时 |
13
- | **npm 8+** 或 **pnpm** | 安装 CLI 全局包 |
14
- | **siluzan-tso** CLI | 由 `npm install -g siluzan-tso-cli` 安装 |
10
+
11
+ | 项目 | 说明 |
12
+ | ---------------------- | ---------------------------------------- |
13
+ | **Node.js 18+** | CLI 运行时 |
14
+ | **npm 8+** 或 **pnpm** | 安装 CLI 全局包 |
15
+ | **siluzan-tso** CLI | 由 `npm install -g siluzan-tso-cli` 安装 |
15
16
 
16
17
  ### 凭据与网络
17
- | 项目 | 说明 |
18
- |------|------|
19
- | API Key / Token | 存储在 `~/.siluzan/config.json`，用于所有 API 调用鉴权 |
20
- | TSO API | `tso-api.siluzan.com`（生产）/ `tso-api-ci.siluzan.com`（测试） |
21
- | Google API 网关 | `googleapi.mysiluzan.com` / `googleapi-ci.mysiluzan.com` |
22
- | 前端页面 | `www.siluzan.com`（充值、激活等浏览器操作） |
23
- | 错误追踪 | `o605862.ingest.us.sentry.io`（匿名崩溃日志） |
24
- | 版本检查 | `registry.npmjs.org` |
18
+
19
+ | 项目 | 说明 |
20
+ | --------------- | --------------------------------------------------------------- |
21
+ | API Key / Token | 存储在 `~/.siluzan/config.json`，用于所有 API 调用鉴权 |
22
+ | TSO API | `tso-api.siluzan.com`（生产）/ `tso-api-ci.siluzan.com`（测试） |
23
+ | Google API 网关 | `googleapi.mysiluzan.com` / `googleapi-ci.mysiluzan.com` |
24
+ | 前端页面 | `www.siluzan.com`（充值、激活等浏览器操作） |
25
+ | 错误追踪 | `o605862.ingest.us.sentry.io`（匿名崩溃日志） |
26
+ | 版本检查 | `registry.npmjs.org` |
25
27
 
26
28
  ### 可执行的操作范围
29
+
27
30
  - **只读**：查询账户列表、余额、消耗数据、报告、预警记录等
28
31
  - **写入**（需用户确认）：创建/修改/发布广告、开户申请、创建预警规则、报告推送配置
29
32
  - **破坏性**（必须用户确认）：账户解绑/关闭、MCC/BC 解绑、删除预警/报告/广告、发票申请
30
33
 
31
34
  ### 报告模板外部资源
35
+
32
36
  HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.com`、`cdn.jsdelivr.net`、`fonts.googleapis.com`。渲染报告时浏览器会发出对应网络请求。
33
37
 
34
38
  ## 1. 环境
@@ -41,7 +45,7 @@ HTML 报告模板引用以下 CDN：`cdn.tailwindcss.com`、`cdnjs.cloudflare.co
41
45
  在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
42
46
 
43
47
  ```bash
44
- npm install -g siluzan-tso-cli@beta
48
+ npm install -g siluzan-tso-cli
45
49
  siluzan-tso init --ai cursor # 写入 Cursor（默认）
46
50
  siluzan-tso init --ai cursor,claude # 同时写入多个平台
47
51
  siluzan-tso init --ai all # 写入所有支持的平台
@@ -49,17 +53,16 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
49
53
  siluzan-tso init --force # 强制覆盖已存在文件
50
54
  ```
51
55
 
52
- > **注意**：当前为测试版（1.1.13-beta.1），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
53
56
 
54
- | 助手 | 建议 `--ai` |
55
- |------|-------------|
56
- | Cursor | `cursor` |
57
- | Claude Code | `claude` |
58
- | OpenClaw（项目内技能） | `openclaw` 或 `openclaw-workspace` |
59
- | OpenClaw（全局技能） | `openclaw-global` |
57
+ | 助手 | 建议 `--ai` |
58
+ | ----------------------- | ------------------------------------ |
59
+ | Cursor | `cursor` |
60
+ | Claude Code | `claude` |
61
+ | OpenClaw（项目内技能） | `openclaw` 或 `openclaw-workspace` |
62
+ | OpenClaw（全局技能） | `openclaw-global` |
60
63
  | WorkBuddy（项目内技能） | `workbuddy` 或 `workbuddy-workspace` |
61
- | WorkBuddy（全局技能） | `workbuddy-global` |
62
- | 一次写入多处 | `all` |
64
+ | WorkBuddy（全局技能） | `workbuddy-global` |
65
+ | 一次写入多处 | `all` |
63
66
 
64
67
  ## 3. 登录 / 鉴权
65
68
 
@@ -100,14 +103,14 @@ siluzan-cso login
100
103
 
101
104
  确认以下路径已存在且含 `SKILL.md` 和 `_meta.json`：
102
105
 
103
- | 助手 | Skill 文件路径 |
104
- |------|----------------|
105
- | Cursor | `.cursor/skills/siluzan-tso/SKILL.md` |
106
- | Claude Code | `.claude/skills/siluzan-tso/SKILL.md` |
107
- | OpenClaw 工作区 | `skills/siluzan-tso/SKILL.md` |
108
- | OpenClaw 全局 | `~/.openclaw/skills/siluzan-tso/SKILL.md` |
109
- | WorkBuddy 项目级 | `.workbuddy/skills/siluzan-tso/SKILL.md` |
110
- | WorkBuddy 全局 | `~/.workbuddy/skills/siluzan-tso/SKILL.md` |
106
+ | 助手 | Skill 文件路径 |
107
+ | ---------------- | ------------------------------------------ |
108
+ | Cursor | `.cursor/skills/siluzan-tso/SKILL.md` |
109
+ | Claude Code | `.claude/skills/siluzan-tso/SKILL.md` |
110
+ | OpenClaw 工作区 | `skills/siluzan-tso/SKILL.md` |
111
+ | OpenClaw 全局 | `~/.openclaw/skills/siluzan-tso/SKILL.md` |
112
+ | WorkBuddy 项目级 | `.workbuddy/skills/siluzan-tso/SKILL.md` |
113
+ | WorkBuddy 全局 | `~/.workbuddy/skills/siluzan-tso/SKILL.md` |
111
114
 
112
115
  完成后，用户可在对话中描述广告账户管理需求（查账户、查余额、查消耗、充值、开户、绑定 MCC/BC/BM、管理 Google 广告等），由已加载的 Skill 指导 `siluzan-tso` CLI 的使用方式。
113
116