siluzan-tso-cli 1.1.46-beta.2 → 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.2），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.46-beta.6），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -107451,8 +107451,8 @@ function assertGoogleOnly(media) {
   if (media !== "Google") {
     console.error(
       `
-\u274C guard \u7194\u65AD\u5199\u76EE\u524D\u4EC5\u652F\u6301 Google\uFF08\u5F53\u524D\uFF1A${media}\uFF09\u3002
-   \u975E Google \u5A92\u4F53\u672C CLI \u65E0\u7CFB\u5217/\u7EC4/\u521B\u610F\u6682\u505C\u5199\u80FD\u529B\uFF1B\u8BF7\u6539\u7528 -m Google\u3002
+\u274C guard \u7194\u65AD\u626B\u63CF\u76EE\u524D\u4EC5\u652F\u6301 Google\uFF08\u5F53\u524D\uFF1A${media}\uFF09\u3002
+   \u8BF7\u6539\u7528 -m Google\u3002
 `
     );
     process.exit(1);
@@ -107543,46 +107543,6 @@ async function fetchAdsForDay(config, accountId, date, verbose) {
     };
   }).filter((r) => r.id);
 }
-async function pauseCampaign(config, accountId, campaignId, verbose) {
-  const googleApiUrl = requireGoogleApi(config);
-  const detailUrl = `${googleApiUrl}/campaignmanagement/campaign/${accountId}/${campaignId}`;
-  const res = await apiFetch2(detailUrl, config, {}, verbose);
-  const campaign = res.data ?? res;
-  const body = { ...campaign, statusV2: "Paused" };
-  await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, verbose);
-}
-async function pauseAdGroup(config, accountId, adGroupId, date, verbose) {
-  const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, accountId, date, date);
-  const adgroup = await findItemInList(
-    listUrl,
-    config,
-    adGroupId,
-    verbose
-  );
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${accountId}/${adGroupId}`;
-  await apiFetch2(
-    putUrl,
-    config,
-    { method: "PUT", body: JSON.stringify({ ...adgroup, statusV2: "Paused" }) },
-    verbose
-  );
-}
-async function pauseAd(config, accountId, adId, date, verbose) {
-  const googleApiUrl = requireGoogleApi(config);
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(date, 0));
-  params.set("endDate", toGoogleDate(date, 0));
-  const listUrl = `${googleApiUrl}/admanagement/v2/list/${accountId}?${params}`;
-  const ad = await findItemInList(listUrl, config, adId, verbose);
-  const putUrl = `${googleApiUrl}/admanagement/campaign/${accountId}/${adId}`;
-  await apiFetch2(
-    putUrl,
-    config,
-    { method: "PUT", body: JSON.stringify({ ...ad, statusV2: "Paused" }) },
-    verbose
-  );
-}
 function printHitsTable(title, rows, cols) {
   console.log(`
 ${title}
@@ -107641,14 +107601,13 @@ async function runBudgetCircuit(opts) {
   }
   const statusFilter = opts.status === void 0 ? "Enabled" : opts.status;
   const filterAll = statusFilter === "" || statusFilter === "*";
-  const apply = Boolean(opts.apply);
   const accounts = await resolveGuardAccounts(opts, config);
   if (accounts.length === 0) {
     console.error("\n\u274C \u672A\u627E\u5230\u53EF\u626B\u63CF\u7684 Google \u8D26\u6237\u3002\n");
     process.exit(1);
   }
   process.stderr.write(
-    `\u23F3 [guard budget-circuit] ${accounts.length} \u6237 \xB7 \u65E5\u671F ${date} \xB7 ratio=${ratio}${apply ? " \xB7 APPLY" : " \xB7 dry-run"}
+    `\u23F3 [guard budget-circuit] ${accounts.length} \u6237 \xB7 \u65E5\u671F ${date} \xB7 ratio=${ratio} \xB7 \u53EA\u8BFB\u626B\u63CF
 `
   );
   const accountResults = await runWithConcurrency(
@@ -107682,18 +107641,8 @@ async function runBudgetCircuit(opts) {
             spend: c.spend,
             budget,
             ratio,
-            threshold: budget * ratio,
-            applied: false
+            threshold: budget * ratio
           };
-          if (apply) {
-            try {
-              await pauseCampaign(config, acc.mediaCustomerId, c.id, opts.verbose);
-              hit.applied = true;
-              hit.statusV2 = "Paused";
-            } catch (err) {
-              hit.applyError = err instanceof Error ? err.message : String(err);
-            }
-          }
           hits2.push(hit);
         }
         return {
@@ -107720,7 +107669,6 @@ async function runBudgetCircuit(opts) {
     accountName: r.accountName,
     error: r.error
   }));
-  const paused = hits.filter((h) => h.applied);
   const checkedCampaigns = accountResults.reduce((n, r) => n + r.checked, 0);
   const payload = {
     meta: {
@@ -107728,20 +107676,16 @@ async function runBudgetCircuit(opts) {
       date,
       ratio,
       statusFilter: filterAll ? "*" : statusFilter,
-      apply,
-      note: "\u975E Google \u5A92\u4F53\u672C CLI \u65E0\u7CFB\u5217\u7194\u65AD\u5199\u80FD\u529B\uFF1B\u672C\u547D\u4EE4\u4EC5\u626B\u63CF Google\u3002"
+      note: "\u672C\u547D\u4EE4\u53EA\u626B\u63CF\u5217\u51FA\u547D\u4E2D\uFF0C\u4E0D\u6682\u505C\u3002\u8981\u5BF9\u67D0\u6761\u7CFB\u5217\u505C\u6295\uFF0C\u987B\u5355\u72EC\u6267\u884C ad campaign-status --status Paused --commit\u3002"
     },
     summary: {
       label: "\u8D85\u9884\u7B97\u7194\u65AD",
       accountCount: accounts.length,
       checkedCampaigns,
       hitCount: hits.length,
-      pausedCount: paused.length,
-      errorCount: errors.length,
-      mode: apply ? "apply" : "dry-run"
+      errorCount: errors.length
     },
     hits,
-    paused,
     errors
   };
   if (await emitCliJsonOrSnapshot(opts, {
@@ -107750,7 +107694,7 @@ async function runBudgetCircuit(opts) {
     payload
   })) {
   }
-  const title = `\u8D85\u9884\u7B97\u7194\u65AD\uFF08${apply ? "\u5DF2\u5C1D\u8BD5\u6682\u505C" : "dry-run"}\uFF09 \xB7 ${date} \xB7 ratio=${ratio} \xB7 \u547D\u4E2D ${hits.length}/${checkedCampaigns}`;
+  const title = `\u8D85\u9884\u7B97\u7194\u65AD\u626B\u63CF \xB7 ${date} \xB7 ratio=${ratio} \xB7 \u547D\u4E2D ${hits.length}/${checkedCampaigns}`;
   printHitsTable(
     title,
     hits.map((h) => ({
@@ -107758,16 +107702,14 @@ async function runBudgetCircuit(opts) {
       campaign: h.campaignName.slice(0, 36),
       spend: h.spend.toFixed(2),
       budget: h.budget.toFixed(2),
-      threshold: h.threshold.toFixed(2),
-      applied: h.applied ? "Paused" : h.applyError ? `ERR:${h.applyError.slice(0, 20)}` : "\u2014"
+      threshold: h.threshold.toFixed(2)
     })),
     [
       { key: "account", header: "\u8D26\u6237ID" },
       { key: "campaign", header: "\u7CFB\u5217" },
       { key: "spend", header: "\u5F53\u65E5\u82B1\u8D39" },
       { key: "budget", header: "\u65E5\u9884\u7B97" },
-      { key: "threshold", header: "\u9608\u503C" },
-      { key: "applied", header: "\u6682\u505C" }
+      { key: "threshold", header: "\u9608\u503C" }
     ]
   );
   if (errors.length > 0) {
@@ -107776,14 +107718,9 @@ async function runBudgetCircuit(opts) {
       console.error(`   \u2022 ${e.mediaCustomerId}: ${e.error}`);
     }
   }
-  if (!apply && hits.length > 0) {
+  if (hits.length > 0) {
     console.log(
-      '\u63D0\u793A\uFF1A\u4EE5\u4E0A\u4E3A dry-run\u3002\u786E\u8BA4\u540E\u8FFD\u52A0 --apply --commit "budget-circuit <date>" \u6267\u884C\u6682\u505C\u3002\n'
-    );
-  } else if (apply) {
-    console.log(
-      `\u2705 apply \u5B8C\u6210\uFF1A\u547D\u4E2D ${hits.length}\uFF0C\u6210\u529F\u6682\u505C ${paused.length}${hits.length - paused.length > 0 ? `\uFF0C\u5931\u8D25 ${hits.length - paused.length}` : ""}\u3002
-`
+      '\u63D0\u793A\uFF1A\u672C\u547D\u4EE4\u53EA\u5217\u51FA\u547D\u4E2D\uFF0C\u4E0D\u4F1A\u6682\u505C\u3002\u8981\u5BF9\u67D0\u6761\u7CFB\u5217\u505C\u6295\uFF0C\u8BF7\u5BF9\u8BE5\u8D26\u6237\u5355\u72EC\u6267\u884C\uFF1A\n  siluzan-tso ad campaign-status -a <\u8D26\u6237ID> --id <\u7CFB\u5217ID> --status Paused --commit "\u8D85\u9884\u7B97\u7194\u65AD <date>"\n'
     );
   } else {
     console.log("\u2705 \u4ECA\u65E5\u65E0\u7CFB\u5217\u89E6\u53D1\u8D85\u9884\u7B97\u7194\u65AD\u3002\n");
@@ -107810,7 +107747,6 @@ async function runZeroConv(opts) {
   const level = parseLevel(opts.level);
   const fallback = opts.fallbackTargetCpa != null && Number.isFinite(opts.fallbackTargetCpa) ? opts.fallbackTargetCpa : null;
   const onlyEnabled = opts.onlyEnabled !== false;
-  const apply = Boolean(opts.apply);
   if ((level === "ad" || level === "both") && fallback == null) {
     process.stderr.write(
       "\u26A0\uFE0F  [guard zero-conv] \u521B\u610F\u7EF4\u65E0\u7EC4\u7EA7 targetCpa \u5B57\u6BB5\uFF0C\u672A\u4F20 --fallback-target-cpa \u65F6\u521B\u610F\u547D\u4E2D\u53EF\u80FD\u4E3A 0\uFF08\u4F1A\u8BB0\u5165 skipped\uFF09\u3002\n"
@@ -107822,7 +107758,7 @@ async function runZeroConv(opts) {
     process.exit(1);
   }
   process.stderr.write(
-    `\u23F3 [guard zero-conv] ${accounts.length} \u6237 \xB7 ${date} \xB7 \xD7${multiple} \xB7 level=${level}${apply ? " \xB7 APPLY" : " \xB7 dry-run"}
+    `\u23F3 [guard zero-conv] ${accounts.length} \u6237 \xB7 ${date} \xB7 \xD7${multiple} \xB7 level=${level} \xB7 \u53EA\u8BFB\u626B\u63CF
 `
   );
   const accountResults = await runWithConcurrency(
@@ -107860,18 +107796,8 @@ async function runZeroConv(opts) {
               conversions: g.conversions ?? 0,
               targetCpaYuan: target,
               multiple,
-              threshold: target * multiple,
-              applied: false
+              threshold: target * multiple
             };
-            if (apply) {
-              try {
-                await pauseAdGroup(config, acc.mediaCustomerId, g.id, date, opts.verbose);
-                hit.applied = true;
-                hit.statusV2 = "Paused";
-              } catch (err) {
-                hit.applyError = err instanceof Error ? err.message : String(err);
-              }
-            }
             hits2.push(hit);
           }
         }
