siluzan-tso-cli 1.1.25 → 1.1.26-beta.2

package/dist/skill/references/core/agent-conventions.md

@@ -24,7 +24,8 @@
 
 - **禁止**「上次已经读过 `accounts/accounts.md` / `google-ads/google-ads.md`，本任务直接 `siluzan-tso …`」
 - **禁止**用对话记忆中的示例 ID、金额、命令 flags 代替当次 Read 文档
-- **禁止**跳过 `references/core/tips.md` 里的 outline→JSON 顺序
+- **禁止**跳过 `references/core/tips.md` 里的 outline→脚本读 JSON 顺序
+- **禁止**用 Read / `cat` / `type` 打开 `--json-out` 落盘的**业务数据** `*.json`（`campaigns-*.json`、`list-accounts-*.json` 等）；只允许 Read 体积小的 `*.outline.txt` 与 `references/` 文档
 
 ---
 
@@ -36,7 +37,8 @@
 2. 涉及写入/修改/删除的操作必须与用户确认
 3. 按计划执行，说明每步意图
 4. 用成对的读命令复核写入结果；异步任务每 5s 轮询直到完成
-5. 全部完成后预测用户下一步操作
+5. **交付前**（报告/Excel/含金额话术）：Read `references/core/deliverable-preflight.md`，运行 `node scripts/check-deliverable-snap.mjs`；币种须来自 `list-accounts` / `overview` 的 `currencyCode`
+6. 全部完成后预测用户下一步操作
 
 ### 执行模式速查
 
@@ -77,15 +79,27 @@
 
 本 Skill 下**所有**业务数据均以 CLI `--json-out`（或用户提供的同构 JSON）落盘为唯一真相源。Agent **不得**在对话或脚本里「代替」磁盘数据。
 
+### 禁止 Read 完整业务 JSON（最高优先级）
+
+`--json-out` 落盘的 `writtenFiles[0]`（及同目录 `campaigns-*.json`、`keywords-*.json` 等）往往为 **MB 级**。Agent **永远不得**用宿主 **Read** 工具、`cat`、`type`、`Get-Content` 等方式把整文件读进对话上下文。
+
+| 允许 Read 的文件 | 必须用代码读取的文件 |
+| ---------------- | -------------------- |
+| `references/**/*.md`、`assets/**/*.md`（Skill 文档） | 所有 `--json-out` 业务 `*.json` |
+| 当次 `*.outline.txt`（通常小于 2KB，仅 schema） | `cli-manifest*.json` / `manifest-*.json` 中的路径索引（应用脚本 `JSON.parse` 读，勿 Read 整份 manifest 若很大） |
+| stdout **一行**摘要 JSON（命令回显，体积小） | 用户提供的同构大 JSON 文件 |
+
+**正确流程**：解析 stdout 摘要 → Read **仅** `outlineFile` 了解字段类型 → **编写并执行** `node -e` / `node script.mjs` / `python`：`require` 或 `readFileSync` 读 JSON → `console.log` / 写 xlsx/html **只输出所需字段** → 用脚本打印结果回答用户。
+
 | 必须 | 禁止 |
 | ---- | ---- |
-| 编写并**执行** Node/Python 脚本：`readFile` / `require` 读落盘 JSON → 计算 → 写出 | 用 `Read` 读大 JSON 后在回复里手填、改数、心算汇总 |
-| **先 outline 后 JSON**：`outlineFile`（`.outline.txt`）→ `writtenFiles[0]` | 跳过 outline 猜字段名；把 outline 当数据贴给用户 |
+| 编写并**执行** Node/Python 脚本读落盘 JSON → 计算 → 写出 | 用 **Read** 打开 `writtenFiles` 业务 JSON；在回复里手填、改数、心算汇总 |
+| **先 outline 后脚本读 JSON**：`outlineFile` → 代码读 `writtenFiles[0]` | 跳过 outline 猜字段名；把 outline 当数据贴给用户 |
 | 字段路径以 `outlineFile` + 当次 `writtenFiles` / manifest 为准 | 把国家名、ID、金额、词表等**业务值**写成源码字面量 |
 | 映射表 / 模板契约在运行时加载（`analytics/geo-continents.json`、`campaign-create-template.json`） | 复制配置条目进源码常量 |
 | 脚本输出与落盘 JSON 可复核 | 用「上次对话记住的数」「占位数」写入交付物 |
 
