siluzan-tso-cli 1.1.18-beta.5 → 1.1.18-beta.7

package/README.md

@@ -51,7 +51,7 @@ siluzan-tso init -d /path/to/skills  # 写入自定义目录
 siluzan-tso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.18-beta.5），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
+> **注意**：当前为测试版（1.1.18-beta.7），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-tso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |
@@ -69,7 +69,18 @@ siluzan-tso init --force             # 强制覆盖已存在文件
 
 **若用户已安装 `siluzan-cso` 并完成登录，无需重复操作，直接跳到第 4 步。**
 
-### 方式 A：交互式登录（推荐）
+**推荐顺序**：① **手机号 + 验证码**（首选）完整参数与排错见 `references/setup.md`（随 Skill 安装到本地）。
+
+### 方式 A：手机号 + 验证码（**推荐**）
+
+```bash
+siluzan-tso send-login-code --phone <手机号>
+siluzan-tso login --phone <手机号> --code <6位验证码>
+```
+
+不向终端索要交互输入；Agent 先发码、用户回填验证码后再执行第二步。手机号须已在丝路赞注册。
+
+### 方式 B：交互式登录（需真人 TTY）
 
 ```bash
 siluzan-tso login
@@ -81,13 +92,13 @@ siluzan-tso login
 siluzan-tso login --api-key <YOUR_API_KEY>
 ```
 
-### 方式 B：直接设置（适合自动化场景）
+### 方式 C：直接设置（适合自动化场景）
 
 ```bash
 siluzan-tso config set --api-key <你的ApiKey>
 ```
 
