siluzan-tso-cli 1.1.45-beta.4 → 1.1.45

package/README.md

@@ -43,7 +43,7 @@ HTML 报告模板外部资源：**ECharts** 统一使用 `https://staticpn.siluz
 在**用户的目标项目根目录**执行（根据用户使用的助手选择 `--ai`）：
 
 ```bash
-npm install -g siluzan-tso-cli@beta
+npm install -g siluzan-tso-cli
 siluzan-tso init --ai cursor         # 写入 Cursor（默认）
 siluzan-tso init --ai cursor,claude  # 同时写入多个平台
 siluzan-tso init --ai all            # 写入所有支持的平台
@@ -51,7 +51,6 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.45-beta.4），供内部测试使用。正式发布后安装命令将改为 `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-ci.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
   }
 });
 
@@ -134013,7 +134013,7 @@ var YANDEX_SECTIONS = [
   },
   {
     name: "daily",
-    description: "\u6309\u65E5\u7EE9\u6548\uFF08\u53EF\u4F9B\u8C03\u7528\u65B9\u81EA\u884C\u805A\u5468\uFF09",
+    description: "\u6309\u65E5\u7EE9\u6548\uFF1B\u843D\u76D8\u542B weekly[]\uFF08ISO \u5468\uFF09\uFF0C\u7981\u6B62\u81EA\u884C\u805A\u5468",
     path: "daily"
   },
   {
@@ -134061,7 +134061,7 @@ var YANDEX_SECTION_ALIASES = {
 
 // src/commands/yandex-analysis/run-batch.ts
 init_auth();
-import * as path43 from "path";
+import * as path44 from "path";
 import { performance as performance8 } from "perf_hooks";
 init_version();
 
@@ -134193,133 +134193,9 @@ function endpointHintForYandexSection(def) {
   return `GET \u2026/yandex-analysis/${def.path}?account=&start=&end=`;
 }
 
-// src/commands/yandex-analysis/resolve-sections.ts
-function normalizeSectionToken4(raw) {
-  const t = raw.trim();
-  if (!t) return null;
-  if (YANDEX_SECTION_NAMES.includes(t)) {
-    return t;
-  }
-  return YANDEX_SECTION_ALIASES[t] ?? null;
-}
-function resolveSectionList5(sections, exclude) {
-  const splitClean = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
-  const include = splitClean(sections);
-  const dropRaw = splitClean(exclude);
-  const unknown = [...include, ...dropRaw].filter((n) => normalizeSectionToken4(n) === null);
-  if (unknown.length > 0) {
-    console.error(
-      `
-\u274C \u672A\u77E5\u7684 section \u540D\u79F0\uFF1A${unknown.join(", ")}
-   \u53EF\u9009\uFF1A${YANDEX_SECTION_NAMES.join(", ")}
-   \u522B\u540D\uFF1A${Object.keys(YANDEX_SECTION_ALIASES).join(", ")}
-`
-    );
-    process.exit(1);
-  }
-  const includeCanonical = new Set(include.map((n) => normalizeSectionToken4(n)).filter(Boolean));
-  const dropCanonical = new Set(dropRaw.map((n) => normalizeSectionToken4(n)).filter(Boolean));
-  const base = include.length > 0 ? YANDEX_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...YANDEX_SECTIONS];
-  return base.filter((s) => !dropCanonical.has(s.name));
-}
-
-// src/commands/yandex-analysis/run-batch.ts
-async function runWithConcurrency6(tasks, concurrency) {
-  const results = new Array(tasks.length);
-  let cursor = 0;
-  const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
-    while (true) {
-      const i = cursor++;
-      if (i >= tasks.length) return;
-      results[i] = await tasks[i]();
-    }
-  });
-  await Promise.all(workers);
-  return results;
-}
-async function runAllYandexSections(opts) {
-  const id = assertYandexAccountId(opts.account);
-  const config = loadConfig(opts.token);
-  if (!opts.jsonOut?.trim()) {
-    console.error("\n\u274C \u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF08\u5404\u7EF4\u5EA6\u843D\u76D8\u540E\u7531 report-manifest \u7D22\u5F15\uFF09\u3002\n");
-    process.exit(1);
-  }
-  const targets = resolveSectionList5(opts.sections, opts.exclude);
-  if (targets.length === 0) {
-    console.error("\n\u274C \u6CA1\u6709\u8981\u6267\u884C\u7684 section\uFF08\u8BF7\u68C0\u67E5 --sections / --exclude\uFF09\u3002\n");
-    process.exit(1);
-  }
-  const { startDate, endDate } = resolveYandexDateRange(opts.start, opts.end);
-  const concurrency = Math.max(
-    1,
-    Math.min(typeof opts.concurrency === "number" ? opts.concurrency : 5, 16)
-  );
-  const cliVersion = getCurrentVersion2();
-  const overallT0 = performance8.now();
-  const tasks = targets.map((def) => async () => {
-    const t0 = performance8.now();
-    const hint = endpointHintForYandexSection(def);
-    try {
-      const payload = await fetchYandexSectionPayload(
-        def,
-        { ...opts, start: startDate, end: endDate },
-        config,
-        id
-      );
-      const summary2 = await writeReportAnalysisSnapshot({
-        snapshotDir: opts.jsonOut,
-        section: def.name,
-        accountId: id,
-        dateRange: { start: startDate, end: endDate },
-        payload,
-        cliVersion
-      });
-      return {
-        section: def.name,
-        ok: true,
-        elapsedMs: performance8.now() - t0,
-        file: summary2.writtenFiles[0],
-        endpointHint: hint
-      };
-    } catch (err) {
-      return {
-        section: def.name,
-        ok: false,
-        elapsedMs: performance8.now() - t0,
-        error: err instanceof Error ? err.message : String(err),
-        endpointHint: hint
-      };
-    }
-  });
-  const results = await runWithConcurrency6(tasks, concurrency);
-  const succeeded = results.filter((r) => r.ok).length;
-  const failed = results.length - succeeded;
-  const absoluteSnapshotDir = path43.resolve(opts.jsonOut);
-  const summary = {
-    kind: "siluzan-tso-yandex-analysis-snapshot-batch",
-    absoluteSnapshotDir,
-    manifestFile: reportManifestFile(id),
-    accountId: id,
-    totalSections: results.length,
-    succeeded,
-    failed,
-    concurrency,
-    elapsedMs: performance8.now() - overallT0,
-    results
-  };
-  console.log(JSON.stringify(summary));
-  if (failed > 0) process.exit(2);
-}
-
-// src/commands/yandex-analysis/render-report.ts
-import fs34 from "fs";
-import fsPromises7 from "fs/promises";
-import path45 from "path";
-import { fileURLToPath as fileURLToPath11 } from "url";
-
 // src/commands/yandex-analysis/merge-snapshot.ts
 import * as fs33 from "fs/promises";
-import * as path44 from "path";
+import * as path43 from "path";
 function asRecord26(value) {
   if (value && typeof value === "object" && !Array.isArray(value)) {
     return value;
@@ -134364,7 +134240,7 @@ function pickMetrics2(row, extras = []) {
 }
 async function loadSectionPayload3(snapshotDir, file) {
   try {
-    const raw = await fs33.readFile(path44.join(snapshotDir, file), "utf8");
+    const raw = await fs33.readFile(path43.join(snapshotDir, file), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -134384,7 +134260,7 @@ async function readManifest6(snapshotDir, accountId) {
   }
   for (const name2 of candidates) {
     try {
-      const raw = await fs33.readFile(path44.join(snapshotDir, name2), "utf8");
+      const raw = await fs33.readFile(path43.join(snapshotDir, name2), "utf8");
       const parsed = JSON.parse(raw);
       if (Array.isArray(parsed.artifacts) && parsed.artifacts.length > 0) return parsed;
     } catch {
@@ -134392,8 +134268,12 @@ async function readManifest6(snapshotDir, accountId) {
   }
   return null;
 }
+function normalizeYandexDailyDate(value) {
+  const m = /(\d{4}-\d{2}-\d{2})/.exec(String(value ?? "").trim());
+  return m?.[1] ?? "";
+}
 function parseYmd2(value) {
-  const s = String(value ?? "").trim().slice(0, 10);
+  const s = normalizeYandexDailyDate(value);
   const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(s);
   if (!m) return null;
   const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
@@ -134410,26 +134290,28 @@ function isoWeekKey(d) {
   const dow = (day.getDay() + 6) % 7;
   const weekStart = new Date(day);
   weekStart.setDate(weekStart.getDate() - dow);
+  const weekEnd = new Date(weekStart);
+  weekEnd.setDate(weekEnd.getDate() + 6);
   const thursday = new Date(weekStart);
   thursday.setDate(thursday.getDate() + 3);
   const yearStart = new Date(thursday.getFullYear(), 0, 1);
   const week = Math.floor((thursday.getTime() - yearStart.getTime()) / 864e5 / 7) + 1;
   const label = `W${String(week).padStart(2, "0")}`;
-  return { key: `${thursday.getFullYear()}-${label}`, label, weekStart };
+  return { key: `${thursday.getFullYear()}-${label}`, label, weekStart, weekEnd };
 }
 function aggregateDailyToWeekly(dailyRows) {
   const map = /* @__PURE__ */ new Map();
   for (const row of dailyRows) {
     const d = parseYmd2(row.date);
     if (!d) continue;
-    const { key, label, weekStart } = isoWeekKey(d);
+    const { key, label, weekStart, weekEnd } = isoWeekKey(d);
     let acc = map.get(key);
     if (!acc) {
       acc = {
         label,
         weekStart,
-        minDate: d,
-        maxDate: d,
+        weekEnd,
+        days: 0,
         spend: 0,
         impressions: 0,
         clicks: 0,
@@ -134437,20 +134319,21 @@ function aggregateDailyToWeekly(dailyRows) {
       };
       map.set(key, acc);
     }
-    if (d < acc.minDate) acc.minDate = d;
-    if (d > acc.maxDate) acc.maxDate = d;
+    acc.days += 1;
     acc.spend += num10(row.spend) ?? 0;
     acc.impressions += num10(row.impressions) ?? 0;
     acc.clicks += num10(row.clicks) ?? 0;
     acc.conversions += num10(row.conversions) ?? 0;
   }
   return [...map.values()].sort((a, b) => a.weekStart.getTime() - b.weekStart.getTime()).map((acc) => {
-    const days = Math.floor((acc.maxDate.getTime() - acc.minDate.getTime()) / 864e5) + 1;
+    const startDate = formatYmd2(acc.weekStart);
+    const endDate = formatYmd2(acc.weekEnd);
     return {
       weekLabel: acc.label,
-      startDate: formatYmd2(acc.minDate),
-      endDate: formatYmd2(acc.maxDate),
-      days,
+      isoWeek: acc.label,
+      startDate,
+      endDate,
+      days: acc.days,
       spend: round25(acc.spend),
       impressions: Math.round(acc.impressions),
       clicks: Math.round(acc.clicks),
@@ -134461,10 +134344,25 @@ function aggregateDailyToWeekly(dailyRows) {
     };
   });
 }
+function prepareYandexDailyPayload(payload) {
+  const obj = asRecord26(payload) ?? {};
+  const items2 = asItems(obj).map((r) => {
+    const date = normalizeYandexDailyDate(r.date);
+    return date ? { ...r, date } : r;
+  });
+  return { ...obj, items: items2, weekly: aggregateDailyToWeekly(items2) };
+}
+var YANDEX_DAILY_OUTLINE_HINTS = [
+  "// `items[].date` \u5DF2\u89C4\u8303\u4E3A YYYY-MM-DD\u3002\u63A5\u53E3\u53EF\u80FD\u8FD4\u56DE ISO \u65F6\u95F4\u6233\uFF08\u5982 2026-07-01T00:00:00+00:00\uFF09\uFF0CCLI \u5DF2\u622A\u65AD\uFF1B\u7981\u6B62\u518D\u62FC\u63A5 T00:00:00Z\uFF0C\u5426\u5219 new Date() \u4F1A Invalid Date\uFF0C\u5468\u6807\u7B7E\u53D8\u6210 NaN\u3002",
+  "// \u5468\u8D8B\u52BF\u8BFB\u672C\u6587\u4EF6 `weekly[]`\uFF08ISO \u5468\u4E00~\u5468\u65E5\uFF1B`days` \u4E3A\u6709\u6570\u636E\u7684\u5929\u6570\uFF09\u3002\u7981\u6B62\u81EA\u884C\u6309 date \u805A\u5468\u3002"
+];
+function buildYandexOutlineHints(section) {
+  if (section === "daily") return YANDEX_DAILY_OUTLINE_HINTS;
+  return void 0;
+}
 function mapDailyRows(payload) {
   return asItems(payload).map((r) => {
-    const dateRaw = r.date;
-    const date = typeof dateRaw === "string" ? dateRaw.slice(0, 10) : dateRaw != null ? String(dateRaw).slice(0, 10) : "";
+    const date = normalizeYandexDailyDate(r.date);
     return pickMetrics2({ ...r, date }, ["date"]);
   });
 }
@@ -134518,7 +134416,7 @@ function mapDeviceRows2(payload) {
   return asItems(payload).map((r) => pickMetrics2(r, ["device", "network"]));
 }
 async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
-  const absDir = path44.resolve(snapshotDir);
+  const absDir = path43.resolve(snapshotDir);
   const metaAccountId = typeof asRecord26(payload.meta)?.accountId === "string" ? asRecord26(payload.meta)?.accountId : void 0;
   const manifest = await readManifest6(snapshotDir, metaAccountId);
   if (!manifest) {
@@ -134595,6 +134493,132 @@ async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
   return { ...payload, meta, kpis, tables };
 }
 
+// src/commands/yandex-analysis/resolve-sections.ts
+function normalizeSectionToken4(raw) {
+  const t = raw.trim();
+  if (!t) return null;
+  if (YANDEX_SECTION_NAMES.includes(t)) {
+    return t;
+  }
+  return YANDEX_SECTION_ALIASES[t] ?? null;
+}
+function resolveSectionList5(sections, exclude) {
+  const splitClean = (s) => (s ?? "").split(",").map((x) => x.trim()).filter(Boolean);
+  const include = splitClean(sections);
+  const dropRaw = splitClean(exclude);
+  const unknown = [...include, ...dropRaw].filter((n) => normalizeSectionToken4(n) === null);
+  if (unknown.length > 0) {
+    console.error(
+      `
+\u274C \u672A\u77E5\u7684 section \u540D\u79F0\uFF1A${unknown.join(", ")}
+   \u53EF\u9009\uFF1A${YANDEX_SECTION_NAMES.join(", ")}
+   \u522B\u540D\uFF1A${Object.keys(YANDEX_SECTION_ALIASES).join(", ")}
+`
+    );
+    process.exit(1);
+  }
+  const includeCanonical = new Set(include.map((n) => normalizeSectionToken4(n)).filter(Boolean));
+  const dropCanonical = new Set(dropRaw.map((n) => normalizeSectionToken4(n)).filter(Boolean));
+  const base = include.length > 0 ? YANDEX_SECTIONS.filter((s) => includeCanonical.has(s.name)) : [...YANDEX_SECTIONS];
+  return base.filter((s) => !dropCanonical.has(s.name));
+}
+
+// src/commands/yandex-analysis/run-batch.ts
+async function runWithConcurrency6(tasks, concurrency) {
+  const results = new Array(tasks.length);
+  let cursor = 0;
+  const workers = new Array(Math.max(1, Math.min(concurrency, tasks.length))).fill(0).map(async () => {
+    while (true) {
+      const i = cursor++;
+      if (i >= tasks.length) return;
+      results[i] = await tasks[i]();
+    }
+  });
+  await Promise.all(workers);
+  return results;
+}
+async function runAllYandexSections(opts) {
+  const id = assertYandexAccountId(opts.account);
+  const config = loadConfig(opts.token);
+  if (!opts.jsonOut?.trim()) {
+    console.error("\n\u274C \u5FC5\u987B\u4F20 --json-out <\u76EE\u5F55>\uFF08\u5404\u7EF4\u5EA6\u843D\u76D8\u540E\u7531 report-manifest \u7D22\u5F15\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const targets = resolveSectionList5(opts.sections, opts.exclude);
+  if (targets.length === 0) {
+    console.error("\n\u274C \u6CA1\u6709\u8981\u6267\u884C\u7684 section\uFF08\u8BF7\u68C0\u67E5 --sections / --exclude\uFF09\u3002\n");
+    process.exit(1);
+  }
+  const { startDate, endDate } = resolveYandexDateRange(opts.start, opts.end);
+  const concurrency = Math.max(
+    1,
+    Math.min(typeof opts.concurrency === "number" ? opts.concurrency : 5, 16)
+  );
+  const cliVersion = getCurrentVersion2();
+  const overallT0 = performance8.now();
+  const tasks = targets.map((def) => async () => {
+    const t0 = performance8.now();
+    const hint = endpointHintForYandexSection(def);
+    try {
+      const raw = await fetchYandexSectionPayload(
+        def,
+        { ...opts, start: startDate, end: endDate },
+        config,
+        id
+      );
+      const payload = def.name === "daily" ? prepareYandexDailyPayload(raw) : raw;
+      const summary2 = await writeReportAnalysisSnapshot({
+        snapshotDir: opts.jsonOut,
+        section: def.name,
+        accountId: id,
+        dateRange: { start: startDate, end: endDate },
+        payload,
+        cliVersion,
+        outlineExtraHints: buildYandexOutlineHints(def.name)
+      });
+      return {
+        section: def.name,
+        ok: true,
+        elapsedMs: performance8.now() - t0,
+        file: summary2.writtenFiles[0],
+        endpointHint: hint
+      };
+    } catch (err) {
+      return {
+        section: def.name,
+        ok: false,
+        elapsedMs: performance8.now() - t0,
+        error: err instanceof Error ? err.message : String(err),
+        endpointHint: hint
+      };
+    }
+  });
+  const results = await runWithConcurrency6(tasks, concurrency);
+  const succeeded = results.filter((r) => r.ok).length;
+  const failed = results.length - succeeded;
+  const absoluteSnapshotDir = path44.resolve(opts.jsonOut);
+  const summary = {
+    kind: "siluzan-tso-yandex-analysis-snapshot-batch",
+    absoluteSnapshotDir,
+    manifestFile: reportManifestFile(id),
+    accountId: id,
+    totalSections: results.length,
+    succeeded,
+    failed,
+    concurrency,
+    elapsedMs: performance8.now() - overallT0,
+    results
+  };
+  console.log(JSON.stringify(summary));
+  if (failed > 0) process.exit(2);
+}
+
+// src/commands/yandex-analysis/render-report.ts
+import fs34 from "fs";
+import fsPromises7 from "fs/promises";
+import path45 from "path";
+import { fileURLToPath as fileURLToPath11 } from "url";
+
 // src/commands/yandex-analysis/report-content.ts
 var SECTION_KEYS4 = [
   "overview",
@@ -134735,6 +134759,19 @@ function validateYandexPeriodReportContent(data) {
     );
   }
   const tables = asRecord27(data.tables) ?? {};
+  const weeklyRows = asArray7(tables.weekly).map((r) => asRecord27(r)).filter((r) => r != null);
+  for (const [i, row] of weeklyRows.entries()) {
+    const label = `${row.weekLabel ?? ""} ${row.startDate ?? ""} ${row.endDate ?? ""}`;
+    if (/nan/i.test(label) || !normalizeYandexDailyDate(row.startDate) || !normalizeYandexDailyDate(row.endDate)) {
+      pushMissing6(
+        missing,
+        `tables-weekly-${i}`,
+        "\u2467\u65E5\u671F/\u5468\u62A5",
+        `tables.weekly[${i}]`,
+        "\u5468\u6807\u7B7E/\u8D77\u6B62\u65E5\u671F\u65E0\u6548\uFF08\u542B NaN \u6216\u975E YYYY-MM-DD\uFF09\u3002\u8BF7\u4F20 --snapshot-dir\uFF0C\u7531 CLI \u4ECE daily \u805A\u5408 weekly\uFF0C\u7981\u6B62\u81EA\u884C\u6309 date \u62FC T00:00:00Z \u805A\u5468\u3002"
+      );
+    }
+  }
   const rowInsights = asRecord27(narrative.rowInsights) ?? {};
   const rowInsightCoverage = {};
   for (const spec of ROW_INSIGHT_SPECS) {
@@ -134822,6 +134859,19 @@ function asRecord28(value) {
   }
   throw new Error("\u62A5\u544A\u6570\u636E\u987B\u4E3A JSON \u5BF9\u8C61");
 }
+function refreshWeeklyFromDaily(data) {
+  const tables = data.tables;
+  if (!tables || typeof tables !== "object" || Array.isArray(tables)) return data;
+  const daily = Array.isArray(tables.daily) ? tables.daily : [];
+  if (daily.length === 0) return data;
+  return {
+    ...data,
+    tables: {
+      ...tables,
+      weekly: aggregateDailyToWeekly(daily)
+    }
+  };
+}
 function injectReportData7(html, payload) {
   const json = JSON.stringify(payload).replace(/</g, "\\u003c");
   if (!html.includes(INJECT_MARKER6)) {
@@ -134835,6 +134885,7 @@ async function runYandexAnalysisRender(opts) {
   if (opts.snapshotDir?.trim()) {
     data = await mergeYandexAnalysisSnapshotIntoReport(data, path45.resolve(opts.snapshotDir));
   }
+  data = refreshWeeklyFromDaily(data);
   const contentCheck = validateYandexPeriodReportContent(data);
   if (!contentCheck.ok) {
     console.error(`

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.45-beta.4",
-  "publishedAt": 1786689638774
+  "version": "1.1.45",
+  "publishedAt": 1786695850282
 }

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-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---

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

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

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