-**允许的字面量**：输出目录、Sheet/列标题、技术格式、`focusCountries` 等**用户当轮明确给出**的配置（建议落盘为 `config.json` 再读）。
+**允许的字面量**：输出目录、Sheet/列标题、技术格式、`focusCountries` 等**用户当轮明确给出**的配置（建议落盘为 `config.json` 再**用脚本**读）。
 
 完整协议见 `references/core/tips.md` § 处理顺序、§ 已有 JSON 时。
 
@@ -122,6 +136,7 @@
 - **符号**：`CNY` → **￥**；`USD` → **$**。多账户按 `currencyCode` 分表，**禁止**跨币种求和。
 - **金额单位统一为「元」**：报告保留 2 位小数。
 - **Google 广告诊断报告**：`report-templates/google-ads-diagnosis.md` § 撰写硬约束 — 每日趋势金额/CPA 必须 2 位小数；每个模块除表格外须有「分析」+「建议」，禁止只贴数据。
+- **交付前自检**：报告/Excel 交付前运行 `scripts/check-deliverable-snap.mjs`（见 `deliverable-preflight.md`）；自检失败禁止交付。
 - **品牌名优先级**：(1) 用户明确提供 → (2) `list-accounts.mag.advertiserName` → (3) 网址域名占位 `[待确认品牌名]`。**严禁**把英文域名翻译为虚构中文品牌。
 
 ---

package/dist/skill/references/core/deliverable-preflight.md