-### 方式 C：Token 登录（已有 siluzan-cso 账号）
+### 方式 D：Token 登录（已有 siluzan-cso 账号）
 
 ```bash
 npm install -g siluzan-cso-cli
@@ -137,4 +148,4 @@ siluzan-tso init --ai xxx --force
 
 ## 6. Token 续期
 
-Token 过期后，重新运行 `siluzan-cso login` 或 `siluzan-tso config set --api-key <新Key>` 即可，`siluzan-tso` 自动读取新凭据，无需额外操作。
+Token 过期后：**优先**再走一遍**方式 A**（手机验证码）签发新 API Key；或 `siluzan-cso login` / `siluzan-tso config set --api-key <新Key>`，`siluzan-tso` 自动读取新凭据。

package/dist/index.js

@@ -1974,6 +1974,7 @@ import { performance } from "perf_hooks";
 import * as fs2 from "fs";
 import * as path2 from "path";
 import { fileURLToPath } from "url";
+import { spawn } from "child_process";
 import Table from "cli-table3";
 import * as path3 from "path";
 import { chmod, mkdir, open, readdir, stat, unlink } from "fs/promises";
@@ -2375,6 +2376,29 @@ async function fetchNpmVersion(pkgName, tag, timeoutMs = 4e3) {
     return null;
   }
 }
+async function defaultRunMinRequiredGlobalInstall(ctx) {
+  if (process.env.SILUZAN_SKIP_AUTO_GLOBAL_INSTALL === "1") {
+    return { ok: false, stderr: "SILUZAN_SKIP_AUTO_GLOBAL_INSTALL=1" };
+  }
+  const spec = `${ctx.pkgName}@${ctx.tag}`;
+  return await new Promise((resolve32) => {
+    const child = spawn("npm", ["install", "-g", spec, "--no-fund", "--no-audit"], {
+      stdio: "inherit",
+      shell: true
+    });
+    child.on("error", (err) => {
+      resolve32({ ok: false, stderr: err instanceof Error ? err.message : String(err) });
+    });
+    child.on("close", (code, signal) => {
+      if (code === 0) {
+        resolve32({ ok: true });
+      } else {
+        const sig = signal ? ` signal=${signal}` : "";
+        resolve32({ ok: false, stderr: `exit code ${code}${sig}` });
+      }
+    });
+  });
+}
 function createVersionNotifier(opts) {
   const {
     pkgName,
@@ -2383,27 +2407,33 @@ function createVersionNotifier(opts) {
     resolveTag,
     forceUpdateExtra = "",
     updateAvailableExtra = "",
+    runMinRequiredGlobalInstall = defaultRunMinRequiredGlobalInstall,
     getCurrentVersion: getCurrentVersion22,
     mergeWriteConfig,
     readConfigRaw
   } = opts;
-  const KEY_LAST_CHECK = `${cachePrefix}LastVersionCheck`;
   const KEY_LATEST_STABLE = `${cachePrefix}LatestStable`;
   const KEY_LATEST_BETA = `${cachePrefix}LatestBeta`;
   const KEY_MIN_STABLE = `${cachePrefix}MinRequiredStable`;
   const KEY_MIN_BETA = `${cachePrefix}MinRequiredBeta`;
   const KEY_LAST_NOTIFIED = `${cachePrefix}LastNotified`;
+  const KEY_FETCH_AT_MAIN = `${cachePrefix}VersionFetchAtMain`;
+  const KEY_FETCH_AT_MIN = `${cachePrefix}VersionFetchAtMin`;
   const HOURS_24 = 24 * 60 * 60 * 1e3;
-  async function fetchVersionByTag(tag, cacheKey, cfg) {
-    const lastCheck = cfg[KEY_LAST_CHECK];
-    if (typeof lastCheck === "string" && cacheKey in cfg) {
-      const lastMs = new Date(lastCheck).getTime();
-      if (Date.now() - lastMs < HOURS_24) {
+  const TTL_MAIN_TAG_MS = 60 * 60 * 1e3;
+  const TTL_MIN_REQUIRED_MS = HOURS_24;
+  async function fetchVersionByTag(tag, cacheKey, fetchAtKey, cfg, maxAgeMs) {
+    const lastAt = cfg[fetchAtKey];
+    if (typeof lastAt === "string" && cacheKey in cfg) {
+      const lastMs = new Date(lastAt).getTime();
+      if (Date.now() - lastMs < maxAgeMs) {
         const v = cfg[cacheKey];
-        return typeof v === "string" && v ? v : null;
+        const sv = typeof v === "string" && v ? v : null;
+        return { version: sv, hitNetwork: false };
       }
     }
-    return fetchNpmVersion(pkgName, tag);
+    const version = await fetchNpmVersion(pkgName, tag);
+    return { version, hitNetwork: true };
   }
   async function notifyIfOutdated2() {
     try {
@@ -2414,15 +2444,20 @@ function createVersionNotifier(opts) {
       const minCacheKey = isBeta ? KEY_MIN_BETA : KEY_MIN_STABLE;
       const minTag = npmMinRequiredTagForBuildEnv(isBeta ? "test" : "production");
       const cfg = readConfigRaw();
-      const [latest, minRequired] = await Promise.all([
-        fetchVersionByTag(tag, latestCacheKey, cfg),
-        fetchVersionByTag(minTag, minCacheKey, cfg)
+      const [mainRes, minRes] = await Promise.all([
+        fetchVersionByTag(tag, latestCacheKey, KEY_FETCH_AT_MAIN, cfg, TTL_MAIN_TAG_MS),
+        fetchVersionByTag(minTag, minCacheKey, KEY_FETCH_AT_MIN, cfg, TTL_MIN_REQUIRED_MS)
       ]);
-      await mergeWriteConfig({
-        [KEY_LAST_CHECK]: (/* @__PURE__ */ new Date()).toISOString(),
+      const latest = mainRes.version;
+      const minRequired = minRes.version;
+      const nowIso = (/* @__PURE__ */ new Date()).toISOString();
+      const cacheUpdates = {
         [latestCacheKey]: latest ?? "",
         [minCacheKey]: minRequired ?? ""
-      });
+      };
+      if (mainRes.hitNetwork) cacheUpdates[KEY_FETCH_AT_MAIN] = nowIso;
+      if (minRes.hitNetwork) cacheUpdates[KEY_FETCH_AT_MIN] = nowIso;
+      await mergeWriteConfig(cacheUpdates);
       const lastNotified = typeof cfg[KEY_LAST_NOTIFIED] === "string" ? new Date(cfg[KEY_LAST_NOTIFIED]).getTime() : 0;
       if (Date.now() - lastNotified < HOURS_24) return;
       const tagLabel = isBeta ? "\uFF08\u6D4B\u8BD5\u7248\uFF09" : "\uFF08\u6B63\u5F0F\u7248\uFF09";
@@ -2430,11 +2465,26 @@ function createVersionNotifier(opts) {
         await mergeWriteConfig({ [KEY_LAST_NOTIFIED]: (/* @__PURE__ */ new Date()).toISOString() });
         console.log(
           `