@@ -126,7 +126,7 @@ siluzan-tso config show
 
 ### 充值页链接（按媒体 × 类型）
 
-链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.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-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
 ## Contents

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-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 
 ---

package/dist/skill/references/analytics/account-analytics.md

@@ -405,7 +405,7 @@ siluzan-tso yandex-analysis render \
   --out ./yandex-period-report.html
 ```
 
-`search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。无 Metrica / 写操作。报告模板：`report-templates/yandex-period-report.md`（8 个分析章节必写总结+建议；`tables.weekly` 由 daily 聚合）。
+`search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。无 Metrica / 写操作。报告模板：`report-templates/yandex-period-report.md`（8 个分析章节必写总结+建议；周趋势读落盘 `daily.weekly[]`，**禁止**自行按 `date` 聚周）。
 
 ---
 

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

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
+知识库管理页面在 https://www.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-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` |
+| 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` |
 
 `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-ci.siluzan.com
+# webUrl: https://www.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

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

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

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

@@ -6,7 +6,7 @@
 siluzan-tso config show   # 取 webUrl
 ```
 
-首页地址：`https://www-ci.siluzan.com/v3/foreign_trade/tso/home`
+首页地址：`https://www.siluzan.com/v3/foreign_trade/tso/home`
 
 ---
 