@@ -107903,18 +107829,8 @@ async function runZeroConv(opts) {
               conversions: ad.conversions ?? 0,
               targetCpaYuan: fallback,
               multiple,
-              threshold: fallback * multiple,
-              applied: false
+              threshold: fallback * multiple
             };
-            if (apply) {
-              try {
-                await pauseAd(config, acc.mediaCustomerId, ad.id, date, opts.verbose);
-                hit.applied = true;
-                hit.statusV2 = "Paused";
-              } catch (err) {
-                hit.applyError = err instanceof Error ? err.message : String(err);
-              }
-            }
             hits2.push(hit);
           }
         }
@@ -107945,7 +107861,6 @@ async function runZeroConv(opts) {
     accountName: r.accountName,
     error: r.error
   }));
-  const paused = hits.filter((h) => h.applied);
   const checked = accountResults.reduce((n, r) => n + r.checked, 0);
   const payload = {
     meta: {
@@ -107954,21 +107869,17 @@ async function runZeroConv(opts) {
       cpaMultiple: multiple,
       level,
       fallbackTargetCpa: fallback,
-      apply,
-      note: "\u975E Google \u5A92\u4F53\u672C CLI \u65E0\u7EC4/\u521B\u610F\u7194\u65AD\u5199\u80FD\u529B\uFF1B\u672C\u547D\u4EE4\u4EC5\u626B\u63CF Google\u3002P1\u300C\u7A7A\u8017\u7194\u65AD\u300D\u901A\u77E5\u7531\u5BBF\u4E3B\u53D1\u9001\u3002"
+      note: "\u672C\u547D\u4EE4\u53EA\u626B\u63CF\u5217\u51FA\u547D\u4E2D\uFF0C\u4E0D\u6682\u505C\u3002\u8981\u5BF9\u67D0\u4E2A\u7EC4/\u521B\u610F\u505C\u6295\uFF0C\u987B\u5355\u72EC\u6267\u884C ad adgroup-status / ad-status --status Paused --commit\u3002P1\u300C\u7A7A\u8017\u7194\u65AD\u300D\u901A\u77E5\u7531\u5BBF\u4E3B\u53D1\u9001\u3002"
     },
     summary: {
       label: "\u7A7A\u8017\u7194\u65AD",
       accountCount: accounts.length,
       checkedObjects: checked,
       hitCount: hits.length,
-      pausedCount: paused.length,
       skippedCount: skipped.length,
-      errorCount: errors.length,
-      mode: apply ? "apply" : "dry-run"
+      errorCount: errors.length
     },
     hits,
-    paused,
     skipped,
     errors
   };
@@ -107977,7 +107888,7 @@ async function runZeroConv(opts) {
     commandLabel: "guard zero-conv",
     payload
   });