-[SILUZAN_FORCE_UPDATE] \u5F53\u524D\u7248\u672C ${current} \u5DF2\u8FC7\u671F\uFF0C\u6700\u4F4E\u8981\u6C42\u7248\u672C ${minRequired}${tagLabel}
-\u26D4 \u5FC5\u987B\u5148\u5347\u7EA7\u624D\u80FD\u7EE7\u7EED\u4F7F\u7528\uFF0CAgent \u8BF7\u7ACB\u5373\u6267\u884C\uFF1A${binName} update
-   \u6216\u624B\u52A8\uFF1Anpm install -g ${pkgName}@${tag}
+[SILUZAN_FORCE_UPDATE] \u5F53\u524D\u7248\u672C ${current} \u5DF2\u4F4E\u4E8E\u6700\u4F4E\u8981\u6C42 ${minRequired}${tagLabel}
+\u26D4 \u6B63\u5728\u81EA\u52A8\u6267\u884C\uFF1Anpm install -g ${pkgName}@${tag}
 ` + (forceUpdateExtra ? forceUpdateExtra + "\n" : "")
         );
+        const installResult = await runMinRequiredGlobalInstall({ pkgName, tag });
+        if (installResult.ok) {
+          console.log(
+            `
+[SILUZAN_AUTO_GLOBAL_INSTALL_OK] \u5168\u5C40\u5B89\u88C5\u5DF2\u5B8C\u6210\uFF0C\u8BF7\u91CD\u65B0\u8FD0\u884C\u672C\u547D\u4EE4\u4EE5\u52A0\u8F7D\u65B0\u7248\u672C ${pkgName}@${tag}\u3002
+`
+          );
+        } else {
+          console.log(
+            `
+[SILUZAN_AUTO_GLOBAL_INSTALL_FAILED] \u81EA\u52A8\u5168\u5C40\u5B89\u88C5\u5931\u8D25\uFF1A${installResult.stderr ?? "unknown"}
+\u8BF7\u624B\u52A8\u6267\u884C\uFF1Anpm install -g ${pkgName}@${tag}
+\u6216\uFF1A${binName} update
+` + (forceUpdateExtra ? forceUpdateExtra + "\n" : "")
+          );
+        }
         return;
       }
       if (latest && isNewer(current, latest)) {
@@ -5925,6 +5975,11 @@ async function fetchJson(config, pathWithQuery, verbose) {
 function assertNever(x, ctx) {
   throw new Error(`${ctx}\uFF1A\u672A\u5904\u7406\u7684\u5206\u652F ${String(x)}`);
 }
+function rowsFromAccountDailyReportsEnvelope(raw, mediaCustomerId) {
+  const block = raw.accounts?.[mediaCustomerId];
+  const list = block?.data;
+  return Array.isArray(list) ? list : [];
+}
 async function fetchGoogleAnalysisSectionJson(config, fullPath, verbose, name) {
   switch (name) {
     case "overview":
@@ -5955,8 +6010,6 @@ async function fetchGoogleAnalysisSectionJson(config, fullPath, verbose, name) {
       return fetchJson(config, fullPath, verbose);
     case "conversion-actions":
       return fetchJson(config, fullPath, verbose);
-    case "daily-metrics":
-      return fetchJson(config, fullPath, verbose);
     case "gold-account":
       return fetchJson(config, fullPath, verbose);
     case "ads-index":
@@ -6009,6 +6062,18 @@ async function fetchSectionPayload(def, opts, config, id) {
     const merged = { images, videos };
     return stripLegacyGoogleFieldsIfV2Present(merged);
   }
+  if (def.name === "daily-metrics") {
+    const { startDate, endDate } = resolveDateRange2(opts.start, opts.end);
+    const params = new URLSearchParams({
+      mediaCustomerIds: id,
+      startDate: `${startDate}T00:00:00+08:00`,
+      endDate: `${endDate}T23:59:59+08:00`
+    });
+    const url = `${config.apiBaseUrl}/report/media-account/google/account-daily-reports?${params.toString()}`;
+    const raw = await apiFetch2(url, config, {}, !!opts.verbose);
+    const rows = rowsFromAccountDailyReportsEnvelope(raw, id);
+    return stripLegacyGoogleFieldsIfV2Present(rows);
+  }
   const sectionPath = def.path(id);
   const query = buildSearchParams(def, opts.start, opts.end, extras);
   const data = await fetchGoogleAnalysisSectionJson(
@@ -6417,9 +6482,10 @@ var init_google_analysis2 = __esm({
       },
       {
         name: "daily-metrics",
-        description: "\u6309\u65E5\u6307\u6807\u66F2\u7EBF reports\uFF08\u542B\u8F6C\u5316\u6210\u672C\u7B49\uFF09",
+        description: "\u6309\u65E5\u6307\u6807\uFF08\u4E3B\u5E73\u53F0 /report/media-account/google/account-daily-reports\uFF0C\u542B\u641C\u7D22\u4EFD\u989D\u7B49\uFF09",
         dateMode: "range",
-        path: (id) => `/reporting/media-account/${id}/reports`
+        /** 仅用于 manifest endpointHint；实际请求走 fetchSectionPayload 专用分支（apiBaseUrl + 东八区起止时刻） */
+        path: () => "/report/media-account/google/account-daily-reports"
       },
       {
         name: "gold-account",
@@ -14328,6 +14394,42 @@ init_auth();
 init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
+function unwrapKeywordDisplayTextForEdit(raw) {
+  const t = raw.trim();
+  if (t.length >= 2 && t.startsWith('"') && t.endsWith('"')) {
+    return t.slice(1, -1);
+  }
+  if (t.length >= 2 && t.startsWith("[") && t.endsWith("]")) {
+    return t.slice(1, -1);
+  }
+  return t;
+}
+function formatKeywordTextForMatchType(rawCoreOrDisplay, matchType) {
+  const core = unwrapKeywordDisplayTextForEdit(rawCoreOrDisplay);
+  switch (matchType) {
+    case "Broad":
+      return core;
+    case "Phrase":
+      return `"${core}"`;
+    case "Exact":
+      return `[${core}]`;
+    default: {
+      const _x = matchType;
+      return _x;
+    }
+  }
+}
+function firstKeywordTextFromRecord(k) {
+  const kt = k["keywordText"];
+  if (Array.isArray(kt) && kt.length > 0 && typeof kt[0] === "string") {
+    return kt[0];
+  }
+  const t = k["text"];
+  if (typeof t === "string") {
+    return t;
+  }
+  return "";
+}
 async function runAdKeywords(opts) {
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
@@ -14519,8 +14621,17 @@ async function runAdKeywordEdit(opts) {
     process.exit(1);
   }
   const body = { ...keyword };
-  if (opts.text !== void 0) body["keywordText"] = [opts.text];
-  if (opts.matchType !== void 0) body["matchTypeV2"] = opts.matchType;
+  if (opts.matchType !== void 0) {
+    const base = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
+    if (!String(base).trim()) {
+      console.error("\n\u274C \u65E0\u6CD5\u89E3\u6790\u5F53\u524D\u5173\u952E\u8BCD\u6587\u6848\uFF0C\u8BF7\u540C\u65F6\u4F20 --text <\u8BCD\u5E72>\n");
+      process.exit(1);
+    }
+    body["keywordText"] = [formatKeywordTextForMatchType(base, opts.matchType)];
+    body["matchTypeV2"] = opts.matchType;
+  } else if (opts.text !== void 0) {
+    body["keywordText"] = [opts.text];
+  }
   if (opts.maxCpc !== void 0) body["maxCPC"] = opts.maxCpc;
   if (opts.finalUrl !== void 0) body["finalURL"] = opts.finalUrl;
   const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
@@ -14567,8 +14678,17 @@ async function runAdNegativeKeywordEdit(opts) {
     process.exit(1);
   }
   const body = { ...keyword };
-  if (opts.text !== void 0) body["keywordText"] = [opts.text];
-  if (opts.matchType !== void 0) body["matchTypeV2"] = opts.matchType;
+  if (opts.matchType !== void 0) {
+    const base = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
+    if (!String(base).trim()) {
+      console.error("\n\u274C \u65E0\u6CD5\u89E3\u6790\u5F53\u524D\u5426\u5B9A\u5173\u952E\u8BCD\u6587\u6848\uFF0C\u8BF7\u540C\u65F6\u4F20 --text <\u8BCD\u5E72>\n");
+      process.exit(1);
+    }
+    body["keywordText"] = [formatKeywordTextForMatchType(base, opts.matchType)];
+    body["matchTypeV2"] = opts.matchType;
+  } else if (opts.text !== void 0) {
+    body["keywordText"] = [opts.text];
+  }
   const url = `${googleApiUrl}/negativekeywordmanagement/negativekeyword/${opts.account}/${opts.id}`;
   try {
     await apiFetch2(url, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
@@ -15870,7 +15990,10 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("keyword-edit").description("\u7F16\u8F91\u641C\u7D22\u5173\u952E\u8BCD\uFF08\u6570\u7EC4 body\uFF0C\u5148 list \u518D\u5408\u5E76\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C\uFF08\u5199\u5165 keywordText \u6570\u7EC4\uFF09").option("--match-type <type>", "\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u5199\u5165 matchTypeV2\uFF09").option(
+  adCmd.command("keyword-edit").description("\u7F16\u8F91\u641C\u7D22\u5173\u952E\u8BCD\uFF08\u6570\u7EC4 body\uFF0C\u5148 list \u518D\u5408\u5E76\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C\uFF08\u5199\u5165 keywordText \u6570\u7EC4\uFF09").option(
+    "--match-type <type>",
+    '\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u5199 matchTypeV2\uFF0C\u5E76\u9ED8\u8BA4\u540C\u6B65\u6539\u5199 keywordText \u4E3A\u8BCD\u5E72/"\u8BCD"/[\u8BCD] \u4EE5\u7B26\u5408\u7F51\u5173\u63A8\u65AD\uFF09'
+  ).option(
     "--max-cpc <n>",
     "\u6700\u9AD8\u6BCF\u6B21\u70B9\u51FB\u8D39\u7528 maxCPC\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 5 \u8868\u793A \xA55\uFF1B\u26A0\uFE0F \u8FD9\u4E2A\u5B57\u6BB5\u540E\u7AEF\u5355\u4F4D\u5C31\u662F\u300C\u4E3B\u5E01\u79CD\u5143\u300D\uFF0CCLI \u76F4\u63A5\u900F\u4F20\u4E0D\u505A \xD7100\uFF0C\u4E0E budget / \u7EC4 maxCPCAmount \u4E0D\u540C\uFF1B0 \u8868\u793A\u6309\u5E73\u53F0/\u8BA1\u5212\u9ED8\u8BA4\uFF09"
   ).option("--final-url <url>", "\u5173\u952E\u8BCD\u7EA7\u6700\u7EC8\u5230\u8FBE\u7F51\u5740 finalURL").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
@@ -15901,7 +16024,10 @@ function register20(program2) {
       });
     }
   );
-  adCmd.command("keyword-negative-edit").description("\u7F16\u8F91\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u6587\u672C\u6216\u5339\u914D\u7C7B\u578B\uFF0C\u81F3\u5C11\u4F20\u4E00\u4E2A\u4FEE\u6539\u9879\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5426\u5B9A\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --negative --json \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C").option("--match-type <type>", "\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  adCmd.command("keyword-negative-edit").description("\u7F16\u8F91\u5426\u5B9A\u5173\u952E\u8BCD\uFF08\u6587\u672C\u6216\u5339\u914D\u7C7B\u578B\uFF0C\u81F3\u5C11\u4F20\u4E00\u4E2A\u4FEE\u6539\u9879\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5426\u5B9A\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --negative --json \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C").option(
+    "--match-type <type>",
+    '\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u5199 matchTypeV2\uFF0C\u5E76\u9ED8\u8BA4\u540C\u6B65\u6539\u5199 keywordText \u4E3A\u8BCD\u5E72/"\u8BCD"/[\u8BCD]\uFF09'
+  ).option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.matchType && !["Broad", "Phrase", "Exact"].includes(opts.matchType)) {
         console.error("\n\u274C --match-type \u53EA\u63A5\u53D7 Broad | Phrase | Exact\n");
@@ -16403,7 +16529,7 @@ async function runAccountShareDetail(opts) {
 
 // src/commands/account-manage/oauth.ts
 init_auth();
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 function toApiMediaType(media) {
   return media === "Meta" ? "FacebookAds" : media;
 }
@@ -16414,17 +16540,17 @@ function tryOpenBrowser(url) {
       return false;
     }
     if (process.platform === "win32") {
-      const child = spawn("rundll32", ["url.dll,FileProtocolHandler", parsed.toString()], {
+      const child = spawn2("rundll32", ["url.dll,FileProtocolHandler", parsed.toString()], {
         detached: true,
         stdio: "ignore",
         windowsHide: true
       });
       child.unref();
     } else if (process.platform === "darwin") {
-      const child = spawn("open", [parsed.toString()], { detached: true, stdio: "ignore" });
+      const child = spawn2("open", [parsed.toString()], { detached: true, stdio: "ignore" });
       child.unref();
     } else {
-      const child = spawn("xdg-open", [parsed.toString()], { detached: true, stdio: "ignore" });
+      const child = spawn2("xdg-open", [parsed.toString()], { detached: true, stdio: "ignore" });
       child.unref();
     }
     return true;

package/dist/skill/SKILL.md

@@ -26,7 +26,7 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 
 Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令时存在兼容性问题。若上述命令异常失败，请先安装 [Git for Windows](https://git-scm.com/download/win)，然后在 Git Bash 中执行 macOS / Linux / WSL 的 Bash 安装命令。
 
-参照 `references/setup.md` 完成安装与配置。
+参照 `references/setup.md` 完成安装与配置。**需登录或我方 401 换凭据时，优先引导「手机号 + 验证码」**（`send-login-code` → `login --phone --code`），详见 `references/setup.md` 登录优先级说明。
 
 ---
 
@@ -34,7 +34,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 
 | 文档 | 功能 |
 |------|------|
-| `references/setup.md` | 安装、登录、配置、环境切换、更新 |
+| `references/setup.md` | 安装、**登录（手机验证码优先）**、配置、环境切换、更新 |
 | `references/workflows.md` | 多步骤业务流程、跨命令串联 |
 | `references/tips.md` | **Agent 拉数一律 `--json-out`**（目录或 `*.json` 文件）+ 读 `cli-manifest[-<查询id>].json` / 各 `<section>[-<查询id>].json` + **`*.outline.txt`**（TS 式类型，**几百字节，描述完整字段结构**——写聚合脚本前先读它而不是 `Read` 整个 JSON，省 2~3 个数量级 context）；stdout 一行摘要含 `manifestFile` / `writtenFiles` / `outlineFile` 等 |
 | `references/accounts.md` | 账户列表、余额、消耗、开户记录、授权/解绑/分享/MCC/BC/BM/邮箱授权 |
@@ -147,7 +147,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 2. 中断后**必须**用 `resume --run-id <id>` 续跑，**禁止**重新 `run`。
 3. stdout 始终是单行 JSON（`kind=siluzan-tso-batch-summary`）；进度读 `progress.json`、轨迹读 `state/tasks.jsonl`。
 4. 退出码：`0` 全成功 / `2` 部分成功 / `3` 全失败或 Token 失效 / `4` 用法错误。
-5. 401 响应 → 整批终止 + `tokenInvalidated:true`，提示用户重新登录`references/setup.md` 后再 resume。
+5. 401 响应 → 整批终止 + `tokenInvalidated:true`，提示用户按 `references/setup.md` **优先手机验证码**重新登录后再 `resume`。
 
 若无批量命令（如 117 个 Bing 账户剩余天数计算）：先 `list-accounts --json-out <dir>` 一次性拿全量 → `node -e` 本地计算 → 只对命中账户做后续操作。
 
@@ -244,7 +244,7 @@ siluzan-tso accounts-digest -m Google -a id1,id2,... --start <S> --end <D> --jso
 ### 常见 HTTP 状态码
 
 - **400**：参数错误，查看对应 reference 或用 `-h` 了解命令用法
-- **401**：平台方返回则需用户重新授权；我方返回则让用户执行 `siluzan-tso login`
+- **401**：平台方返回则需用户重新授权；**我方凭据失效**则优先 **`send-login-code` + `login --phone --code`**（或 TTY 下 `siluzan-tso login` / `config set …`），见 `references/setup.md`
 - **500**：服务可能正在部署/升级，建议提交给 Siluzan 相关人员
 
 ### 报告模板外部资源

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.18-beta.5",
-  "publishedAt": 1778322175468
+  "version": "1.1.18-beta.7",
+  "publishedAt": 1778465751958
 }

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

@@ -33,10 +33,10 @@
 2. 确定报告维度（默认含：执行摘要、每日趋势、月度汇总、系列表现、设备分布、地域分布、关键词表现、优化建议），详见 `report-templates/README.md`。
 3. **拉数**：使用 `google-analysis … --json-out <dir>`（Google）或对应 `report <media>-*` 命令落盘。
 4. **编写并执行代码**从磁盘读取 `manifest-<accountId>.json` 与各 `<section>-<accountId>.json` 来完成筛选、聚合、排序等计算；**禁止**用 `Read` 看 JSON 后在对话里心算或手填报告数字。
-   - **写脚本前先读 `<section>-<accountId>.outline.txt`**（与 JSON 同 stem 的纯文本，最后一行是 TS 式类型字面量）了解字段结构；它体积只有几百字节、不含数据，比直接 `Read` 整个 `*.json`（动辄几 MB / 几万行）省**两到三个数量级**的上下文。**注意是 `.outline.txt` 不是 `.outline.json`**，不要 `require()`，用 `fs.readFileSync(outlineFile,'utf8')` 读最后一行即可。
-   - 真实数据始终从 `<section>-<accountId>.json` 由脚本读，**不要**把 outline 当作业务数据贴给用户。
-5. **由代码写出最终文件**（HTML/Excel/PDF/PPT/Markdown 等）。**禁止**在报告脚本中以源码字面量写死应从 JSON 读取的业务数据（消耗金额、系列名、日期区间等）。允许的常量仅限：快照目录路径、JSON 字段键名、版式/结构占位。
-6. **报告首行**须标注：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`，由脚本从 JSON 拼接写入，不得手写常量冒充。
+   - **写脚本前先读 `<section>-<accountId>.outline.txt`**（与 JSON 同 stem 的纯文本，最后一行是 TS 式类型字面量）了解字段结构；它体积只有几百字节、不含数据，比直接 `Read` 整个 `*.json`（动辄几 MB / 几万行）省**两到三个数量级**的上下文，不要 `require()`，用 `fs.readFileSync(outlineFile,'utf8')` 读最后一行即可。
+   - 真实数据始终从 `<section>-<accountId>.json` 通过代码获取，**不要**把 outline 当作业务数据贴给用户。
+5. **由代码写出最终文件**（HTML/Excel/PDF/PPT/Markdown/word 等）。**禁止**在报告脚本中以源码字面量写死应从 JSON 读取的业务数据（消耗金额、系列名、日期区间等）。允许的常量仅限：快照目录路径、JSON 字段键名、版式/结构占位。
+6. **报告首行**须标注：`统计区间：YYYY-MM-DD ~ YYYY-MM-DD（货币：XXX）`
 7. 交付后帮用户打开报告文件。
 
 ---