@@ -0,0 +1,107 @@
+# 交付前自检（币种 + 数据完整）
+
+> 用户反馈 Agent 产出物常见两类问题：**币种错误**（Google 默认美金、符号混用）、**报告缺章/缺数**（少拉维度、Read JSON 截断后手填）。本节给出**可执行**防线。
+
+---
+
+## 根因（简要）
+
+| 问题 | 典型原因 |
+| ---- | -------- |
+| 币种错误 | 未先 `list-accounts` 读 `currencyCode`；报告脚本写死 `USD`；CNY 用 `$` |
+| 数据缺失 | 未按模板拉全 `--sections`；未读 `manifest` 就写报告；Read 大 JSON 截断后编造；多账户漏 ID |
+
+---
+
+## 强制流程（报告/Excel 交付前）
+
+与 `references/core/agent-conventions.md`「计划 → 确认 → 执行 → **验证**」一致，**交付前增加验证步**：
+
+### 1. 币种（第一步就做）
+
+```bash
+siluzan-tso list-accounts -m Google -k <mediaCustomerId> --json-out ./snap
+node -e "
+const d=require('./snap/list-accounts-google.json');
+const ma=(d.items||[]).map(x=>x.ma||x).find(m=>String(m.mediaCustomerId)===process.argv[1]);
+if(!ma){console.error('账户未找到');process.exit(1);}
+console.log(ma.currencyCode, ma.mediaCustomerName);
+" <mediaCustomerId>
+```
+
+- 将输出的 **`currencyCode`** 写入报告生成脚本（从 JSON 读，勿写死）。
+- 首行必须有：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：CNY|USD）`。
+- 符号：**CNY → ￥**，**USD → $**。详见 `references/accounts/currency.md`。
+
+### 2. 拉数完整（对照模板 + manifest）
+
+- 周期报告：按 `report-templates/google-period-report.md` 默认 7 维（或用户追加维）一次 `google-analysis --sections … --json-out`。
+- 拉数后打开 **`manifest-<accountId>.json`**（用脚本 `JSON.parse`，勿 Read 整份若很大），核对 `artifacts[].section` 与模板一致。
+
+### 3. 写报告只用脚本读 JSON
+
+见 `references/core/tips.md`：**禁止** Read 业务 `*.json`；用 `node`/Python 聚合后写 HTML/xlsx。
+
+### 4. 交付前运行自检脚本（必做）
+
+Skill 自带脚本（安装后在 skill 根目录）：
+
+```bash
+node scripts/check-deliverable-snap.mjs ./snap --preset p4-google
+# 或自定义：--required overview,campaigns,geographic
+# 已知账户为 CNY 时：--expect-currency CNY
+```
+
+| 参数 | 说明 |
+| ---- | ---- |
+| `<snapDir>` | `--json-out` 目录 |
+| `--preset p4-google` | 对齐 Google 周期报告默认 7 维 |
+| `--preset p1-google` | 单账户画像：list-accounts + stats + ad-campaigns |
+| `--required a,b` | 额外必填 section（逗号分隔，前缀匹配） |
+| `--expect-currency CNY\|USD` | 与 `list-accounts` / `overview` 中 `currencyCode` 对照 |
+
+**退出码 1** → 补拉缺失维度或修币种后再交付。**禁止**在自检失败时仍把报告发给用户。
+
+### 5. 报告正文抽检（脚本输出对照）
+
+交付前用脚本打印 3 个汇总（示例）：
+
+```bash
+node -e "
+const o=require('./snap/overview-<id>_<start>-<end>.json');
+const r=o.record||{};
+const p=r.currentPeriod||{};
+console.log('spend',p.spend,'clicks',p.clicks,'currency',r.currencyCode);
+"
+```
+
+报告中的总消耗、币种须与上述一致（允许四舍五入，**不允许数量级或币种错误**）。
+
+---
+
+## Playbook 挂钩
+
+| Playbook | 自检命令 |
+| -------- | -------- |
+| P1 | `--preset p1-google` + `--expect-currency`（来自 list-accounts） |
+| P4 | `--preset p4-google` |
+| P6 / P7 | 按 `okki-weekly-google-client.md` / `google-inquiry-analysis.md` 自建 `--required`（含各月 `campaigns`、`geographic` 等） |
+
+---
+
+## 长期改进（可选）
+
+| 手段 | 说明 |
+| ---- | ---- |
+| **skill-eval 场景** | 断言 Agent 先 `list-accounts` 且报告含 `（货币：XXX）` |
+| **CLI `snap check`** | 将本脚本收编为 `siluzan-tso snap check`（待开发） |
+| **报告模板内嵌币种占位** | 脚本写 `{currencyCode}` 而非手写符号 |
+
+---
+
+## 相关文档
+
+- `references/accounts/currency.md`
+- `report-templates/REPORT-WORKFLOW.md` § 步骤 4–5
+- `references/core/tips.md`
+- `references/core/playbooks.md`

package/dist/skill/references/core/playbooks.md

@@ -4,10 +4,10 @@
 
 | 编号 | 场景 | 必读 references |
 | ---- | ---- | --------------- |
-| P1 | 单账户投放画像 | `analytics/account-analytics.md`、`accounts/currency.md`、`core/tips.md` |
+| P1 | 单账户投放画像 | `analytics/account-analytics.md`、`accounts/currency.md`、`core/tips.md`、`core/deliverable-preflight.md` |
 | P2 | 多账户余额扫描 | `accounts/accounts.md`（`balance-scan`）、`accounts/currency.md` |
 | P3 | 多账户投放画像汇总 | `accounts/accounts.md` § accounts-digest、`accounts/currency.md`、`core/tips.md` |
-| P4 | Google 账户周期报告 | `report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md` |
+| P4 | Google 账户周期报告 | `report-templates/google-period-report.md`、`analytics/account-analytics.md`、`core/tips.md`、`core/deliverable-preflight.md` |
 | P4-FB | Meta/Facebook 周期报告 | `report-templates/meta-period-report.md`、`analytics/facebook-analysis-guide.md`、`analytics/account-analytics.md`、`core/tips.md` |
 | P5 | 多账户多维度报告 | `analytics/google-analysis-batch.md`、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
 | P6 | OKKI 周报 | `report-templates/okki-weekly-google-client.md`（全文）、`analytics/account-analytics.md`、`core/tips.md`；可选 `core/subagent-orchestration.md` |
@@ -24,6 +24,7 @@
 4. `ad campaigns -a <mediaCustomerId> --start <S> --end <D> --json-out ./snap-p1`
 5. 诊断/画像报告：Read `report-templates/google-ads-diagnosis.md`（**硬约束：每日趋势 2 位小数、每模块必有分析**）+ `google-account-diagnosis-report.md`（章节与 CLI）；`google-analysis --json-out` 须含 `daily-metrics`（按日趋势）。
 6. 首行标注统计区间和货币；HTML 可对齐 `report-template.html` + `section-*` 区块。
+7. 交付前：`node scripts/check-deliverable-snap.mjs ./snap-p1 --preset p1-google --expect-currency <来自 list-accounts>`。
 
 ---
 
@@ -66,6 +67,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 1. 确认时间范围；区间 > 3 个月时分段（季度/月）。
 2. 按 `google-period-report.md` 默认维度执行 `google-analysis --json-out <dir>`。
 3. 报告须含：账户概览、投放趋势、Top 关键词/系列/地区分布、优化建议。
+4. 交付前：`node scripts/check-deliverable-snap.mjs <dir> --preset p4-google --expect-currency <currencyCode>`。
 
 ---
 

package/dist/skill/references/core/setup.md

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -129,9 +129,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

package/dist/skill/references/core/skill-authoring.md

@@ -53,7 +53,7 @@ siluzan-tso/                    # 安装后目录名
 
 - 从 SKILL.md **只链接一层**（`references/foo.md`），避免 A→B→C 链式引用。
 - 路径用正斜杠，不用 Windows 反斜杠。
-- 占位符 `https://www.siluzan.com`、`https://tso-api.siluzan.com`、`npm install -g siluzan-tso-cli` 由构建脚本替换，文档中禁止硬编码环境 URL。
+- 占位符 `https://www-ci.siluzan.com`、`https://tso-api-ci.siluzan.com`、`npm install -g siluzan-tso-cli@beta` 由构建脚本替换，文档中禁止硬编码环境 URL。
 
 ---
 

