siluzan-tso-cli 1.0.0-beta.45 → 1.0.0-beta.47

package/README.md

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

package/dist/index.js

@@ -10275,7 +10275,7 @@ invoiceInfoCmd.command("delete <id>").description("\u5220\u9664\u53D1\u7968\u62A
 var optimizeCmd = program.command("optimize").description("AI \u5E7F\u544A\u4F18\u5316\uFF08Google\uFF09");
 optimizeCmd.command("list").description("\u67E5\u8BE2\u8D26\u6237\u7EA7\u4F18\u5316\u4E3B\u5217\u8868\uFF08\u5BF9\u5E94\u9875\u9762 /advertising/intelligentOptimization\uFF09").option("-a, --account <id>", "\u8D26\u6237 mediaCustomerId\uFF08\u7559\u7A7A\u67E5\u5168\u90E8\uFF09").option(
   "--match-media-customer-id <id>",
-  "\u5728\u5168\u91CF\u5217\u8868\u4E2D\u7B5B\u9009\u8BE5 Google \u5BA2\u6237 ID\uFF08\u81EA\u52A8\u7FFB\u9875\uFF1B\u5DF2\u8131\u7BA1\u52FF\u7528 -a\uFF0C\u89C1 reporting.md\uFF09"
+  "\u5728\u5168\u91CF\u5217\u8868\u4E2D\u7B5B\u9009\u8BE5 Google \u5BA2\u6237 ID\uFF08\u81EA\u52A8\u7FFB\u9875\uFF1B\u5DF2\u8131\u7BA1\u52FF\u7528 -a\uFF0C\u89C1 optimize.md\uFF09"
 ).option("--start <date>", "\u5F00\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-p, --page <n>", "\u9875\u7801", parseInt).option("--page-size <n>", "\u6BCF\u9875\u6570\u91CF", parseInt).option("-t, --token <token>", "Auth Token").option("--json", "JSON \u683C\u5F0F\u8F93\u51FA", false).option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(async (opts) => {
   await runOptimizeList({
     token: opts.token,

package/dist/skill/SKILL.md

@@ -21,191 +21,74 @@ description: >-
 
 # Siluzan TSO Skill
 
-通过 `siluzan-tso` CLI 完成广告投放管理，不要手动调接口。
-
-配置查看与更新详见 `references/setup.md`。
-
----
-## 使指南
-凡欲用此技，先当以 -h 索命令行之详解。
-为省token，宜先以 --json 取单条数据之式，后乃以编程之法批操巨数，勿率取原始数据以致耗费token无度。
-于用户前，毋泄命令行参数，盖不雅且难明也。
-又除setup.md所载命令允用户亲为外，其余业务命令诸事，汝当自执，悉按需代劳，然后详报于用户，禁绝令用户亲自操命令行也！
-若用户命令取汇总文牍，可观《report-templates/report-template.html》以取其式为法。
-## 参考文档导航
-
+## 文档索引
+实现用户要求时，请先阅读以下对应功能的文档
 | 文档 | 内容 |
 |------|------|
-| `references/workflows.md`| **多命令组合流程**（优先读取） |
-| `references/tips.md` | **`--json` + Node.js 精准查询技巧**（过滤 / 提取 / 多步串联） |
-| `references/accounts.md` | 账户查询 / 余额 / 消耗 / 开户 / 账号管理 |
-| `references/open-account-google-ui.md` | **Google 开户**：网页五步 + 两步表单与 CLI 对照（向导/时区列表） |
-| `references/open-account-by-media.md` | **各媒体开户差异**：路由、所需资料、接口路径与 CLI 对照（Google/TikTok/Yandex/Bing/Kwai） |
-| `references/google-ads.md` | Google 广告 CRUD（系列 / 组 / 创意 / 关键词） |
-| `references/google-ads-test.md` | Google 广告业务矩阵与 Agent 测试 |
-| `references/aigc.md` | AIGC 智能广告（`ad smart prepare` / `ad smart create`）及落地流程 |
-| `references/reporting.md` | TSO steward **优化报告**、Google 网关分析、`google-analysis`、**Meta/TikTok/Bing TSO 分析**（`report meta-overview`、`report tiktok-*`、`report bing-*`）、AI 智投 / 优化 / 预警 / 线索 |
-| `report-templates/` | 分析/诊断类报告纲要（`.md`）与输出汇总内容的style参考；**生成前须确认维度**见本节「报告与维度」 |
+| `references/setup.md` | 安装 / 登录 / 配置 / 环境切换 |
+| `references/workflows.md`| 一般业务流程 |
+| `references/tips.md` | 使用技巧 |
+| `references/accounts.md` | 账户相关 |
+| `references/open-account-by-media.md` | 开户相关 |
+| `references/google-ads.md` | Google广告创建/修改 |
+| `references/aigc.md` | 智能创建广告 / `ad smart`、异步批量 `ad batch` |
+| `references/reporting.md` | Google 账号优化报告（list/create/delete）、推送、网页查看 |
+| `references/account-analytics.md` | （默认情况下报告都使用这个）可获取多个维度的数据，用于账户分析，生成报告或其他类似的业务 |
+| `references/optimize.md` | `optimize` AI 广告优化记录 |
+| `references/clue.md` | `clue` TikTok/Meta 线索表单 |
+| `references/forewarning.md` | 智能预警（含微信通知、`forewarning` 命令） |
 | `references/finance.md` | 转账 / 发票（充值需网页） |
 | `references/tso-home.md` | TSO 首页看板页面与 CLI 对照 |
-| `references/setup.md` | 安装 / 登录 / 配置 / 环境切换 |
-| `references/google-ads-compliance.md` | **Google 广告合规指南**：关键词 & 文案审核通过规则、编辑规范、禁止内容、虚假承诺处理、商标规则、多语言规则 |
-| `references/sensitive-industries.md` | **敏感行业合规细则**：酒精 / 赌博 / 金融 / 加密 / 医疗 / 法律等 12 个行业的关键词生成规则与地区限制 |
-| `references/google-ads-keyword-strategy.md` | **关键词策略与优化技巧**：匹配类型策略、分组结构、否定词技巧、出价意图分层、搜索词挖掘、竞品策略、PMax/AI Max 协同、信号污染防治 |
-| `references/google-ads-keyword-optimization.md` | **关键词持续优化指南**：基于投放数据的迭代优化闭环——指标解读、决策框架（暂停/提价/降价/加否定）、优化节奏、转化归因、预算再分配、衰减检测、竞争响应、CRM 反馈 |
-| `references/google-ads-creative-optimization.md` | **广告创意与素材优化**：RSA 六类主题法、Ad Strength 评分、文案 A/B 测试、创意疲劳管理、附加信息（Sitelink/Callout/Snippet/Image）优化、DKI/倒计时/IF 函数、落地页 CRO、PMax 创意策略、多语言管理 |
-| `references/google-ads-campaign-optimization.md` | **广告系列结构与投放优化**：系列类型选择决策树、电商/线索/本地/SaaS 架构模板、出价策略校准与启动协议、地域/设备优化、转化追踪（Enhanced Conversions/离线导入/价值规则）、预算优化、网络设置、实验设计、账户健康诊断 |
-| `references/google-ads-creation-plan.md` | **广告创建确认方案模板**（**创建前必读**）：执行任何广告创建命令前，必须按此模板输出完整方案等待用户确认——系列配置、关键词列表、RSA 文案、附加信息、合规检查、执行计划；含等待确认话术和特殊场景（AIGC/关键词追加/草稿发布）处理规则 |
+| `report-templates/report-template.html` | **默认 HTML 样式参考**：凡输出带「总结 / 报告 / 汇总」性质的 HTML（不限于账户分析或诊断），均应以本文件为版式、配色与区块结构的参照；需其他视觉风格时再从同目录 `report-template*.html` 选用或询问用户（见 `report-templates/README.md`） |
+
 ---
 
-## 分析报告生成规则
+## 报告生成规则
 
 两类报告，规则不同：
 
 | 类型 | 操作 | 规则 |
 |------|------|------|
 | **TSO 优化报告** | `report list` / `report create` / `report push` 等 | 由平台生成，直接操作，不需要额外询问维度 |
-| **分析报告**（Agent 撰写） | `google-analysis *` / `report tiktok-*` / `report bing-*` / `report meta-overview` 拉数据后撰写 | 按下方规则执行 |
+| **一般报告**（Agent 撰写） | `google-analysis *` / `report tiktok-*` / `report bing-*` / `report meta-overview` 拉数据后撰写 | 按下方规则执行；子命令与模板见 `references/account-analytics.md` |
+### TSO优化报告
+只支持google平台，除非用户提到 优化报告否则一般不走这个流程
 
-### 分析报告做法
+### 一般报告做法（默认做法）
 1. 询问用户需要生成哪些维度的报告，或直接生成默认报告：包含以下维度：执行摘要、每日投放趋势、月度汇总、广告系列表现、设备分布、地域分布、关键词表现、优化建议
-2. 默认在**在report-templates/*.html** 文件中找到报告的样式参考，有多个必要时询问用户
+2. 需输出 HTML 时：**默认**以 `report-templates/report-template.html` 为样式基准（适用于一切总结性、报告性、汇总性成稿）；若场景更适合作正式件、深色、单页等，再从 `report-templates/report-template*.html` 中选或询问用户，并对照 `report-templates/README.md`
 3. 输出成html后可以转成pdf方便用户查看
 ---
 
-
-## 业务流程速查
-
-| 场景 | 参考 |
-|------|------|
-| 开通新广告账户（Google/TikTok/Bing/Kwai/Yandex） | `references/workflows.md` 流程一 |
-| AI 智投草稿 → 发布 Google 广告 | `references/workflows.md` 流程二 |
-| 手动搭建 Google 广告（系列→组→词→广告） | `references/workflows.md` 流程三 |
-| 查看 AI 优化建议并执行 | `references/workflows.md` 流程四 |
-| 创建/管理智能预警规则 | `references/workflows.md` 流程五 |
-| TSO 优化报告 → 推送 → 查看链接 | `references/workflows.md` 流程六 |
-| CLI 拉数撰写的分析/诊断报告 | `references/workflows.md` 流程六点五 + `report-templates/README.md` |
-| 开票申请完整流程 | `references/workflows.md` 流程七 |
-| 定期拉取 TikTok/Meta 广告线索 | `references/workflows.md` 流程八 |
-| 账户分享 / OAuth 重授权 / 解绑 | `references/workflows.md` 流程九 |
-| 日/周消耗数据巡检 | `references/workflows.md` 流程十 |
-| 媒体转账到账核查 | `references/workflows.md` 流程十一 |
-| TSO 首页看板 CLI 巡检 | `references/workflows.md` 流程十二 + `references/tso-home.md` |
-| AIGC 广告方案生成（全 CLI） | `references/workflows.md` 流程十三 |
-| 网站诊断与落地页评估 | `references/workflows.md` 流程十四 |
-| 账户管理（关闭/BM绑定/BC绑定/激活/邮箱） | `references/workflows.md` 流程十五 |
-| 生成合规关键词/广告文案 | `references/google-ads-compliance.md` 全文 |
-| 关键词策略与优化 | `references/google-ads-keyword-strategy.md` 全文 |
-| 投放后持续优化 | `references/google-ads-keyword-optimization.md` 全文 |
-| 创建/优化广告创意 | `references/google-ads-creative-optimization.md` 全文 |
-| 设计系列架构/调优投放 | `references/google-ads-campaign-optimization.md` 全文 |
-| **创建广告前输出确认方案** | `references/google-ads-launch-plan-template.md` 全文 |
-
----
-
-## 常用命令速查
-
-| 场景 | 命令 |
-|------|------|
-| 首次登录 | `siluzan-tso login` |
-| 查看配置 | `siluzan-tso config show` |
-| 查询广告账户 | `siluzan-tso list-accounts -m Google` |
-| 账户激活/充值账单明细 | `siluzan-tso account-active-bills -m Google --id <entityId>`（`entityId` 来自 `list-accounts --json`，非 mediaCustomerId；详见 `references/accounts.md`） |
-| 查询账户余额 | `siluzan-tso balance -m Google -a <mediaCustomerId>` |
-| 查询投放数据 | `siluzan-tso stats -m Google -a <mediaCustomerId>` |
-| TSO 首页（网页） | `config show` 取 `webUrl` → `{webUrl}/v3/foreign_trade/tso/home` |
-| 查广告主组（TikTok 等取 magKey） | `siluzan-tso open-account list-groups` |
-| Google 开户（脚本） | `siluzan-tso open-account google --company "…" --promotion-link "…" --promotion-type b2c ...`（**无需 magKey**） |
-| Google 开户时区列表 | `siluzan-tso open-account google-timezones`（可加 `--keyword`） |
-| 开户记录（网页，提交开户后确认/查进度；**勿用** `manageAccounts`） | `config show` 取 `webUrl` → `{webUrl}/v3/foreign_trade/tso/accountOpeningHistory` |
-| TikTok 开户时区列表 | `siluzan-tso open-account tiktok-timezones`（可加 `--keyword`） |
-| TikTok 行业列表 | `siluzan-tso open-account tiktok-industries`（两级结构，传叶子节点 ID） |
-| TikTok 注册地列表 | `siluzan-tso open-account tiktok-areas`（`--registered-area` 的合法值） |
-| TikTok 开户 | `siluzan-tso open-account tiktok --advertiser-id <magKey> ...` |
-| BingV2 行业列表 | `siluzan-tso open-account bing-industries`（`--trade-id` 的合法值） |
-| 查询 Google 被封账户（可提现） | `siluzan-tso account withdraw-list` |
-| 提交 Google 被封账户提现申请 | `siluzan-tso account withdraw-submit --accounts <entityId>`（**仅 Google**） |
-| 添加 OAuth 授权 | `siluzan-tso account auth -m Google` |
-| 解除授权 / 解绑 | `siluzan-tso account delink --id <entityId>` |
-| Google MCC 绑定 | `siluzan-tso account mcc-bind --customers <mediaCustomerId> --mcc <MCC客户ID>` |
-| Google MCC 解绑 | `siluzan-tso account mcc-unbind --customers <mediaCustomerId> --mcc <MCC客户ID>` |
-| 账号分享 | `siluzan-tso account share --id <entityId> --phone <手机号>` |
-| TikTok 关闭账户 | `siluzan-tso account close --accounts <mediaCustomerId>` |
-| Meta BM 绑定 | `siluzan-tso account bm-bind --account-id <mediaCustomerId> --bm-id <bmId>` |
-| TikTok BC 绑定 | `siluzan-tso account bc-bind --customers <mediaCustomerId> --bc-ids <bcId>` |
-| TikTok BC 解绑 | `siluzan-tso account bc-unbind --customers <mediaCustomerId> --bc-id <bcId>` |
-| Google 账户激活（网页） | `{webUrl}/v3/foreign_trade/tso/manageAccounts` |
-| AIGC 方案数据准备 | `siluzan-tso ad smart prepare -a <accountId> --url <url> -w "词1,词2"`（详见 `references/aigc.md`） |
-| 优化报告列表 | `siluzan-tso report list -m Google` |
-| 优化报告推送 | 页 `/dataReport/optimizationReport`：`report push list|create|update|history|receive-emails|start|stop|delete`；记录页 `/dataReport/pushRecord` 对应 `push history --setting-id <entityId>`；详见 `references/reporting.md` |
-| TikTok 账户分析（总览/系列/受众等） | `siluzan-tso report tiktok-overview -a <mediaCustomerId> [--json]`（另有 `tiktok-campaigns`、`tiktok-audience` 等，见 `report --help`） |
-| Bing（BingV2）账户分析 | `siluzan-tso report bing-overview -a <mediaCustomerId> [--json]`（区间不可含今天/昨天；另有 `bing-keywords`、`bing-search-terms` 等，见 `report --help`） |
-| 充值 / 钱包（网页） | 见 `references/finance.md` |
-| 媒体转账记录 | `siluzan-tso transfer list -m Google` |
-| 提交账户间转账 | `siluzan-tso transfer create -m Google --out <转出ID> --in <转入ID> --amount <金额>` |
-| 开票记录 | `siluzan-tso invoice list` |
-| 异步批量 / 智投记录 | `siluzan-tso ad batch list` |
-| 记录 / 草稿详情 | `siluzan-tso ad batch get --id <id>` |
-| 发布草稿 | `siluzan-tso ad batch publish --id <id>` |
-| 更新草稿 | `siluzan-tso ad batch update --id <id> --budget <n>` |
-| AI 广告优化 | 托管中：`optimize list -a <id>`。已脱管：全量筛 `optimize list --match-media-customer-id <Google客户号> --json` 取批次 `id`，再 `optimize get` / `optimize children --parent-id`；系列列表 `optimize records`（勿依赖 `-a`）；详见 `references/reporting.md` |
-| Google 广告诊断链接 | `siluzan-tso diagnostic` |
-| 线索表单（TikTok） | `siluzan-tso clue -m TikTok -a <advertiserId>` |
-| 线索表单（Meta） | `siluzan-tso clue -m Meta -a <pageId>` |
-| 智能预警列表 | `siluzan-tso forewarning list -m Google` |
-| 创建预警规则 | `siluzan-tso forewarning create -m Google --name "..." --accounts <ids> --field cost --operator GREATER_EQUALS --value 500` |
-| Google 广告系列列表 | `siluzan-tso ad campaigns -a <accountId>` |
-| Google 广告系列创建（走 AI 创建 API） | `siluzan-tso ad campaign-create -a <accountId> --customer-name "..." --name "..." --budget <n> --bidding MANUAL_CPC --location-ids <id> --adgroup-name "..." --max-cpc <n>` |
-| Google 广告组创建 | `siluzan-tso ad adgroup-create -a <accountId> --campaign-id <id> ...` |
-| Google 自适应搜索广告编辑（RSA） | `siluzan-tso ad ad-edit -a <accountId> --id <adId>`，可选 `--headlines`、`--descriptions`、`--final-url`、`--path1`、`--path2`、`--status`（Enabled 或 Paused） |
-| Google 关键字推荐 | `siluzan-tso keyword -k "running shoes"` |
-| Google 搜索关键词编辑 | `siluzan-tso ad keyword-edit -a <accountId> --id <keywordId>`，可选 `--text`、`--match-type`（Broad/Phrase/Exact）、`--max-cpc`、`--final-url`；接口为 `PUT .../keywordmanagement/Keyword/{account}/batch`，成功后 id 可能变化，见 `references/google-ads.md` |
-| Google 搜索关键词删除 | `siluzan-tso ad keyword-delete -a <accountId> --id <keywordId> --adgroup-id <adGroupId>`；`DELETE .../keywordmanagement/Keyword/{account}/batch`，body `[{adGroupId,id}]`，成功响应常为空 |
-| Google 搜索字词报告 | `siluzan-tso ad search-terms -a <accountId> [--start YYYY-MM-DD] [--end YYYY-MM-DD]`（**仅 Google**，只读） |
-
----
-
-## 自动更新规则（必须遵守）
-
+## 自动更新规则
 CLI 命令执行后可能在输出末尾出现以下两种标记，Agent 必须按对应规则处理：
-
 ### `[SILUZAN_FORCE_UPDATE]` — 强制更新（必须，不可跳过）
-
 当前版本已低于最低要求版本，**必须先升级再继续**：
-
 1. 立即执行 `siluzan-tso update`
 2. 告知用户：当前版本过旧，已自动升级，请重新执行刚才的操作
 3. 不得在升级前继续执行任何业务命令
-
 ### `[SILUZAN_UPDATE_AVAILABLE]` — 可选更新
-
 有新版本可用，但当前版本仍可正常使用：
-
 1. 执行 `siluzan-tso update`
 2. 更新完成后继续执行原本的用户任务
-
 > 两种情况下，`siluzan-tso update` 都会同步刷新 Skill 文件，新版本可能包含参数或流程变更。
-
 ---
 
 ## AI 行为规范
-- **合理使用命令行的帮助功能**：使用命令前，调用-h查看命令有哪些参数
-- **先查账户再操作**：对具体账户做操作前，先通过 `list-accounts -m [mediaType] -k {id}` 确认 ID。特别是不确定是Google/Bing/TikTok这些媒体平台中的哪一个的时候
+- **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件或使用-h查看命令帮助，不要猜参数。
+- **先查账户再操作**：对具体账户做操作前，先通过 `list-accounts -m [mediaType] -k [mediaCustomerId]` 确认。特别是不确定是Google/Bing/TikTok这些媒体平台中的哪一个的时候
 - **使用 --json 处理数据**：需对返回数据做计算或筛选时，加 `--json`，再用 `node -e` 过滤提取（见 `references/tips.md`）。
 - **不要猜测账户 ID**：`entityId` ≠ `mediaCustomerId`，两者均来自 `list-accounts`。
 - **媒体类型区分大小写**：`Google`、`TikTok`、`MetaAd`、`BingV2`、`Kwai`。
-- **Google 网关**：使用 `ad`、`keyword`、`account mcc-*` 前，先 `config show` 确认 `googleApiUrl` 已配置。
-- **时区**：所有日期按北京时间（UTC+8），`optimize` 命令自动附加 `+08:00`。
-- **分页**：默认每页 20 条，数据量大时加 `--page-size 100` 或 `--page` 翻页。
-- **充值等网页操作**：先 `config show` 取 `webUrl`，再拼路径引导用户。
-- **Google 新开户**：终端用户优先建议 `open-account google-wizard`；说明网页「五步」里**充值激活**必须网页完成。详见 `references/open-account-google-ui.md`。
-- **分析报告**：按默认维度直接拉数 + 撰写，同时列出可选追加维度询问用户；见上文「分析报告生成规则」与 `report-templates/google-period-report.md`。
-- **优化报告**（`report list/create/push`）：由平台生成，直接操作，不额外询问维度。
-- **报告内容以 `*.md` 纲要为准**，`report-template*.html` 仅提供样式，内容优先级高于样式。
-- **不确定时读文档**：遇到不熟悉的命令，先读对应 references 文件，不要猜参数。
-- **关键词/文案合规**：执行 `ad keyword-create`、`ad ad-create`、`ad campaign-create`、`ad smart create` 前，先读 `references/google-ads-compliance.md` 中的生成前检查清单（第十一章）；如行业属于 Tier 2/3（受限/高度管制），还须读 `references/sensitive-industries.md` 对应章节。
-- **关键词策略优化**：生成关键词时，参考 `references/google-ads-keyword-strategy.md` 的匹配类型选择（第二章）、分组结构（第三章）和否定词策略（第四章）；优化已有广告系列时，参考搜索词挖掘（第八章）和信号污染防治（第十五章）。
-- **投放后持续优化**：有投放数据后，按 `references/google-ads-keyword-optimization.md` 的优化节奏（第五章）执行每周/每月任务；使用决策框架（第三章）判断关键词去留；用 `google-analysis` 系列命令拉取数据（第十三章）。
-- **广告创意优化**：创建/编辑广告创意（`ad ad-create`/`ad-edit`）时，参考 `references/google-ads-creative-optimization.md` 的 RSA 六类主题法（第一章）和 Ad Strength 指南（第二章）；管理附加信息时参考第五章；定期检查创意疲劳（第四章）。
-- **系列架构与投放**：新建广告系列（`ad campaign-create`）时，参考 `references/google-ads-campaign-optimization.md` 的架构模板（第二章）和出价启动协议（第三章）；调整地域/设备/预算时参考对应章节；定期用 `google-analysis gold-account` 检查账户健康。
-- **广告创建前必须输出确认方案**：执行 `ad campaign-create`、`ad adgroup-create`、`ad ad-create`、`ad keyword-create`、`ad smart create`、`ad batch publish` 之前，必须先读 `references/google-ads-launch-plan-template.md`，按模板格式输出完整方案，明确等待用户回复「确认」后才能开始执行创建命令；未经用户确认不得提前调用任何写入类命令。
+- **一个完整的产品，不应该暴露内部命令**：除了 `setup` 中的 `login` 命令，所有命令行工具都是交由你完全代替用户执行。禁止向用户透露任何命令行、参数或代码逻辑。
+- **具体业务的额外规范**：开户、优化、报告、Google 广告创建等场景的详细约束，请分别在执行前阅读对应的 `references/*.md` 文档。
+
+
+## 账户ID示例
+用于快速确定用户发送账号的类型,xxx是脱敏处理，一般主要通过位数就能确定账号类型，无法确定再查list-account -m mediatype -k id
+Google: 4545xxx137
+Tiktok: 70083497xxx59820033
+Meta(Facebook): 1716030xxx734076, 6843984xxx14909, 479423xxx752348
+Bing: 138xxx763， 1882xxx80
+Yandex: porg-uthxxxrk
+Kwai: act_1716030xxx734076

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.0.0-beta.45",
-  "publishedAt": 1774866365842
+  "version": "1.0.0-beta.47",
+  "publishedAt": 1774942711256
 }

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

@@ -0,0 +1,175 @@
+# 账户分析数据拉取与周期报告
+
+> 所属 skill：`siluzan-tso`。
+>
+> 本文档说明如何通过 CLI 拉取 **Google / Meta / TikTok / Bing** 的账户分析数据，供撰写**分析报告、诊断报告**使用。  
+> **TSO 平台生成的优化报告**（`report list` / `create` / `push`）见 `references/reporting.md`。
+
+---
+
+## Google 账户分析数据接口
+
+| `report-templates/` | 分析/诊断类报告纲要（`.md`）与输出汇总内容的 style 参考；**生成前须确认维度**见下文「报告模板」 |
+
+用于按账户维度拉取 Google Ads 报表、结构类数据。
+
+### 指标字段对照
+
+多条报表行的原始体里，消耗类指标常用下列字段名（调用方若要做统一展示，可按此对照；**以实际响应为准**）：
+
+| 常见展示名 | 响应中常见字段名 |
+|------------|------------------|
+| 消耗 | `spend` |
+| 展示 | `impressions` |
+| 点击 | `clicks` |
+| 转化 | `conversions` |
+| 点击率 | `ctr` |
+| 转化率 | `conversionRate` |
+| 平均点击成本 | `averageCpc` |
+| 转化成本 | `costPerConversion` |
+
+---
+
+### google-analysis
+
+使用已配置的 `googleApiUrl` 与 Token，无需手写 curl。
+
+```text
+siluzan-tso google-analysis <子命令> -a <mediaCustomerId> [选项]
+```
+
+**通用选项**
+
+| 选项 | 说明 |
+|------|------|
+| `-a, --account` | Google `mediaCustomerId`（必填） |
+| `--start` / `--end` | 统计区间；**须同传或同省略**（省略则默认近 7 天截至昨天） |
+| `--json` | 输出完整响应 JSON |
+| `-t, --token` | 鉴权 Token（可选，默认读配置） |
+| `--verbose` | 打印详细错误 |
+
+**子命令与网关路径对应**
+
+| 子命令 | 说明 |
+|--------|------|
+| `overview` | 总览 `OverviewSectionData` |
+| `keywords` | 关键词 `KeywordSectionData`；可选 `--limit`、`--no-order-by-cost` |
+| `search-terms` | 搜索词 `searchtermmanagement/v2/list`；同上 |
+| `campaigns` | 系列 `CampaignSectionData` |
+| `ads` | 广告 `admanagement/v2/list` |
+| `extensions` | 附加信息 `extensionmanagement/v2/list`；可选 `--level`（Account / Campaign / Ad Group） |
+| `devices` | 设备 `DeviceSectionData` |
+| `geographic` | 地域 `GeographicSectionData` |
+| `audience` | 受众 `AdGroupAudienceData`；可选 `--audience-type SystemDefined \| UserDefined` |
+| `asset-images` | 图片素材 `CampaignAssetView` |
+| `videos` | 视频 `Videos` |
+| `materials` | 合并 `CampaignAssetView` + `Videos`（一次输出 `{ images, videos }`） |
+| `resource-counts` | 结构 `resource-counts` |
+| `conversion-actions` | 转化动作 |
+| `daily-metrics` | 按日 `reports` |
+| `gold-account` | 黄金账户 `GoldAccountData` |
+| `ads-index` | 质量指标 `AdsIndexData` |
+| `final-urls` | 最终到达网址（**不要**传 `--start`/`--end`） |
+| `dimension-summary` | 账户汇总 `reports/combined` |
+| `campaign-types` | 系列类型（**不要**传 `--start`/`--end`） |
+
+**示例**
+
+```bash
+siluzan-tso google-analysis overview -a 6326027735 --start 2026-03-01 --end 2026-03-31 --json
+siluzan-tso google-analysis keywords -a 6326027735 --limit 50
+siluzan-tso google-analysis final-urls -a 6326027735 --json
+```
+
+---
+
+## Meta 账户分析总览（TSO）
+
+```bash
+siluzan-tso report meta-overview -a <mediaCustomerId> [--start YYYY-MM-DD --end YYYY-MM-DD] [--json]
+```
+
+`--start` / `--end` 须**同传或同省略**；省略时默认**近 7 天（截至昨天）**，与 `google-analysis` 日期规则一致。
+
+响应结构可与 Google 总览类比（如 `accountId`、`totalCost`、`currentPeriod` / `previousPeriod`、`optimizationScore` 等），**以实际 JSON 为准**。
+
+**报告模板**：`report-templates/meta-period-report.md`
+
+---
+
+## TikTok 账户分析（TSO）
+
+与周期报告常见数据块对应关系见 **`report-templates/tiktok-period-report.md`**。
+
+| 子命令 | HTTP 段 / 说明 |
+|--------|----------------|
+| `report tiktok-overview` | `.../OverviewSectionData?startDate=&endDate=` |
+| `report tiktok-campaigns` | `.../CampaignSectionData?startDate=&endDate=&take=`（默认 `take=100`） |
+| `report tiktok-ad-groups` | `.../AdGroupReport?...` |
+| `report tiktok-ads` | `.../AdReport?...` |
+| `report tiktok-videos` | `.../VideoReport?...` |
+| `report tiktok-audience` | `.../AudienceReport?...&dimensions=` + `-d` 取值见 CLI 帮助（gender / age / interest_category 等） |
+| `report tiktok-audience-merged` | 同上接口三次（`gender`、`age`、`interest_category`），**合并输出 JSON** |
+| `report tiktok-areacode` | `GET {mainApiUrl}/query/media-account/tiktok/TikTokAreacode/Read` |
+| `report tiktok-interest-list` | `{tiktokApiUrl}/.../GetInterestList?mediaCustomerId=`（需配置 `tiktokApiUrl`） |
+
+**日期与鉴权**：`--start` / `--end` 须**同传或同省略**；省略时默认**近 7 天（截至昨天）**。鉴权与 TSO 其他接口相同。
+
+**示例**
+
+```bash
+siluzan-tso report tiktok-overview -a 1234567890 --json
+siluzan-tso report tiktok-campaigns -a 1234567890 --start 2026-03-01 --end 2026-03-31 --take 50 --json
+siluzan-tso report tiktok-audience -a 1234567890 -d gender --json
+siluzan-tso report tiktok-audience-merged -a 1234567890 --start 2026-03-01 --end 2026-03-07
+siluzan-tso report tiktok-areacode --json
+```
+
+---
+
+## Bing（BingV2）账户分析（TSO）
+
+章节与数据块对照见 **`report-templates/bing-period-report.md`**。
+
+**重要（日期）**：Bing 报表**不能包含「今天」或「昨天」**（接口限制，与 Web 端校验一致）。`--start` / `--end` 须**同传或同省略**；**省略时** CLI 默认区间为**截至前天**的近 7 天（避免误含昨天）。
+
+| 子命令 | HTTP 段 / 说明 |
+|--------|----------------|
+| `report bing-overview` | `.../OverviewSectionData?startDate=&endDate=` |
+| `report bing-device` | `.../DeviceSectionData?...` |
+| `report bing-geographic` | `.../GeographicSectionData?...` |
+| `report bing-age-audience` | `.../AgeAudienceData?...` |
+| `report bing-gender-audience` | `.../GenderAudienceData?...` |
+| `report bing-audience-merged` | 上两项并行拉取，**合并输出 JSON** |
+| `report bing-campaigns` | `.../CampaignReport?...` |
+| `report bing-ad-groups` | `.../AdGroupReport?...` |
+| `report bing-ads` | `.../AdReport?...` |
+| `report bing-keywords` | `.../KeywordReport?startDate=&endDate=&limit=&orderByCost=true`（默认 `limit=100`） |
+| `report bing-search-terms` | `.../SearchQueryReport?...`（同上） |
+
+**示例**
+
+```bash
+siluzan-tso report bing-overview -a <mediaCustomerId> --json
+siluzan-tso report bing-keywords -a <mediaCustomerId> --start 2026-03-01 --end 2026-03-20 --limit 50 --json
+siluzan-tso report bing-audience-merged -a <mediaCustomerId>
+```
+
+---
+
+## 报告模板与输出形式
+
+报告输出内容参考 **`report-templates/`**：
+
+- `report-templates/google-period-report.md` — 单周期汇总报告章节
+- `report-templates/google-account-diagnosis-report.md` — 诊断类报告章节（纲要）
+- `report-templates/google-ads-diagnosis.md` — 与网页版《Google Ads 账户诊断报告》**章节与数据块对齐**的完整骨架
+- `report-templates/meta-period-report.md` — Meta（Facebook）周期报告纲要（当前仅总览）
+- `report-templates/tiktok-period-report.md` — TikTok 周期报告纲要（与 `report tiktok-*` 对齐）
+- `report-templates/bing-period-report.md` — Bing（BingV2）分析纲要（与 `report bing-*` 对齐）
+- `report-templates/README.md` — 索引与规则
+
+`report-templates` 目录下的 `.html` 文件（如 `report-template.html`、`report-template-academic.html` 等）为**样式参考**，可先生成 HTML 再转为 PDF。
+
+> **分析报告做法**：按 `google-period-report.md`（或对应媒体 `*.md`）中的默认维度拉数撰写，同时列出可选追加维度询问用户。**TSO 优化报告**（`report list` / `create` / `push`）不走此流程，详见 `references/reporting.md`。  
+> 报告内容以各 `*.md` 纲要为准，`report-template*.html` 仅提供样式；如未另行指定，所有总结 / 报告 / 汇总类 HTML 默认对齐 `report-templates/report-template.html` 的区块结构与视觉风格。

package/dist/skill/references/aigc.md

@@ -223,7 +223,7 @@ ChatGPT 通常会生成 20-25 条标题，若全部发送则触发此错误。CL
 
 ---
 
-## 后续步骤：草稿管理
+## 后续步骤：草稿管理（速查）
 
 ```bash
 # 查看 AI 智投记录（含草稿和已发布）
@@ -235,3 +235,67 @@ siluzan-tso ad batch publish --id <草稿ID>
 # 查看创建进度（异步任务）
 siluzan-tso ad batch get --id <记录ID>
 ```
+
+完整参数与边界说明见下文 **「ad batch — 异步批量创建 / AI 智投记录」**。
+
+---
+
+## ad batch — 异步批量创建 / AI 智投记录
+
+对应页面：`/advertising/AICreationList`。与 `ad campaign-create` / `ad smart create` 等同源异步创建链路。
+
+### list — 查询列表
+
+```bash
+siluzan-tso ad batch list [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-s, --state <state>` | 状态：`Creating \| Successfully \| Failed \| HasFailed \| Unpublished` |
+| `--customer-id <id>` | Google mediaCustomerId |
+| `--customer-name <name>` | 客户名称关键字 |
+| `-k, --keyword <text>` | 关键字 |
+| `--start / --end <date>` | 创建日期范围 |
+| `-p, --page <n>` | 页码（默认 1） |
+| `--page-size <n>` | 每页数量（默认 20） |
+| `--json` | 输出原始 JSON |
+
+**示例：**
+
+```bash
+siluzan-tso ad batch list
+siluzan-tso ad batch list --customer-id 6326027735
+siluzan-tso ad batch list --state Failed --json
+siluzan-tso ad batch list --state Unpublished --start 2026-03-01
+```
+
+### get — 获取记录 / 草稿详情
+
+```bash
+siluzan-tso ad batch get --id <recordId>
+```
+
+输出完整 JSON（含广告系列、预算、关键词、定向位置等）。
+
+### update — 更新草稿字段
+
+只有 `draftStatus === "Draft"` 的记录可更新。
+
+```bash
+siluzan-tso ad batch update --id <recordId> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `--budget <amount>` | 新预算（最小货币单位，如 `8500` = 85 元 CNY） |
+| `--url <url>` | 新推广链接 |
+| `--campaign-name <name>` | 新广告系列名称 |
+
+### publish — 发布草稿
+
+只有 `draftStatus === "Draft"` 的记录可发布。发布后状态变为 `Creating`，Google 后台异步执行创建。
+
+```bash
+siluzan-tso ad batch publish --id <recordId>
+```

package/dist/skill/references/clue.md

@@ -0,0 +1,57 @@
+# 广告线索表单（clue）
+
+> 所属 skill：`siluzan-tso`。
+>
+> 对应页面：`/clue-form`。支持 **TikTok** 和 **Meta（Facebook）** 两种媒体。
+
+> **注意**：线索数据直接来自媒体 API，**不支持服务端分页**，数据量大时建议 `--json` 导出后自行处理。
+
+```bash
+siluzan-tso clue -m <媒体> -a <账户ID> [选项]
+```
+
+| 选项 | 说明 |
+|------|------|
+| `-m, --media` | `TikTok \| Meta`（默认 TikTok） |
+| `-a, --account <id>` | TikTok：`advertiserId`（mediaCustomerId）；Meta：Facebook 页面 ID |
+| `--region <region>` | TikTok 专用：`eu \| us \| other \| ALL`（默认 ALL） |
+| `--start <date>` | Meta 专用：开始日期（YYYY-MM-DD） |
+| `--end <date>` | Meta 专用：结束日期（YYYY-MM-DD） |
+| `--json` | 输出原始 JSON |
+
+**TikTok 示例：**
+
+```bash
+# 查询 TikTok 全部区域线索
+siluzan-tso clue -m TikTok -a 1234567890
+
+# 只查欧洲区线索
+siluzan-tso clue -m TikTok -a 1234567890 --region eu
+
+# 查美国区，JSON 输出
+siluzan-tso clue -m TikTok -a 1234567890 --region us --json
+```
+
+**Meta 示例：**
+
+```bash
+# 查询 Meta 线索（3月份）
+siluzan-tso clue -m Meta -a 987654321 --start 2026-03-01 --end 2026-03-31
+
+# JSON 输出
+siluzan-tso clue -m Meta -a 987654321 --start 2026-03-01 --json
+```
+
+**输出字段说明（TikTok）：**
+
+| 字段 | 来源 |
+|------|------|
+| 姓名、邮箱、手机 | `custom_fields` |
+| 表单名、广告名、区域、时间、lead_id | `system_fields` |
+
+**输出字段说明（Meta）：**
+
+| 字段 | 来源 |
+|------|------|
+| 姓名、邮箱、手机 | `field_data` |
+| 表单名、创建时间 | 顶层字段 |

package/dist/skill/references/{google-ads-launch-plan-template.md → google-ads-rules/google-ads-launch-plan-template.md}

@@ -20,12 +20,12 @@
 
 - 用户可见正文只写业务字段（预算、地域、文案等），不出现命令行、可执行脚本或工具名称
 - 助手侧须保证每个业务字段可落实为实际创建步骤（映射关系见文末「助手执行计划」）；**搜索网络仅限 Google 搜索、关闭搜索合作伙伴与展示网络**为必选策略
-- 关键词和广告文案必须通过合规检查（参考 `google-ads-compliance.md` 第十一章）
+- 关键词和广告文案必须通过合规检查（参考 `references/google-ads-rules/google-ads-compliance.md` 第十一章）
 - 敏感行业须额外标注合规要求（参考 `sensitive-industries.md`）
 
 ### 各模块推荐数量一览
 
-以下与 `google-ads-compliance.md` 第七章、`google-ads-keyword-strategy.md`、`google-ads-creative-optimization.md` 第一章与第五章对齐；**正文结构以本节下「模板正文」中 Google Ads 搜索详细执行方案为准**。生成计划时按推荐条数填满表格，勿仅用少量示例占位。
+以下与 `references/google-ads-rules/google-ads-compliance.md` 第七章、`references/google-ads-rules/google-ads-keyword-strategy.md`、`references/google-ads-rules/google-ads-creative-optimization.md` 第一章与第五章对齐；**正文结构以本节下「模板正文」中 Google Ads 搜索详细执行方案为准**。生成计划时按推荐条数填满表格，勿仅用少量示例占位。
 
 | 模块 | 最少 | 推荐 | 上限 / 说明 |
 |------|------|------|----------------|
@@ -108,7 +108,7 @@ AI 生成计划时，按以下格式输出。`{{占位符}}` 由 AI 根据用户
 
 ### 3.2 广告系列（Campaign）基础设置
 
-**表项**：按系列列展开（常见 **1–3 个搜索系列**；多于 3 个时继续增列并写清预算占比）。**广告轮换**统一建议：**优先展示效果最佳的广告（Optimize）**。
+**表项**：按系列列展开（常见 **2–3 个搜索系列**；多于 3 个时继续增列并写清预算占比）。**广告轮换**统一建议：**优先展示效果最佳的广告（Optimize）**。
 
 | 设置项 | {{系列 1 名称}} | {{系列 2 名称}} | {{系列 3（可选）}} |
 |---|---|---|---|
@@ -190,7 +190,7 @@ AI 生成计划时，按以下格式输出。`{{占位符}}` 由 AI 根据用户
 | … | … | … | … |
 | Headline 15（上限） | {{文案}} | {{N}} | 自由轮换 |
 
-（Headlines **推荐 12–15 条**；主题分配仍参考 `google-ads-creative-optimization.md` 1.2 六类主题法。）
+（Headlines **推荐 12–15 条**；主题分配仍参考 `references/google-ads-rules/google-ads-creative-optimization.md` 1.2 六类主题法。）
 
 | 资产类型 | 广告文案 | 字符数 | 后台设置指令 |
 |---|---|---|---|
@@ -211,7 +211,7 @@ Display URL：`{{domain}}/{{path1}}/{{path2}}`（Path1/Path2 各 ≤ 15 字符
 
 **数量**：Sitelink **推荐 6–8**；Callout **推荐 6–8**；Structured Snippet **至少 1 组，推荐 1–2 组**，每组 **≥4 值**；**CALL** 有合规号码则 **1 条**；**Lead Form** 按业务 **0–1 套**。
 
-**联系方式**：电话走 **CALL**；**无独立「邮箱」附加信息类型**，邮箱用 **Sitelink** 指向 `mailto:` 或联系页（勿写入 RSA 正文，见 `google-ads-compliance.md`）。
+**联系方式**：电话走 **CALL**；**无独立「邮箱」附加信息类型**，邮箱用 **Sitelink** 指向 `mailto:` 或联系页（勿写入 RSA 正文，见 `references/google-ads-rules/google-ads-compliance.md`）。
 
 #### 附加链接（Sitelinks）
 
@@ -241,7 +241,7 @@ Display URL：`{{domain}}/{{path1}}/{{path2}}`（Path1/Path2 各 ≤ 15 字符
 | **每周** | **砍烂词**：某关键词花费 > {{如：$15}} 且无有效转化（或无线索/WhatsApp 等约定动作），**暂停**；**调出价**：有效 B2B/目标动作词可提价 **10%–15%**，争取**绝对页首展示份额** |
 | **每月** | 核对 CRM/销售数据，算真实 ROI；对「垃圾线索」来源词**降价或暂停**；评估是否满足切换 **tCPA / 智能出价** 的数据门槛 |
 
-**阶段总览**（与 `google-ads-campaign-optimization.md` 可对照，不替代上表日常动作）：
+**阶段总览**（与 `references/google-ads-rules/google-ads-campaign-optimization.md` 可对照，不替代上表日常动作）：
 
 | 阶段 | 时间 | 重点任务 |
 |---|---|---|
@@ -269,7 +269,7 @@ Display URL：`{{domain}}/{{path1}}/{{path2}}`（Path1/Path2 各 ≤ 15 字符
 
 ## 五、合规检查清单
 
-**条数**：以下 **8 条**逐项勾选（与 `google-ads-compliance.md` 第十一章呼应，不增删序号以免漏检）。
+**条数**：以下 **8 条**逐项勾选（与 `references/google-ads-rules/google-ads-compliance.md` 第十一章呼应，不增删序号以免漏检）。
 
 - [ ] 所有 headline ≤ 30 字符（CJK 按 2 字符/字计算）
 - [ ] 所有 description ≤ 90 字符