@@ -139,7 +139,7 @@ siluzan-tso google-analysis -a <id> --exclude materials,gold-account --json-out
 | `materials` | 合并图片+视频 `{ images, videos }` |
 | `resource-counts` | 结构统计 |
 | `conversion-actions` | 转化动作 |
-| `daily-metrics` | 按日报表 |
+| `daily-metrics` | 按日指标（主平台 `GET …/report/media-account/google/account-daily-reports`，`--json` 根为按日数组） |
 | `gold-account` | 黄金账户 |
 | `ads-index` | 质量指标 |
 | `final-urls` | 最终到达网址（不传 `--start`/`--end`） |

package/dist/skill/references/accounts.md

@@ -1,7 +1,5 @@
 # 账户管理命令详解
 
-> 所属 skill：`siluzan-tso`。通用选项 `--token <token>` 可覆盖配置文件中的 Token（通常无需传，直接使用 `siluzan-tso login` 保存的配置）。
-
 ---
 
 ## list-accounts — 查询广告账户列表

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

@@ -980,6 +980,8 @@ siluzan-tso ad keyword-delete -a 6326027735 --id 2464982882313 --adgroup-id 1955
 
 **约束：** `--text`、`--match-type`、`--max-cpc`、`--final-url` 至少传一项。
 
