siluzan-tso-cli 1.1.46-beta.5 → 1.1.46-beta.6

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.46-beta.5），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.46-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -132169,7 +132169,14 @@ function parseLocalYmd(ymd) {
     return /* @__PURE__ */ new Date(NaN);
   }
   const [y, m, day] = parts;
-  return new Date(y, m - 1, day);
+  if (m < 1 || m > 12 || day < 1 || day > 31) {
+    return /* @__PURE__ */ new Date(NaN);
+  }
+  const d = new Date(y, m - 1, day);
+  if (d.getFullYear() !== y || d.getMonth() !== m - 1 || d.getDate() !== day) {
+    return /* @__PURE__ */ new Date(NaN);
+  }
+  return d;
 }
 function formatLocalYmd(d) {
   const y = d.getFullYear();
@@ -134371,7 +134378,14 @@ function parseLocalYmd2(ymd) {
     return /* @__PURE__ */ new Date(NaN);
   }
   const [y, m, day] = parts;
-  return new Date(y, m - 1, day);
+  if (m < 1 || m > 12 || day < 1 || day > 31) {
+    return /* @__PURE__ */ new Date(NaN);
+  }
+  const d = new Date(y, m - 1, day);
+  if (d.getFullYear() !== y || d.getMonth() !== m - 1 || d.getDate() !== day) {
+    return /* @__PURE__ */ new Date(NaN);
+  }
+  return d;
 }
 function formatLocalYmd2(d) {
   const y = d.getFullYear();
@@ -134502,6 +134516,11 @@ function num10(value) {
 function round25(value) {
   return value == null ? void 0 : Math.round(value * 100) / 100;
 }
+function normalizeYandexRoi(value) {
+  if (typeof value !== "number" && typeof value !== "string") return void 0;
+  const r = num10(value);
+  return r === -1 ? void 0 : r;
+}
 function asItems(payload) {
   const obj = asRecord26(payload);
   if (!obj) return [];
@@ -134523,7 +134542,7 @@ function pickMetrics2(row, extras = []) {
     averageCpc: num10(row.averageCpc) ?? (clicks > 0 ? round25(spend / clicks) : void 0),
     conversionRate: num10(row.conversionRate) ?? (clicks > 0 ? conversions / clicks : void 0),
     costPerConversion: num10(row.costPerConversion) ?? (conversions > 0 ? round25(spend / conversions) : void 0),
-    roi: num10(row.roi)
+    roi: normalizeYandexRoi(row.roi)
   };
   for (const f of extras) {
     if (row[f] !== void 0 && row[f] !== null) out[f] = row[f];
@@ -134568,8 +134587,14 @@ function parseYmd2(value) {
   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]));
-  return Number.isNaN(d.getTime()) ? null : d;
+  const y = Number(m[1]);
+  const month = Number(m[2]);
+  const day = Number(m[3]);
+  const d = new Date(y, month - 1, day);
+  if (Number.isNaN(d.getTime()) || d.getFullYear() !== y || d.getMonth() !== month - 1 || d.getDate() !== day) {
+    return null;
+  }
+  return d;
 }
 function formatYmd2(d) {
   const y = d.getFullYear();
@@ -134648,9 +134673,12 @@ 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"
 ];
+var YANDEX_ROI_OUTLINE_HINTS = [
+  "// `roi` = (Revenue-Spend)/Spend\uFF0C\u5DF2\u662F\u500D\u6570\uFF083.72 \u2248 \u5229\u6DA6 372%\uFF09\uFF0C\u4E0D\u662F 0~1\u3002\u7981\u6B62\u518D \xD7100\u3002\u65E0\u6536\u76CA\u65F6\u5E38\u4E3A -1\uFF0C\u6309\u7F3A\u5931\u5904\u7406\u3002"
+];
 function buildYandexOutlineHints(section) {
-  if (section === "daily") return YANDEX_DAILY_OUTLINE_HINTS;
-  return void 0;
+  if (section === "daily") return [...YANDEX_DAILY_OUTLINE_HINTS, ...YANDEX_ROI_OUTLINE_HINTS];
+  return YANDEX_ROI_OUTLINE_HINTS;
 }
 function mapDailyRows(payload) {
   return asItems(payload).map((r) => {
@@ -134737,7 +134765,8 @@ async function mergeYandexAnalysisSnapshotIntoReport(payload, snapshotDir) {
       kpis.costPerConversion = round25(num10(totals.costPerConversion));
     }
     if (num10(totals.conversionRate) != null) kpis.conversionRate = num10(totals.conversionRate);
-    if (num10(totals.roi) != null) kpis.roi = num10(totals.roi);
+    const overviewRoi = normalizeYandexRoi(totals.roi);
+    if (overviewRoi != null) kpis.roi = overviewRoi;
   }
   if (overview) {
     if (num10(overview.balance) != null) kpis.balance = round25(num10(overview.balance));

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.46-beta.5",
-  "publishedAt": 1787024164836
+  "version": "1.1.46-beta.6",
+  "publishedAt": 1787040608858
 }

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

@@ -442,7 +442,7 @@ siluzan-tso bing-analysis run -a <mediaCustomerId> --json-out ./snap --sections
 >
 > **账户 ID**：Yandex Client-Login / mediaCustomerId（如 `porg-xxx`，与 `list-accounts -m Yandex` 一致），**不是**纯数字。
 >
-> **金额**：已从 micros 转为账户币种小数（`/1e6`）。`ctr` / `conversionRate` 为 **0~1 小数**（先读 outline）。
+> **金额**：已从 micros 转为账户币种小数（`/1e6`）。`ctr` / `conversionRate` 为 **0~1 小数**（先读 outline）。`roi` 为 **(收益-消耗)/消耗** 倍数，禁止再 ×100。
 
 与 `bing-analysis` 同架构：`yandex-analysis -a … --json-out …`（省略子命令名默认执行 `run`）；周期报告默认 **HTML**：`yandex-analysis render`（见 `report-templates/yandex-period-report.md`）。用户要 Excel → `yandex-period-report-excel.md`（Agent 脚本，无 excel 子命令）。
 

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

@@ -19,7 +19,7 @@
 | `geo`            | `{ …, items: GeoRow[] }`                                              | → `tables.geo[]`                                 |
 | `devices`        | `{ …, items: DeviceRow[] }`                                           | → `tables.devices[]`                             |
 
-> 金额已为账户币种小数；`ctr` / `conversionRate` 为 **0~1 小数**。写叙事前先读各维 `*.outline.txt`。
+> 金额已为账户币种小数；`ctr` / `conversionRate` 为 **0~1 小数**。`roi` 为 **(收益-消耗)/消耗** 的倍数（如 `3.72` 表示利润约 372%），**不是** 0~1，禁止再 ×100；无收益时常为 `-1`（按缺失）。写叙事前先读各维 `*.outline.txt`。
 
 ---
 

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

@@ -492,6 +492,17 @@
           return (n * 100).toFixed(2) + "%";
         }
 
+        /**
+         * 后端 roi = (Revenue - Spend) / Spend，已是倍数（如 3.72 = 372% 利润），
+         * **不是** CTR 那种 0~1。禁止走 pct()，否则 371.96 会显示成 37195.98%。
+         * 无收益时网关算成 -1，展示为 —。
+         */
+        function fmtRoi(v) {
+          const n = toNum(v);
+          if (n === undefined || n === -1) return "—";
+          return n.toFixed(2) + "%";
+        }
+
         function num2(v) {
           const n = toNum(v);
           return n === undefined ? "—" : n.toFixed(2);
@@ -1158,7 +1169,7 @@
                   '</td><td class="num">' +
                   money(r.costPerConversion, currency) +
                   '</td><td class="num">' +
-                  pct(r.roi) +
+                  fmtRoi(r.roi) +
                   '</td><td class="num">' +
                   pct(r.ctr) +
                   "</td><td>" +

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

@@ -19,7 +19,7 @@
 | `geo`            | `{ …, items: GeoRow[] }`                                              | → `tables.geo[]`                                 |
 | `devices`        | `{ …, items: DeviceRow[] }`                                           | → `tables.devices[]`                             |
 
-> 金额已为账户币种小数；`ctr` / `conversionRate` 为 **0~1 小数**。写叙事前先读各维 `*.outline.txt`。
+> 金额已为账户币种小数；`ctr` / `conversionRate` 为 **0~1 小数**。`roi` 为 **(收益-消耗)/消耗** 的倍数（如 `3.72` 表示利润约 372%），**不是** 0~1，禁止再 ×100；无收益时常为 `-1`（按缺失）。写叙事前先读各维 `*.outline.txt`。
 
 ---
 

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-tso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.46-beta.5'
+$PKG_VERSION = '1.1.46-beta.6'
 $CLI_BIN     = 'siluzan-tso'
 $SKILL_LABEL = 'Siluzan TSO'
 $INSTALL_CMD = 'npm install -g siluzan-tso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-tso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.46-beta.5"
+readonly PKG_VERSION="1.1.46-beta.6"
 readonly CLI_BIN="siluzan-tso"
 readonly SKILL_LABEL="Siluzan TSO"
 readonly INSTALL_CMD="npm install -g siluzan-tso-cli@beta"

package/package.json

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