@@ -25,7 +25,7 @@ siluzan-tso config show   # 取 webUrl
 
 ## 推荐话术
 
-1. **「和首页一样的总览」** → 打开 `https://www-ci.siluzan.com/v3/foreign_trade/tso/home`。
+1. **「和首页一样的总览」** → 打开 `https://www.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/yandex-period-report-excel.md

@@ -35,7 +35,7 @@
 | --------------- | ------------------------- | ---------------------------- |
 | 账户总览        | `overview`                | 对象：`totals` / `balance` … |
 | 日报表          | `daily`                   | `items[]`                    |
-| 周报表          | （无）                    | 脚本按 ISO 周聚合 `daily`    |
+| 周报表          | `daily` 的 `weekly[]`     | **读落盘 weekly，禁止自行聚周** |
 | Search 网络     | `search`                  | `items[]`                    |
 | 广告系列        | `campaigns`               | `items[]`                    |
 | 关键词          | `keywords`                | `items[]`                    |
@@ -78,7 +78,7 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 | 地域     | `locationName` / `targetingLocationName`                                      |
 | 设备     | `device`                                                                      |
 | 日报     | `date`                                                                        |
-| 周报     | `weekLabel`、`startDate`、`endDate`、`days`（脚本生成）                       |
+| 周报     | `daily.weekly[]` 的 `weekLabel`、`startDate`、`endDate`、`days`（CLI 已算） |
 
 **账户总览 Sheet**：KPI 区（余额、本期消耗、日均、点击、CTR、CPC、转化）+ **全部叙事**（执行摘要、各维总结/建议、≥3 条跨维优化建议）写在本 Sheet；列表 Sheet 仅数据表。
 
@@ -90,6 +90,7 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 | ------------------------------------ | ---------------------------------------------------- |
 | 把 `ctr` 当已是百分数再 ÷100         | 落盘为 0~1；Excel 用百分比格式或 `*100` 后加 `%`     |
 | 编造学习期、搜索词分类等无接口硬事实 | 无字段且算不出则不写该列；关键词翻译走 rowInsights   |
+| 自行按 `daily.date` 聚周（易出 `NaN-NaN-NaN`） | 读 `daily.weekly[]`；`date` 已是 YYYY-MM-DD，禁止再拼 `T00:00:00Z` |
 | `campaignId` 写成数字                | `String(id)` + 文本格式                              |
 | search-terms 拉超过 180 天           | 缩短区间或排除该维                                   |
 

package/dist/skill/references/report-templates/yandex-period-report.md

@@ -6,12 +6,12 @@
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止** Agent 手写/拼接 HTML。  
 > **用户明确要求 Excel / xlsx** 时：拉数步骤不变，改为 Agent 脚本写 `.xlsx`；**不要**调用 `yandex-analysis render`；禁止假设存在内置 excel 子命令。见 `yandex-period-report-excel.md`。
 
-数据块（YandexAPI `/yandex-analysis` 8 维 + 本地周聚合）：总览、按日、Search 网络、系列、关键词、搜索词、地域、设备；周报由 `daily` 本地聚合（后端无独立 weekly）。
+数据块（YandexAPI `/yandex-analysis` 8 维 + 本地周聚合）：总览、按日、Search 网络、系列、关键词、搜索词、地域、设备；周报由 CLI 写入 `daily.weekly`（后端无独立 weekly）。**禁止**自行按 `date` 聚周。
 
 | CLI `--sections` | 落盘形状（CI 实测）                                      | 报告 `tables.*` / KPI                                      |
 | ---------------- | -------------------------------------------------------- | ---------------------------------------------------------- |
 | `overview`       | 对象：`account` / `currency` / `balance` / `totals` …    | → `meta` + `kpis`（余额、日均、续航天数）                  |
-| `daily`          | `{ account, startDate, endDate, items: DayRow[] }`       | → `tables.daily[]`；并聚合 → `tables.weekly[]`             |
+| `daily`          | `{ account, startDate, endDate, items: DayRow[], weekly: WeekRow[] }` | → `tables.daily[]` + `tables.weekly[]`（勿重算） |
 | `search`         | `{ …, items: SearchRow[] }`                              | → `tables.search[]`                                        |
 | `campaigns`      | `{ …, items: CampaignRow[] }`（默认 limit=100）          | → `tables.campaigns[]`                                     |
 | `keywords`       | `{ …, items: KeywordRow[] }`                             | → `tables.keywords[]`                                      |
@@ -28,7 +28,7 @@
 | 步骤             | 执行者       | 动作                                                                                                                                     |
 | ---------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
 | **1. 拉数**      | Agent 调 CLI | `yandex-analysis -a <porg-xxx> --start <s> --end <e> --json-out ./snap-yandex`（全 8 维或 `--sections` 指定子集）                        |
-| **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），对照 outline 完成聚合与洞察                                           |
+| **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`）。周趋势读 `daily-*.json` 的 `weekly[]`，**禁止**自己按 `date` 聚周。 |
 | **3. 写 JSON**   | Agent        | 撰写 `yandex-period-report.json`：仅 `meta.accountId` + `narrative`（8 个分析章节）为必填；`kpis`/`tables` 可省略由 `--snapshot-dir` 合并 |
 | **4. 渲染 HTML** | CLI          | `yandex-analysis render` — **校验 narrative 8 个分析章节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                   |
 