+**匹配类型与文案：** Google 网关 V2 根据 `keywordText` 上的 `"` / `[` `]` 推断实际 MatchType（会覆盖仅传的 `matchTypeV2`）。因此只要传 `--match-type`，CLI **默认**把 `keywordText` 规范为词干 / `"词干"` / `[词干]` 并写入 `matchTypeV2`，无需额外开关；仅改匹配时可不传 `--text`（用列表里的当前文案去外层括号后再包一层）。
+
 ```bash
 siluzan-tso ad keyword-edit \
   -a <accountId> \
@@ -1009,6 +1011,8 @@ siluzan-tso ad keyword-edit -a 6326027735 --id 2081924039951 \
 
 ## ad keyword-negative-edit — 否词编辑
 
+与搜索词相同：传 `--match-type` 时 CLI 会默认同步改写 `keywordText` 外层括号/引号。
+
 ```bash
 siluzan-tso ad keyword-negative-edit \
   -a <accountId> \

package/dist/skill/references/setup.md

@@ -40,8 +40,11 @@ siluzan-tso init -d /path/to-your/skills       # 写入自定义目录
 
 `siluzan-tso` 与 `siluzan-cso` **共用同一份凭据**，存储在 `~/.siluzan/config.json`，配置一次两个 CLI 均可使用。
 
