siluzan-tso-cli 1.1.42 → 1.1.43-beta.2

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,6 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
+> **注意**：当前为测试版（1.1.43-beta.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -4026,7 +4026,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -5544,6 +5544,32 @@ var init_daily_metrics_range = __esm({
   }
 });
 
+// src/utils/snapshot/async-lock.ts
+async function withAsyncLock(key, fn) {
+  const prev = chains.get(key) ?? Promise.resolve();
+  let release;
+  const gate = new Promise((resolve21) => {
+    release = resolve21;
+  });
+  chains.set(
+    key,
+    prev.catch(() => void 0).then(() => gate)
+  );
+  await prev.catch(() => void 0);
+  try {
+    return await fn();
+  } finally {
+    release();
+  }
+}
+var chains;
+var init_async_lock = __esm({
+  "src/utils/snapshot/async-lock.ts"() {
+    "use strict";
+    chains = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/commands/google-analysis/wrap-snapshot-envelope.ts
 function coerceToRowArray(value) {
   if (Array.isArray(value)) return value;
@@ -5766,26 +5792,29 @@ async function writeGoogleAnalysisSnapshot(params) {
   const outlineBody = formatOutlineFileBody(fileName, normalizedWrapped, outlineExtra);
   await fs7.writeFile(path11.join(absDir, outlineFileName), `${outlineBody}
 `, "utf8");
-  const existing = await readManifestIfExists(absDir, accountSlug || void 0);
   const newArtifact = {
     section: params.section,
     file: relativeFile,
     writtenAt,
     ...params.endpointHint !== void 0 ? { endpointHint: params.endpointHint } : {}
   };
-  const merged = mergeGoogleAnalysisManifest(existing, {
-    accountId: params.accountId,
-    dateRange: params.dateRange,
-    cliVersion: params.cliVersion,
-    newArtifact
-  });
   const manifestFile = googleAnalysisManifestFile(accountSlug || void 0);
-  await fs7.writeFile(
-    path11.join(absDir, manifestFile),
-    `${JSON.stringify(stringifyIdsDeep(merged), null, 2)}
+  const manifestPath = path11.join(absDir, manifestFile);
+  await withAsyncLock(manifestPath, async () => {
+    const existing = await readManifestIfExists(absDir, accountSlug || void 0);
+    const merged = mergeGoogleAnalysisManifest(existing, {
+      accountId: params.accountId,
+      dateRange: params.dateRange,
+      cliVersion: params.cliVersion,
+      newArtifact
+    });
+    await fs7.writeFile(
+      manifestPath,
+      `${JSON.stringify(stringifyIdsDeep(merged), null, 2)}
 `,
-    "utf8"
-  );
+      "utf8"
+    );
+  });
   return {
     kind: "siluzan-tso-google-analysis-snapshot",
     schemaVersion: SCHEMA_VERSION2,
@@ -5803,6 +5832,7 @@ var init_google_analysis = __esm({
     "use strict";
     init_cli_json();
     init_wrap_snapshot_envelope();
+    init_async_lock();
     init_dir();
     LEGACY_MANIFEST_FILE = "manifest.json";
     CLI_PACKAGE = "siluzan-tso-cli";
@@ -102288,6 +102318,56 @@ async function loadSectionFile(snapshotDir, file) {
     return null;
   }
 }
+function dateTagFromRange(dateRange) {
+  if (!dateRange || dateRange.mode !== "range") return void 0;
+  return `${dateRange.start.replace(/-/g, "")}-${dateRange.end.replace(/-/g, "")}`;
+}
+function dateTagFromMeta(meta) {
+  const start = typeof meta?.startDate === "string" ? meta.startDate : "";
+  const end = typeof meta?.endDate === "string" ? meta.endDate : "";
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(start) || !/^\d{4}-\d{2}-\d{2}$/.test(end)) return void 0;
+  return `${start.replace(/-/g, "")}-${end.replace(/-/g, "")}`;
+}
+function pickSectionSnapshotFile(files, section, accountId, preferredDateTag) {
+  const escapedSection = section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const escapedId = accountId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const re = new RegExp(`^${escapedSection}-${escapedId}(?:_(\\d{8}-\\d{8}))?\\.json$`);
+  const matches = files.filter((f) => re.test(f));
+  if (matches.length === 0) return null;
+  if (preferredDateTag) {
+    const preferred = matches.find((f) => f.endsWith(`_${preferredDateTag}.json`));
+    if (preferred) return preferred;
+  }
+  return [...matches].sort().at(-1) ?? null;
+}
+async function recoverMissingReportSections(sectionMap, absDir, accountId, preferredDateTag) {
+  if (!accountId) return;
+  let entries;
+  try {
+    entries = await fs20.readdir(absDir);
+  } catch {
+    return;
+  }
+  for (const section of REPORT_MERGE_SECTIONS) {
+    if (sectionMap.has(section)) continue;
+    const file = pickSectionSnapshotFile(entries, section, accountId, preferredDateTag);
+    if (!file) continue;
+    const data = await loadSectionFile(absDir, file);
+    if (data) sectionMap.set(section, data);
+  }
+}
+function periodMetricsFromRow(row) {
+  if (!row) return null;
+  return {
+    cost: num2(row.spend),
+    impressions: num2(row.impressions),
+    clicks: num2(row.clicks),
+    conversions: num2(row.conversions),
+    ctr: num2(row.ctr),
+    averageCpc: num2(row.averageCpc),
+    costPerConversion: num2(row.costPerConversion)
+  };
+}
 function items(envelope) {
   if (!envelope || !Array.isArray(envelope.items)) return [];
   return envelope.items.filter((row) => asRecord11(row) !== null);
@@ -102342,16 +102422,18 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
   if (!manifest) {
     throw new Error(`\u672A\u5728 ${absDir} \u627E\u5230 manifest*.json\uFF0C\u8BF7\u5148\u6267\u884C google-analysis --json-out`);
   }
+  const accountId = manifest.googleAnalysis?.accountId ?? metaAccountId;
+  const dateRange = manifest.googleAnalysis?.dateRange;
+  const preferredDateTag = dateTagFromRange(dateRange) ?? dateTagFromMeta(asRecord11(payload.meta) ?? void 0);
   const sectionMap = /* @__PURE__ */ new Map();
   for (const art of manifest.artifacts ?? []) {
     const data = await loadSectionFile(absDir, art.file);
     if (data) sectionMap.set(art.section, data);
   }
+  await recoverMissingReportSections(sectionMap, absDir, accountId, preferredDateTag);
   const overviewRecord = record(sectionMap.get("overview"));
   const currentPeriod = asRecord11(overviewRecord?.currentPeriod);
   const previousPeriod = asRecord11(overviewRecord?.previousPeriod);
-  const accountId = manifest.googleAnalysis?.accountId ?? metaAccountId;
-  const dateRange = manifest.googleAnalysis?.dateRange;
   const meta = { ...payload.meta ?? {} };
   if (!meta.accountId && accountId) meta.accountId = accountId;
   if (!meta.currency) {
@@ -102363,16 +102445,9 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
   if (!meta.generatedAt) meta.generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const campaignRows2 = items(sectionMap.get("campaigns"));
   const campaignKpis = sumCampaignRowsToPeriodKpis(campaignRows2);
+  const dimensionSummaryRecord = record(sectionMap.get("dimension-summary"));
   const kpis = { ...payload.kpis ?? {} };
-  const currentKpiSource = campaignKpis ?? (currentPeriod ? {
-    cost: num2(currentPeriod.spend),
-    impressions: num2(currentPeriod.impressions),
-    clicks: num2(currentPeriod.clicks),
-    conversions: num2(currentPeriod.conversions),
-    ctr: num2(currentPeriod.ctr),
-    averageCpc: num2(currentPeriod.averageCpc),
-    costPerConversion: num2(currentPeriod.costPerConversion)
-  } : null);
+  const currentKpiSource = campaignKpis ?? periodMetricsFromRow(currentPeriod) ?? periodMetricsFromRow(dimensionSummaryRecord);
   if (currentKpiSource) {
     if (currentKpiSource.cost != null) kpis.cost = currentKpiSource.cost;
     if (currentKpiSource.impressions != null) kpis.impressions = currentKpiSource.impressions;
@@ -102411,22 +102486,21 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     }
   }
   const tables = { ...payload.tables ?? {} };
-  {
-    const summary = record(sectionMap.get("dimension-summary"));
-    if (summary) {
-      tables.dimensionSummary = {
-        cost: num2(summary.spend),
-        impressions: num2(summary.impressions),
-        clicks: num2(summary.clicks),
-        conversions: num2(summary.conversions),
-        ctr: num2(summary.ctr),
-        averageCpc: num2(summary.averageCpc),
-        costPerConversion: num2(summary.costPerConversion),
-        searchImpressionShare: num2(summary.searchImpressionShare),
-        searchBudgetLostImpressionShare: num2(summary.searchBudgetLostImpressionShare),
-        searchRankLostImpressionShare: num2(summary.searchRankLostImpressionShare)
-      };
-    }
+  if (dimensionSummaryRecord) {
+    tables.dimensionSummary = {
+      cost: num2(dimensionSummaryRecord.spend),
+      impressions: num2(dimensionSummaryRecord.impressions),
+      clicks: num2(dimensionSummaryRecord.clicks),
+      conversions: num2(dimensionSummaryRecord.conversions),
+      ctr: num2(dimensionSummaryRecord.ctr),
+      averageCpc: num2(dimensionSummaryRecord.averageCpc),
+      costPerConversion: num2(dimensionSummaryRecord.costPerConversion),
+      searchImpressionShare: num2(dimensionSummaryRecord.searchImpressionShare),
+      searchBudgetLostImpressionShare: num2(
+        dimensionSummaryRecord.searchBudgetLostImpressionShare
+      ),
+      searchRankLostImpressionShare: num2(dimensionSummaryRecord.searchRankLostImpressionShare)
+    };
   }
   if (campaignRows2.length > 0) {
     tables.campaigns = campaignRows2.map((r) => ({
@@ -102464,10 +102538,20 @@ async function mergeGoogleAnalysisSnapshotIntoReport(payload, snapshotDir) {
     tables
   };
 }
+var REPORT_MERGE_SECTIONS;
 var init_merge_snapshot = __esm({
   "src/commands/google-analysis/merge-snapshot.ts"() {
     "use strict";
     init_google_analysis();
+    REPORT_MERGE_SECTIONS = [
+      "overview",
+      "daily-metrics",
+      "dimension-summary",
+      "campaigns",
+      "devices",
+      "geographic",
+      "keywords"
+    ];
   }
 });
 
@@ -102511,6 +102595,19 @@ function validateGooglePeriodReportContent(data) {
       "\u22651 \u6BB5\u6267\u884C\u6458\u8981\uFF0C\u6982\u8FF0\u672C\u671F\u6D88\u8017/\u8F6C\u5316/CTR/CPA \u8D70\u52BF"
     );
   }
+  const kpis = asRecord12(data.kpis);
+  const hasCoreKpi = ["cost", "impressions", "clicks"].some(
+    (key) => Number.isFinite(Number(kpis?.[key]))
+  );
+  if (!hasCoreKpi) {
+    pushMissing(
+      missing,
+      "kpis-core-metrics",
+      "\u6267\u884C\u6458\u8981 KPI",
+      "kpis.cost / kpis.impressions / kpis.clicks",
+      "\u81F3\u5C11\u4E00\u9879\u987B\u4E3A\u6709\u6548\u6570\u5B57\uFF1B\u8BF7\u52A0 --snapshot-dir \u4ECE google-analysis \u5FEB\u7167\u5408\u5E76\uFF08\u52FF\u624B\u586B HTML\uFF09"
+    );
+  }
   const sectionAnalysisCounts = {};
   const sectionSuggestionCounts = {};
   for (const key of SECTION_KEYS) {
@@ -102571,7 +102668,7 @@ function formatGooglePeriodReportErrors(result) {
     ...lines,
     "",
     "\u8BF7\u8865\u5168 narrative.sections.<dimension>.{analysis,suggestions} \u4E0E narrative.recommendations \u540E\u91CD\u65B0\u6267\u884C render\u3002",
-    "\u6570\u503C\u7C7B\u5B57\u6BB5\uFF08kpis/charts/tables\uFF09\u53EF\u7701\u7565\uFF0C\u52A0 --snapshot-dir \u7531 CLI \u4ECE google-analysis \u5FEB\u7167\u81EA\u52A8\u5408\u5E76\uFF1BAgent \u53EA\u9700\u64B0\u5199\u53D9\u4E8B\u6587\u5B57\uFF0C\u7981\u6B62\u624B\u5199 HTML\u3002"
+    "kpis/charts/tables \u987B\u7531 --snapshot-dir \u4ECE google-analysis \u5FEB\u7167\u81EA\u52A8\u5408\u5E76\uFF08Agent \u53EA\u5199 narrative\uFF09\uFF1B\u5408\u5E76\u540E kpis \u4ECD\u4E3A\u7A7A\u65F6\u68C0\u67E5\u5FEB\u7167\u76EE\u5F55 manifest \u662F\u5426\u542B overview/campaigns/dimension-summary\u3002\u7981\u6B62\u624B\u5199 HTML\u3002"
   ].join("\n");
 }
 var SECTION_KEYS, SECTION_LABELS;
@@ -108342,6 +108439,7 @@ init_cli_table();
 init_cli_json_snapshot();
 
 // src/utils/snapshot/report-analysis.ts
+init_async_lock();
 init_google_analysis();
 init_cli_json();
 import * as fs8 from "fs/promises";
@@ -108415,25 +108513,24 @@ async function writeReportAnalysisSnapshot(params) {
 `,
     "utf8"
   );
-  const existing = await readReportManifestIfExists(absDir, accountSlug || void 0);
   const newArtifact = {
     section: params.section,
     file: fileName,
     writtenAt
   };
-  const merged = mergeReportAnalysisManifest(existing, {
-    accountId: params.accountId,
-    dateRange: params.dateRange,
-    cliVersion: params.cliVersion,
-    newArtifact
-  });
   const manifestFile = reportManifestFile(accountSlug || void 0);
-  await fs8.writeFile(
-    path12.join(absDir, manifestFile),
-    `${JSON.stringify(merged, null, 2)}
-`,
-    "utf8"
-  );
+  const manifestPath = path12.join(absDir, manifestFile);
+  await withAsyncLock(manifestPath, async () => {
+    const existing = await readReportManifestIfExists(absDir, accountSlug || void 0);
+    const merged = mergeReportAnalysisManifest(existing, {
+      accountId: params.accountId,
+      dateRange: params.dateRange,
+      cliVersion: params.cliVersion,
+      newArtifact
+    });
+    await fs8.writeFile(manifestPath, `${JSON.stringify(merged, null, 2)}
+`, "utf8");
+  });
   return {
     kind: "siluzan-tso-report-analysis-snapshot",
     schemaVersion: SCHEMA_VERSION3,

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.42",
-  "publishedAt": 1785974807433
+  "version": "1.1.43-beta.2",
+  "publishedAt": 1785994362313
 }

package/dist/skill/assets/google-period-report.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "siluzan-tso/google-period-report.schema.json",
   "title": "GooglePeriodReport",
-  "description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 8 默认维度；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative 字段，kpis/charts/tables 可省略由 --snapshot-dir 从 google-analysis 落盘快照自动合并。",
+  "description": "Google Ads 周期分析报告 JSON（对齐 google-period-report.md 8 默认维度；供 google-analysis render 注入 HTML）。Agent 只需撰写 narrative；kpis/charts/tables 由 --snapshot-dir 从 google-analysis 快照合并。render 校验要求合并后 kpis.cost/impressions/clicks 至少一项为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。",
   "type": "object",
   "required": ["meta", "narrative"],
   "properties": {
@@ -21,7 +21,7 @@
     },
     "kpis": {
       "type": "object",
-      "description": "账户级 KPI（执行摘要 KPI 网格）；可省略，由 --snapshot-dir 从 overview 合并",
+      "description": "账户级 KPI（执行摘要 KPI 网格）；Agent 可省略，但 render 时须经 --snapshot-dir 合并出 cost/impressions/clicks",
       "properties": {
         "cost": { "type": "number" },
         "impressions": { "type": "number" },

package/dist/skill/references/accounts/accounts-list.md

@@ -167,7 +167,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---

package/dist/skill/references/accounts/accounts-permissions.md

@@ -486,7 +486,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 
 | 功能                                    | 媒体   | 网页路径                                          |
 | --------------------------------------- | ------ | ------------------------------------------------- |
-| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
+| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 
 **Agent 建议话术**：
 
@@ -495,5 +495,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 siluzan-tso config show   # 查看 webUrl 字段
 
 # 账户激活（Google）→ 引导至账户管理页
-# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
 ```

package/dist/skill/references/accounts/finance.md

@@ -127,7 +127,7 @@ siluzan-tso config show
 
 ### 充值页链接（按媒体 × 类型）
 
-链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
 
 | 充值类型                  | `<page>`              | 支持媒体（`mediaType` 参数）                |
 | ------------------------- | --------------------- | ------------------------------------------- |

package/dist/skill/references/accounts/open-account-by-media.md

@@ -1,6 +1,6 @@
 # 各媒体开户
 
-> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 网页链接：`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
 

package/dist/skill/references/accounts/open-account-google-ui.md

@@ -65,7 +65,7 @@ siluzan-tso open-account google-wizard
 
 ```bash
 siluzan-tso account-history -m Google
-# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 
 ---

package/dist/skill/references/analytics/rag.md

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 

package/dist/skill/references/analytics/reporting.md

@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 
 | 媒体   | 报告类型         | URL 模板                                                    |
 | ------ | ---------------- | ----------------------------------------------------------- |
-| Google | 日报（Daily）    | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
-| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
-| TikTok | 日报             | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 日报（Daily）    | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
+| TikTok | 日报             | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
 
 `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
 
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

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

@@ -142,6 +142,17 @@
 - **破坏性操作必须确认 + `--commit`**：账户解绑/关闭/取消分享、BC/MCC 解绑、删除预警/报告/广告/关键词、发票申请、广告发布等。
   - **CLI 硬门控**：`account delink` / `unshare` / `reauth` / `mcc-unbind` / `bc-unbind` **缺少 `--i-confirm` 会直接失败**（不会发网关）。`--commit` 只是审计说明，**不能替代**用户确认。
   - **Agent**：先说明风险与将执行的命令 → **等待用户明确同意** → 才附加 `--i-confirm --commit "…"` 执行。用户说「别问我 / 直接做」也**不得**跳过确认；**禁止**未获同意就自行加 `--i-confirm`。
+- **写操作结束后必须向用户交付成败报告**（修改 / 创建 / 删除 / 绑定 / 分享 / 开户提交 / 预警变更等凡改变远端状态的命令）：
+  - 用**业务语言**说明：结论（全成功 / 部分失败 / 全失败）→ **成功了哪些**（对象名或 ID）→ **失败了哪些**（对象 + 原因，来自当次 CLI stderr / `reason` / `errors` / 读命令复核）→ 如需用户动作再给 1 句下一步。
+  - 批量或可部分失败时（多账户 MCC/BC、关户、批量关键词等）：**逐项**列清，禁止只说「已处理」。
+  - 单资源写：至少交代「改了什么 + 当前状态」（可用成对读命令复核后写进报告）。
+  - **禁止**只贴一行 CLI `✅`/`❌` 或整段 stdout 当交付；**禁止**写命令成功后静默结束。
+  - **广告创建（W3）另有加强**：见下条与 `workflows.md` W3——创建完成后必须输出**每个系列**的详情，不能只报「任务已提交 / 创建完成」。
+- **Google 广告创建完成后必出系列详情报告**（用户确认计划并执行 `campaign-create` / `pmax-create` 之后）：
+  - 流水线跑完：`batch get` 至终态 →（搜索）`batch diff` + 必要自动补建 → 再读 `ad campaigns`（及组/词/扩展等按需）核对。
+  - 对用户按**每个广告系列**交代：账户、系列名与 `campaignId`、batch 状态、广告组/关键词/RSA/否词/投放国家/附加信息的**计划 vs 实况**（可用 `batch diff` 的 `counts` + `missing` + 读命令结果组织）；已自动补建的条数；仍失败项与原因。
+  - 多系列：每个系列各跑完核对后，在同一回复里**按系列分节**汇报。
+  - **禁止**只说「已创建成功 / 未发现缺失」而不列成功明细；代改过用户方案时另加修改表（见 `google-ads-plan-source-fidelity.md`）。
 - **不确定时读文档**：先读对应 references 或用 `-h`，不要猜参数。
 - **跨账号 / 企业管家手机号**：用户消息中出现**中国大陆 11 位手机号**（常见语境：「企业管家」「管家账户」「账号 xxx」）且意图是查**该手机号名下**的账户数据时，**必须先**执行 `siluzan-tso account me --check-phone <手机号> --json-out ./snap-me`。**禁止**在未校验通过前用当前凭据拉他户数据。
   - `matched: true`（或 CLI exit 0）→ 按原工作流继续（如 P3 `accounts-digest` 查 TOP 消耗）。
@@ -153,7 +164,7 @@
   - 当前凭据未返回手机号且用户指定了手机号 → 视同未校验通过，引导重新用手机号登录。
 - **Google 新建搜索系列**：流程在 `references/google-ads/google-ads-campaign-plan.md`；填 JSON 前**必须先 Read** `assets/campaign-create-template.json`，再 Read `assets/campaign-create-template.md`。**禁止**只读 `.md` 手写 JSON。
 - **「根据官网生成 Google 搜索广告 / 表格格式」**：仍属新建搜索系列 → **W3 + 本文件上条**；用户要的「表格」是对已落盘 JSON 的投影（Agent 写代码生成），**不是**可跳过 JSON 的独立交付物。**仅出方案**时可先 JSON + 审查稿（跳过 validate）；**创建前**必须 `campaign-validate` 且用户已审完整审查稿。**禁止**与 P8 网站诊断、P9 市场分析、W5 仅拓词混用；**禁止**因缺账户 ID 拒出方案。
-- **Excel/表格投放方案 → 创建广告**：必读 `references/google-ads/rules/google-ads-plan-source-fidelity.md`。Agent **写代码**直接转成 campaign-create JSON；地域用 **`ad geo resolve`**；**禁止**对话手填完整 JSON、**禁止**编造 geo id；有方案匹配类型时勿压成一律 BROAD。**方案不合规时必须询问**：「您自己改还是我帮您改？」——**禁止**未问就静默改用户方案内容后 create。用户选「我帮您改」时：代改同步落盘变更账本；**创建完成后必出报告**（创建了哪些 + 从 xxx→xxx + 原因）。
+- **Excel/表格投放方案 → 创建广告**：必读 `references/google-ads/rules/google-ads-plan-source-fidelity.md`。Agent **写代码**直接转成 campaign-create JSON；地域用 **`ad geo resolve`**；**禁止**对话手填完整 JSON、**禁止**编造 geo id；有方案匹配类型时勿压成一律 BROAD。**方案不合规时必须询问**：「您自己改还是我帮您改？」——**禁止**未问就静默改用户方案内容后 create。用户选「我帮您改」时：代改同步落盘变更账本。**创建完成后必出系列详情报告**；代改过则**另附**修改表（从 xxx→xxx + 原因）。
 - **「行业分析 / 行业分析报告 / 生成 XX 行业报告」**（例：「帮我生成一份电商行业的行业分析报告」）→ **P9 战略市场分析**。**必须**先 `siluzan-tso market-analysis collect … --json-out`，再 WebSearch 补数据、写 `market-report.json`，最后 `market-analysis render` 出 HTML。**禁止**不调用 CLI、仅在对话里用 WebSearch 写 Markdown 充当终稿。**不是** `google-analysis`、**不是** P8 网站诊断。
 - **开户首次响应**：对话内首次进入开户话题时，**必须先**按 `references/accounts/open-account-by-media.md` §「首次响应硬规范」输出**完整必填业务清单**（未指明媒体则列全平台六媒体业务项），再收集资料；**禁止**未列清单就执行 `open-account` 或零散追问。清单**只写业务项与说明**；**禁止**向用户展示 `--flag` / CLI 选项名 / 命令行参数列（参数仅 Agent 内部组命令用）。
 - **Google 开户**：`open-account google-wizard` 仅限真实 TTY；Agent/自动化用非交互 `open-account google ...`，审核进度用 `account-history`；对用户话术仍只用业务语言。
@@ -322,8 +333,10 @@
 | 模糊意图 | 选最可能工作流先执行；结论后附「您是不是还想…」 |
 | campaign-create 后 Sitelink/国家 batch 漏建 | **自动** `batch get` → `batch diff` → `ad geo add` / `ad extension *`；**勿**反问是否补建 |
 | 用户方案（Excel 等）不合规 | 列出问题 → 二选一「您自己改还是我帮您改？」→ 停等；禁止未问静默改后 create |
-| 用户选「我帮您改」且已创建 | **必出报告**：创建了哪些 + 从 xxx→xxx + 原因（见 `google-ads-plan-source-fidelity.md`） |
-| 写入/删除/充值/开户提交 | **必须先确认**（§四）；业务语言说明将要做什么 |
+| **任意写操作刚结束** | **必出成败报告**（§四）：成功对象 + 失败对象/原因；禁止只贴 emoji 行或静默结束 |
+| **广告创建流水线刚结束**（含未代改方案） | **必出每个系列的创建详情**（§四）：计划 vs 实况计数、补建条数、仍失败项；代改时另加修改表（`google-ads-plan-source-fidelity.md`） |
+| 用户选「我帮您改」且已创建 | 在系列详情之上 **另出修改表**：从 xxx→xxx + 原因 |
+| 写入/删除/充值/开户提交 | **必须先确认**（§四）；业务语言说明将要做什么；执行后再按上表汇报结果 |
 | 对象不清且无法推断 | **只问一次**，给 2～3 个选项 |
 
 ### 14.4 自然语言 ↔ 内部路由（对用户隐藏编号）
@@ -347,5 +360,6 @@
 - 禁止冷冰冰系统提示语气而不给下一步。
 - 禁止用户未要求时输出冗长「执行计划」清单；尽快进入执行。
 - 交付 HTML/Excel 时附 **3～5 行摘要**（区间、币种、核心 KPI、最大问题、建议动作），不要只丢文件路径。
+- 写操作 / 广告创建结束后：**禁止**用「搞定了 / 已提交」代替成败明细；须按 §四交付成功项与失败项（创建另须按系列列详情）。
 
 数值纪律不变：金额、状态、ID 只来自当次 CLI/`--json-out`；本节只约束表述方式。

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
 ```
 
 ---
@@ -63,7 +63,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 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -126,9 +126,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/workflows.md

@@ -1,7 +1,7 @@
 # 工作流目录 · 操作 / 管理类（W1–W12）
 
 > **范围**：调接口 / 写操作类业务（账户读取、开户、广告 CRUD、智投、拓词、优化、报告推送、财务、权限、预警、线索、巡检）。分析/报告类（拉数 → 撰稿 → 交付）见 `references/core/playbooks.md`（P1–P9）。
-> **通用纪律见 `references/core/agent-conventions.md`**（写操作确认 + `--commit`、ID 口径）；各卡片只写线性步骤。卡片字段：`触发 / 必读 / 步骤 / 产物`。完整参数表见「必读」指向的命令文档。
+> **通用纪律见 `references/core/agent-conventions.md`**（写操作确认 + `--commit`、写后成败报告、ID 口径）；各卡片只写线性步骤。卡片字段：`触发 / 必读 / 步骤 / 产物`。完整参数表见「必读」指向的命令文档。
 
 | 编号 | 业务                            | 必读                                                                                        |
 | ---- | ------------------------------- | ------------------------------------------------------------------------------------------- |
@@ -76,10 +76,11 @@
   4. 创建阶段门禁：`ad pmax-validate --config-file ./pmax.json --json-out ./snap-pmax`。
   5. **写代码**按 `google-ads-pmax-launch-plan-template.md` 从 JSON 投影完整审查稿 → 用户审查确认 → `ad pmax-create --commit "…"`。
   6. 复核：`ad campaigns` / `ad pmax-get`；缺表单时 `ad extension lead-form` 补挂。
+  7. **向用户交付创建详情**（系列名/`campaignId`、资产组/扩展是否齐全、失败原因）；禁止只说「已创建」。
 - **步骤（Search · 方案文件 → 创建）**：
   1. Read `campaign-create-template.json`；Agent 写转换脚本读 Excel → 写出 `campaign.json`（匹配类型按方案分块）。
   2. `ad geo resolve -a <id> --from-file ./locations.json --json-out ./snap-geo`，把 id 写回 JSON。
-  3. `ad campaign-validate`；**有不合规 → 询问「您自己改还是我帮您改？」**（见 `google-ads-plan-source-fidelity.md`）→ **写代码投影完整审查稿** → 用户确认 → `campaign-create` → `batch get` / `batch diff` / 自动补扩展；若 Agent 代改过 → **创建完成报告**（创建清单 + 从 xxx→xxx + 原因）。
+  3. `ad campaign-validate`；**有不合规 → 询问「您自己改还是我帮您改？」**（见 `google-ads-plan-source-fidelity.md`）→ **写代码投影完整审查稿** → 用户确认 → `campaign-create` → `batch get` / `batch diff` / 自动补扩展 → **必出系列创建详情报告**；若 Agent 代改过 → 详情中**另附**修改表（创建清单 + 从 xxx→xxx + 原因）。
 - **步骤（Search 一体化创建，无现成方案文件）**：
   1. 地域：多国 `ad geo resolve`；单国 `ad geo search -a <id> -q "United States"`（仍禁止编造）。
   2. 门禁：`ad campaign-validate --config-file ./campaign.json`（必跑）。
@@ -88,8 +89,9 @@
   5. 轮询：`ad batch get --id <taskId> --config-file … --json-out …` 直至非 Creating；**读落盘 `agentWorkflow.nextCommand`**（`--json-out` 时人读提示不会出现）。
   6. **必做** `ad batch diff`（含投放国家）；`ok===false` / exit 2 时按 `missing[].remediateCommand` **自动** `ad geo add` / `ad extension *` 补建，勿反问用户（见 `google-ads-campaign-plan.md` § batch diff 后自动补建）。
   7. 复核：`ad campaigns` / `ad extension list` 确认系列与扩展齐全。
-- **精细管理与日常运营**：`ad adgroup-create` / `ad keyword-create` / `ad keyword-negative-create` / `ad ad-create`（拓词辅助见 **W5**）；调整用 `ad adgroup-status` / `ad campaign-status` / `ad ad-delete` / `ad keyword-negative-delete`。完整参数见 `references/google-ads/google-ads-write.md`；列表复核见 `google-ads-read.md`。
-- **产物**：系列（`ad campaigns` 可见）+ batch（`ad batch get` / `batch diff` 补齐扩展与地域）；关键词匹配格式 `running shoes`=广泛 / `"..."`=词组 / `[...]`=精确；结构性写操作须用户确认；写后用成对读命令复核。
+  8. **向用户交付创建详情报告**（每个系列一节）：系列名/`campaignId`、batch 状态、组/词/RSA/否词/国家/附加信息的计划 vs 实况（依据 `batch diff` 的 `counts`/`missing` + 读命令）、已补建条数、仍失败项与原因；**禁止**只说「创建完成」。代改过方案时另附修改表（`google-ads-plan-source-fidelity.md`）。见 `agent-conventions.md` §四。
+- **精细管理与日常运营**：`ad adgroup-create` / `ad keyword-create` / `ad keyword-negative-create` / `ad ad-create`（拓词辅助见 **W5**）；调整用 `ad adgroup-status` / `ad campaign-status` / `ad ad-delete` / `ad keyword-negative-delete`。完整参数见 `references/google-ads/google-ads-write.md`；列表复核见 `google-ads-read.md`。写后按 `agent-conventions.md` §四向用户汇报成败（改了什么、是否生效）。
+- **产物**：系列（`ad campaigns` 可见）+ batch（`ad batch get` / `batch diff` 补齐扩展与地域）+ **面向用户的系列创建详情报告**；关键词匹配格式 `running shoes`=广泛 / `"..."`=词组 / `[...]`=精确；结构性写操作须用户确认；写后用成对读命令复核并汇报成败。
 
 ---
 
@@ -102,8 +104,8 @@
   2. 详情：`ad batch get --id <recordId>`。
   3. （可选）改字段（仅 `draftStatus=Draft` 可改）：`ad batch update --id <recordId> --budget … --campaign-name … --url …`。
   4. 发布：`ad batch publish --id <recordId>`。
-  5. 跟踪：`ad batch list` 看 `Creating → Successfully / Failed`；成功后 `ad campaigns -a <id>` 验证。
-- **产物**：草稿的**从零创建**须在网页向导完成，CLI 不支持；要纯 CLI 创建走 **W3**。发布前与用户确认。
+  5. 跟踪：`ad batch list` 看 `Creating → Successfully / Failed`；成功后 `ad campaigns -a <id>` 验证；终态后按 **W3** / `agent-conventions.md` §四向用户交付系列创建详情（成功/失败项）。
+- **产物**：草稿的**从零创建**须在网页向导完成，CLI 不支持；要纯 CLI 创建走 **W3**。发布前与用户确认；发布后须汇报成败明细。
 
 ---
 

package/dist/skill/references/google-ads/google-ads-campaign-plan.md

@@ -61,13 +61,13 @@
 | 5   | 得到与模板同构的 `campaign-create` JSON（仅出方案时 `account`=`[PENDING_ACCOUNT]`）                                                                                                                                | **`assets/campaign-create-template.json`**                                        |
 | 6   | **创建阶段**：`ad campaign-validate --config-file <json>`；**仅出方案 → 跳过**，交付时说明「有账户后再 validate」                                                                                                                      | 下文「校验」                                                                      |
 | 6b  | **方案来自用户且不合规**（创建前）：列出问题 → **询问**「您自己改还是我帮您改？」→ 按选择处理后再 validate（**禁止**未问就静默改方案）                                         | **`rules/google-ads-plan-source-fidelity.md`** § 用户方案不合规                   |
-| 6c  | 用户选「我帮您改」：改 JSON 时**同步落盘变更账本**（from → to + reason）                                                                                              | 同上 § Agent 代改后：创建完成报告                                                  |
+| 6c  | 用户选「我帮您改」：改 JSON 时**同步落盘变更账本**（from → to + reason）                                                                                              | 同上 § 创建完成报告                                                               |
 | 7   | **审查稿（必做）**：Agent **写代码**读 JSON，按 `google-ads-launch-plan-template.md` 投影完整文件（默认 MD；用户要 Excel 等则改格式）；须含全部关键词与 RSA 正文；**禁止**概览表代替；**勿**贴整份 JSON 当主交付 | `google-ads-launch-plan-template.md`                                              |
 | 8   | 用户确认后 **`ad campaign-create`**                                                                                                                                  | `references/google-ads/google-ads-write.md`                                       |
 | 9   | 每隔5s 获取创建结果                                                                                                                                                  | `ad batch get --id <taskId> --config-file ./campaign.json`                        |
 | 10  | 成功或部分成功后 **`ad batch diff`** 对照 JSON 与账户实况                                                                                                              |                                                                                   |
 | 11  | **自动补建缺失项**（见下文「batch diff 后自动补建」）：附加信息（Sitelink/Callout 等）**直接**执行 `ad extension *`；组/词/RSA 用对应 create 命令。**勿**仅汇报失败并反问用户是否补建 | `references/google-ads/google-ads-batch.md` § batch diff 后自动补建                     |
-| 12  | **若曾由 Agent 代改方案**：出「创建与修改报告」——创建了哪些 + 修改了哪些（从 xxx → xxx + 原因）                                                                   | **`rules/google-ads-plan-source-fidelity.md`** § 创建完成报告                     |
+| 12  | **向用户交付系列创建详情**（每个系列：计划 vs 实况、补建、失败项）；代改过方案时**另附**修改表（从 xxx → xxx + 原因）                                              | `agent-conventions.md` §四；**`rules/google-ads-plan-source-fidelity.md`** § 创建完成报告 |
 
 多系列：每系列一个 JSON；可选 `campaign-manifest.json`（`role: brand|competitor|generic`）仅作文件组织参考。
 
@@ -147,6 +147,7 @@ validate 与 create **共用** `runCampaignCreateValidation`：词面规范化 +
 | 5 | 有缺失时 CLI **exit 2**；补建后再 `ad batch diff`，直到 `ok===true`（含 `counts.liveLocations === plannedLocations`） |
 | 6 | 汇总告诉用户「已自动补上 N 个投放国家 / M 条 Sitelink」 |
 | 7 | 仅当补建命令也失败时，才向用户说明原因并给改写方案 |
+| 8 | **向用户交付系列创建详情报告**（必做，即使 `ok===true`）：按系列列出名/`campaignId`、batch 状态、各组层计划 vs 实况（`counts` + 无 `missing` 的项视为已生效）、补建条数、仍失败项；**禁止**只说「创建完成 / 未发现缺失」。多系列按系列分节。细则见 `agent-conventions.md` §四；代改方案另附修改表见 `google-ads-plan-source-fidelity.md` |
 
 **Agent 易漏点**：`--json-out` 时人读「下一步」不会打印——**必须以落盘 `agentWorkflow` 为准**；`campaign-create` 落盘同样带 `agentWorkflow.nextCommand`（首轮 `batch get`）。
 

package/dist/skill/references/google-ads/google-ads-write.md

@@ -177,6 +177,7 @@ BatchJob 常漏 **附加信息**（Sitelink）与 **投放地域**；系列/组/
 3. 扩展字段映射：`Properties.Text` + `DestinationUrl` → `ad extension sitelink`；`CALLOUT` → `callout`；`CALL` → `call`；`STRUCTURED_SNIPPET` → `snippet`。
 4. 有缺失时 CLI **exit 2**；补建后再跑一次 `ad batch diff`，直到 `ok===true`。
 5. 向用户汇报已补挂条数（地域 + Sitelink 等）。
+6. **无论全成功或部分失败**，收尾必须向用户交付**每个系列的创建详情**（业务语言）：系列名/`campaignId`、batch 状态、组/词/RSA/否词/国家/附加信息计划 vs 实况（用 `counts` + `missing` + 读命令）、补建与仍失败项。**禁止**只说「已创建成功」或只复述「未发现缺失」。见 `agent-conventions.md` §四。
 
 完整流水线见 `references/google-ads/google-ads-campaign-plan.md` § batch diff 后自动补建。
 

package/dist/skill/references/google-ads/rules/google-ads-plan-source-fidelity.md

@@ -62,10 +62,11 @@
 
 ---
 
-## Agent 代改后：创建完成报告（必出）
+## 创建完成报告（必出）
 
-**何时必出**：用户选择「我帮您改」且最终完成了 `campaign-create`（含 batch get / batch diff / 必要补建）之后。  
-**何时不必出完整修改表**：用户全程自己改方案、Agent 未改业务内容——只需常规创建结果摘要。
+**何时必出系列创建详情**：凡最终完成了 `campaign-create`（含 `batch get` / `batch diff` / 必要补建）之后——**无论是否代改方案**。结构见下节「创建了哪些」；多系列按系列分节。总纪律见 `agent-conventions.md` §四。
+
+**何时另出完整修改表**：仅当用户选择「我帮您改」且 Agent 改过业务内容。用户全程自己改方案、Agent 未改业务内容 → **不必**出修改表，但仍须出系列创建详情。
 
 ### 变更账本（代改过程中维护）
 
@@ -82,20 +83,20 @@
 
 ### 面向用户的报告结构（业务语言）
 
-创建与核对结束后，用一份短报告回复用户，至少含三块：
+创建与核对结束后，用一份短报告回复用户：
 
-1. **创建了哪些**  
-   账户 ID/名称、系列名与 `campaignId`、广告组数、关键词数（可附 Exact/Phrase/Broad）、否词数、投放国家数、RSA/附加信息条数；batch 状态；若有自动补建（Sitelink/地域等）写明补了几条。
+1. **创建了哪些（每个系列必有）**  
+   账户 ID/名称、系列名与 `campaignId`、广告组数、关键词数（可附 Exact/Phrase/Broad）、否词数、投放国家数、RSA/附加信息条数（计划 vs 实况，依据 `batch diff` 的 `counts` / `missing`）；batch 状态；若有自动补建（Sitelink/地域等）写明补了几条；仍失败项与原因。
 
-2. **修改了哪些（相对您的原方案）**  
+2. **修改了哪些（相对您的原方案）**——**仅代改时必出**  
    表格逐条：**位置 | 从（原值） | 改成（新值） | 原因**。  
    - `from` / `to` 写清原文，勿只写「已优化」。  
-   - 无修改则写「相对您的原方案无业务内容修改」（仅 geo id 解析等不写进此表）。
+   - 无业务修改则写「相对您的原方案无业务内容修改」（仅 geo id 解析等不写进此表）。
 
 3. **未改动的说明（可选一句）**  
    如：匹配类型/国家列表按您的方案保留。
 
-**禁止**：只说「已创建成功」而不交代代改明细；**禁止**把创建结果与修改混成一团让用户自己猜改了啥。
+**禁止**：只说「已创建成功 / 未发现缺失」而不列系列详情；代改时**禁止**省略修改表；**禁止**把创建结果与修改混成一团让用户自己猜改了啥。
 
 可选脚手架（非必须）：`assets/plan-extract.example.json` + `assets/scripts/assemble-campaign-from-plan.mjs`——若 Agent 更习惯先抽中间件再组装，可以用；**不强制**。
 

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

@@ -6,7 +6,7 @@
 siluzan-tso config show   # 取 webUrl
 ```
 
-首页地址：`https://www.siluzan.com/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. **「和首页一样的总览」** → 打开 `https://www.siluzan.com/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/references/report-templates/google-period-report.md

@@ -15,7 +15,7 @@
 | ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **1. 拉数**      | Agent 调 CLI | `google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google --sections <见下方默认维度对应 CLI>`                                                               |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察                                                                              |
-| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：仅 `meta` + `narrative`（8 维度叙事）为必填，`kpis`/`charts`/`tables` 可省略由 CLI 自动合并 |
+| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（8 维度叙事）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 会拒绝出 HTML） |
 | **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 8 维度必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                           |
 
 ```bash
@@ -33,7 +33,7 @@ siluzan-tso google-analysis render \
 `google-period-report.json` 顶层结构：
 
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
-- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；可省略。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率（规避 overview/stats 相对 Google API 延迟）；无 campaigns 快照时回退 `overview.currentPeriod`。环比仍来自 `overview.previousPeriod`。
+- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。环比仍来自 `overview.previousPeriod`。
 - `charts.dailyTrend`：每日趋势（`dates`/`cost`/`conversions`/`cpa`）；可省略由 `daily-metrics` 自动合并。
 - `tables.{dimensionSummary,campaigns,devices,geographic,keywords}`：对应 §3～§7 表格数据；可省略由同名 `google-analysis` section 自动合并。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
@@ -53,7 +53,7 @@ siluzan-tso google-analysis render \
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
 `render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加；Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加。若 manifest 缺条目但磁盘上仍有对应 `*.json`，CLI 会按文件名自愈补齐。Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---
 

package/dist/skill/report-templates/google-period-report.md

@@ -15,7 +15,7 @@
 | ---------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **1. 拉数**      | Agent 调 CLI | `google-analysis -a <id> --start <s> --end <e> --json-out ./snap-google --sections <见下方默认维度对应 CLI>`                                                               |
 | **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），完成筛选、聚合、排序与洞察                                                                              |
-| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：仅 `meta` + `narrative`（8 维度叙事）为必填，`kpis`/`charts`/`tables` 可省略由 CLI 自动合并 |
+| **3. 写 JSON**   | Agent        | 按 `assets/google-period-report.schema.json` 撰写 `google-period-report.json`：只写 `meta` + `narrative`（8 维度叙事）；`kpis`/`charts`/`tables` 留给步骤 4 的 `--snapshot-dir` 合并（合并后缺 KPI 会拒绝出 HTML） |
 | **4. 渲染 HTML** | CLI          | `google-analysis render` — **校验 narrative 8 维度必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                                                           |
 
 ```bash
@@ -33,7 +33,7 @@ siluzan-tso google-analysis render \
 `google-period-report.json` 顶层结构：
 
 - `meta`：`accountId`（必填）/ `accountName` / `currency` / `startDate` / `endDate`；可省略由 `--snapshot-dir` 从 `overview` + manifest 自动合并。
-- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；可省略。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率（规避 overview/stats 相对 Google API 延迟）；无 campaigns 快照时回退 `overview.currentPeriod`。环比仍来自 `overview.previousPeriod`。
+- `kpis`：账户级 KPI（消耗/展示/点击/转化/CTR/CPC/CPA，含可选 `previousPeriod` 环比）；Agent 可省略，但 **render 合并后** `cost`/`impressions`/`clicks` 至少一项须为有效数字，否则拒绝出 HTML（避免执行摘要卡片全「—」）。本期 KPI 由 CLI 优先对 `campaigns` 全系列累加并重算比率；无 campaigns 时回退 `overview.currentPeriod`，再回退 `dimension-summary`。环比仍来自 `overview.previousPeriod`。
 - `charts.dailyTrend`：每日趋势（`dates`/`cost`/`conversions`/`cpa`）；可省略由 `daily-metrics` 自动合并。
 - `tables.{dimensionSummary,campaigns,devices,geographic,keywords}`：对应 §3～§7 表格数据；可省略由同名 `google-analysis` section 自动合并。
 - `narrative`（**Agent 必填，唯一由 Agent 撰写的内容**）：
@@ -53,7 +53,7 @@ siluzan-tso google-analysis render \
 模板源码：`report-templates/google-period-report.html`（结构与样式，ECharts 渲染逻辑已内联）。
 
 `render` 会向输出目录写入 HTML，并注入 `window.__GOOGLE_PERIOD_REPORT__`。  
-传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加；Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
+传 `--snapshot-dir` 时 CLI 自动从快照合并 KPI、每日趋势图表、周期汇总/系列/设备/地域/关键词表格：**数值一律以 CLI 快照覆盖**（`meta` 仅补空）。本期 KPI 优先 `campaigns` 累加。若 manifest 缺条目但磁盘上仍有对应 `*.json`，CLI 会按文件名自愈补齐。Agent 只写 `narrative`，勿自填 `kpis`/`tables`。
 
 ---
 

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.42'
+$PKG_VERSION = '1.1.43-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.42"
+readonly PKG_VERSION="1.1.43-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/package.json

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