@@ -49,7 +49,7 @@ siluzan-tso yandex-analysis render \
 - `kpis`：`spend` / `impressions` / `clicks` / `conversions` / `ctr` / `averageCpc` / `costPerConversion` / `conversionRate` / `roi` / `balance` / `avgDailySpend` / `activeDays` / `runwayDays` / `balanceAsOf`；可省略。
 - `tables`（可省略，由 `--snapshot-dir` 映射）：
   - `daily[]`：`{date, spend, impressions, clicks, ctr, averageCpc, conversions, …}`
-  - `weekly[]`：`{weekLabel, startDate, endDate, days, spend, impressions, clicks, ctr, averageCpc, conversions, costPerConversion}`（CLI 由 daily 聚合）
+  - `weekly[]`：`{weekLabel, isoWeek, startDate, endDate, days, spend, …}`（**只读** CLI 已算好的周；`startDate`/`endDate` 为该 ISO 周周一~周日，`days` 为有数据的天数。禁止自填）
   - `search[]`：`{network, spend, …}`
   - `campaigns[]`：`{campaignId, campaignName, status, state, campaignType, budget, strategy, …metrics}`
   - `keywords[]`：`{keyword, campaignName, criteriaType, network, …metrics}`
@@ -60,15 +60,14 @@ siluzan-tso yandex-analysis render \
   - `executiveSummary[]`：≥1 段执行摘要
   - `sections.{overview,search,campaigns,keywords,searchTerms,geo,devices,daily}`：每个维度各 `{analysis[]（≥1，含数字依据）, suggestions[]（≥1）}`
   - `recommendations[]`：≥3 条跨维度优化建议（可用 `{priority,text,anchor}`，anchor 对齐样例锚点如 `#keyword` / `#query`）