-  const title = `\u7A7A\u8017\u7194\u65AD\uFF08${apply ? "\u5DF2\u5C1D\u8BD5\u6682\u505C" : "dry-run"}\uFF09 \xB7 ${date} \xB7 \xD7${multiple} \xB7 \u547D\u4E2D ${hits.length}/${checked}`;
+  const title = `\u7A7A\u8017\u7194\u65AD\u626B\u63CF \xB7 ${date} \xB7 \xD7${multiple} \xB7 \u547D\u4E2D ${hits.length}/${checked}`;
   printHitsTable(
     title,
     hits.map((h) => ({
@@ -107986,8 +107897,7 @@ async function runZeroConv(opts) {
       name: h.objectName.slice(0, 32),
       spend: h.spend.toFixed(2),
       target: h.targetCpaYuan.toFixed(2),
-      threshold: h.threshold.toFixed(2),
-      applied: h.applied ? "Paused" : h.applyError ? `ERR` : "\u2014"
+      threshold: h.threshold.toFixed(2)
     })),
     [
       { key: "account", header: "\u8D26\u6237ID" },
@@ -107995,21 +107905,15 @@ async function runZeroConv(opts) {
       { key: "name", header: "\u5BF9\u8C61" },
       { key: "spend", header: "\u5F53\u65E5\u82B1\u8D39" },
       { key: "target", header: "\u76EE\u6807CPA" },
-      { key: "threshold", header: "\u9608\u503C" },
-      { key: "applied", header: "\u6682\u505C" }
+      { key: "threshold", header: "\u9608\u503C" }
     ]
   );
   if (errors.length > 0) {
     console.error(`\u26A0\uFE0F  ${errors.length} \u4E2A\u8D26\u6237\u62C9\u6570\u5931\u8D25\uFF08\u8BE6\u89C1 json-out errors[]\uFF09`);
   }
-  if (!apply && hits.length > 0) {
-    console.log(
-      '\u63D0\u793A\uFF1A\u4EE5\u4E0A\u4E3A dry-run\u3002\u786E\u8BA4\u540E\u8FFD\u52A0 --apply --commit "zero-conv <date>" \u6267\u884C\u6682\u505C\u3002\n'
-    );
-  } else if (apply) {
+  if (hits.length > 0) {
     console.log(
-      `\u2705 apply \u5B8C\u6210\uFF1A\u547D\u4E2D ${hits.length}\uFF0C\u6210\u529F\u6682\u505C ${paused.length}${hits.length - paused.length > 0 ? `\uFF0C\u5931\u8D25 ${hits.length - paused.length}` : ""}\u3002
-`
+      '\u63D0\u793A\uFF1A\u672C\u547D\u4EE4\u53EA\u5217\u51FA\u547D\u4E2D\uFF0C\u4E0D\u4F1A\u6682\u505C\u3002\u8981\u5BF9\u67D0\u4E2A\u7EC4/\u521B\u610F\u505C\u6295\uFF0C\u8BF7\u5BF9\u8BE5\u8D26\u6237\u5355\u72EC\u6267\u884C\uFF1A\n  siluzan-tso ad adgroup-status -a <\u8D26\u6237ID> --id <\u7EC4ID> --status Paused --commit "\u7A7A\u8017\u7194\u65AD <date>"\n  siluzan-tso ad ad-status -a <\u8D26\u6237ID> --id <\u5E7F\u544AID> --status Paused --commit "\u7A7A\u8017\u7194\u65AD <date>"\n'
     );
   } else {
     console.log("\u2705 \u4ECA\u65E5\u65E0\u5BF9\u8C61\u89E6\u53D1\u7A7A\u8017\u7194\u65AD\u3002\n");
@@ -108019,14 +107923,14 @@ async function runZeroConv(opts) {
 // src/commands/guard/_register.ts
 function register11(program2) {
   const guard = program2.command("guard").description(
-    "Google \u6295\u653E\u81EA\u63A7\u7194\u65AD\uFF1A\u5168\u6237\uFF08\u6216 -a \u5B50\u96C6\uFF09\u626B\u63CF\u5F53\u65E5\u8D85\u9884\u7B97/\u7A7A\u8017\u547D\u4E2D\uFF0C\u9ED8\u8BA4 dry-run\uFF1B--apply \u65F6\u6682\u505C\u547D\u4E2D\u5BF9\u8C61\uFF08\u987B\u5168\u5C40 --commit\uFF09\u3002\u975E Google \u5A92\u4F53\u4E0D\u652F\u6301\u3002"
+    "Google \u6295\u653E\u81EA\u63A7\u7194\u65AD\u626B\u63CF\uFF1A\u5168\u6237\uFF08\u6216 -a \u5B50\u96C6\uFF09\u5217\u51FA\u5F53\u65E5\u8D85\u9884\u7B97/\u7A7A\u8017\u547D\u4E2D\uFF0C\u53EA\u8BFB\u4E0D\u6682\u505C\u3002\u8981\u505C\u6295\u653E\u987B\u5BF9\u6BCF\u4E2A\u547D\u4E2D\u5BF9\u8C61\u5355\u72EC\u6267\u884C ad campaign-status / adgroup-status / ad-status\uFF08\u5E26 --commit\uFF09\u3002\u975E Google \u5A92\u4F53\u4E0D\u652F\u6301\u3002"
   );
   guard.command("budget-circuit").description(
-    "\u5355\u65E5\u9884\u7B97\u7194\u65AD\uFF1A\u5F53\u65E5\u7CFB\u5217 spend \u2265 \u65E5\u9884\u7B97 \xD7 ratio \u65F6\u5217\u51FA\uFF08\u53EF\u9009\u6682\u505C\uFF09\u3002\u66FF\u4EE3\u300Clist-accounts \xD7 N + \u9010\u6237 ad campaigns + \u811A\u672C\u300D\u3002"
+    "\u5355\u65E5\u9884\u7B97\u7194\u65AD\u626B\u63CF\uFF1A\u5F53\u65E5\u7CFB\u5217 spend \u2265 \u65E5\u9884\u7B97 \xD7 ratio \u65F6\u5217\u51FA\u547D\u4E2D\uFF08\u4E0D\u6682\u505C\uFF09\u3002\u66FF\u4EE3\u300Clist-accounts \xD7 N + \u9010\u6237 ad campaigns + \u811A\u672C\u300D\u3002"
   ).requiredOption("-m, --media <type>", "\u76EE\u524D\u4EC5\u652F\u6301 Google").option(
     "-a, --accounts <ids>",
     "\u6307\u5B9A\u8D26\u6237 mediaCustomerId\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u7559\u7A7A\u5219\u626B\u63CF\u540D\u4E0B\u5168\u90E8 Google \u8D26\u6237"
-  ).option("--date <YYYY-MM-DD>", "\u7EDF\u8BA1\u65E5\uFF08Asia/Shanghai \u9ED8\u8BA4\u4ECA\u5929\uFF09\uFF1B\u5F3A\u5236 start=end=\u8BE5\u65E5").option("--ratio <n>", "\u9608\u503C\u7CFB\u6570\uFF1Aspend >= budget * ratio\uFF08\u9ED8\u8BA4 1.1\uFF09", (v) => parseFloat(v)).option("--status <statusV2>", "\u53EA\u68C0\u67E5\u8BE5\u72B6\u6001\u7684\u7CFB\u5217\uFF08\u9ED8\u8BA4 Enabled\uFF1B\u4F20 * \u8868\u793A\u4E0D\u8FC7\u6EE4\uFF09", "Enabled").option("--apply", "\u5BF9\u547D\u4E2D\u7CFB\u5217\u6267\u884C Paused\uFF08\u987B\u914D\u5408\u5168\u5C40 --commit\uFF09", false).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF09").option(
+  ).option("--date <YYYY-MM-DD>", "\u7EDF\u8BA1\u65E5\uFF08Asia/Shanghai \u9ED8\u8BA4\u4ECA\u5929\uFF09\uFF1B\u5F3A\u5236 start=end=\u8BE5\u65E5").option("--ratio <n>", "\u9608\u503C\u7CFB\u6570\uFF1Aspend >= budget * ratio\uFF08\u9ED8\u8BA4 1.1\uFF09", (v) => parseFloat(v)).option("--status <statusV2>", "\u53EA\u68C0\u67E5\u8BE5\u72B6\u6001\u7684\u7CFB\u5217\uFF08\u9ED8\u8BA4 Enabled\uFF1B\u4F20 * \u8868\u793A\u4E0D\u8FC7\u6EE4\uFF09", "Enabled").option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF09").option(
     "--json-out <path>",
     "\u843D\u76D8\u76EE\u5F55\u6216 *.json\uFF1Bstdout \u4E00\u884C\u6458\u8981\uFF1B\u4EBA\u7C7B\u53EF\u8BFB\u8868\u59CB\u7EC8\u6253\u5370",
     void 0
@@ -108038,7 +107942,6 @@ function register11(program2) {
         date: opts.date,
         ratio: opts.ratio,
         status: opts.status,
-        apply: opts.apply,
         pageSize: opts.pageSize,
         maxPages: opts.maxPages,
         token: opts.token,
@@ -108049,7 +107952,7 @@ function register11(program2) {
     }
   );
   guard.command("zero-conv").description(
-    "\u7A7A\u8017\u7194\u65AD\uFF1A\u5F53\u65E5 spend \u2265 \u76EE\u6807 CPA \xD7 N \u4E14\u8F6C\u5316\u4E3A 0 \u65F6\u5217\u51FA\u7EC4/\u521B\u610F\uFF08\u53EF\u9009\u6682\u505C\uFF09\u3002\u7ED3\u679C summary.label=\u300C\u7A7A\u8017\u7194\u65AD\u300D\uFF1BP1 \u901A\u77E5\u7531\u5BBF\u4E3B\u53D1\u9001\u3002"
+    "\u7A7A\u8017\u7194\u65AD\u626B\u63CF\uFF1A\u5F53\u65E5 spend \u2265 \u76EE\u6807 CPA \xD7 N \u4E14\u8F6C\u5316\u4E3A 0 \u65F6\u5217\u51FA\u7EC4/\u521B\u610F\uFF08\u4E0D\u6682\u505C\uFF09\u3002\u7ED3\u679C summary.label=\u300C\u7A7A\u8017\u7194\u65AD\u300D\uFF1BP1 \u901A\u77E5\u7531\u5BBF\u4E3B\u53D1\u9001\u3002"
   ).requiredOption("-m, --media <type>", "\u76EE\u524D\u4EC5\u652F\u6301 Google").option(
     "-a, --accounts <ids>",
     "\u6307\u5B9A\u8D26\u6237 mediaCustomerId\uFF0C\u9017\u53F7\u5206\u9694\uFF1B\u7559\u7A7A\u5219\u626B\u63CF\u540D\u4E0B\u5168\u90E8 Google \u8D26\u6237"
@@ -108057,7 +107960,7 @@ function register11(program2) {
     "--fallback-target-cpa <yuan>",
     "\u7EC4\u65E0 targetCpa\uFF08\u6216\u521B\u610F\u7EF4\uFF09\u65F6\u4F7F\u7528\u7684\u76EE\u6807 CPA\uFF08\u5143\uFF09",
     (v) => parseFloat(v)
-  ).option("--apply", "\u5BF9\u547D\u4E2D\u5BF9\u8C61\u6267\u884C Paused\uFF08\u987B\u914D\u5408\u5168\u5C40 --commit\uFF09", false).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF09").option("--json-out <path>", "\u843D\u76D8\u76EE\u5F55\u6216 *.json", void 0).option("--refresh-dp", "\u5F3A\u5236\u91CD\u62C9 Datapermission", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF", false).action(
+  ).option("--page-size <n>", "\u8D26\u6237\u6E05\u5355\u5206\u9875\u5927\u5C0F\uFF08\u9ED8\u8BA4 200\uFF09", (v) => parseInt(v, 10)).option("--max-pages <n>", "\u6700\u591A\u626B\u63CF\u9875\u6570\uFF08\u9ED8\u8BA4 20\uFF09", (v) => parseInt(v, 10)).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF09").option("--json-out <path>", "\u843D\u76D8\u76EE\u5F55\u6216 *.json", void 0).option("--refresh-dp", "\u5F3A\u5236\u91CD\u62C9 Datapermission", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF", false).action(
     async (opts) => {
       await runZeroConv({
         media: opts.media,
@@ -108066,7 +107969,6 @@ function register11(program2) {
         cpaMultiple: opts.cpaMultiple,
         level: opts.level,
         fallbackTargetCpa: opts.fallbackTargetCpa,
-        apply: opts.apply,
         pageSize: opts.pageSize,
         maxPages: opts.maxPages,
         token: opts.token,
@@ -132267,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();
@@ -134469,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();
@@ -134600,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 [];
@@ -134621,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];
@@ -134666,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();
@@ -134746,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) => {
@@ -134835,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/SKILL.md

@@ -113,7 +113,9 @@ siluzan-tso -h
 | TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |
 | 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |
 | 超预算熔断 / 空耗熔断（全户 Google） | — | `references/operations/guard.md`（`guard budget-circuit` / `guard zero-conv`；禁止逐户 for-loop） |
-| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP；预算/空耗熔断优先 guard.md） |
+| Bing 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-bing.md`（只读告警，不能自动暂停/改价） |
+| Yandex 自动化巡检（余额/CPA/日花费预警） | — | `references/operations/hosted-automation-yandex.md`（只读告警，不能自动改投放） |
+| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP；Google 熔断优先 guard.md；Bing/Yandex 走上两行） |
 
 ---
 

package/dist/skill/_meta.json

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

package/dist/skill/references/README.md

@@ -65,9 +65,11 @@
 | `references/operations/forewarning.md`                       | 智能预警               |
 | `references/operations/clue.md`                              | TikTok / Meta 线索表单 |
 | `references/operations/hosted-automation-user-catalog.md`    | 高阶自动化能力目录     |
-| `references/operations/hosted-automation-self-control.md`    | 预算/CPA/空耗自控 SOP  |
-| `references/operations/hosted-automation-monitoring-json.md` | 异常监控 JSON 键名     |
-| `references/operations/hosted-automation-optimize-index.md`  | 自动优化 SOP 索引      |
+| `references/operations/hosted-automation-self-control.md`    | Google 预算/CPA/空耗自控 SOP |
+| `references/operations/hosted-automation-monitoring-json.md` | Google 异常监控 JSON 键名 |
+| `references/operations/hosted-automation-optimize-index.md`  | Google 自动优化 SOP 索引 |
+| `references/operations/hosted-automation-bing.md`            | Bing 只读巡检 SOP      |
+| `references/operations/hosted-automation-yandex.md`          | Yandex 只读巡检 SOP    |
 | `references/operations/hosted-automation-scenarios.md`       | 宿主编排场景索引       |
 
 ## Assets 模板（`../assets/`）

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

@@ -332,6 +332,8 @@ siluzan-tso tiktok-analysis -a 1234567890 --start 2026-03-01 --end 2026-03-31 \
 ## Bing（BingV2）账户分析
 
 > **日期限制**：Bing 报表不能包含今天或昨天。省略时 CLI 默认截至前天的近 7 天。用户要**已结束的完整自然月**（如「6月份」）→ `--start` 当月 1 日、`--end` 当月最后一天（6 月 = `06-30`，**禁止**减 1 天），见 `report-templates/bing-period-report.md` §日期规则。
+>
+> **自动化巡检步骤**（封禁 / 拒审 / 落地页 / 当日超预算 / 空耗预警，只读告警）：`references/operations/hosted-automation-bing.md`。
 
 与 `google-analysis` / `facebook-analysis` 同架构：`bing-analysis -a … --json-out …`（省略子命令名默认执行 `run`，批量拉取全部维度或 `--sections` 指定子集）。
 
@@ -432,13 +434,15 @@ siluzan-tso bing-analysis run -a <mediaCustomerId> --json-out ./snap --sections
 
 ## Yandex 账户分析
 
+> **自动化巡检步骤**（余额 / 多账户 CPA / 日报花费，只读告警）：`references/operations/hosted-automation-yandex.md`。
+>
 > **网关**：直打 YandexAPI `{yandexApiUrl}/yandex-analysis/*`（从 TSO `apiBaseUrl` 推导：`tso-api-ci` → `yandexapi-ci.mysiluzan.com`；可用 `SILUZAN_YANDEX_API` 覆盖）。
 >
 > **日期**：`start`/`end` 不能晚于今天；省略默认近 7 天（含今天）。**search-terms** 仅支持近 **180 天**（Direct 限制），超窗网关/CLI 均会拒绝。
 >
 > **账户 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/core/agent-conventions.md

@@ -285,7 +285,7 @@
 
 ## 十二、风险预警与自动化（按需）
 
-**仅当**用户问自动化 / 巡检 / 熔断 / 自控 / 异常监控时：Read `references/operations/hosted-automation-user-catalog.md`，按表选 **一个** SOP 介绍或执行。**禁止**在无关任务（查余额、出报告、开户等）主动灌输自动化目录。
+**仅当**用户问自动化 / 巡检 / 熔断 / 自控 / 异常监控时：Read `references/operations/hosted-automation-user-catalog.md`，按表选 **一个** SOP 介绍或执行。Google 熔断优先 `guard.md`；Bing 走 `hosted-automation-bing.md`；Yandex 走 `hosted-automation-yandex.md`。**禁止**在无关任务（查余额、出报告、开户等）主动灌输自动化目录。
 
 ---
 

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

@@ -208,11 +208,13 @@
 ## W12 · 日 / 周巡检
 
 - **触发**：日常/每周快速了解各媒体余额、消耗、预警与报告/智投状态。
-- **必读**：`references/accounts/accounts-balance-stats.md`；首页看板口径见 `references/misc/tso-home.md`。超预算/空耗熔断另读 `references/operations/guard.md`。
+- **必读**：`references/accounts/accounts-balance-stats.md`；首页看板口径见 `references/misc/tso-home.md`。Google 超预算/空耗熔断另读 `references/operations/guard.md`。Bing / Yandex 只读巡检读 `hosted-automation-bing.md` / `hosted-automation-yandex.md`。
 - **步骤**：
   1. 余额：`list-accounts -m <媒体> --json-out ./snap` → `balance -m <媒体> -a <mediaCustomerId,...>`（多户续航预警走 **P2**）。
-  2. 消耗：`stats -m <媒体> -a <id> --start <昨天/上周一> --end <昨天/上周日>`（多户汇总走 **P3**）。
+  2. 消耗：`stats -m <媒体> -a <id> --start <昨天/上周一> --end <昨天/上周日>`（多户汇总走 **P3**；Bing/Yandex **今天**不要用 `stats`）。
   3. Google 当日超预算/空耗熔断（若用户要求）：`guard budget-circuit` / `guard zero-conv -m Google --json-out`（**禁止**逐户 for-loop）。
-  4. 预警触发：`forewarning records -m <媒体> --start <S>`（见 **W10**）。
-  5. 智投/线索（按需）：`ad batch list --state Failed/HasFailed`（**W4**）、`clue …`（**W11**）、`optimize list/records`（**W6**）。
-- **产物**：要与网页首页看板数字完全一致（聚合口径）时引导打开首页（`tso-home.md`）；CLI 给的是单账户粒度的近似巡检；熔断任务须交付命中表或显式「无命中」。
+  4. Bing 巡检（若用户要求）：按 `hosted-automation-bing.md` 跑封禁/拒审/当日超预算或空耗预警（只告警，不暂停）。
+  5. Yandex 巡检（若用户要求）：按 `hosted-automation-yandex.md` 跑 `balance-scan` / `accounts-digest` / `yandex-analysis`（只告警）。
+  6. 预警触发：`forewarning records -m <媒体> --start <S>`（见 **W10**）。
+  7. 智投/线索（按需）：`ad batch list --state Failed/HasFailed`（**W4**）、`clue …`（**W11**）、`optimize list/records`（**W6**）。
+- **产物**：要与网页首页看板数字完全一致（聚合口径）时引导打开首页（`tso-home.md`）；CLI 给的是单账户粒度的近似巡检；Google 熔断须交付命中表或显式「无命中」；Bing/Yandex 巡检交付告警列表（不能写成已自动暂停）。

package/dist/skill/references/operations/guard.md

@@ -1,27 +1,20 @@
-# guard —— Google 全户熔断扫描
+# guard —— Google 全户熔断扫描（只读）
 
 > 流程见 `hosted-automation-user-catalog.md`（预算/空耗自控）。单户排障仍可用 `ad campaigns` / `ad groups`。
-> **仅 Google**。非 Google 媒体本 CLI 无系列/组/创意暂停写能力。
-
-## Contents
-
-- 何时用
-- budget-circuit（超预算）
-- zero-conv（空耗）
-- 输出与交付
-- 与旧编排对照
-
----
+> **仅 Google**。本命令**只扫描列出命中，不会暂停任何账户/系列/组/创意**。
+> 若要对某个命中对象停投，必须对该账户单独执行 `ad campaign-status` / `ad adgroup-status` / `ad ad-status`（带 `--commit`），以便写审计能记清「改了哪个账户的哪个对象」。
 
 ## 何时用
 
 | 用户话术                                           | 命令                                   |
 | -------------------------------------------------- | -------------------------------------- |
-| 所有账户系列当日花费 ≥ 日预算 110% → 暂停          | `guard budget-circuit`                 |
-| 空耗熔断：花 ≥ 目标 CPA × N 且转化 0 → 暂停组/创意 | `guard zero-conv`                      |
+| 所有账户系列当日花费 ≥ 日预算 110% → **列出**      | `guard budget-circuit`                 |
+| 空耗：花 ≥ 目标 CPA × N 且转化 0 → **列出**组/创意 | `guard zero-conv`                      |
+| 确认后暂停某一户的某一条系列/组/创意               | `ad campaign-status` / `adgroup-status` / `ad-status` |
 | 只查某一户 / 改预算后复核单系列                    | 仍用 `ad campaigns -a … --start=--end` |
 
-**禁止**外层 for-loop：`list-accounts` × 多媒体再逐户 `ad campaigns` 做全户熔断。
+**禁止**外层 for-loop：`list-accounts` × 多媒体再逐户 `ad campaigns` 做全户扫描。  
+**禁止**指望 `guard` 一条命令批量暂停——没有 `--apply`，也不会改投放状态。
 
 ---
 
@@ -32,9 +25,9 @@ siluzan-tso guard budget-circuit -m Google \
   [--date YYYY-MM-DD] [--ratio 1.1] [-a id1,id2] \
   --json-out ./snap-guard
 
-# 确认命中后暂停（须全局 --commit）
-siluzan-tso guard budget-circuit -m Google --date 2026-07-28 --ratio 1.1 \
-  --apply --json-out ./snap-guard --commit "budget-circuit 2026-07-28"
+# 确认某条命中后，对该账户单独暂停（须 --commit，写审计记这一次）
+siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> \
+  --status Paused --commit "超预算熔断 2026-07-28"
 ```
 
 | 选项         | 说明                                                             |
@@ -44,7 +37,6 @@ siluzan-tso guard budget-circuit -m Google --date 2026-07-28 --ratio 1.1 \
 | `--date`     | 统计日；默认 Asia/Shanghai 今天；**强制当日 spend**（start=end） |
 | `--ratio`    | 默认 `1.1`（建议 1.10–1.20）                                     |
 | `--status`   | 默认只查 `Enabled`；传 `*` 不过滤                                |
-| `--apply`    | 默认 dry-run；加此旗才 `Paused`                                  |
 | `--json-out` | Agent 必带                                                       |
 
 命中条件：`budget > 0` 且 `spend >= budget * ratio`（`budget`/`spend` 均为元；`spend` 为该日合计）。
@@ -59,8 +51,9 @@ siluzan-tso guard zero-conv -m Google \
   [--fallback-target-cpa <元>] \
   --json-out ./snap-guard
 
-siluzan-tso guard zero-conv -m Google --cpa-multiple 3 --apply \
-  --json-out ./snap-guard --commit "zero-conv 空耗熔断"
+# 确认某条命中后，对该账户单独暂停
+siluzan-tso ad adgroup-status -a <mediaCustomerId> --id <adGroupId> \
+  --status Paused --commit "空耗熔断 2026-07-28"
 ```
 
 | 选项                     | 说明                                                                          |
@@ -68,18 +61,16 @@ siluzan-tso guard zero-conv -m Google --cpa-multiple 3 --apply \
 | `--cpa-multiple`         | 默认 `3`                                                                      |
 | `--level`                | 默认 `adgroup`；`ad`/`both` 需 `--fallback-target-cpa`（创意无组级 CPA 字段） |
 | `--fallback-target-cpa`  | 组无 `targetCpaAmountYuan` 时回退；缺失则进 `skipped[]`                       |
-| `--apply` / `--json-out` | 同 budget-circuit                                                             |
+| `--json-out`             | Agent 必带                                                                    |
 
-命中：`conversions === 0` 且 `spend >= targetCpaYuan * N`。`summary.label` 固定为 **「空耗熔断」**（宿主发 P1 时用此文案；CLI 不代发通知）。
+命中：`conversions === 0` 且 `spend >= targetCpaYuan * N`。摘要文案为 **「空耗熔断」**（宿主发 P1 时用此文案；CLI 不代发通知）。
 
 ---
 
 ## 输出与交付
 
-- 落盘 section：`guard-budget-circuit` / `guard-zero-conv`
-- 字段：`meta`、`summary`、`hits[]`、`paused[]`、`errors[]`（zero-conv 另有 `skipped[]`）
-- stdout：一行摘要 JSON（若 `--json-out`）+ **人类可读命中表**（无命中也打印「无命中」——巡检必须收口）
-- dry-run 命中后提示追加 `--apply --commit …`
+- `--json-out` 落盘命中表；无命中也必须收口（打印「无命中」）
+- 命中后用 **逐账户** `ad *-status` 暂停，**没有** `--apply`
 
 恢复：人工加预算 / 改出价后，用 `ad campaign-status|adgroup-status|ad-status … --status Enabled`（或网页），**禁止**无人值守自动恢复。
 
@@ -91,4 +82,4 @@ siluzan-tso guard zero-conv -m Google --cpa-multiple 3 --apply \
 | -------------------------------------------------------- | -------------------------------- |
 | 6 媒体 list-accounts → 逐户 ad campaigns → 脚本比 budget | `guard budget-circuit -m Google` |
 | 逐户 ad groups + 手写阈值                                | `guard zero-conv -m Google`      |
-| `ad campaigns -m Google`（非法）                         | 单户用 `-a`；全户熔断用 `guard`  |
+| `ad campaigns -m Google`（非法）                         | 单户用 `-a`；全户扫描用 `guard`  |

package/dist/skill/references/operations/hosted-automation-bing.md

@@ -0,0 +1,118 @@
+# 宿主编排：Bing（BingV2）只读巡检
+
+> **何时 Read**：用户要 Bing / Microsoft Ads 自动化、巡检、熔断、封禁、拒审、落地页、超预算或空耗。Google 熔断走 `references/operations/guard.md`。
+> **能做什么**：拉数、对比阈值、宿主告警。
+> **不能做什么**：暂停系列/组/广告、改价、改预算。没有对应写命令，**禁止**假装已执行熔断。
+
+**前置**：已 `siluzan-tso login`，并用 `list-accounts -m BingV2 --json-out ./snap` 确认 `mediaCustomerId`（数字）。
+
+**硬约束**：
+
+- `guard` **只支持 Google**。禁止 `guard … -m BingV2`。
+- 周期报表（不带 `--aggregation`）日期**不能含今天/昨天**；省略则默认截至前天的近 7 天。
+- 当日花费、近两小时 CPA 必须显式传 `--aggregation Daily|Hourly`，且 `--sections` 只能是 `campaigns` / `ad-groups` / `ads`。
+- Hourly 时间桶是**太平洋时区**，和北京日期可能差一天；阈值按 `timePeriod` 对齐，不要按北京日历硬切。
+- 花费/转化用 `bing-analysis run --sections …`；日预算/启停状态用 `campaign-entities`。两套数据不要混成一行。
+
+---
+
+## 1. 余额 / 额度续航
+
+多户先扫 TSO 余额（截至昨天的日均，**不含当天**）：
+
+```bash
+siluzan-tso balance-scan -m BingV2 --threshold-days 7 --json-out ./snap-bing
+```
+
+有插入订单（IO）的户再核对官方额度：
+
+```bash
+siluzan-tso bing-analysis insertion-orders -a <mediaCustomerId> --json-out ./snap-bing
+siluzan-tso bing-analysis monthly-spend -a <mediaCustomerId> --json-out ./snap-bing
+```
+
+无 IO 时没有额度上限，只看 `monthly-spend` 与 `balance-scan`。命中续航/额度不足 → 宿主通知充值或补 IO；CLI **不能**自动充值。
+
+---
+
+## 2. 账户封禁
+
+```bash
+siluzan-tso bing-analysis account-status -a <mediaCustomerId> --json-out ./snap-bing
+```
+
+`status` 不是 `Active` → 宿主发 **告警P1**（账户、状态原文）。不能在 CLI 里解封。
+
+---
+
+## 3. 素材拒审
+
+全账户巡检用 `bulk-ads`，**禁止**按系列循环 `ad-entities`。首次全量；下次把上次响应的 `syncTimeUtc` 原样回传做增量（最早回溯 30 天）：
+
+```bash
+siluzan-tso bing-analysis bulk-ads -a <mediaCustomerId> --editorial-status Disapproved --json-out ./snap-bing
+siluzan-tso bing-analysis bulk-ads -a <mediaCustomerId> --editorial-status Disapproved --last-sync-time-utc <上次syncTimeUtc> --json-out ./snap-bing
+```
+
+`bulk-ads` 是官方异步下载，大账户可能要几分钟，适合定时任务。命中 → 告警广告 ID / 系列 / 审核状态；改创意、申诉在 Bing 后台做。
+
+---
+
+## 4. 落地页死链
+
+同样用 `bulk-ads` 拉广告上的到达网址（不传 `--editorial-status` 则全量）。CLI **不**发 HTTP。宿主对 URL 做 HEAD/GET，4xx/5xx 或超时 → 告警。不要为了探活去遍历 `ad-entities`。
+
+---
+
+## 5. 当日超预算（只预警，不暂停）
+
+1. 拉系列日预算：
+
+```bash
+siluzan-tso bing-analysis campaign-entities -a <mediaCustomerId> --json-out ./snap-bing
+```
+
+2. 拉**当天**花费（必须 `--aggregation Daily`，日期可含今天）：
+
+```bash
+siluzan-tso bing-analysis run -a <mediaCustomerId> --json-out ./snap-bing --sections campaigns \
+  --start <当日YYYY-MM-DD> --end <当日YYYY-MM-DD> --aggregation Daily
+```
+
+3. 按同一 `campaignId` 对齐：当日花费对照 `dailyBudget`。`isSharedBudget=true` 时 `dailyBudget` 是共享总额，不要当成单系列上限。建议阈值 **110%–120%**（缓冲报表延迟）。
+4. 超阈值 → 宿主告警系列名、花费、日预算。**禁止**调用 `ad campaign-status`（那是 Google 命令）。恢复加预算或暂停由人工在 Bing 后台处理。
+
+---
+
+## 6. CPA 飙升 / 空耗（只预警，不降价、不暂停）
+
+近实时（近两小时或当日）用 Hourly / Daily，不要用默认周期报表冒充「今天」：
+
+```bash
+# 当日组级花费与转化
+siluzan-tso bing-analysis run -a <mediaCustomerId> --json-out ./snap-bing --sections ad-groups \
+  --start <当日> --end <当日> --aggregation Daily
+
+# 近两小时（按 adGroupId 取最近两个整点相加再算）
+siluzan-tso bing-analysis run -a <mediaCustomerId> --json-out ./snap-bing --sections ad-groups \
+  --start <起> --end <止> --aggregation Hourly
+```
+
+宿主侧：
+
+- 有转化：`CPA = 花费 / 转化`；超过约定目标倍数 → 告警「CPA 飙升」。
+- 花费已达「目标 CPA × N」且转化为 0 → 告警「空耗预警」（文案不要写成「已熔断」）。
+
+目标 CPA 以账户约定或系列出价策略为准；落盘里没有就不要猜。拉今天数据**不要**显式传 `--return-only-complete-data true`。
+
+---
+
+## 7. 多账户消耗 / 零转化巡检（截至昨天）
+
+`accounts-digest` / `stats` 走每日同步，**今天为 0**，只适合回看已结束的日期：
+
+```bash
+siluzan-tso accounts-digest -m BingV2 --start <S> --end <D> --zero-conversions --json-out ./snap-bing
+```
+
+看当天必须走第 5、6 步的 `--aggregation` 报表。

package/dist/skill/references/operations/hosted-automation-monitoring-json.md

@@ -1,8 +1,9 @@
 # 异常监控巡检：`siluzan-tso` CLI `--json-out` 落盘 JSON 键名与命令
 
-> **主题索引**：[`references/operations/hosted-automation-scenarios.md`](references/operations/hosted-automation-scenarios.md)  
-> **编排责任**：定时、HTTP 探活、通知等在宿主。本页只列 **读数命令与常见 JSON 键名**。  
+> **主题索引**：[`references/operations/hosted-automation-scenarios.md`](references/operations/hosted-automation-scenarios.md)
+> **编排责任**：定时、HTTP 探活、通知等在宿主。本页只列 **Google 读数命令与常见 JSON 键名**。
 > **统计日 / 时区**：与自控场景相同，见 [`references/operations/hosted-automation-self-control.md`](references/operations/hosted-automation-self-control.md)「统计日与今日」。
+> Bing / Yandex 巡检步骤见 `hosted-automation-bing.md` / `hosted-automation-yandex.md`，不要套用本页 Google 键名。
 
 宿主做定时巡检时，**只以当次 CLI 落盘 JSON 键名为准**（读命令统一 **`--json-out <dir>`**，以**落盘 `*.json` 文件正文**为准；`google-analysis` 等同理）。Google Ads API 文档里的资源名（如 `billing_setup`、`account_budget`、`amount_served_micros`）**与本 CLI 输出不是同一套命名**，不要当作本仓库 JSON 的键去解析。若某键缺失，**禁止猜测**：以实际输出为准，或换用 `references/analytics/account-analytics.md` 中的其它子命令。
 

package/dist/skill/references/operations/hosted-automation-optimize-index.md

@@ -1,7 +1,8 @@
 # 宿主编排：自动优化（Google）— 文档索引
 
-> **编排责任**：定时、阈值、多轮状态（如「连续 3 日未改善」）、统计检验、通知（P1/P2）由 **宿主** 实现。  
+> **编排责任**：定时、阈值、多轮状态（如「连续 3 日未改善」）、统计检验、通知（P1/P2）由 **宿主** 实现。
 > **本组文档**：说明如何用 `siluzan-tso` **拉检查项**、**执行写操作**、**写后复核**；每条 SOP 独立成文，避免单文件过长。
+> Bing / Yandex 没有降价、暂停、改预算接口，不要套用本组 SOP；巡检见 `hosted-automation-bing.md` / `hosted-automation-yandex.md`。
 
 | 文档                                                                                                                                   | 场景                                   |
 | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |

package/dist/skill/references/operations/hosted-automation-scenarios.md

@@ -1,25 +1,24 @@
-# 宿主编排（Google）：文档索引
+# 宿主编排：文档索引
 
-> **Bing（BingV2）**：同类「预算与 ROI / 异常监控 / 自动优化」场景的**只读**读数命令见 `references/analytics/account-analytics.md` § Bing 只读运营子命令（`bing-analysis account-status`/`campaign-entities`/`ad-entities`/`bulk-ads`/`insertion-orders`/`monthly-spend`：账户封禁、拒审巡检、余额续航）与 § Bing 近实时报表（`bing-analysis run --aggregation`：单日花费、近两小时 CPA）；本批暂无暂停/改价/改预算接口，宿主侧只能读数决策，不能自动执行写操作。
+> **编排责任**：定时、多条件 IF、滑动时间窗、通知（含 P1 /「空耗熔断」文案）由 **OpenClaw / WorkBuddy / Cron** 等宿主实现。
+> **CLI 责任**：单次调用给出检查与（仅 Google 具备的）写操作命令；**不**内置常驻调度或通知渠道。
 
-> **编排责任**：定时、多条件 IF、滑动时间窗、通知（含 P1 /「空耗熔断」文案）由 **OpenClaw / WorkBuddy / Cron** 等宿主实现。  
-> **CLI 责任**：单次调用下给出检查与写操作所需命令；**不**内置常驻调度或通知渠道。
+按媒体选文档（本文件只做入口）。
 
-本主题拆成下面两份子文档，按需打开（本文件只做**入口与导航**）。
+| 文档                                                                                                                       | 内容                                                                                                                                         |
+| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`references/operations/hosted-automation-user-catalog.md`](references/operations/hosted-automation-user-catalog.md)       | **用户向一览**：先看这张表，每行只 Read **一个** SOP                                                                                         |
+| [`references/operations/hosted-automation-self-control.md`](references/operations/hosted-automation-self-control.md)       | **Google 三类投放自控**：单日预算熔断、CPA 飙升降价、连续空耗暂停                                                                            |
+| [`references/operations/hosted-automation-monitoring-json.md`](references/operations/hosted-automation-monitoring-json.md) | **Google 异常监控**落盘与读数                                                                                                                |
+| [`references/operations/hosted-automation-optimize-index.md`](references/operations/hosted-automation-optimize-index.md)   | **Google 自动优化**：差素材降价/关停、高转化扩量、A/B 停输家                                                                                 |
+| [`references/operations/hosted-automation-bing.md`](references/operations/hosted-automation-bing.md)                       | **Bing 只读巡检**：余额/IO、封禁、拒审、落地页、当日超预算预警、CPA/空耗预警；**不能**自动暂停/改价                                          |
+| [`references/operations/hosted-automation-yandex.md`](references/operations/hosted-automation-yandex.md)                   | **Yandex 只读巡检**：余额、多账户 CPA/零转化、日报花费异动；**不能**自动改投放                                                               |
 
-| 文档                                                                                                                       | 内容                                                                                                                                                                                                                                        |
-| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [`references/operations/hosted-automation-self-control.md`](references/operations/hosted-automation-self-control.md)       | **三类投放自控**：单日预算熔断、CPA 飙升降价、连续空耗暂停；通用约定与常用 JSON 字段表；宿主编排实现清单；与 `forewarning` 的关系                                                                                                           |
-| [`references/operations/hosted-automation-monitoring-json.md`](references/operations/hosted-automation-monitoring-json.md) | **异常监控巡检**：`balance-scan` / `balance` 等 **`--json-out` 落盘**；**`google-analysis --sections overview` / `campaign-hour` / `final-urls`** 与账户分析口径一致时用 **`--json-out <dir>`** 读落盘 `*.json`；拒审相关键名与命令见该文档 |
-| [`references/operations/hosted-automation-optimize-index.md`](references/operations/hosted-automation-optimize-index.md)   | **自动优化（宿主编排）**：差素材降价/关停、高转化扩量、A/B 停输家 — 分文件 SOP（含 `ad list` 按日聚合、`google-analysis --sections campaigns` 等）                                                                                          |
-| [`references/operations/hosted-automation-user-catalog.md`](references/operations/hosted-automation-user-catalog.md)       | **用户向一览**：预算/ROI 自控、异常监控、自动优化表格（可节选给用户；与上表互补）                                                                                                                                                           |
+**必读交叉引用**：
 
-**必读交叉引用**（子文档内会再写一遍）：
+- Google 金额与写命令：`references/google-ads/google-ads.md`
+- 各媒体拉数与日期限制：`references/analytics/account-analytics.md`
+- 余额类命令：`references/accounts/accounts-balance-stats.md`
+- `--json-out`：`references/core/tips.md`
 
-- 金额与展示：`references/google-ads/google-ads.md` § Gotchas（金额单位）；币种见 `references/accounts/currency.md`
-- 通用读命令 **`--json-out`** 与 Node 过滤：`references/core/tips.md`；**`google-analysis` 账户分析** 用 **`--json-out`**：`references/analytics/account-analytics.md`
-- 写命令语法：`references/google-ads/google-ads.md`
-- 账户/维度分析、时间窗：`references/analytics/account-analytics.md`
-- 余额类命令详解：`references/accounts/accounts-balance-stats.md`
-
-**前置**：已 `siluzan-tso login`，并已用 `list-accounts -m Google -k <mediaCustomerId> --json-out ./snap` 确认账户与 `mediaCustomerId`。
+**前置**：已 `siluzan-tso login`。Google 用 `list-accounts -m Google`；Bing 用 `-m BingV2`（数字 ID）；Yandex 用 `-m Yandex`（`porg-…`）。

package/dist/skill/references/operations/hosted-automation-self-control.md

@@ -1,8 +1,9 @@
 # 宿主编排：三类 Google 投放自控（详细步骤）
 
-> **主题索引**：[`references/operations/hosted-automation-scenarios.md`](references/operations/hosted-automation-scenarios.md)  
-> **编排责任**：定时、多条件 IF、滑动时间窗、通知（含 P1 /「空耗熔断」文案）由 **OpenClaw / WorkBuddy / Cron** 等宿主实现。  
+> **主题索引**：[`references/operations/hosted-automation-scenarios.md`](references/operations/hosted-automation-scenarios.md)
+> **编排责任**：定时、多条件 IF、滑动时间窗、通知（含 P1 /「空耗熔断」文案）由 **OpenClaw / WorkBuddy / Cron** 等宿主实现。
 > **本页责任**：说明如何用 `siluzan-tso` **拉检查项**、**执行最终写操作**、**写后复核**。
+> Bing / Yandex **没有**本页写操作，只读巡检见 `hosted-automation-bing.md` / `hosted-automation-yandex.md`。
 
 ## Contents
 
@@ -57,12 +58,12 @@
 
 ### 首选（全户 / 多户 Google）
 
-一条命令扫描名下 Google 户并交付命中表（默认 dry-run）：
+一条命令扫描名下 Google 户并交付命中表（**只读，不暂停**）：
 
 ```bash
 siluzan-tso guard budget-circuit -m Google --date <当日YYYY-MM-DD> --ratio 1.1 --json-out ./snap-guard
-# 确认后：
-siluzan-tso guard budget-circuit -m Google --date <当日> --ratio 1.1 --apply --json-out ./snap-guard --commit "budget-circuit"
+# 确认某条命中后，对该账户单独暂停（写审计记这一次）：
+siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status Paused --commit "超预算熔断"
 ```
 
 参数与落盘字段见 **`references/operations/guard.md`**。**禁止** `list-accounts` 六媒体循环 + 逐户 `ad campaigns`。
@@ -106,7 +107,7 @@ siluzan-tso ad campaign-status -a <mediaCustomerId> --id <campaignId> --status E
 
 | 状态 | 说明                                                                               |
 | ---- | ---------------------------------------------------------------------------------- |
-| 首选 | `guard budget-circuit -m Google`（全户扫描 + 可选 `--apply`）                      |
+| 首选 | `guard budget-circuit -m Google`（全户扫描，只读）；暂停用 `ad campaign-status`     |
 | 单户 | 读：`ad campaigns --json-out`；写：`ad campaign-status`；复核：再次 `ad campaigns` |
 
 ---
@@ -180,10 +181,11 @@ siluzan-tso ad adgroup-edit -a <mediaCustomerId> --id <adGroupId> --max-cpc <主
 
 ```bash
 siluzan-tso guard zero-conv -m Google --date <当日> --cpa-multiple 3 --level adgroup --json-out ./snap-guard
-# 确认后 --apply --commit …；创意维加 --level ad|both --fallback-target-cpa <元>
+# 确认某条命中后，对该账户单独暂停；创意维加 --level ad|both --fallback-target-cpa <元>
+siluzan-tso ad adgroup-status -a <mediaCustomerId> --id <adGroupId> --status Paused --commit "空耗熔断"
 ```
 
-见 **`references/operations/guard.md`**。`summary.label` =「空耗熔断」。
+见 **`references/operations/guard.md`**。摘要文案为「空耗熔断」。
 
 ### 单户排障（可选）
 

package/dist/skill/references/operations/hosted-automation-user-catalog.md

@@ -1,28 +1,24 @@
 # 宿主编排能力目录
 
 > **何时 Read**：用户明确问自动化 / 巡检 / 熔断 / 自控 / 异常监控 / 自动优化时。其他任务**跳过**本文件。
-> **怎么读**：下表每行只 Read **一个**「SOP」列路径。金额口径见 `references/google-ads/google-ads.md` § Gotchas（金额单位） + `references/accounts/currency.md`（**不要**在 SKILL.md 找「金额硬约束」节）。
+> **怎么读**：下表每行只 Read **一个**「SOP」列路径。Google 金额口径见 `references/google-ads/google-ads.md` § Gotchas + `references/accounts/currency.md`。
 > 宿主侧告警优先级写作 **告警P1**（勿与 Playbook **P1** 账户诊断混淆）。
 
-## Contents
-
-- 预算与 ROI 自控
-- 异常监控
-- 自动优化
+`guard` 与自动暂停/改价**只支持 Google**。Bing / Yandex 只能拉数告警，步骤见各自 SOP。
 
 ---
 
-## 预算与 ROI 自控
+## Google：预算与 ROI 自控
 
-| 场景             | 自动动作（摘要）                                                     | 首选 CLI / SOP（只读一份）                                                                                               |
-| ---------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
-| 单日预算熔断     | 当日花费相对日预算达阈值 → 暂停系列                                  | **首选** `references/operations/guard.md`（`guard budget-circuit`）；细节/单户排障见 `hosted-automation-self-control.md` |
-| CPA 飙升自动降价 | 窗内 CPA 超目标 → 下调出价上限                                       | `references/operations/hosted-automation-optimize-weak-downbid.md`                                                       |
-| 连续空耗自动暂停 | 当日花费达阈值且 0 转化 → 暂停组/创意；宿主发 **告警P1**「空耗熔断」 | **首选** `references/operations/guard.md`（`guard zero-conv`）；细节见 `hosted-automation-self-control.md`               |
+| 场景             | 自动动作（摘要）                                                                                         | 首选 CLI / SOP（只读一份）                                                                                               |
+| ---------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| 单日预算熔断     | 当日花费相对日预算达阈值 → **列出命中**；暂停须逐账户 `ad campaign-status`                               | **首选** `references/operations/guard.md`（`guard budget-circuit`）；细节/单户排障见 `hosted-automation-self-control.md` |
+| CPA 飙升自动降价 | 窗内 CPA 超目标 → 下调出价上限                                                                           | `references/operations/hosted-automation-optimize-weak-downbid.md`                                                       |
+| 连续空耗自动暂停 | 当日花费达阈值且 0 转化 → **列出命中**；暂停须逐账户 `adgroup-status`/`ad-status`；宿主发 **告警P1**「空耗熔断」 | **首选** `references/operations/guard.md`（`guard zero-conv`）；细节见 `hosted-automation-self-control.md`               |
 
 > **消耗 ≠ 日消耗**：`spend` 为 `--start`～`--end` 合计。`guard` 命令已强制 `--date` 单日；手写 `ad campaigns` 时须 `start=end=当日`。续航日均用 `balance-scan.dailySpend`。
 
-## 异常监控
+## Google：异常监控
 
 字段键名以当次 `--json-out` 为准，细则只读：`references/operations/hosted-automation-monitoring-json.md`。
 
@@ -34,7 +30,7 @@
 | 花费异动   | `google-analysis --sections campaign-hour`                               |
 | 余额枯竭   | `balance-scan`（P2）                                                     |
 
-## 自动优化
+## Google：自动优化
 
 索引（可选）：`references/operations/hosted-automation-optimize-index.md`。执行时直接读 SOP：
 
@@ -44,3 +40,28 @@
 | 高转化提价扩量  | `references/operations/hosted-automation-optimize-scale.md`                |
 | A/B 决出胜者    | `references/operations/hosted-automation-optimize-ab-winner.md`            |
 | 异动根因排查    | `references/analytics/account-analytics.md` + 对应 `report-templates/*.md` |
+
+---
+
+## Bing（BingV2）：只读巡检
+
+全部步骤只读一份：`references/operations/hosted-automation-bing.md`。**不能**自动暂停/改价/改预算。
+
+| 场景           | 做什么                                                                 | SOP                                              |
+| -------------- | ---------------------------------------------------------------------- | ------------------------------------------------ |
+| 余额 / IO 续航 | `balance-scan -m BingV2`；有 IO 再 `insertion-orders` + `monthly-spend` | `references/operations/hosted-automation-bing.md` |
+| 账户封禁       | `bing-analysis account-status`；非 Active 告警                         | 同上                                             |
+| 素材拒审       | `bing-analysis bulk-ads --editorial-status Disapproved`                | 同上                                             |
+| 落地页死链     | `bulk-ads` 拉 URL，宿主 HTTP 探活                                      | 同上                                             |
+| 当日超预算     | `campaign-entities` 日预算 + `run --aggregation Daily` 当日花费；只告警 | 同上                                             |
+| CPA / 空耗     | `run --aggregation Daily\|Hourly`；只告警，不降价、不暂停              | 同上                                             |
+
+## Yandex：只读巡检
+
+全部步骤只读一份：`references/operations/hosted-automation-yandex.md`。**不能**自动改投放；无封禁/拒审/落地页/小时接口。
+
+| 场景                 | 做什么                                                                 | SOP                                                |
+| -------------------- | ---------------------------------------------------------------------- | -------------------------------------------------- |
+| 余额续航             | `balance-scan -m Yandex`                                               | `references/operations/hosted-automation-yandex.md` |
+| 多账户 CPA / 零转化  | `accounts-digest -m Yandex`（截至昨天）                                | 同上                                               |
+| 当日/近日花费与 CPA  | `yandex-analysis --sections overview,daily,campaigns`（可含今天）      | 同上                                               |

package/dist/skill/references/operations/hosted-automation-yandex.md

@@ -0,0 +1,83 @@
+# 宿主编排：Yandex 只读巡检
+
+> **何时 Read**：用户要 Yandex / 直通广告自动化、巡检、熔断、余额或 CPA 预警。Google 熔断走 `references/operations/guard.md`；Bing 走 `hosted-automation-bing.md`。
+> **能做什么**：拉余额、拉日报/周期报表、宿主按阈值告警。
+> **不能做什么**：暂停、改价、改预算、封禁专用接口、拒审列表、落地页列表、小时花费。没有写命令，**禁止**假装已执行熔断。
+
+**前置**：已 `siluzan-tso login`，并用 `list-accounts -m Yandex --json-out ./snap` 确认 `mediaCustomerId`（形如 `porg-…`，**不是**纯数字，也不是 `entityId`）。
+
+**硬约束**：
+
+- `guard` **只支持 Google**。禁止 `guard … -m Yandex`。
+- 没有 `account-status` / `bulk-ads` / `campaign-entities` 这类实体子命令。
+- `yandex-analysis` 日期不能晚于今天；省略则默认近 7 天**含今天**。`search-terms` 只支持近 180 天。
+- `balance-scan` / `accounts-digest` 的消耗是每日同步**截至昨天**；查当天消耗用 `yandex-analysis`，不要用 `stats` 判断今天。
+
+---
+
+## 1. 余额续航
+
+```bash
+siluzan-tso balance-scan -m Yandex --threshold-days 7 --json-out ./snap-yandex
+```
+
+已知子集加 `-a porg-xxx,porg-yyy`。命中续航/余额不足 → 宿主通知充值。CLI **不能**自动充值。单户复核：
+
+```bash
+siluzan-tso balance -m Yandex -a <porg-xxx> --json-out ./snap-yandex
+```
+
+---
+
+## 2. 多账户消耗 / CPA / 零转化（截至昨天）
+
+一条命令扫该媒体全部户（或 `-a` 子集）。区间必须是已结束的日期，**不要把今天当完整日**：
+
+```bash
+siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --json-out ./snap-yandex
+siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --zero-conversions --json-out ./snap-yandex
+siluzan-tso accounts-digest -m Yandex --start <S> --end <D> --max-cpa <目标CPA> --json-out ./snap-yandex
+```
+
+命中 → 宿主告警账户、区间花费、转化、CPA。不能自动关停。
+
+---
+
+## 3. 单户当日 / 近日花费与 CPA（可含今天）
+
+```bash
+mkdir -p ./snap-yandex
+siluzan-tso yandex-analysis -a <porg-xxx> --json-out ./snap-yandex \
+  --start <当日或近几日> --end <当日> --sections overview,daily,campaigns
+```
+
+宿主侧：
+
+- **日花费异动**：读 `daily` 按日对比前一日或近 7 日均值，超阈值告警。
+- **系列花费 / 预算**：同一窗口读 `campaigns`，用落盘里的花费对照 `budget`；缺字段就不要猜，改用日环比。
+- **CPA**：`花费 / 转化`（转化为 0 不算 CPA，改走空耗判断）。超过约定目标倍数 → 告警。
+- **空耗**：当日（或约定日）花费已达「目标 CPA × N」且转化为 0 → 告警「空耗预警」，文案不要写成「已熔断」。目标 CPA 用落盘 `targetCpa` 或账户约定。
+
+没有小时维度，做不了「近两小时 CPA」。
+
+---
+
+## 4. 周期报告（给人看，不代替巡检告警）
+
+```bash
+siluzan-tso yandex-analysis -a <porg-xxx> --start <S> --end <D> --json-out ./snap-yandex
+```
+
+出 HTML 按 `report-templates/yandex-period-report.md` 写 narrative 后再 `yandex-analysis render`。自动化任务里报告是可选交付物；阈值告警仍走上面 1–3 步。
+
+---
+
+## 做不到（勿编造命令）
+
+| 场景           | 现状                                      |
+| -------------- | ----------------------------------------- |
+| 账户封禁专用   | 无；`list-accounts` 状态仅供人工看        |
+| 素材拒审       | 无拒审列表                                |
+| 落地页探活     | 无最终到达网址接口                        |
+| 小时花费       | 无                                        |
+| 自动暂停 / 改价 | 无写接口；告警后人工在 Yandex 后台处理 |

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.2'
+$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.2"
+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/eval/cases/guard-budget-circuit-all-google.scenario.json

@@ -4,7 +4,7 @@
   "turns": [
     "检查我名下的所有广告账户下所有广告系列的当日花费。如果某个系列的当日花费达到其日预算的 110% 以上，先列出被命中的系列名称、当日花费和日预算（先不要暂停）。用 siluzan-tso，JSON 落盘。这是定时任务，直接执行。"
   ],
-  "judgeExpectation": "路径：用户要求检查名下所有账户系列当日花费相对日预算达 110% 并列出/暂停时，应执行 `siluzan-tso guard budget-circuit -m Google`（可带 --date/--ratio/--json-out），**不要**对六媒体 list-accounts 后再逐户 `ad campaigns`。\n默认 dry-run 即可交付命中表；未获确认前可不加 --apply。输出须收口（命中列表或明确无命中）。",
+  "judgeExpectation": "路径：用户要求检查名下所有账户系列当日花费相对日预算达 110% 并列出命中时，应执行 `siluzan-tso guard budget-circuit -m Google`（可带 --date/--ratio/--json-out），**不要**对六媒体 list-accounts 后再逐户 `ad campaigns`。\n`guard` 只扫描不暂停；若用户随后要求停某一条，须对该账户单独执行 `ad campaign-status --status Paused --commit`。输出须收口（命中列表或明确无命中）。",
   "skillMapping": "references/operations/guard.md · budget-circuit",
   "judgeReferencePaths": [
     "references/operations/guard.md",

package/eval/cases/guard-zero-conv-empty-spend.scenario.json

@@ -4,7 +4,7 @@
   "turns": [
     "检查我名下的所有广告账户的当日数据。对于当日累计花费已达到目标 CPA 3 倍以上、但转化数为 0 的广告组，先列出（标注「空耗熔断」），先不要暂停。用 siluzan-tso，JSON 落盘，直接执行。"
   ],
-  "judgeExpectation": "路径：用户要求空耗熔断（当日花费 ≥ 目标 CPA × 3 且转化 0）时，应执行 `siluzan-tso guard zero-conv -m Google`（--cpa-multiple 3、--json-out），结果摘要应体现「空耗熔断」。\n默认 dry-run；未确认前可不 --apply。禁止逐户 for-loop `ad groups`。",
+  "judgeExpectation": "路径：用户要求空耗熔断（当日花费 ≥ 目标 CPA × 3 且转化 0）时，应执行 `siluzan-tso guard zero-conv -m Google`（--cpa-multiple 3、--json-out），结果摘要应体现「空耗熔断」。\n`guard` 只扫描不暂停；禁止 `--apply`。禁止逐户 for-loop `ad groups`。",
   "skillMapping": "references/operations/guard.md · zero-conv",
   "judgeReferencePaths": ["references/operations/guard.md"],
   "commandMustInclude": [["guard", "zero-conv"], ["--json-out"]]

package/eval/stub-fixtures/guard-budget-circuit.json

@@ -7,7 +7,6 @@
     "media": "Google",
     "date": "2026-07-28",
     "ratio": 1.1,
-    "apply": false,
     "stub": true
   },
   "summary": {
@@ -15,9 +14,7 @@
     "accountCount": 1,
     "checkedCampaigns": 2,
     "hitCount": 1,
-    "pausedCount": 0,
-    "errorCount": 0,
-    "mode": "dry-run"
+    "errorCount": 0
   },
   "hits": [
     {
@@ -27,10 +24,8 @@
       "spend": 120,
       "budget": 100,
       "ratio": 1.1,
-      "threshold": 110,
-      "applied": false
+      "threshold": 110
     }
   ],
-  "paused": [],
   "errors": []
 }

package/eval/stub-fixtures/guard-zero-conv.json

@@ -8,7 +8,6 @@
     "date": "2026-07-28",
     "cpaMultiple": 3,
     "level": "adgroup",
-    "apply": false,
     "stub": true
   },
   "summary": {
@@ -16,10 +15,8 @@
     "accountCount": 1,
     "checkedObjects": 2,
     "hitCount": 1,
-    "pausedCount": 0,
     "skippedCount": 0,
-    "errorCount": 0,
-    "mode": "dry-run"
+    "errorCount": 0
   },
   "hits": [
     {
@@ -31,11 +28,9 @@
       "conversions": 0,
       "targetCpaYuan": 100,
       "multiple": 3,
-      "threshold": 300,
-      "applied": false
+      "threshold": 300
     }
   ],
-  "paused": [],
   "skipped": [],
   "errors": []
 }

package/package.json

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