package/dist/skill/references/core/subagent-orchestration.md

@@ -58,7 +58,7 @@
 | `mediaCustomerId` | 来自当次 `list-accounts`，禁止猜 |
 | `dateRange` | `start` / `end`（YYYY-MM-DD）；P7 另附 `m1`/`m2`/`m3` |
 | `commands[]` | 可复制 bash 块（来自 playbook 或 report-template） |
-| `forbidden[]` | 至少包含：禁止 Read 全量 MB JSON 进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
+| `forbidden[]` | 至少包含：禁止 Read/cat 打开落盘业务 `*.json`（须 node/python 脚本读盘）；禁止把 JSON 贴进回复；禁止编造 ID/金额；禁止 batch 重新 `run`（仅 `resume`） |
 | `returnSchema` | 子会话**只**回传下列内容 |
 
 ### returnSchema（子会话结束时的回复格式）

package/dist/skill/references/core/tips.md

@@ -2,7 +2,7 @@
 
 > **文档重读（与落盘无关，但同样硬）**：**每个新的用户任务**或**同对话内换话题**时，须按 `references/core/agent-conventions.md` § 文档加载纪律 **重新 Read** 当次任务对应的 `references/*.md` / `report-templates/*.md`，再执行 CLI。
 
-> **AI 助手（本 Skill）**：凡需结构化数据，一律使用 **`--json-out <路径>`**（**目录** 或 **`*.json` 具体文件**）将 JSON 写入磁盘（并更新 **`cli-manifest[-<查询id>].json`**，与 `google-analysis` 的 **`manifest-<accountId>.json`**、`report …` 的 **`report-manifest[-<accountId>].json`** 并存于各自目录），再用 **脚本读文件**（`fs.readFileSync` / `require`）做筛选与聚合；**不要**依赖对话里粘贴的 stdout 整包 JSON。命令成功时 **stdout 仅一行摘要 JSON**（体积小），其中 **`outlineFile`** 指向与当次 `*.json` **同 stem** 的 **`*.outline.txt`**（纯文本单行，接近 **TypeScript 类型字面量**：`{ a: number; b: string }`、`(T | U)[]` 等；数组由**前 8 项**去重推断并集；环 / 同对象再出现为 `any`）。完整数据仍以落盘 `*.json` 为准，类型扫一眼读 outline 文件即可。
+> **AI 助手（本 Skill）**：凡需结构化数据，一律 **`--json-out <路径>`** 落盘，再用 **Node/Python 脚本**（`require` / `readFileSync`）读 JSON 做筛选与聚合。**禁止**用宿主 **Read** 工具打开落盘业务 `*.json`（会占满上下文且易截断）。命令成功时 **stdout 仅一行摘要 JSON**（体积小）；**`outlineFile`**（`*.outline.txt`，通常小于 2KB）是唯一允许用 Read 查看的「数据结构」文件——最后一行是 TS 类型字面量。业务数据**只**通过脚本访问，脚本 stdout 打印你需要的行/汇总即可。
 >
 > **文件命名规则（重要）**：当一条命令具备明确的"查询 id"（mediaCustomerId / entityId / ruleId / auditId 等）时，目录模式落盘的 `*.json`、`*.outline.txt` 与对应 manifest **都会带上 `-<查询id>` 后缀**：
 >
@@ -21,23 +21,26 @@
 
 ---
 