+> **登录方式优先级**  
+> 1. **首选**：**手机号 + 短信验证码**两段式（`send-login-code` → `login --phone --code`）——无 TTY 不卡死、不依赖浏览器里复制 API Key，**对话式 AI / OpenClaw / CI 日志旁路**均适用。  
 
-### 通过手机号 + 验证码登录（对话式 AI 推荐）
+
+### 通过手机号 + 验证码登录（**首选**；对话式 AI / 无 TTY 与各 Agent 环境）
 
 **两段式调用**，专为 AI Agent 设计——任何一步都不会进入交互等待，绝不会卡住 stdout。
 拆分后单一职责：第 1 步只发码；第 2 步只用 code 换 API Key。这样 Agent 不会因为"看到 stdout 卡住就重试"而触发短信轰炸。
@@ -51,13 +54,12 @@ siluzan-tso init -d /path/to-your/skills       # 写入自定义目录
 | 1 | `siluzan-tso send-login-code --phone <手机号>` | 仅向手机发送 6 位验证码 |
 | 2 | `siluzan-tso login --phone <手机号> --code <验证码>` | 用 code 完成登录并自动签发 API Key 写入 `~/.siluzan/config.json` |
 
-## 其他方式登录
+## 其它登录方式（TTY 交互 / 已有 API Key / JWT）
+
 ```bash
-siluzan-tso login                                    # 交互式登录，按提示创建 API Key 后粘贴
+siluzan-tso login                                    # 交互式登录（需 TTY），按提示创建 API Key 后粘贴
 siluzan-tso login --api-key <YOUR_API_KEY>           # 直接设置 API Key（跳过交互）
-siluzan-tso send-login-code --phone 138xxxx          # 两段式登录第 1 步：发送短信验证码
-siluzan-tso login --phone 138xxxx --code 123456      # 两段式登录第 2 步：用验证码完成登录
-siluzan-tso config set --api-key <Key>               # 或通过 config set 直接写入
+siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 

package/package.json

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