siluzan-tso-cli 1.1.19-beta.4 → 1.1.19-beta.5
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
|
@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills # 写入自定义目录
|
|
|
51
51
|
siluzan-tso init --force # 强制覆盖已存在文件
|
|
52
52
|
```
|
|
53
53
|
|
|
54
|
-
> **注意**：当前为测试版（1.1.19-beta.
|
|
54
|
+
> **注意**：当前为测试版（1.1.19-beta.5），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
55
55
|
|
|
56
56
|
| 助手 | 建议 `--ai` |
|
|
57
57
|
| ----------------------- | ------------------------------------ |
|
package/dist/skill/SKILL.md
CHANGED
|
@@ -219,7 +219,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
|
|
|
219
219
|
|
|
220
220
|
1. **不要**按 `google-period-report.md` 展开默认 8 维并追问追加；改读 **`report-templates/okki-weekly-google-client.md`** 全文并按其结构交付。
|
|
221
221
|
2. 确认 `mediaCustomerId` 与 `--start` / `--end`（未给齐则按上文「时间范围强制反问」）。
|
|
222
|
-
3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选但推荐）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,
|
|
222
|
+
3. 同一 `--json-out` 目录执行模板中的命令组合：`list-accounts`（可选但推荐）、`stats`、`balance`、`google-analysis --sections overview,campaigns,keywords,search-terms,devices,geographic`。
|
|
223
223
|
4. **先 outline 后脚本**：读各 `*.outline.txt`，再编写并执行代码从 JSON 计算并写出：① 客户话术（Markdown/纯文本均可）；② 若需 **Excel**：**必须**产出多 Sheet `.xlsx`（版式与 Sheet 名见模板「必选交付」节），**只能**由 Agent 在当前环境执行脚本生成，**禁止**假设存在 `siluzan-tso … excel` 类 CLI 子命令。WorkBuddy 等编排器须在流程中显式包含「写 `.xlsx` 脚本并执行」一步，否则易缺产物。
|
|
224
224
|
5. 遵守 SKILL 硬规范：金额 `*Display`、禁止手填业务数、禁止编造 ID。
|
|
225
225
|
|
package/dist/skill/_meta.json
CHANGED
|
@@ -41,18 +41,26 @@ siluzan-tso stats -m Google -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
41
41
|
siluzan-tso balance -m Google -a <mediaCustomerId> --json-out ./snap-okki
|
|
42
42
|
|
|
43
43
|
siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-out ./snap-okki \
|
|
44
|
-
--sections overview,campaigns,keywords,search-terms,
|
|
44
|
+
--sections overview,campaigns,keywords,search-terms,devices,geographic
|
|
45
45
|
```
|
|
46
46
|
|
|
47
47
|
**说明**：
|
|
48
48
|
|
|
49
49
|
- `stats`：区间消耗、曝光、点击、转化、CTR、CPC 等与**账户级周报摘要**对齐；金额用 `*Display` 或文档规定的展示字段。
|
|
50
50
|
- `balance`：**当前**账户余额（非历史快照）；话术里写清「截至查询时点」。
|
|
51
|
-
- `google-analysis`：系列 / 词 /
|
|
52
|
-
-
|
|
53
|
-
- TopN、排序、跨系列汇总均在脚本内对 JSON 完成，禁止心算。
|
|
51
|
+
- `google-analysis`：系列 / 词 / 搜索词；**设备**与**国家**两 Sheet 的指标来自账户级 **`devices`** / **`geographic`**（落盘 `devices-<id>.json`、`geographic-<id>.json`）。样表 R3 含「广告系列」「级别」「出价调整」等列，而账户级 JSON **常无**系列/组字段——写 xlsx 时由脚本按下文 **「样表占位（账户级→样表列）」** 统一补齐，**禁止**为凑列改拉 `campaign-device` / `campaign-geo` 冒充账户口径。
|
|
52
|
+
- TopN、排序、聚合均在脚本内对 JSON 完成，禁止心算。
|
|
54
53
|
- **写脚本前**先读各 `<section>-<id>.outline.txt`（及 stats/balance 的 outline，若有），再读对应 `.json`。
|
|
55
54
|
|
|
55
|
+
**样表占位（账户级 `devices` / `geographic` → 设备与国家 Sheet）**（写脚本时**必须**遵守，便于与运营样表逐列对齐）：
|
|
56
|
+
|
|
57
|
+
| 列（样表语义） | 规则 |
|
|
58
|
+
| --- | --- |
|
|
59
|
+
| **广告系列** | JSON 无 `campaignName`（或等价字段）时，**统一填** `所有广告系列` |
|
|
60
|
+
| **级别** | **统一填** `账户` |
|
|
61
|
+
| **出价调整** | **统一填** `-`（半角减号；勿与空单元格混用，除非运营另行约定） |
|
|
62
|
+
| **广告组**（仅「设备」Sheet R3 含该列） | 账户级 JSON 无广告组字段时，**统一填** `—`（全角长横，**勿**用 `-`，以免与「出价调整」列混淆） |
|
|
63
|
+
|
|
56
64
|
---
|
|
57
65
|
|
|
58
66
|
## 最终 xlsx 版式规范（与运营样表对齐）
|
|
@@ -66,8 +74,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
66
74
|
| 1 | `账户报告` | `campaigns` + 复盘文案（stats/overview 汇总后由 Agent 撰写） |
|
|
67
75
|
| 2 | `关键词` | `keywords` |
|
|
68
76
|
| 3 | `搜索词` | `search-terms` |
|
|
69
|
-
| 4 | `设备` | **`
|
|
70
|
-
| 5 | `国家` | **`
|
|
77
|
+
| 4 | `设备` | **`devices`**（`devices-*.json`；账户级；见上「样表占位」补齐广告系列/级别/出价调整列） |
|
|
78
|
+
| 5 | `国家` | **`geographic`**（`geographic-*.json`；账户级；**广告系列**列无字段时填 `所有广告系列`） |
|
|
71
79
|
|
|
72
80
|
### 各 Sheet 共同版式
|
|
73
81
|
|
|
@@ -100,8 +108,8 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
100
108
|
**1. 账户层级**（整体消耗、展示、点击、点击率与 3% 基准对比、询盘/转化数、平均询盘成本等，数来自 stats/overview 与上表合计）；
|
|
101
109
|
**2. 关键词层级**（高转化词、高消耗低转化词及出价/竞争力建议）；
|
|
102
110
|
**3. 搜索字词层级**（标红/高意向词、否词与加词建议）；
|
|
103
|
-
**4.
|
|
104
|
-
**5.
|
|
111
|
+
**4. 设备层级**（账户级 **`devices`**：各设备消耗/转化分布；结合样表占位列阅读）；
|
|
112
|
+
**5. 国家层级**（账户级 **`geographic`**：各国家/地区消耗/转化；**广告系列**列在占位规则下为 `所有广告系列`）。
|
|
105
113
|
文案由 Agent 据 JSON 撰写，**不得编造**表中不存在的数字。
|
|
106
114
|
|
|
107
115
|
---
|
|
@@ -135,7 +143,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
135
143
|
| R1 标题 | `设备报告` |
|
|
136
144
|
| R2 | 统计区间 |
|
|
137
145
|
| R3 表头（A→M，共 13 列） | `设备` \| `级别` \| `出价调整` \| `广告系列` \| `广告组` \| `展示次数` \| `点击次数` \| `点击率` \| `平均每次点击费用` \| `费用` \| `转化次数` \| `每次转化费用` \| `转化率` |
|
|
138
|
-
| R4… | **`
|
|
146
|
+
| R4… | **`devices-*.json`**（`devices[]`）：`deviceType` → 设备；指标列按 outline 映射。**广告系列**无字段 → **`所有广告系列`**；**级别** → **`账户`**；**出价调整** → **`-`**；**广告组**无字段 → **`—`** |
|
|
139
147
|
|
|
140
148
|
---
|
|
141
149
|
|
|
@@ -146,7 +154,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
146
154
|
| R1 标题 | `地理位置报告` |
|
|
147
155
|
| R2 | 统计区间 |
|
|
148
156
|
| R3 表头（A→L，共 12 列） | `地理位置` \| `广告系列` \| `展示次数` \| `互动次数` \| `互动率` \| `费用` \| `平均费用` \| `点击次数` \| `点击率` \| `转化次数` \| `每次转化费用` \| `转化率` |
|
|
149
|
-
| R4… | **`
|
|
157
|
+
| R4… | **`geographic-*.json`**（`countries[]`）：`countryOrRegion` → 地理位置；**广告系列**无 `campaignName`（或等价字段）→ **`所有广告系列`**；**互动次数 / 互动率 / 平均费用** 按 outline 与网关字段映射，无则留空或从 `interactions` 等派生并注释 |
|
|
150
158
|
|
|
151
159
|
---
|
|
152
160
|
|
|
@@ -185,7 +193,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
185
193
|
|
|
186
194
|
## 复盘小结 + 优化建议（对内或可附在客户邮件末段）
|
|
187
195
|
|
|
188
|
-
基于同一批 JSON（尤其 `campaigns`、`keywords`、`search-terms
|
|
196
|
+
基于同一批 JSON（尤其 `campaigns`、`keywords`、`search-terms`、`devices`、`geographic`、`overview`）：
|
|
189
197
|
|
|
190
198
|
- **复盘**：3～6 条 bullet：消耗集中度、高消耗系列/词、地域与设备差异、CTR/CPC 相对水平。
|
|
191
199
|
- **优化建议**：3～5 条可执行项（预算、否词、落地页、系列状态等），**不额外拉数**；缺数据则标 `[数据不可用：原因]`。
|
|
@@ -196,7 +204,7 @@ siluzan-tso google-analysis -a <mediaCustomerId> --start <S> --end <E> --json-ou
|
|
|
196
204
|
|
|
197
205
|
| 项 | 周期报告 `google-period-report.md` | 本文 OKKI 周报 |
|
|
198
206
|
| -- | ---------------------------------- | ---------------- |
|
|
199
|
-
| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,
|
|
207
|
+
| 默认维度 | 8 维 + 主动追问可选追加 | **固定** `overview,campaigns,keywords,search-terms,devices,geographic` + `stats` + `balance` |
|
|
200
208
|
| 输出形态 | 长文分析报告 | **固定话术** + 短复盘 + **多 Sheet Excel（Agent 脚本写，非 CLI）** |
|
|
201
209
|
| 典型用户 | 内部分析 | **发客户**的同步简报 |
|
|
202
210
|
|