-## 处理顺序（**Agent 必读**）：先 outline → 再 JSON → 再脚本聚合
+## 处理顺序（**Agent 必读**）：摘要 → outline（schema）→ **脚本**读 JSON
 
 每条 `--json-out` 命令成功后，**必须**按以下顺序处理，不要跳步、不要把 outline 当数据：
 
-1. **先读 stdout 一行摘要 JSON**：拿到 `outlineFile`、`writtenFiles[0]`、`manifestFile`，以及固定回显的 **`agentHint`** 一行说明（即"先读 outline 再读 JSON"的提示）。**不要硬编码 `<section>.json` 文件名**。
-2. **再 `fs.readFileSync(outlineFile, 'utf8')` 读 outline 文件**（即 `*.outline.txt`）：
+1. **解析 stdout 一行摘要 JSON**（禁止 Read 打开 `writtenFiles[0]` 的 `.json`）：拿到 `outlineFile`、`writtenFiles[0]`、`manifestFile`、`agentHint`。**不要硬编码 `<section>.json` 文件名**。
+2. **了解字段结构**（二选一，推荐 A）：
+   - **A**：宿主 **Read** 仅 `outlineFile`（`*.outline.txt`，体积小）；或
+   - **B**：`node -e "const fs=require('fs'); const o=fs.readFileSync(process.argv[1],'utf8').trimEnd().split('\\n').filter(l=>!l.startsWith('//')); console.log(o.pop())" <outlineFile>`
    - 第 1 行（注释）：`// outline of \`<xxx>.json\` — schema-only, NOT the data.` —— **明确告诉你它是"数据结构描述文件"**，不要把它当业务数据使用。
    - 第 2 行（注释）：中文用法说明。
    - 第 3 行（注释）：类型推断口径（数组取前 8 项去重并集；环或重复对象记为 any）。
    - 其后**可能**还有若干行 `//` 字段提示（例如 `google-analysis` 的 **`campaigns-*.outline.txt`** 会插入金额字段已统一为元的说明）。
    - **类型字面量**：**最后一个不以 `//` 开头的行**（单行 TS，如 `{ a: number; items: { ... }[] }`）—— 写筛选/聚合脚本时取这一行即可。
    - 提取写法：`outlineRaw.trimEnd().split('\n').filter(l => !l.startsWith('//')).pop()`（**不要**用 `lines[lines.length - 1]`：当最后一行是空行时会错）。
-3. **再 `require(writtenFiles[0])` / `fs.readFileSync` 读真实 JSON 数据**做筛选、聚合、计算。**禁止**：
-   - 把 outline 文件 `require` 进来当 JSON 解析（它是 `.txt` 不是 JSON）；
-   - 跳过 outline 直接猜 JSON 字段名；
-   - 把 outline 当成"摘要数据"贴给用户当结论。
-4. **交付物**用代码（Node / Python + 数据处理库）写出对应格式（HTML / Excel / PDF / PPT / Markdown 等），不要在对话里手填数。
+3. **必须用 Bash 执行脚本**读 `writtenFiles[0]`（及 manifest 中的路径）做筛选、聚合、计算——脚本内 `require` / `readFileSync`，**禁止**宿主 Read / cat / type 打开该 `.json`。**禁止**：
+   - 用 **Read** 读 `campaigns-*.json`、`list-accounts-*.json` 等落盘业务 JSON；
+   - 把 outline 当 JSON `require`（它是 `.txt`）；
+   - 跳过 outline 猜字段名；
+   - 把 outline 或整段 JSON 贴进对话当结论。
+4. **交付物**用代码写出（HTML / Excel / PDF / PPT / Markdown 等）；向用户展示的数字须来自**脚本 stdout**，不要在对话里手填数。
 
 > 这个顺序对所有三类快照统一生效：通用业务命令（`cli-manifest[-<id>].json`）、`google-analysis`（`manifest-<accountId>.json`）、`report …` 分析（`report-manifest[-<accountId>].json`）。三种 summary 都带 `outlineFile`、`agentHint` 字段。
 
@@ -324,8 +327,8 @@ console.log('可用字段：', first && Object.keys(first));
 
 ## AI Agent 使用规范
 