-  - `rowInsights`：有关键词表格行时，**HTML 将展示的 Top N 行必须有中文翻译**；`render` 缺项会拒绝出 HTML。问题/建议可空。见下方「逐行洞察」
+  - `rowInsights`：有关键词表格行时，**HTML 将展示的 Top N 行必须有中文翻译**；`render` 缺项会拒绝出 HTML。见下方「逐行洞察」。Campaign / 关键词 / 搜索词 / 地域 / 设备列表**不展示**「问题」「建议」列，行级判断写入各维 `sections.*.analysis/suggestions` 即可。
 
 #### 逐行洞察 `narrative.rowInsights`
 
-开发样例的部分表格列（关键词"中文翻译"、各维度"问题/建议"）不是原始接口字段，而是 **Agent 基于已拉取数据做的翻译/判断**：
+表格主观列目前只有关键词「中文翻译」，不是原始接口字段，由 Agent 基于已拉取原文翻译：
 
 - **必填（`render` 校验）**：`tables.keywords` 有行时，须为 HTML 将展示的每一行（按消耗降序，最多 40 行）提供匹配的 `rowInsights`，且有非空 `translation`。缺一项即拒绝生成 HTML。
-- **可空**：各维 `issue` / `suggestion`（空表示该行无问题，模板显示「—」）。
-- 搜索词「分类」Yandex 不提供，也无法由现有指标算出，报告不展示该列。
+- Campaign「学习期」、搜索词「分类」、各维行级「问题/建议」均不展示。
 
 示例：
 
@@ -77,25 +76,13 @@ siluzan-tso yandex-analysis render \
   "rowInsights": {
     // 按 keyword 原文匹配（如同词跨系列，可加 campaignName 消歧）
     "keywords": [
-      { "match": { "keyword": "металлопрокатное оборудование" }, "translation": "金属轧制设备", "issue": "", "suggestion": "可加大预算" }
-    ],
-    // 按 searchQuery 原文匹配
-    "searchTerms": [
-      { "match": { "searchQuery": "прокатный стан своими руками" }, "issue": "DIY 意图消耗", "suggestion": "添加否定短语 своими руками" }
-    ],
-    // 按 campaignName 匹配
-    "campaigns": [
-      { "match": { "campaignName": "Search - 自动定向" }, "issue": "自动定向 CTR 弱", "suggestion": "评估降价或暂停" }
-    ],
-    // 按 locationName（城市名）匹配
-    "geo": [{ "match": { "locationName": "Moscow" }, "issue": "", "suggestion": "" }],
-    // 按 device 匹配
-    "devices": [{ "match": { "device": "tablet" }, "issue": "样本不足", "suggestion": "暂不调整设备系数" }]
+      { "match": { "keyword": "металлопрокатное оборудование" }, "translation": "金属轧制设备" }
+    ]
   }
 }
 ```
 
-- `translation` 是 Agent **对已知原文的翻译**，允许生成；不得编造原始接口没有、也无法由现有指标算出的硬事实。Campaign「学习期」、搜索词「分类」无数据源，报告不展示这两列。
+- `translation` 是 Agent **对已知原文的翻译**，允许生成；不得编造原始接口没有、也无法由现有指标算出的硬事实。
 - 每条洞察按原文匹配一行；HTML 将展示的关键词行若缺中文翻译，`render` 会拒绝出 HTML。
 
 ### 快照合并范围（`--snapshot-dir`）
@@ -104,9 +91,17 @@ siluzan-tso yandex-analysis render \
 
 1. `meta`（仅补空字段）
 2. **`kpis` / `tables.*` 一律以 CLI 快照覆盖**（有对应 section 时）
-3. `tables.weekly` 由 `daily.items` 本地 ISO 周聚合
+3. `tables.weekly` 由 CLI 从 `daily.items` 按 ISO 周重算并覆盖（与落盘 `daily.weekly` 同一套函数）
 
-Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kpis`/`tables` 数值。
+Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kpis`/`tables` 数值，**禁止**自行聚周。
+
+### 周趋势（禁止再出现 NaN）
+
+网关 `daily.items[].date` 可能是 ISO 时间戳（`2026-07-01T00:00:00+00:00`）。CLI 落盘时已截成 `YYYY-MM-DD`，并写好 `weekly[]`。
+
+- 写「周趋势」叙事时：**脚本读 `weekly[]`**（`weekLabel` / `startDate` / `endDate` / `spend` / `conversions` / `days`）。
+- **禁止** `new Date(date + 'T00:00:00Z')`：日期已是完整时间戳时再拼接会变成 Invalid Date，年份/月份变成 `NaN`，报告出现 `NaN-NaN-NaN`。
+- **禁止**自己算 ISO 周、自己拆周。周末无投放时 `days` 会小于 7，属正常。
 
 ---
 
@@ -130,7 +125,8 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 
 - 写脚本前先读各 `yandex-*-<id>.outline.txt`（或 stdout 摘要里的 outline），再脚本读 `.json`。
 - `search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。
-- Campaign「学习期」、搜索词「分类」无接口字段、也无法由现有指标算出，报告不展示这两列。关键词中文翻译可由 Agent 通过 `narrative.rowInsights` 提供（见上方「逐行洞察」）。
+- 周趋势读 `daily-*.json` 的 `weekly[]`，禁止自行聚周、禁止给 `date` 再拼 `T00:00:00Z`。
+- Campaign「学习期」、搜索词「分类」、各维行级「问题/建议」均不展示。关键词中文翻译可由 Agent 通过 `narrative.rowInsights` 提供（见上方「逐行洞察」）。
 
 ---
 

package/dist/skill/report-templates/yandex-period-report-excel.md

