siluzan-tso-cli 1.1.22-beta.10 → 1.1.22-beta.12

package/README.md

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

package/dist/index.js

@@ -4623,7 +4623,10 @@ function buildOutlineHints(section) {
     hints.push(...GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS);
   }
   if (section === "campaigns") {
-    hints.push(...GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS);
+    hints.push(
+      ...GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS,
+      ...GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS
+    );
   }
   const zhHints = GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION[section];
   if (zhHints) hints.push(...zhHints);
@@ -4732,7 +4735,7 @@ async function writeGoogleAnalysisSnapshot(params) {
     agentHint: OUTLINE_AGENT_HINT
   };
 }
-var LEGACY_MANIFEST_FILE, CLI_PACKAGE2, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE2, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
+var LEGACY_MANIFEST_FILE, CLI_PACKAGE2, SCHEMA_VERSION2, DEFAULT_FIELD_GUIDE2, GOOGLE_ANALYSIS_CAMPAIGNS_OUTLINE_BUDGET_HINTS, GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS, RATE_BEARING_SECTIONS, GOOGLE_ANALYSIS_RATE_NORMALIZED_OUTLINE_HINTS, GOOGLE_ANALYSIS_ZH_FIELD_HINTS_BY_SECTION;
 var init_google_analysis = __esm({
   "src/utils/snapshot/google-analysis.ts"() {
     "use strict";
@@ -4749,6 +4752,10 @@ var init_google_analysis = __esm({
       "// \u91D1\u989D\uFF1A`campaigns[].budgetAmountYuan` / `campaignTargetCpaYuan` / `maximizeConversionsTargetCpaYuan` \u5747\u4E3A**\u5143**\uFF08CLI \u51FA\u53E3\u7EDF\u4E00\uFF09\uFF1B\u540C\u884C `spend` / `averageCpc` / `costPerConversion` \u4E5F\u662F\u5143\u3002",
       "// \u65E7\u5B57\u6BB5 `budgetAmount`\uFF08\u5206\uFF09/ `*Micros`\uFF08\u5FAE\u5143\uFF09\u5DF2\u4E0D\u518D\u843D\u76D8\uFF0C**\u7981\u6B62**\u518D\u505A \xF7100 / \xF71_000_000 \u6362\u7B97\u3002"
     ];
+    GOOGLE_ANALYSIS_CAMPAIGNS_COMPETITIVE_METRICS_HINTS = [
+      "// \u7ADE\u4E89\u6307\u6807\uFF1A`campaigns[].competitiveMetrics` \u4E3A Google \u539F\u751F **0~1 \u5C0F\u6570**\uFF08\u5982 `0.0999` = 9.99%\uFF09\uFF0C\u542B Top/AbsoluteTop/Content/ClickShare \u7B49 15 \u9879\uFF1B\u65E0 GAQL \u7ADE\u4E89\u6570\u636E\u65F6\u4E3A `null`\u3002",
+      "// \u884C\u9876 `searchImpressionShare` / `searchBudgetLostImpressionShare` / `searchRankLostImpressionShare` \u4ECD\u4E3A **0~100 \u767E\u5206\u6570**\uFF08\u4EC5 3 \u9879\uFF09\uFF1B**\u7981\u6B62**\u4E0E `competitiveMetrics.*` \u76F8\u52A0\u6216\u6DF7\u7B97\u3002"
+    ];
     RATE_BEARING_SECTIONS = /* @__PURE__ */ new Set([
       "overview",
       "keywords",
@@ -116564,6 +116571,62 @@ init_auth();
 init_cli_json_snapshot();
 init_cli_table();
 
+// src/commands/keyword-account-match.ts
+init_auth();
+function normalizeKeywordForAccountMatch(raw) {
+  return unwrapKeywordDisplayTextForEdit(raw.trim()).toLowerCase();
+}
+function extractKeywordTextFromManagementRow(row) {
+  const kt = row["keywordText"];
+  if (Array.isArray(kt) && kt.length > 0 && typeof kt[0] === "string") {
+    return kt[0];
+  }
+  const t = row["text"];
+  if (typeof t === "string") return t;
+  const kw = row["keyword"];
+  if (typeof kw === "string") return kw;
+  return "";
+}
+async function fetchAccountPositiveKeywordNormSet(config, googleApiUrl, accountId, opts) {
+  const lookback = opts?.lookbackDays ?? 3650;
+  const params = new URLSearchParams();
+  params.set("startDate", toGoogleDate(void 0, -lookback));
+  params.set("endDate", toGoogleDate(void 0, 0));
+  const url = `${googleApiUrl}/keywordmanagement/v2/list/${accountId}?${params}`;
+  const data = await apiFetch2(
+    url,
+    config,
+    {},
+    opts?.verbose
+  );
+  const rawItems = data.data ?? [];
+  const seenIds = /* @__PURE__ */ new Set();
+  const normSet = /* @__PURE__ */ new Set();
+  for (const row of rawItems) {
+    const id = row["id"];
+    if (id !== void 0) {
+      if (seenIds.has(id)) continue;
+      seenIds.add(id);
+    }
+    const text = extractKeywordTextFromManagementRow(row);
+    if (!text) continue;
+    const norm = normalizeKeywordForAccountMatch(text);
+    if (norm) normSet.add(norm);
+  }
+  return normSet;
+}
+function keywordAlreadyInAccountFlag(recommendKeyword, accountNormSet) {
+  const norm = normalizeKeywordForAccountMatch(recommendKeyword ?? "");
+  if (!norm) return 0;
+  return accountNormSet.has(norm) ? 1 : 0;
+}
+function annotateKeywordSuggestWithAccountPresence(items, accountNormSet) {
+  return items.map((item) => {
+    const flag = keywordAlreadyInAccountFlag(item.keyword, accountNormSet);
+    return { ...item, alreadyInAccount: flag };
+  });
+}
+
 // src/commands/keyword-geo.ts
 function parseGeoTargetConstantIds(raw) {
   if (!raw?.trim()) return [];
@@ -116828,6 +116891,27 @@ async function runKeywordSuggest(opts) {
       return !excludes.some((exc) => kw.includes(exc));
     });
   }
+  if (accountId) {
+    try {
+      const accountNormSet = await fetchAccountPositiveKeywordNormSet(
+        config,
+        googleApiUrl,
+        accountId,
+        { verbose: opts.verbose }
+      );
+      items = annotateKeywordSuggestWithAccountPresence(items, accountNormSet);
+      if (opts.verbose) {
+        const matched = items.filter((r) => r.alreadyInAccount === 1).length;
+        console.error(
+          `  [keyword] \u8D26\u6237\u8BCD\u5E93 ${accountNormSet.size} \u4E2A\u8BCD\u5E72\uFF1B\u63A8\u8350 ${items.length} \u6761\uFF0C\u5176\u4E2D\u5DF2\u5728\u8D26\u6237 ${matched} \u6761`
+        );
+      }
+    } catch (err) {
+      console.error(
+        `  [keyword] \u8B66\u544A\uFF1A\u62C9\u53D6\u8D26\u6237\u5173\u952E\u8BCD\u5931\u8D25\uFF0C\u8DF3\u8FC7 alreadyInAccount \u6807\u6CE8\uFF1A${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
   const n = items.length;
   const kwPayload = buildKeywordSuggestJsonPayload(items, { bidAmountCurrency });
   const displayItems = kwPayload.items;
@@ -116849,6 +116933,7 @@ async function runKeywordSuggest(opts) {
   const cur = bidAmountCurrency;
   const cols = [
     { key: "keyword", header: "\u5173\u952E\u8BCD" },
+    ...accountId ? [{ key: "alreadyInAccount", header: "\u5DF2\u5728\u8D26\u6237\u4E2D" }] : [],
     { key: "montlySearch", header: "\u6708\u5747\u641C\u7D22" },
     { key: "cpcMain", header: `\u5E73\u5747CPC(${cur})` },
     { key: "bidRangeMain", header: `\u9875\u9996\u51FA\u4EF7(${cur})` },
@@ -116862,6 +116947,9 @@ async function runKeywordSuggest(opts) {
     const competitionDisplay = item.competitionV2 ?? (item.competition != null ? item.competition.toFixed(2) : "\u2014");
     return {
       keyword: item.keyword ?? "",
+      ...accountId ? {
+        alreadyInAccount: item.alreadyInAccount === 1 ? "1" : item.alreadyInAccount === 0 ? "0" : "\u2014"
+      } : {},
       montlySearch: String(item.montlySearch ?? "\u2014"),
       cpcMain,
       bidRangeMain,

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.22-beta.10",
-  "publishedAt": 1779948041465
+  "version": "1.1.22-beta.12",
+  "publishedAt": 1779959114618
 }

package/dist/skill/assets/campaign-create-template.md

@@ -7,7 +7,7 @@
 **`ad campaign-create` 提交前**，CLI 在 JSON 原文之外额外处理（不影响 validate 读到的「元」口径）：
 
 1. 剥除以 `_` 开头的注解键（如 `_meta`、`_comment_budget`、`_comment_finalurl`）；
-2. 外层 body：`account` → 数字 `customerId`；补全 `KeywordRecommendationsV2`（按广告组名，`Value` 可为 `[]`）；`googleDataRecordId` 缺省为 `""`（与 Web 智投一致）；
+2. 外层 body：`account` → 数字 `customerId`；补全 `KeywordRecommendationsV2`（按广告组名，`Value` 可为 `[]`）；`googleDataRecordId` 缺省为 `""`（CLI 默认）；
 3. `campaign` 金额字段「元」→「分」（×100）；
 4. `ExtensionsForBatchJob` 中 SITELINK 的 `Properties` 规范化（见下文「SITELINK」）。
 
@@ -99,11 +99,11 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 | `url`                  | string              |      | 智投展示用 URL；后端只读，用于回显                                                                     |
 | `locations`            | string[]            |      | 展示用地区名（后端只读，可空数组）                                                                     |
 | `productWords`         | string[]            |      | 智投/推荐用产品核心词                                                                                  |
-| `googleDataRecordId`   | string \| null      |      | 智投记录 ID；省略时提交 `""`（与 Web 智投一致）                                                        |
+| `googleDataRecordId`   | string \| null      |      | 智投记录 ID；省略时提交 `""`（CLI 默认）                                                        |
 | `draft`                | boolean             |      | `false`（默认）立即发布到 Google；`true` 仅保存草稿，需后续 `ad batch publish`                         |
 | `campaign`             | object              |  ✅  | 内层 Campaign 对象，见下表                                                                             |
 
-> 提交时 CLI 另附 `KeywordRecommendationsV2`：`[{ Key: <广告组 Name>, Value: [] }, …]`，与 Web `/advertising/AICreation` 结构一致；JSON 文件内无需手写。
+> 提交时 CLI 另附 `KeywordRecommendationsV2`：`[{ Key: <广告组 Name>, Value: [] }, …]`，由 CLI 自动附加；JSON 文件内无需手写。
 
 ---
 
@@ -202,7 +202,7 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 
 ### 关键词块（`KeywordsForBatchJob[j]`）
 
-每个块描述一组**同匹配类型**的关键词。若同一块内混用裸词 / `"词组"` / `[完全]`（或与块级 `MatchTypeV2` 冲突的符号），`campaign-validate` 会**自动拆成多个块**（顺序：BROAD → PHRASE → EXACT，与 Web 智投一致），再按块级类型修复词面。
+每个块描述一组**同匹配类型**的关键词。若同一块内混用裸词 / `"词组"` / `[完全]`（或与块级 `MatchTypeV2` 冲突的符号），`campaign-validate` 会**自动拆成多个块**（顺序：BROAD → PHRASE → EXACT），再按块级类型修复词面。
 
 | 字段          | 类型                              | 说明                                                                  |
 | ------------- | --------------------------------- | --------------------------------------------------------------------- |
@@ -217,7 +217,7 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 | `TypeV2`                      | string   |      | RSA 填 `RESPONSIVE_SEARCH_AD`                  |
 | `DestinationUrl`              | string   |  ✅  | 展示/编辑用落地页 URL                         |
 | `Finalurl`                    | string   |  ✅  | **后端 BatchJob 必填**；与 `DestinationUrl` 填**相同** URL。勿只写前者——validate 可能仍通过，create 会失败 |
-| `AdTitle`                     | null \| string |  | 可选；无标题时写 `null`（与 Web 智投一致）   |
+| `AdTitle`                     | null \| string |  | 可选；无标题时写 `null`（CLI 默认）   |
 | `Path1` / `Path2`             | string   |  ✅  | 显示路径（**必填**，缺/null 会导致后端 BatchJob `ArgumentNullException`）；**≤ 15 字符**（CJK 按 2 计）；小写 a-z、数字、连字符 |
 | `headlinePart1/2/3`           | string   |  ✅  | 前 3 条标题；**每条 ≤ 30 字符**（CJK 按 2 计） |
 | `AddtionalHeadlines`          | string[] |      | 第 4–15 条标题（合计 ≤ 15）                   |
@@ -226,13 +226,13 @@ siluzan-tso ad batch diff --batch-id <taskId> --config-file ./campaign.json --js
 
 ---
 
-## 校验规则（CLI 镜像后端）
+## 校验规则（`ad campaign-validate`）
 
-| 来源                                                                                       | 规则                                                                                                |
-| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
-| `CampaignCommandController.CreateCampaignAsync`                                            | `customerName` 非空 / `campaign` 非空                                                              |
-| `CampaignCommandController` 行 94–106                                                      | `campaign.TargetPartnerSearchNetwork` 必须 false；`!TargetGoogleSearch && TargetSearchNetwork` 拒绝 |
-| Google Ads BatchJob                                                                         | RSA `Path1`/`Path2` 必填（缺/null → 后端 ArgumentNullException）；字段数与字符上限；关键词词面非空；SITELINK `Line2`/`Line3` ≤25 字且不可 null |
-| CLI 实务                                                                                    | `Budget > 0`、地理/语言至少 1 项、日期格式与先后、出价策略与配套字段                                |
+| 规则 | 说明 |
+| ---- | ---- |
+| 基础 | `customerName` / `campaign` 非空；`Budget > 0`；地理/语言至少 1 项 |
+| 网络 | `TargetPartnerSearchNetwork` 须 false；不可同时关闭 Google 搜索与搜索网络 |
+| RSA / 关键词 / 附加信息 | 字符上限、词面非空；RSA `Path1`/`Path2` 必填；SITELINK 行长度限制 |
+| 实务 | 日期格式与先后、出价策略与配套字段一致 |
 
 `ad campaign-validate` 通过不保证 BatchJob 成功（例如仅写 `DestinationUrl` 未写 `Finalurl` 时 validate 仍可能 ✅）。异步结果用 `ad batch get` 轮询；`HasFailed` / 部分失败时用 `ad batch diff` 对照 JSON 补缺，系列级失败时改 JSON 重提，勿在半成品上反复整包创建。写操作须 `--commit`，见 `references/google-ads/google-ads.md` § ad campaign-create。

package/dist/skill/assets/pmax-create-template.md

@@ -2,7 +2,7 @@
 
 `siluzan-tso ad pmax-create` / `ad pmax-validate` **仅**接受 `--config-file` 指向的 JSON 文件。
 
-**与 Search 智投隔离**：勿使用 `campaign-create-template.json` 或 `ad campaign-create`（BatchJob / `campaign-batch-asyncs`）。PMax 走 Google 网关 **`POST /accounts/{accountId}/campaign/pmax`**，同步返回 `campaignId`。
+**与 Search 智投隔离**：勿使用 `campaign-create-template.json` 或 `ad campaign-create`。PMax 使用 `ad pmax-create`，同步返回 `campaignId`。
 
 模板 JSON：同目录 [`pmax-create-template.json`](pmax-create-template.json)。
 
@@ -92,4 +92,4 @@ siluzan-tso ad campaigns -a <accountId> --json-out ./snap
 - **支持**：Lead Gen / 非 Shopping 的 Performance Max
 - **不含**：Shopping PMax、Listing groups；信号与其它编辑见 `ad pmax-signals-*` 等（`references/google-ads/pmax-api.md`）
 
-网关完整契约见 Sammamish：`src/GoogleAPI/docs/pmax-frontend-api.md`；CLI 摘录见 `references/google-ads/pmax-api.md`。
+命令与流程见 `references/google-ads/pmax-api.md`。

package/dist/skill/references/README.md

@@ -20,7 +20,7 @@
 | `accounts/accounts.md` | 列表、余额、消耗、分享、MCC/BC/BM、balance-scan、accounts-digest |
 | `accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |
 | `accounts/open-account-by-media.md` | 各媒体开户命令与参数 |
-| `accounts/open-account-google-ui.md` | Google 开户网页 ↔ CLI 字段对照 |
+| `accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |
 | `accounts/finance.md` | 转账、开票、充值 |
 | `accounts/write-audit-restore.md` | 写审计、`--commit`、restore |
 

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

@@ -49,11 +49,9 @@ siluzan-tso list-accounts --page 2 --page-size 50
 
 ## account-active-bills — 账户激活充值账单明细
 
-查询指定广告账户在平台上的**激活/充值类账单**（与网页账户管理侧一致）。对应 TSO：
+查询指定广告账户在平台上的**激活/充值类账单**。
 
-`GET {apiBaseUrl}/AccountActiveBills/{Media}/{entityId}`
-
-路径末尾的 **`entityId`** 必须为 **`list-accounts --json-out ./snap`** 返回的账户 **`entityId`**（UUID 形态），**不能**传 `mediaCustomerId` 数字 ID。请求会带 **Datapermission**（与浏览器一致）。
+路径中的 **`entityId`** 必须为 **`list-accounts --json-out`** 返回的 **`entityId`**（UUID），**不能**传 `mediaCustomerId`。
 
 ```bash
 siluzan-tso account-active-bills -m <媒体> --id <entityId> [--json-out ./snap]
@@ -266,8 +264,6 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 
 ## account — 账号管理（OAuth 授权 / 解除关联 / Google MCC / 分享）
 
-> 与网页 **`/foreign_trade/tso/manageAccounts`** 对应：`account auth` = 添加授权；`account delink` = 解除授权（从丝路赞解绑账户）；`mcc-bind` / `mcc-unbind` = MCC 绑定与解绑。
-
 ### auth — 添加媒体平台 OAuth 授权
 
 在浏览器中打开对应媒体的 OAuth 授权页面，授权后账户自动绑定到丝路赞。
@@ -299,7 +295,7 @@ siluzan-tso account auth -m Meta
 
 ### delink — 解除授权 / 断开账户关联
 
-从当前丝路赞账号下移除媒体账户绑定（网页上常称为「解除授权」或「解绑」）。
+从当前丝路赞账号下移除媒体账户绑定。
 
 ```bash
 siluzan-tso account delink --id <entityId>
@@ -327,7 +323,7 @@ siluzan-tso account delink --ids abc123,def456,ghi789
 
 ### mcc-bind — Google MCC 绑定
 
-将 **子账户**（Google `mediaCustomerId`）挂到指定 **经理账户（MCC）** 下。请求走 **`googleApiUrl`**（与网页一致），需先 `config show` 确认已配置。
+将 **子账户**（Google `mediaCustomerId`）挂到指定 **经理账户（MCC）** 下。请求走 **`googleApiUrl`**，需先 `config show` 确认已配置。
 
 ```bash
 siluzan-tso account mcc-bind --customers <mediaCustomerId> --mcc <MCC客户ID>
@@ -337,7 +333,7 @@ siluzan-tso account mcc-bind --customers 111,222 --mcc "333;444"
 | 选项                | 说明                                                                                   |
 | ------------------- | -------------------------------------------------------------------------------------- |
 | `--customers <ids>` | 子账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts` 的 `ma.mediaCustomerId`） |
-| `--mcc <ids>`       | MCC 的客户 ID；多个可用英文逗号、中文逗号、分号、顿号等分隔（与网页输入规则一致）      |
+| `--mcc <ids>`       | MCC 的客户 ID；多个可用英文逗号、中文逗号、分号、顿号等分隔                            |
 | `--json-out`            | 输出每个子账户接口的原始返回，便于排查                                                 |
 
 ---
@@ -405,14 +401,14 @@ siluzan-tso account share-detail --customer-id 1234567890
 
 ## open-account — 开户申请
 
-> **Google 与网页 `/openAnAccount` 的对照**（五步进度、两步表单、币种/时区下拉）：见 **`references/accounts/open-account-google-ui.md`**。  
-> **各媒体路由、资料、提交接口都不相同**（不只 Google 用 `/openAnAccount`）：见 **`references/accounts/open-account-by-media.md`**。
+> Google 开户字段与向导说明见 **`references/accounts/open-account-google-ui.md`**。  
+> 各媒体开户参数与接口差异见 **`references/accounts/open-account-by-media.md`**。
 
 ### 广告主组 magKey 说明
 
 **所有媒体（Google / TikTok / Yandex / BingV2 / Kwai）开户均无需手动查询或填写 magKey。**
 
-CLI 与网页行为完全一致：提交时按 `--company`（或 `--advertiser-name` / `--company-name`）在后台自动查找同名广告主组——存在则更新，不存在则创建——再用拿到的 magKey 提交开户。
+提交时按 `--company`（或 `--advertiser-name` / `--company-name`）自动查找同名广告主组——存在则更新，不存在则创建——再用 magKey 提交开户。
 
 `--advertiser-id` 在所有媒体开户命令中均为**可选**，仅供调试或特殊场景手动指定。
 
@@ -422,13 +418,11 @@ CLI 与网页行为完全一致：提交时按 `--company`（或 `--advertiser-n
 
 ### Google 开户（无需图片）
 
-**更贴近网页交互：**
-
 ```bash
-# 交互向导（说明「五步」进度条 + 按网页第 1、2 步顺序提问；需真实终端 TTY）
+# 交互向导（需真实终端 TTY；Agent 环境不可用）
 siluzan-tso open-account google-wizard
 
-# 时区列表（与网页第二步「时区」下拉同一接口，可加 --keyword 过滤）
+# 时区列表（可加 --keyword 过滤）
 siluzan-tso open-account google-timezones
 siluzan-tso open-account google-timezones --keyword Hong
 ```
@@ -447,7 +441,7 @@ siluzan-tso open-account google \
 ```
 
 > 推广链接可只写域名（如 `www.brand-a.com`），CLI 会自动补 `https://`。  
-> 可选：`--industry1` / `--industry2`（网页端行业已弱化，多数情况可不填）。  
+> 可选：`--industry1` / `--industry2`（多数情况可不填）。  
 > 可选：`--advertiser-id <magKey>` 仅用于调试或必须指定已有组时。
 
 | 选项                        | 说明                                                  | 必填 |
@@ -499,7 +493,7 @@ siluzan-tso open-account tiktok \
 ```
 
 > CLI 自动完成：① 上传图片到 TikTok 取得 `license_image_id`；② 存档到丝路赞；③ 按公司名自动创建/关联广告主组；④ 检查是否需要法人银联验证。  
-> **注意**：`--company` 和 `--license-no` 需用户手动填写；网页上传执照图片有 OCR 自动识别，CLI 无此功能。
+> **注意**：`--company` 和 `--license-no` 需用户手动提供；CLI **无**执照 OCR。
 
 **需要法人银联验证时追加：**
 
@@ -582,9 +576,7 @@ siluzan-tso open-account kwai \
 
 > 仅支持 **TikTok** 账户。关闭后账户停止投放，如需恢复请联系丝路赞客服，操作**不可自助撤销**，谨慎使用。
 >
-> 对应网页：`/foreign_trade/tso/manageAccounts` → 选中 TikTok 账户 → 关闭账户
->
-> **实现说明（与网页 `manageAccounts` 一致）**：先经 TikTok 侧 `CheckAdvDisable` 校验（不满足条件如余额未清零会失败），再 `POST .../AdvertiserDisable`；Body 为各账户的 **entityId**。你只需传入 `list-accounts` 中的 **mediaCustomerId**，CLI 会解析 entityId；旧版误把 mediaCustomerId 当 Body 会导致 HTTP 成功但关户不生效。
+> 先经 TikTok `CheckAdvDisable` 校验（余额未清零等会失败）。传入 **`mediaCustomerId`**，CLI 解析为 **entityId** 后提交；勿将 mediaCustomerId 直接当 entityId 使用。
 
 ```bash
 siluzan-tso account close --accounts <mediaCustomerId>
@@ -614,8 +606,6 @@ siluzan-tso account close --accounts 1234567890123456,9876543210654321
 ## account bm-bind — Meta BM 绑定
 
 > 将 Meta 广告账户绑定到指定的 **Business Manager（商务管理平台）**。
->
-> 对应网页：`/foreign_trade/tso/manageAccounts` → 选中 Meta 账户 → BM 绑定
 
 ```bash
 siluzan-tso account bm-bind --account-id <mediaCustomerId> --bm-id <bmId>
@@ -701,8 +691,6 @@ siluzan-tso account withdraw-submit --accounts id1,id2,id3
 ## account bc-bind — TikTok BC 绑定
 
 > 将 TikTok 广告账户绑定到 **Business Center（BC，商务中心）**。
->
-> 对应网页：`/foreign_trade/tso/manageAccounts` → 选中 TikTok 账户 → BC 绑定
 
 ```bash
 siluzan-tso account bc-bind --customers <mediaCustomerId> --bc-ids <bcId>
@@ -758,7 +746,7 @@ siluzan-tso account email-auth-list -c <mediaCustomerId> [--agent-type <type>]
 
 | 选项                     | 说明                                                                       |
 | ------------------------ | -------------------------------------------------------------------------- |
-| `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`（与网页查询参数 `customerId` 一致）      |
+| `-c, --customer-id <id>` | Google 广告账户 `mediaCustomerId`                                            |
 | `--agent-type <type>`    | 可选；平台需要时再传（与 `list-accounts --json-out ./snap` 的 `ma.accountType` 一致） |
 | `--json-out`                 | 输出原始 JSON                                                              |
 

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

@@ -7,8 +7,6 @@
 
 ## invoice-info — 发票抬头管理
 
-对应页面：`https://www-ci.siluzan.com/v3/foreign_trade/settings/invoiceInformation`
-
 发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：
 
 - **PI**：形式发票（境外美金账户，英文信息）
@@ -98,7 +96,7 @@ siluzan-tso invoice-info delete <id>
 
 ```bash
 siluzan-tso config show
-# 输出中 webUrl 行即为前端基地址，例如：
+# 输出中 webUrl 行即为网页基地址，例如：
 #   webUrl : https://www.siluzan.com        （生产环境）
 #   webUrl : https://www-ci.siluzan.com     （测试环境）
 ```
@@ -107,7 +105,7 @@ siluzan-tso config show
 
 ### 功能总览
 
-| 功能                         | 对应页面路径                         | CLI 支持                                |
+| 功能                         | 引导用户打开的网页路径               | CLI 支持                                |
 | ---------------------------- | ------------------------------------ | --------------------------------------- |
 | 现金充值（单笔）             | `/recharge/pay`                      | ❌ 引导网页                             |
 | 现金充值（批量）             | `/recharge/pay_batch`                | ❌ 引导网页                             |
@@ -269,7 +267,7 @@ siluzan-tso invoice billable -m Google --json-out ./snap
 
 ### invoice apply — 提交开票申请
 
-与 Web「申请开票」一致的业务规则：
+开票业务规则：
 
 - **人民币（CNY）订单**：只能开 **增值税** 发票（`VATI` / `VATSI`），不能选形式发票 `PI`。
 - **美金等外币订单**（常见为 USD，且不含 CNY）：只能开 **形式发票 `PI`**（系统自动出具），不能选增值税票。
@@ -318,7 +316,7 @@ siluzan-tso invoice apply \
 | `--recipient-phone`       | 收件人手机号                                                                        | ✅             |
 | `--recipient-email`       | 推送邮箱                                                                            | —              |
 | `--company-name-en`       | 公司英文名称（PI 必填）                                                             | PI✅           |
-| `--registered-address-en` | 英文单位地址（PI 必填，与 Web 校验一致）                                            | PI✅           |
+| `--registered-address-en` | 英文单位地址（PI 必填）                                                             | PI✅           |
 | `--company-name`          | 公司中文名称（VATI/VATSI 必填）                                                     | VATI✅         |
 | `--tax-id`                | 税号（VATI/VATSI 必填）                                                             | VATI✅         |
 | `--title`                 | 发票抬头（VATI/VATSI 必填）                                                         | VATI✅         |
@@ -368,7 +366,7 @@ siluzan-tso invoice apply \
 
 - 用户给出自定义抬头（公司名、税号、抬头文案、地址、联系人等）时：
   1. 先用 `invoice-info list`（可加 `-k` 关键字、`--invoice-type`）在**已有抬头**中检索：公司名、`title`、税号等与用户输入是否**实质相同**（允许轻微空格/标点差异）。
-  2. **若已存在等价记录**：不要重复 `invoice-info create`；直接沿用该条里的字段填 `invoice apply`（与 Web 一致：`apply` 传的是完整 `InvoiceInfomation`，不是只传抬头 id）。
+  2. **若已存在等价记录**：不要重复 `invoice-info create`；直接沿用该条字段填 `invoice apply`（传完整 `InvoiceInfomation`，不是只传抬头 id）。
   3. **若不存在**：先 `siluzan-tso invoice-info create ...` 创建成功，再 `siluzan-tso invoice apply ...`。避免未落库就假定「已保存」。
 
 #### 4. 最后调用开票接口

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

@@ -1,6 +1,5 @@
 # 各媒体开户
 
-> 对应页面：`/accountOpeningHistory`  
 > 网页链接：`{webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
@@ -17,7 +16,7 @@
 
 **所需信息**：公司名称、推广网址、推广类型（b2b/b2c/app）、账户名称、币种（CNY/USD）、时区、邀请邮箱
 
-**网页对照**（字段映射）：`references/accounts/open-account-google-ui.md`
+**Google 字段说明**：`references/accounts/open-account-google-ui.md`
 
 **常用时区**（完整：`siluzan-tso open-account google-timezones`）：
 
@@ -117,7 +116,7 @@ siluzan-tso account-history -m BingV2
 
 **所需信息**：公司名称、主体信息、行业多级 ID、产品网址、账户类型、营业执照图片路径
 
-> **双上传**（与网页 `KwaiOpenAnAccount.vue` 一致）：CLI 先 `POST /command/attachment` 得 `imageId`（更新广告主组 MAG），再 `POST /KwaiAccount/Management/Upload` 得 `blobstoreKey`（写入 `KwaiAccountInfo.mainCertPhotos`）。二者不可混用。
+> **双上传**：CLI 先上传附件得 `imageId`（更新广告主组 MAG），再上传 Kwai 资质得 `blobstoreKey`（写入 `mainCertPhotos`）。二者不可混用。
 
 ```bash
 siluzan-tso open-account kwai \

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

@@ -1,64 +1,42 @@
-## 一、页面顶部「五步」是什么？
+## 一、开户流程（五步语义）
 
-与**表单分步**不是同一套数字，但语义连贯：
+| 步骤 | 含义 | CLI / Skill |
+| ---- | ---- | ----------- |
+| ① | 准备资料 | 向用户说明清单；无法代替用户准备资质 |
+| ② | 填写并提交 | `open-account google-wizard`（TTY）或 `open-account google` |
+| ③ | 等待审核 | `account-history -m Google` |
+| ④ | 审核通过 | 同上 |
+| ⑤ | 充值激活 | **必须网页**；`config show` → `webUrl` + 充值路径（见 `finance.md`） |
 
-| 步骤 | 文案（意译） | 用户要做什么                       | CLI / Skill 能做什么                                          |
-| ---- | ------------ | ---------------------------------- | ------------------------------------------------------------- |
-| ①    | 准备开户资料 | 准备公司名、网址、类型、账户信息等 | 说明清单；**无法**代替用户准备资质                            |
-| ②    | 填写申请     | 网页里完成第 1、2 步表单并提交     | **`open-account google-wizard`** 或 **`open-account google`** |
-| ③    | 等待审核     | 等待媒体/平台审核                  | **`account-history -m Google`** 轮询                          |
-| ④    | 审核通过     | 查看通过结果                       | 同上                                                          |
-| ⑤    | 充值并激活   | **必须在网页完成充值**             | 引导 `config show` → `webUrl` + 充值路径（见 `accounts/finance.md`）   |
-
-页面上还有提示：**美元账户最低充值约 100 USD、人民币约 700 CNY**（以实际页面为准）。
+美元账户最低充值约 **100 USD**，人民币约 **700 CNY**（以平台为准）。
 
 ---
 
-## 二、网页里实际填表是「两步」
-
-### 第 1 步（企业 / 推广信息）
-
-| 网页控件 | 说明                                         | CLI 对应                                       |
-| -------- | -------------------------------------------- | ---------------------------------------------- |
-| 公司名称 | 文本，可联想已有广告主                       | `--company`                                    |
-| 网址     | 左侧下拉 `https://` / `http://` + 右侧输入框 | `--promotion-link`（可只写域名，CLI 会补协议） |
-| 类型     | 单选 **B2B / B2C / APP**                     | `--promotion-type`：`b2b` \| `b2c` \| `app`    |
-| 行业级联 | 当前前端已隐藏                               | 可选 `--industry1` / `--industry2`             |
-
-提交第 1 步后，后台会**创建或更新广告主组**并拿到 `magKey`；CLI 已内置该逻辑，**无需**用户自己查 `magKey`。
-
-### 第 2 步（广告账户表格，与下拉菜单一致）
-
-| 网页控件 | 说明                                              | CLI 对应                                                 |
-| -------- | ------------------------------------------------- | -------------------------------------------------------- |
-| 账户名称 | 文本，默认与公司名一致                            | `--account-name`                                         |
-| 币种     | 下拉：**CNY / USD**（HKD 对代理商场景为禁用）     | `--currency`：`CNY` \| `USD`                             |
-| 时区     | 下拉：文案为 **`(Time)Name`**，值为 **IANA Code** | `--timezone`；列表用 **`open-account google-timezones`** |
-| 开户数量 | 1～3，且多行总和 ≤3（网页表格）                   | `--counts`（1～3）                                       |
-| 开户邮箱 | 接收 Google 账户邀请的邮箱（不限 Gmail / `.com`） | `--invite-email`                                         |
+## 二、非交互提交字段
 
-**币种 ↔ 默认时区（与网页 `changeCurrency` 一致）**
+| 字段 | CLI 选项 |
+| ---- | -------- |
+| 公司名称 | `--company` |
+| 推广网址 | `--promotion-link`（可只写域名，CLI 补协议） |
+| 推广类型 B2B/B2C/APP | `--promotion-type`：`b2b` \| `b2c` \| `app` |
+| 行业（可选） | `--industry1` / `--industry2` |
+| 账户名称 | `--account-name` |
+| 币种 CNY/USD | `--currency` |
+| 时区 IANA | `--timezone`；列表：`open-account google-timezones` |
+| 开户数量 1～3 | `--counts` |
+| 邀请邮箱 | `--invite-email` |
 
-- 选 **CNY** → 默认 **`Asia/Shanghai`**
-- 选 **USD**（或其它非 CNY）→ 默认 **`Asia/Hong_Kong`**
+**币种默认时区**：CNY → `Asia/Shanghai`；USD（或其它非 CNY）→ `Asia/Hong_Kong`。其它时区从 `google-timezones` 取 **Code** 列。
 
-其它时区请从 **`siluzan-tso open-account google-timezones`** 里取 **Code** 列（与网页下拉同一接口）。
+提交时按 `--company` 自动查找/创建广告主组并拿 `magKey`，**无需**手动填 magKey。
 
 ---
 
 ## 三、推荐用法
 
-### 1）非交互提交（Agent / 脚本首选）
+### 非交互（Agent / 脚本首选）
 
 ```bash
-# 常用时区速查（无需每次运行 google-timezones）：
-# Asia/Shanghai      北京/上海（CNY 默认）
-# Asia/Hong_Kong     香港（USD 默认）
-# America/New_York   美东
-# America/Los_Angeles 美西
-# Europe/London      伦敦
-# 完整列表：siluzan-tso open-account google-timezones [--keyword <关键词>]
-
 siluzan-tso open-account google \
   --company "某某公司" \
   --promotion-link "https://www.example.com" \
@@ -70,49 +48,40 @@ siluzan-tso open-account google \
   --counts 1
 ```
 
-### 2）交互向导（人工终端操作，需要真实 TTY）
+常用时区：`Asia/Shanghai`、`Asia/Hong_Kong`、`America/New_York`、`America/Los_Angeles`、`Europe/London`。完整列表：`open-account google-timezones [--keyword <关键词>]`
+
+### 交互向导（需真实 TTY；Agent 不可用）
 
 ```bash
-# 注意：需要真实终端，CI / 管道 / AI Agent 环境下无法使用
 siluzan-tso open-account google-wizard
 ```
 
-### 3）审核与后续
+### 审核与充值
 
 ```bash
-# 轮询审核进度
 siluzan-tso account-history -m Google
-
-# 提交后需在网页查看/确认：开户记录（勿用 manageAccounts）
-# {webUrl}/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory
-# （非交互 `open-account google` 成功时 CLI 也会打印该链接）
-
-# 审核通过后，充值激活（必须网页完成）
-# siluzan-tso config show 取 webUrl，打开：{webUrl}/v3/foreign_trade/tso/recharge
-# 美元账户最低约 100 USD，人民币账户约 700 CNY
+# 审核通过后：config show → {webUrl}/v3/foreign_trade/tso/recharge
 ```
 
 ---
 
-## 四、给 AI Agent 的简短指令模板
-
-当用户说「我要在丝路赞开 Google 户」时：
+## 四、Agent 指令模板
 
-1. 收集必填字段：公司名、推广网址、推广类型、账户名、币种、时区、邀请邮箱。
-2. 时区未知时，先给出常用时区表（见上方速查），或运行 `open-account google-timezones --keyword <关键词>` 辅助选择。
-3. 拼一条 `open-account google` 非交互命令提交。
-4. 提交后：`account-history -m Google` 轮询进度。
-5. 审核通过后：引导充值激活，给出充值网页路径（见第三步）。
+1. 收集：公司名、网址、推广类型、账户名、币种、时区、邀请邮箱。
+2. 时区不明时运行 `google-timezones` 或给出常用时区表。
+3. 执行 `open-account google`。
+4. `account-history -m Google` 轮询。
+5. 通过后引导充值（`finance.md`）。
 
 ---
 
-## 五、相关命令速查
+## 五、命令速查
 
-| 命令                            | 作用                                    |
-| ------------------------------- | --------------------------------------- |
-| `open-account google-wizard`    | 交互向导（对齐网页两步表单 + 五步说明） |
-| `open-account google-timezones` | 时区列表（网页下拉同源）                |
-| `open-account google`           | 非交互一次性提交                        |
-| `account-history -m Google`     | 开户审核进度                            |
+| 命令 | 作用 |
+| ---- | ---- |
+| `open-account google-wizard` | 交互向导 |
+| `open-account google-timezones` | 时区列表 |
+| `open-account google` | 非交互提交 |
+| `account-history -m Google` | 审核进度 |
 
-更完整的参数表见 `accounts/accounts.md` → **open-account** 章节。
+完整参数见 `accounts/accounts.md` → **open-account**。