-- **优先用 `--json-out` 与清单文件**：同一运行目录、同一"查询 id"的多次拉数会合并到 `cli-manifest-<id>.json` 的 `artifacts[]`；不同账户/实体写入各自的 manifest，互不覆盖。读具体数据请打开 stdout 摘要 `writtenFiles[0]` 或对应 `<section>-<id>.json`。
-- **中间结果一律落盘**：跨步骤数据不要靠对话记忆，写到工作目录或临时目录并在后续脚本中 `require` / `readFile`。
+- **优先用 `--json-out` 与清单文件**：同一运行目录、同一"查询 id"的多次拉数会合并到 `cli-manifest-<id>.json` 的 `artifacts[]`；不同账户/实体写入各自的 manifest，互不覆盖。读具体数据**只**在脚本里 `require(writtenFiles[0])`，**禁止 Read 工具**打开该 json。
+- **中间结果一律落盘**：跨步骤数据不要靠对话记忆，写到工作目录并在后续 **`node`/`python` 脚本**中读盘。
 - **Windows 上避免直接管道 JSON**：PowerShell 管道可能改变编码；优先 `--json-out` + `node -e` 读文件。
 - **用 `process.stdout.write` 而不是 `console.log` 提取单个值**：前者不带换行符，方便直接赋给 shell 变量。
 - **节点代码复杂时拆分写法**：不要写超过 10 行的 `node -e` 单行，改用 `node -e "$(cat <<'EOF'\n...\nEOF\n)"` 或多行 `.mjs` 脚本文件。

package/dist/skill/references/core/workflows.md

@@ -70,7 +70,7 @@ siluzan-tso account-history -m Google
 siluzan-tso list-accounts -m Google
 
 # 第四步：充值激活（必须网页完成）
-# siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# siluzan-tso config show 取 webUrl，打开：https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 # 美元账户最低约 100 USD，人民币账户约 700 CNY
 ```
 
@@ -135,7 +135,7 @@ siluzan-tso account-history -m Yandex
 **必填清单**：见 `open-account-by-media.md` § BingV2（含 `--pattern`、`--name-remark-list`、`--postcode`）。
 
 ```bash
-# 前置：查询行业名称（将输出的 name 值传给 --trade-id）
+# 前置：查询行业（将 bing-industries 输出的 id 传给 --trade-id，勿猜行业名）
 siluzan-tso open-account bing-industries --keyword "科技"
 
 # 提交开户（CLI 自动按公司名创建/关联广告主组，无需 magKey）
@@ -149,7 +149,7 @@ siluzan-tso open-account bing \
   --address "南山区科技园XX路XX号XX大厦" \
   --postcode "518000" \
   --promotion-link "https://www.brand-a.com" \
-  --trade-id "IT/消费电子-其他" \
+  --trade-id "<bing-industries 输出的 id>" \
   --license-file "/path/to/license.jpg"
 
 # 轮询审核进度
@@ -790,7 +790,7 @@ siluzan-tso balance -m Google -a <mediaCustomerId>
 siluzan-tso config show   # 取 webUrl
 
 # 诊断入口（网页 AICreation 向导内嵌）：
-# {webUrl}/v3/foreign_trade/tso/advertising/AICreation
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/advertising/AICreation
 # → 输入推广链接时，系统会自动触发网站诊断
 ```
 
@@ -851,7 +851,7 @@ siluzan-tso account bm-bind \
   --bm-id <businessManagerId>
 
 # 第三步：确认绑定状态（在网页确认）
-# {webUrl}/v3/foreign_trade/tso/manageAccounts → 找到对应账户查看 BM 状态
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts → 找到对应账户查看 BM 状态
 ```
 
 ### 场景 C：TikTok BC 绑定 / 解绑
@@ -875,7 +875,7 @@ siluzan-tso account bc-unbind --customers <mediaCustomerId> --bc-id <bcId>
 siluzan-tso config show   # 取 webUrl
 
 # 打开账户管理页：
-# {webUrl}/v3/foreign_trade/tso/manageAccounts
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
 # → 选中 Google 账户 → 点击「激活账户」→ 选择激活方式
 ```
 

package/dist/skill/references/misc/tso-home.md

@@ -6,7 +6,7 @@
 siluzan-tso config show   # 取 webUrl
 ```
 
-首页地址：`{webUrl}/v3/foreign_trade/tso/home`
+首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
 
 ---
 
@@ -25,7 +25,7 @@ siluzan-tso config show   # 取 webUrl
 
 ## 推荐话术
 
-1. **「和首页一样的总览」** → 打开 `{webUrl}/v3/foreign_trade/tso/home`。
+1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
 2. **「某个 Google 账户昨天花了多少」** → `list-accounts -m Google` + `stats -m Google -a <id>`。
 3. **「有待充值账户」** → 说明聚合数据在首页；CLI 可 `list-accounts` + `balance` 逐户排查，或引导充值页。
 

