siluzan-tso-cli 1.1.29-beta.1 → 1.1.29-beta.2
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.29-beta.
|
|
54
|
+
> **注意**：当前为测试版（1.1.29-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
|
|
55
55
|
|
|
56
56
|
| 助手 | 建议 `--ai` |
|
|
57
57
|
| ----------------------- | ------------------------------------ |
|
package/dist/skill/_meta.json
CHANGED
|
@@ -20,26 +20,18 @@
|
|
|
20
20
|
| **上下文被压缩 / 记不清字段或命令** | 重读 `SKILL.md` 路由表 + 当次任务 references |
|
|
21
21
|
| **CLI 返回 400 / 字段对不上** | 回到对应 reference 核对参数名与口径，勿猜 |
|
|
22
22
|
|
|
23
|
-
###
|
|
23
|
+
### 应当遵循（及原因）
|
|
24
|
+
|
|
25
|
+
| 应当怎么做 | 原因 |
|
|
26
|
+
| -------- | ---- |
|
|
27
|
+
| **每个新任务先 Read 当次必读 references，再执行 CLI** — 即使用户刚查过余额、对话里刚读过 `accounts/accounts.md` 或 `google-ads/google-ads.md`，换话题（建系列、预警、报告等）仍按 `SKILL.md` 路由表 **重新 Read** 对应文档后再 `siluzan-tso …` | 不同任务的命令、参数口径、Playbook 编号各不相同；对话会被压缩，「读过」≠ 当前上下文仍含正确字段名与 flags |
|
|
28
|
+
| **所有 ID、金额、命令 flags 以当次 Read 文档 + 当次 CLI 输出为准** — 计划与执行前对照 reference 确认 `-a`/`-m`/日期等参数；数值只来自本次 stdout 或脚本读盘结果 | Skill 文档与 CLI 会迭代，对话记忆里的示例 ID、占位金额易串户、串币种或触发 400 |
|
|
29
|
+
| **数据转换严格按 outline → 脚本读 JSON 顺序** — Read `references/core/tips.md` § 处理顺序；解析 stdout 得 `outlineFile` → Read outline → 编写并执行脚本读 `writtenFiles` | outline 是字段类型的唯一轻量索引；跳步会导致列名猜错（如 `keywordText` vs `keyword`）或把 MB 级 JSON 误读进对话 |
|
|
30
|
+
| **大 JSON 只经脚本读盘，对话里只 Read 小文件** — Read 仅 `references/`、`*.outline.txt`、stdout 一行摘要；业务 `*.json`（`campaigns-*.json`、`list-accounts-*.json` 等）由 Node/Python `readFileSync` / `JSON.parse` 处理 | `--json-out` 落盘常为 MB 级，Read 整文件会撑爆上下文且无法可靠汇总；脚本可精确取所需字段并与落盘 JSON 复核 |
|
|
31
|
+
| **报告 / Excel 走本 Skill 拉数 + outline + 脚本全流程** — 按 Playbook 与 `report-templates/*.md` 拉数、落盘、脚本转换后交付；不另加载宿主 xlsx / Excel 第三方 Skill 代劳 | 第三方 Skill 不知 TSO 字段口径、账户核验与 `deliverable-preflight`；易跳过 `-k` 核验或编造未落盘数据 |
|
|
32
|
+
| **用户给出的 `mediaCustomerId` 必须 `-k` 核验，全链路同一 ID** — `list-accounts -m <媒体> -k <用户ID>`；无结果则告知用户并停止；拉数、脚本、报告文件名均用该 ID（以 stdout `accountId` 为准） | 列表第一页可能不含目标户；自行换 ID 会导致报告错户，属严重交付事故 |
|
|
33
|
+
| 交付前自检产物，是否有为空的部分，是否有数据明显异常的部分，是否有字段使用错误的部分 | 如果不自检的话，出来的产物很可能无法使用 |
|
|
24
34
|
|
|
25
|
-
- **禁止**「上次已经读过 `accounts/accounts.md` / `google-ads/google-ads.md`，本任务直接 `siluzan-tso …`」
|
|
26
|
-
- **禁止**用对话记忆中的示例 ID、金额、命令 flags 代替当次 Read 文档
|
|
27
|
-
- **禁止**跳过 `references/core/tips.md` 里的 outline→脚本读 JSON 顺序
|
|
28
|
-
- **禁止**用 Read / `cat` / `type` / `head` 打开 `--json-out` 落盘的**业务数据** `*.json`（`campaigns-*.json`、`list-accounts-*.json` 等）；只允许 Read 体积小的 `*.outline.txt` 与 `references/` 文档
|
|
29
|
-
- **禁止**在 siluzan-tso 报告任务中加载宿主「xlsx / Excel」第三方 Skill 代替本 Skill 的拉数 + outline + 脚本流程
|
|
30
|
-
- **禁止**用户给出 `mediaCustomerId` 后不用 `-k` 核验、翻页 `grep` 列表并**换成另一个账户 ID** 继续拉数/写报告
|
|
31
|
-
|
|
32
|
-
### 报告类常见违规（对照修复）
|
|
33
|
-
|
|
34
|
-
| 违规现象 | 正确做法 |
|
|
35
|
-
| -------- | -------- |
|
|
36
|
-
| 未读 `*.outline.txt` 就写 Excel，列名用 `keywordText` / `query` / `geoName` | 先 Read 各 section 的 outline；字段以最后一行 TS 类型为准（如 `keyword`、`searchTermText`、`countryOrRegion`） |
|
|
37
|
-
| `cat keywords-*.json \| python -m json.tool \| head` 探结构 | 只 Read `keywords-*.outline.txt`；业务 JSON 仅在脚本内读取 |
|
|
38
|
-
| `list-accounts` 第一页未见 ID，改用列表里「另一个」账户 | `list-accounts -m Google -k <用户ID>`；无结果则告知用户，停止 |
|
|
39
|
-
| 用户要 `2702960720`，拉数/脚本却用 `9322098303` | 全流程同一 `mediaCustomerId`；文件名以 stdout `accountId` 为准 |
|
|
40
|
-
| 交付 xlsx 前未对照 `deliverable-preflight.md` | 交付前自检表 A/B/C；xlsx 附脚本 stdout 行数/汇总摘要 |
|
|
41
|
-
|
|
42
|
-
---
|
|
43
35
|
|
|
44
36
|
## 执行流程
|
|
45
37
|
|
|
@@ -9,7 +9,7 @@ $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.29-beta.
|
|
12
|
+
$PKG_VERSION = '1.1.29-beta.2'
|
|
13
13
|
$CLI_BIN = 'siluzan-tso'
|
|
14
14
|
$SKILL_LABEL = 'Siluzan TSO'
|
|
15
15
|
$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
|
|
@@ -9,7 +9,7 @@ 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.29-beta.
|
|
12
|
+
readonly PKG_VERSION="1.1.29-beta.2"
|
|
13
13
|
readonly CLI_BIN="siluzan-tso"
|
|
14
14
|
readonly SKILL_LABEL="Siluzan TSO"
|
|
15
15
|
readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
|