@@ -35,7 +35,7 @@
 | --------------- | ------------------------- | ---------------------------- |
 | 账户总览        | `overview`                | 对象：`totals` / `balance` … |
 | 日报表          | `daily`                   | `items[]`                    |
-| 周报表          | （无）                    | 脚本按 ISO 周聚合 `daily`    |
+| 周报表          | `daily` 的 `weekly[]`     | **读落盘 weekly，禁止自行聚周** |
 | Search 网络     | `search`                  | `items[]`                    |
 | 广告系列        | `campaigns`               | `items[]`                    |
 | 关键词          | `keywords`                | `items[]`                    |
@@ -78,7 +78,7 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 | 地域     | `locationName` / `targetingLocationName`                                      |
 | 设备     | `device`                                                                      |
 | 日报     | `date`                                                                        |
-| 周报     | `weekLabel`、`startDate`、`endDate`、`days`（脚本生成）                       |
+| 周报     | `daily.weekly[]` 的 `weekLabel`、`startDate`、`endDate`、`days`（CLI 已算） |
 
 **账户总览 Sheet**：KPI 区（余额、本期消耗、日均、点击、CTR、CPC、转化）+ **全部叙事**（执行摘要、各维总结/建议、≥3 条跨维优化建议）写在本 Sheet；列表 Sheet 仅数据表。
 
@@ -90,6 +90,7 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 | ------------------------------------ | ---------------------------------------------------- |
 | 把 `ctr` 当已是百分数再 ÷100         | 落盘为 0~1；Excel 用百分比格式或 `*100` 后加 `%`     |
 | 编造学习期、搜索词分类等无接口硬事实 | 无字段且算不出则不写该列；关键词翻译走 rowInsights   |
+| 自行按 `daily.date` 聚周（易出 `NaN-NaN-NaN`） | 读 `daily.weekly[]`；`date` 已是 YYYY-MM-DD，禁止再拼 `T00:00:00Z` |
 | `campaignId` 写成数字                | `String(id)` + 文本格式                              |
 | search-terms 拉超过 180 天           | 缩短区间或排除该维                                   |
 

package/dist/skill/report-templates/yandex-period-report.html

@@ -380,9 +380,26 @@
     return String(v ?? "").trim().toLowerCase();
   }
 