package/dist/skill/report-templates/REPORT-WORKFLOW.md

@@ -51,6 +51,14 @@
 
 ---
 
+### 步骤 4b：交付前自检（**必做**）
+
+- Read `references/core/deliverable-preflight.md`。
+- 运行 `node scripts/check-deliverable-snap.mjs <snapDir> --preset p4-google`（或按模板 `--required` / `--expect-currency`）。
+- 退出码非 0：**补拉数据或修正币种**，不得交付。
+
+---
+
 ### 步骤 5：撰写报告
 
 - 按 `*.md` 章节结构组织内容。

package/dist/skill/scripts/check-deliverable-snap.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * 交付前快照自检（币种 + 缺文件/空数据）
+ *
+ * 用法：
+ *   node scripts/check-deliverable-snap.mjs <snapDir> [--preset p4-google] [--required a,b]
+ *   node scripts/check-deliverable-snap.mjs ./snap --expect-currency CNY
+ *
+ * 退出码：0 通过；1 有 error；2 用法错误
+ */
+import fs from "node:fs";
+import path from "node:path";
+
+const PRESETS = {
+  "p4-google": [
+    "overview",
+    "daily-metrics",
+    "dimension-summary",
+    "campaigns",
+    "devices",
+    "geographic",
+    "keywords",
+  ],
+  "p1-google": ["list-accounts", "stats", "ad-campaigns"],
+};
+
+function parseArgs(argv) {
+  const snapDir = argv[2];
+  if (!snapDir) return { error: "缺少 snapDir" };
+  let preset;
+  let required = [];
+  let expectCurrency;
+  for (let i = 3; i < argv.length; i++) {
+    if (argv[i] === "--preset" && argv[i + 1]) {
+      preset = argv[++i];
+    } else if (argv[i] === "--required" && argv[i + 1]) {
+      required = argv[++i].split(",").map((s) => s.trim()).filter(Boolean);
+    } else if (argv[i] === "--expect-currency" && argv[i + 1]) {
+      expectCurrency = argv[++i].toUpperCase();
+    }
+  }
+  if (preset) {
+    const p = PRESETS[preset];
+    if (!p) return { error: `未知 preset：${preset}，可选：${Object.keys(PRESETS).join(", ")}` };
+    required = [...new Set([...required, ...p])];
+  }
+  return { snapDir: path.resolve(snapDir), required, expectCurrency };
+}
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+
+function listManifests(dir) {
+  return fs.readdirSync(dir).filter((f) => /^manifest(-.*)?\.json$/.test(f) || /^report-manifest(-.*)?\.json$/.test(f) || /^cli-manifest(-.*)?\.json$/.test(f));
+}
+
+function sectionMatches(artifactSection, required) {
+  return required.some((r) => artifactSection === r || artifactSection.startsWith(`${r}-`) || artifactSection.includes(r));
+}
+
+function itemCount(payload) {
+  if (!payload || typeof payload !== "object") return null;
+  if (Array.isArray(payload.items)) return payload.items.length;
+  if (Array.isArray(payload.data?.items)) return payload.data.items.length;
+  if (payload.record && typeof payload.record === "object") return 1;
+  if (Array.isArray(payload.data)) return payload.data.length;
+  return null;
+}
+
+function extractCurrencyFromPayload(payload, section) {
+  if (!payload || typeof payload !== "object") return null;
+  const rec = payload.record ?? payload.data?.record;
+  if (rec?.currencyCode) return String(rec.currencyCode);
+  const items = payload.items ?? payload.data?.items;
+  if (Array.isArray(items) && items.length > 0) {
+    const ma = items[0].ma ?? items[0];
+    if (ma?.currencyCode) return String(ma.currencyCode);
+    if (items[0].currencyCode) return String(items[0].currencyCode);
+  }
+  if (section.includes("list-accounts") && Array.isArray(items) && items[0]?.ma?.currencyCode) {
+    return String(items[0].ma.currencyCode);
+  }
+  return null;
+}
+
+function main() {
+  const parsed = parseArgs(process.argv);
+  if (parsed.error) {
+    console.error(parsed.error);
+    process.exit(2);
+  }
+  const { snapDir, required, expectCurrency } = parsed;
+  if (!fs.existsSync(snapDir)) {
+    console.error(`目录不存在：${snapDir}`);
+    process.exit(2);
+  }
+
+  const manifests = listManifests(snapDir);
+  if (manifests.length === 0) {
+    console.error(`未找到 manifest / report-manifest / cli-manifest：${snapDir}`);
+    process.exit(1);
+  }
+
+  const errors = [];
+  const warnings = [];
+  let currencySeen = null;
+
+  for (const mf of manifests) {
+    const man = readJson(path.join(snapDir, mf));
+    const arts = man.artifacts ?? [];
+    console.log(`\n📋 ${mf}（${arts.length} 个 artifact）`);
+
+    if (required.length > 0) {
+      for (const req of required) {
+        const hit = arts.some((a) => sectionMatches(String(a.section ?? ""), [req]));
+        if (!hit) errors.push(`[${mf}] 缺少维度/命令：${req}`);
+        else console.log(`  ✓ 已拉取：${req}`);
+      }
+    }
+
+    for (const art of arts) {
+      const fp = path.join(snapDir, art.file);
+      if (!fs.existsSync(fp)) {
+        errors.push(`[${mf}] 文件缺失：${art.file}`);
+        continue;
+      }
+      let payload;
+      try {
+        payload = readJson(fp);
+      } catch (e) {
+        errors.push(`[${mf}] JSON 解析失败：${art.file}`);
+        continue;
+      }
+      const n = itemCount(payload);
+      const sec = String(art.section ?? "");
+      if (n === 0) warnings.push(`[${mf}] ${art.file} items 为空（章节可能写「无数据」）`);
+      const ccy = extractCurrencyFromPayload(payload, sec);
+      if (ccy) {
+        if (!currencySeen) currencySeen = ccy;
+        else if (currencySeen !== ccy) warnings.push(`[${mf}] 币种不一致：${ccy} vs 先前 ${currencySeen}`);
+        if (sec.includes("overview") || sec.includes("list-accounts")) {
+          console.log(`  💱 币种来源 ${art.file}：${ccy}`);
+        }
+      }
+    }
+  }
+
+  if (expectCurrency) {
+    if (!currencySeen) warnings.push(`未从快照解析到 currencyCode，无法对照 --expect-currency ${expectCurrency}`);
+    else if (currencySeen !== expectCurrency) {
+      errors.push(`币种不符：快照为 ${currencySeen}，期望 ${expectCurrency}（报告须用 ￥/ $ 与代码一致）`);
+    } else console.log(`\n✓ 币种与期望一致：${expectCurrency}`);
+  } else if (currencySeen) {
+    console.log(`\n💱 建议在报告首行写：统计区间：…（货币：${currencySeen}）`);
+  }
+
+  if (warnings.length) {
+    console.log("\n⚠️ 警告：");
+    warnings.forEach((w) => console.log(`  - ${w}`));
+  }
+  if (errors.length) {
+    console.log("\n❌ 错误：");
+    errors.forEach((e) => console.log(`  - ${e}`));
+    process.exit(1);
+  }
+  console.log("\n✅ 交付前自检通过（仍须确认报告正文金额来自脚本、非手填）\n");
+}
+
+main();

package/dist/skill/scripts/install.ps1

@@ -9,11 +9,11 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.25'
+$PKG_VERSION = '1.1.26-beta.2'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
-$WEB_BASE    = 'https://www.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
+$WEB_BASE    = 'https://www-ci.siluzan.com'
 
 # -- Constants ----------------------------------------------------------------
 $NODE_MAJOR_MIN    = 18

package/dist/skill/scripts/install.sh

@@ -9,11 +9,11 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.25"
+readonly PKG_VERSION="1.1.26-beta.2"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
-readonly WEB_BASE="https://www.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
+readonly WEB_BASE="https://www-ci.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/eval/stub-fixtures/meta-overview.json

@@ -6,5 +6,5 @@
   "writtenFiles": ["meta-overview-3995107670753101.json", "meta-overview-3995107670753101.outline.txt"],
   "section": "meta-overview",
   "outlineFile": "meta-overview-3995107670753101.outline.txt",
-  "agentHint": "Read outline first, then JSON."
+  "agentHint": "禁止 Read 业务 *.json；先 outline schema，再用脚本读 JSON。"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-tso-cli",
-  "version": "1.1.25",
+  "version": "1.1.26-beta.2",
   "description": "Siluzan 广告账户管理 CLI — 查询账户、余额、消耗数据，管理绑定关系与充值。",
   "keywords": [
     "ad-account",