+  /** 周区间文案：含 NaN 时回退，避免脚本误聚周把 Invalid Date 写进表格。 */
+  function weekRangeText(r) {
+    const start = String((r && r.startDate) || "").trim();
+    const end = String((r && r.endDate) || "").trim();
+    const joined = start && end ? start + " ~ " + end : start || end;
+    if (joined && !/nan/i.test(joined)) return joined;
+    const label = String((r && r.weekLabel) || "").trim();
+    if (label && !/nan/i.test(label)) return label;
+    return "—";
+  }
+
+  function weekLabelText(r) {
+    const label = String((r && (r.isoWeek || r.weekLabel)) || "").trim();
+    if (label && !/nan/i.test(label)) return label;
+    return "—";
+  }
+
   /**
-   * 从 Agent 可选提供的 `narrative.rowInsights.<dim>[]` 里按主字段（如关键词原文/搜索词原文）
-   * 找匹配行的洞察（翻译/分类/问题/建议）。找不到返回 null——渲染层一律显示「—」，不编造内容。
+   * 从 Agent 提供的 `narrative.rowInsights.<dim>[]` 按主字段匹配行洞察（目前仅关键词中文翻译）。
+   * 找不到返回 null——渲染层显示「—」，不编造内容。
    * 每条洞察支持 `{match:{...}, ...}` 或扁平写法 `{keyword, campaignName, ...}`。
    */
   function findInsight(list, primaryField, primaryValue, row) {
@@ -541,9 +558,9 @@
         .map(function (r) {
           return (
             "<tr><td>" +
-            escapeHtml(r.weekLabel || "") +
+            escapeHtml(weekLabelText(r)) +
             "</td><td>" +
-            escapeHtml((r.startDate || "") + " ~ " + (r.endDate || "")) +
+            escapeHtml(weekRangeText(r)) +
             '</td><td class="num">' +
             int(r.days) +
             '</td><td class="num">' +
@@ -852,9 +869,9 @@
           .map(function (r) {
             return (
               "<tr><td>" +
-              escapeHtml(r.weekLabel || "") +
+              escapeHtml(weekLabelText(r)) +
               "</td><td>" +
-              escapeHtml((r.startDate || "") + " ~ " + (r.endDate || "")) +
+              escapeHtml(weekRangeText(r)) +
               '</td><td class="num">' +
               int(r.days) +
               '</td><td class="num">' +
@@ -883,7 +900,7 @@
       "</div>" +
       "</div></section>" +
       '<section id="weekly"><div class="wrap">' +
-      sectionHead("周报表", "由每日数据按 ISO 周本地聚合") +
+      sectionHead("周报表", "由 CLI 从 daily 按 ISO 周聚合（禁止脚本重算）") +
       '<div class="panel">' +
       weeklyBody +
       "</div>" +
@@ -963,16 +980,8 @@
           { label: "Conv", num: true },
           { label: "CPA", num: true },
           { label: "状态" },
-          { label: "问题" },
-          { label: "建议" },
         ],
-        rowCells: function (r, currency, data) {
-          const insight = findInsight(
-            rowInsightsOf(data, "campaigns"),
-            "campaignName",
-            r.campaignName,
-            r
-          );
+        rowCells: function (r, currency) {
           return (
             "<td>" +
             escapeHtml(r.campaignName || r.campaignId || "—") +
@@ -996,10 +1005,6 @@
             money(r.costPerConversion, currency) +
             "</td><td>" +
             campaignStatusBadge(r) +
-            "</td><td>" +
-            escapeHtml((insight && insight.issue) || "—") +
-            "</td><td>" +
-            escapeHtml((insight && insight.suggestion) || "—") +
             "</td>"
           );
         },
@@ -1015,7 +1020,7 @@
         title: "关键词",
         desc: "按消耗排序的关键词明细",
         footnote:
-          "「中文翻译」「问题/建议」为 Agent 撰写报告时提供（narrative.rowInsights.keywords），未提供的行显示「—」，不做机械占位。",
+          "「中文翻译」为 Agent 撰写报告时提供（narrative.rowInsights.keywords），未提供的行显示「—」，不做机械占位。",
         headers: [
           { label: "Campaign" },
           { label: "Group" },
@@ -1029,8 +1034,6 @@
           { label: "CPA", num: true },
           { label: "CTR", num: true },
           { label: "CPC", num: true },
-          { label: "问题" },
-          { label: "建议" },
         ],
         rowCells: function (r, currency, data) {
           const insight = findInsight(rowInsightsOf(data, "keywords"), "keyword", r.keyword, r);
@@ -1059,10 +1062,6 @@
             pct(derivedCtr(r)) +
             '</td><td class="num">' +
             money(derivedCpc(r), currency) +
-            "</td><td>" +
-            escapeHtml((insight && insight.issue) || "—") +
-            "</td><td>" +
-            escapeHtml((insight && insight.suggestion) || "—") +
             "</td>"
           );
         },
@@ -1077,8 +1076,6 @@
         tableKey: "searchTerms",
         title: "搜索词",
         desc: "按消耗排序的搜索词明细（仅近 180 天数据）",
-        footnote:
-          "「问题/建议」为 Agent 撰写报告时提供（narrative.rowInsights.searchTerms），未提供的行显示「—」，不做机械占位。",
         headers: [
           { label: "Search Query" },
           { label: "匹配关键词" },
@@ -1090,16 +1087,8 @@
           { label: "Conv", num: true },
           { label: "cr%", num: true },
           { label: "CPA", num: true },
-          { label: "问题" },
-          { label: "建议" },
         ],
-        rowCells: function (r, currency, data) {
-          const insight = findInsight(
-            rowInsightsOf(data, "searchTerms"),
-            "searchQuery",
-            r.searchQuery,
-            r
-          );
+        rowCells: function (r, currency) {
           return (
             "<td>" +
             escapeHtml(r.searchQuery || "—") +
@@ -1121,10 +1110,6 @@
             pct(derivedCr(r)) +
             '</td><td class="num">' +
             money(derivedCpa(r), currency) +
-            "</td><td>" +
-            escapeHtml((insight && insight.issue) || "—") +
-            "</td><td>" +
-            escapeHtml((insight && insight.suggestion) || "—") +
             "</td>"
           );
         },
@@ -1151,8 +1136,6 @@
           { label: "Conv", num: true },
           { label: "cr%", num: true },
           { label: "CPA", num: true },
-          { label: "问题" },
-          { label: "建议" },
         ],
         rowCells: function (r, currency, data) {
           const cityName =
@@ -1161,7 +1144,6 @@
             r.location ||
             r.name ||
             (r.locationId != null ? "地域 " + r.locationId : "—");
-          const insight = findInsight(rowInsightsOf(data, "geo"), "locationName", cityName, r);
           return (
             "<td>" +
             escapeHtml((data.meta && data.meta.region) || "—") +
@@ -1183,10 +1165,6 @@
             pct(derivedCr(r)) +
             '</td><td class="num">' +
             money(derivedCpa(r), currency) +
-            "</td><td>" +
-            escapeHtml((insight && insight.issue) || "—") +
-            "</td><td>" +
-            escapeHtml((insight && insight.suggestion) || "—") +
             "</td>"
           );
         },
@@ -1211,11 +1189,8 @@
           { label: "Conv", num: true },
           { label: "cr%", num: true },
           { label: "CPA", num: true },
-          { label: "问题" },
-          { label: "建议" },
         ],
-        rowCells: function (r, currency, data) {
-          const insight = findInsight(rowInsightsOf(data, "devices"), "device", r.device, r);
+        rowCells: function (r, currency) {
           return (
             "<td>" +
             escapeHtml(r.device || "—") +
@@ -1235,10 +1210,6 @@
             pct(derivedCr(r)) +
             '</td><td class="num">' +
             money(derivedCpa(r), currency) +
-            "</td><td>" +
-            escapeHtml((insight && insight.issue) || "—") +
-            "</td><td>" +
-            escapeHtml((insight && insight.suggestion) || "—") +
             "</td>"
           );
         },

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

@@ -6,12 +6,12 @@
 > 用户**未指定格式**时一律走下方 **标准四步流程**；**禁止** Agent 手写/拼接 HTML。  
 > **用户明确要求 Excel / xlsx** 时：拉数步骤不变，改为 Agent 脚本写 `.xlsx`；**不要**调用 `yandex-analysis render`；禁止假设存在内置 excel 子命令。见 `yandex-period-report-excel.md`。
 
-数据块（YandexAPI `/yandex-analysis` 8 维 + 本地周聚合）：总览、按日、Search 网络、系列、关键词、搜索词、地域、设备；周报由 `daily` 本地聚合（后端无独立 weekly）。
+数据块（YandexAPI `/yandex-analysis` 8 维 + 本地周聚合）：总览、按日、Search 网络、系列、关键词、搜索词、地域、设备；周报由 CLI 写入 `daily.weekly`（后端无独立 weekly）。**禁止**自行按 `date` 聚周。
 
 | CLI `--sections` | 落盘形状（CI 实测）                                      | 报告 `tables.*` / KPI                                      |
 | ---------------- | -------------------------------------------------------- | ---------------------------------------------------------- |
 | `overview`       | 对象：`account` / `currency` / `balance` / `totals` …    | → `meta` + `kpis`（余额、日均、续航天数）                  |
-| `daily`          | `{ account, startDate, endDate, items: DayRow[] }`       | → `tables.daily[]`；并聚合 → `tables.weekly[]`             |
+| `daily`          | `{ account, startDate, endDate, items: DayRow[], weekly: WeekRow[] }` | → `tables.daily[]` + `tables.weekly[]`（勿重算） |
 | `search`         | `{ …, items: SearchRow[] }`                              | → `tables.search[]`                                        |
 | `campaigns`      | `{ …, items: CampaignRow[] }`（默认 limit=100）          | → `tables.campaigns[]`                                     |
 | `keywords`       | `{ …, items: KeywordRow[] }`                             | → `tables.keywords[]`                                      |
@@ -28,7 +28,7 @@
 | 步骤             | 执行者       | 动作                                                                                                                                     |
 | ---------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
 | **1. 拉数**      | Agent 调 CLI | `yandex-analysis -a <porg-xxx> --start <s> --end <e> --json-out ./snap-yandex`（全 8 维或 `--sections` 指定子集）                        |
-| **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`），对照 outline 完成聚合与洞察                                           |
+| **2. 分析**      | Agent        | 用 **node/python 脚本**读落盘 JSON（勿用 Read 打开业务 `*.json`）。周趋势读 `daily-*.json` 的 `weekly[]`，**禁止**自己按 `date` 聚周。 |
 | **3. 写 JSON**   | Agent        | 撰写 `yandex-period-report.json`：仅 `meta.accountId` + `narrative`（8 个分析章节）为必填；`kpis`/`tables` 可省略由 `--snapshot-dir` 合并 |
 | **4. 渲染 HTML** | CLI          | `yandex-analysis render` — **校验 narrative 8 个分析章节必含字段**，缺项报错不生成 HTML；**禁止** Agent 手写/拼接 HTML                   |
 
@@ -49,7 +49,7 @@ siluzan-tso yandex-analysis render \
 - `kpis`：`spend` / `impressions` / `clicks` / `conversions` / `ctr` / `averageCpc` / `costPerConversion` / `conversionRate` / `roi` / `balance` / `avgDailySpend` / `activeDays` / `runwayDays` / `balanceAsOf`；可省略。
 - `tables`（可省略，由 `--snapshot-dir` 映射）：
   - `daily[]`：`{date, spend, impressions, clicks, ctr, averageCpc, conversions, …}`
-  - `weekly[]`：`{weekLabel, startDate, endDate, days, spend, impressions, clicks, ctr, averageCpc, conversions, costPerConversion}`（CLI 由 daily 聚合）
+  - `weekly[]`：`{weekLabel, isoWeek, startDate, endDate, days, spend, …}`（**只读** CLI 已算好的周；`startDate`/`endDate` 为该 ISO 周周一~周日，`days` 为有数据的天数。禁止自填）
   - `search[]`：`{network, spend, …}`
   - `campaigns[]`：`{campaignId, campaignName, status, state, campaignType, budget, strategy, …metrics}`
   - `keywords[]`：`{keyword, campaignName, criteriaType, network, …metrics}`
@@ -60,15 +60,14 @@ siluzan-tso yandex-analysis render \
   - `executiveSummary[]`：≥1 段执行摘要
   - `sections.{overview,search,campaigns,keywords,searchTerms,geo,devices,daily}`：每个维度各 `{analysis[]（≥1，含数字依据）, suggestions[]（≥1）}`
   - `recommendations[]`：≥3 条跨维度优化建议（可用 `{priority,text,anchor}`，anchor 对齐样例锚点如 `#keyword` / `#query`）
-  - `rowInsights`：有关键词表格行时，**HTML 将展示的 Top N 行必须有中文翻译**；`render` 缺项会拒绝出 HTML。问题/建议可空。见下方「逐行洞察」
+  - `rowInsights`：有关键词表格行时，**HTML 将展示的 Top N 行必须有中文翻译**；`render` 缺项会拒绝出 HTML。见下方「逐行洞察」。Campaign / 关键词 / 搜索词 / 地域 / 设备列表**不展示**「问题」「建议」列，行级判断写入各维 `sections.*.analysis/suggestions` 即可。
 
 #### 逐行洞察 `narrative.rowInsights`
 
-开发样例的部分表格列（关键词"中文翻译"、各维度"问题/建议"）不是原始接口字段，而是 **Agent 基于已拉取数据做的翻译/判断**：
+表格主观列目前只有关键词「中文翻译」，不是原始接口字段，由 Agent 基于已拉取原文翻译：
 
 - **必填（`render` 校验）**：`tables.keywords` 有行时，须为 HTML 将展示的每一行（按消耗降序，最多 40 行）提供匹配的 `rowInsights`，且有非空 `translation`。缺一项即拒绝生成 HTML。
-- **可空**：各维 `issue` / `suggestion`（空表示该行无问题，模板显示「—」）。
-- 搜索词「分类」Yandex 不提供，也无法由现有指标算出，报告不展示该列。
+- Campaign「学习期」、搜索词「分类」、各维行级「问题/建议」均不展示。
 
 示例：
 
@@ -77,25 +76,13 @@ siluzan-tso yandex-analysis render \
   "rowInsights": {
     // 按 keyword 原文匹配（如同词跨系列，可加 campaignName 消歧）
     "keywords": [
-      { "match": { "keyword": "металлопрокатное оборудование" }, "translation": "金属轧制设备", "issue": "", "suggestion": "可加大预算" }
-    ],
-    // 按 searchQuery 原文匹配
-    "searchTerms": [
-      { "match": { "searchQuery": "прокатный стан своими руками" }, "issue": "DIY 意图消耗", "suggestion": "添加否定短语 своими руками" }
-    ],
-    // 按 campaignName 匹配
-    "campaigns": [
-      { "match": { "campaignName": "Search - 自动定向" }, "issue": "自动定向 CTR 弱", "suggestion": "评估降价或暂停" }
-    ],
-    // 按 locationName（城市名）匹配
-    "geo": [{ "match": { "locationName": "Moscow" }, "issue": "", "suggestion": "" }],
-    // 按 device 匹配
-    "devices": [{ "match": { "device": "tablet" }, "issue": "样本不足", "suggestion": "暂不调整设备系数" }]
+      { "match": { "keyword": "металлопрокатное оборудование" }, "translation": "金属轧制设备" }
+    ]
   }
 }
 ```
 
-- `translation` 是 Agent **对已知原文的翻译**，允许生成；不得编造原始接口没有、也无法由现有指标算出的硬事实。Campaign「学习期」、搜索词「分类」无数据源，报告不展示这两列。
+- `translation` 是 Agent **对已知原文的翻译**，允许生成；不得编造原始接口没有、也无法由现有指标算出的硬事实。
 - 每条洞察按原文匹配一行；HTML 将展示的关键词行若缺中文翻译，`render` 会拒绝出 HTML。
 
 ### 快照合并范围（`--snapshot-dir`）
@@ -104,9 +91,17 @@ siluzan-tso yandex-analysis render \
 
 1. `meta`（仅补空字段）
 2. **`kpis` / `tables.*` 一律以 CLI 快照覆盖**（有对应 section 时）
-3. `tables.weekly` 由 `daily.items` 本地 ISO 周聚合
+3. `tables.weekly` 由 CLI 从 `daily.items` 按 ISO 周重算并覆盖（与落盘 `daily.weekly` 同一套函数）
 
-Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kpis`/`tables` 数值。
+Agent 只需撰写 `narrative`；**禁止手写 HTML**，也**禁止**自填 `kpis`/`tables` 数值，**禁止**自行聚周。
+
+### 周趋势（禁止再出现 NaN）
+
+网关 `daily.items[].date` 可能是 ISO 时间戳（`2026-07-01T00:00:00+00:00`）。CLI 落盘时已截成 `YYYY-MM-DD`，并写好 `weekly[]`。
+
+- 写「周趋势」叙事时：**脚本读 `weekly[]`**（`weekLabel` / `startDate` / `endDate` / `spend` / `conversions` / `days`）。
+- **禁止** `new Date(date + 'T00:00:00Z')`：日期已是完整时间戳时再拼接会变成 Invalid Date，年份/月份变成 `NaN`，报告出现 `NaN-NaN-NaN`。
+- **禁止**自己算 ISO 周、自己拆周。周末无投放时 `days` 会小于 7，属正常。
 
 ---
 
@@ -130,7 +125,8 @@ siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <E> --json-out ./sna
 
 - 写脚本前先读各 `yandex-*-<id>.outline.txt`（或 stdout 摘要里的 outline），再脚本读 `.json`。
 - `search` / `campaigns` / `keywords` / `geo` / `devices` 在 Direct 侧过滤 `AdNetworkType=SEARCH`。
-- Campaign「学习期」、搜索词「分类」无接口字段、也无法由现有指标算出，报告不展示这两列。关键词中文翻译可由 Agent 通过 `narrative.rowInsights` 提供（见上方「逐行洞察」）。
+- 周趋势读 `daily-*.json` 的 `weekly[]`，禁止自行聚周、禁止给 `date` 再拼 `T00:00:00Z`。
+- Campaign「学习期」、搜索词「分类」、各维行级「问题/建议」均不展示。关键词中文翻译可由 Agent 通过 `narrative.rowInsights` 提供（见上方「逐行洞察」）。
 
 ---
 

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.45-beta.4'
+$PKG_VERSION = '1.1.45'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
-$INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'
-$WEB_BASE    = 'https://www-ci.siluzan.com'
+$INSTALL_CMD = 'npm install -g siluzan-tso-cli'
+$WEB_BASE    = 'https://www.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.45-beta.4"
+readonly PKG_VERSION="1.1.45"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
-readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"
-readonly WEB_BASE="https://www-ci.siluzan.com"
+readonly INSTALL_CMD="npm install -g siluzan-tso-cli"
+readonly WEB_BASE="https://www.siluzan.com"
 
 # -- Constants ----------------------------------------------------------------
 readonly NODE_MAJOR_MIN=18

package/package.json

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