siluzan-tso-cli 1.1.47 → 1.1.48-beta.2

package/dist/skill/AGENTS.md

@@ -28,6 +28,7 @@
 | Core       | `references/core/`                 | conventions、intent-routing、playbooks、workflows                          |
 | Accounts   | `references/accounts/`             | 直接读 `accounts-list` / `accounts-balance-stats` / `accounts-permissions` |
 | Google Ads | `references/google-ads/`           | `google-ads-read` / `write` / `batch`；`rules/` 先 README 再单文件         |
+| Meta Ads   | `references/meta-ads/`             | Instant Form：`meta-ads` / `read` / `write` + `meta-lead-launch-plan-template` |
 | Analytics  | `references/analytics/`            | 拉数、批处理、拓词                                                         |
 | Operations | `references/operations/`           | 预警、线索；自动化仅用户问起时                                             |
 | Templates  | `report-templates/*.md`、`assets/` | 报告纲要 / JSON 契约                                                       |

package/dist/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: siluzan-tso
-description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网+诊断/检测/监测/评估/体检/报告/符合投放要求/能不能投（含「网络诊断」混说）→P8 website-diagnosis collect（禁纯WebFetch/肉眼看页），禁止P9/P1/W3、禁止A/B/C/D追问；细则见 intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类话术→必走P9 market-analysis collect+render出HTML，禁止纯WebSearch/WebFetch在对话里写Markdown/HTML当终稿、禁止改走P8/P1/P4/W5/google-analysis；细则见 references/core/intent-routing.md §零·B。【§零·C·关键词规划】Google Ads/谷歌广告拓词、关键词规划/推荐、Keyword Planner、长尾关键词、月搜索量/搜索量、竞争度、核心词/种子词扩词（含「阅读网址/文章/页面后针对核心词出带搜索量词表」，无论是否提及丝路赞/TSO/账户）→必走W5 keyword -k … --google-only --json-out，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/campaign JSON→W3；仅要词表+搜索量/竞争度→W5；平台优化报告列表/推送→W7；对象仍不清→Read intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、六大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】Google **仅支持搜索广告（Search）与 PMax**（不支持展示广告 Display）；搜索系列方案与 campaign-validate/create（W3）、系列/组/广告/关键词 CRUD/拒审、PMax 创建与素材、AI智投草稿 batch（W4）、拓词 keyword -k（W5）、AI广告优化 optimize（W6）、优化合规 SOP。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
+description: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/Kwai/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网+诊断/检测/监测/评估/体检/报告/符合投放要求/能不能投（含「网络诊断」混说）→P8 website-diagnosis collect（禁纯WebFetch/肉眼看页），禁止P9/P1/W3、禁止A/B/C/D追问；细则见 intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类话术→必走P9 market-analysis collect+render出HTML，禁止纯WebSearch/WebFetch在对话里写Markdown/HTML当终稿、禁止改走P8/P1/P4/W5/google-analysis；细则见 references/core/intent-routing.md §零·B。【§零·C·关键词规划】Google Ads/谷歌广告拓词、关键词规划/推荐、Keyword Planner、长尾关键词、月搜索量/搜索量、竞争度、核心词/种子词扩词（含「阅读网址/文章/页面后针对核心词出带搜索量词表」，无论是否提及丝路赞/TSO/账户）→必走W5 keyword -k … --google-only --json-out，禁止WebSearch/WebFetch编造搜索量当终稿；细则见 references/core/intent-routing.md §零·C。【报告/诊断消歧】其余报告类话术禁止默认某一CLI——行业/市场/战略/行业分析报告→P9 market-analysis（必走collect+render，禁止纯WebSearch代替）；Google账户ID+健康诊断→P1 google-ads-diagnosis；账户ID+周期/月度→P4；Meta/TikTok/Bing周期→P4/P4-FB；多账户对比→P3/P5；OKKI周报→P6；Google询盘→P7；官网+明确要搜索广告方案/campaign JSON→W3；Meta Instant Form 线索广告→W13；仅要词表+搜索量/竞争度→W5；平台优化报告列表/推送→W7；对象仍不清→Read intent-routing.md。【账户】列表/余额/消耗/激活账单（W1）、多账户余额预警 balance-scan（P2）、多户消耗汇总 accounts-digest（P3）、六大媒体开户与进度（W2）、分享/解绑/MCC/BC/BM/权限（W9）。【投放】Google **仅支持搜索广告（Search）与 PMax**（不支持展示广告 Display）；搜索系列方案与 campaign-validate/create（W3）、系列/组/广告/关键词 CRUD/拒审、PMax 创建与素材、AI智投草稿 batch（W4）、拓词 keyword -k（W5）、AI广告优化 optimize（W6）、优化合规 SOP；Meta Instant Form 线索广告 meta-ad validate/create（W13）。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。
 license: MIT
 compatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权
 metadata:
@@ -14,7 +14,7 @@ allowed-tools: Bash(siluzan-tso:*) Read Write
 本文件只做 **任务路由**：意图 → **唯一**工作流 → 按需 Read 子文档（参数与步骤不在此重复）。
 
 - 分析 / 报告 → `references/core/playbooks.md`（P1–P9）
-- 操作 / 管理 → `references/core/workflows.md`（W1–W12）
+- 操作 / 管理 → `references/core/workflows.md`（W1–W13）
 - 命令参数 → 路由表「必读文档」
 - 通用纪律与沟通 → `references/core/agent-conventions.md`
 
@@ -87,6 +87,16 @@ siluzan-tso -h
 | AI 广告优化记录 / 建议 | W6 | `references/operations/optimize.md` |
 | 优化/合规 SOP | W3 / W6 | `references/google-ads/rules/README.md`（**仅读索引表** → 再 Read **一个**具体 `rules/*.md`） |
 
+### Meta 广告投放
+
+> **类型边界**：仅 **Instant Form 线索广告**；无视频 / Advantage+ / 系列列表。拉已有线索走 **W11**；周期报告走 **P4-FB**。
+
+| 用户意图（关键词） | 工作流 | 必读文档 |
+| ------------------ | ------ | -------- |
+| 新建 Meta/Facebook 线索广告 / Instant Form / 潜在客户表单投放 / **出 Facebook 线索方案或表格** | **W13** | `references/meta-ads/meta-ads.md` + **`assets/meta-lead-create-template.json`**（先 Read）+ `assets/meta-lead-create-template.md` + **`references/meta-ads/meta-lead-launch-plan-template.md`**（**写代码**投影审查稿）+ `references/meta-ads/meta-ads-write.md`。**≠ W11 ≠ P4-FB ≠ W3** |
+| Meta 系列/组/广告 **查询**（按 ID）/ 主页 / 表单列表 | W13 | `references/meta-ads/meta-ads-read.md` |
+| Meta 系列/组/广告 **创建·编辑·启停**（原语） | W13 | `references/meta-ads/meta-ads-write.md` |
+
 ### 分析与报告
 
 | 用户意图（关键词） | 工作流 | 必读文档 |

package/dist/skill/_meta.json

@@ -1,5 +1,5 @@
 {
   "slug": "siluzan-tso",
-  "version": "1.1.47",
-  "publishedAt": 1787306827872
+  "version": "1.1.48-beta.2",
+  "publishedAt": 1787557251168
 }

package/dist/skill/assets/meta-lead-create-template.json

@@ -0,0 +1,105 @@
+{
+  "_meta": {
+    "schema": "meta-lead-create/v1",
+    "doc": "meta-lead-create-template.md",
+    "note": "以 _ 开头的键仅作说明，CLI 提交前会剥离。金额填主币种元。",
+    "agentPitfalls": [
+      "仅 Instant Form 线索广告（OUTCOME_LEADS）；勿当完整 Meta 投放后台",
+      "先 meta-ad pages 取 pageId，空列表不要硬填历史 page_id",
+      "budgetMode=CBO 预算只放 campaign；ABO 只放 adset",
+      "dailyBudget / lifetimeBudget 填元（10 = $10 / ¥10），禁止填网关最小单位 1000 当 10 元",
+      "form.reuseId 与新建表单字段二选一；表单建成后几乎不可改",
+      "图片三选一：imageHash / imagePath / imageUrl；创意必须用 hash",
+      "提交前：validate → 写代码按 meta-lead-launch-plan-template.md 投影审查稿 → 用户确认 → create --commit",
+      "仅出方案：account=[PENDING_ACCOUNT] pageId=[PENDING_PAGE]；勿因缺账户阻塞",
+      "create 默认 PAUSED；投放须三个对象分别 *-status ACTIVE",
+      "pages --json-out 读 items[].id（不是 pages[]）；403 或空列表不要硬填 pageId",
+      "建广告报支付方式则停，补付款后 ad-create 续跑，不要重头 create",
+      "拉已有线索走 clue -m Meta（W11），不是本模板"
+    ]
+  },
+  "account": "REPLACE_mediaCustomerId",
+  "pageId": "REPLACE_pageId",
+  "budgetMode": "CBO",
+  "form": {
+    "name": "询盘表单",
+    "locale": "en_US",
+    "privacyPolicyUrl": "https://www.example.com/privacy",
+    "followUpActionUrl": "https://www.example.com/thanks",
+    "questions": [
+      { "type": "FULL_NAME" },
+      { "type": "EMAIL" },
+      { "type": "PHONE" },
+      { "type": "CUSTOM", "label": "公司名称", "key": "company" }
+    ],
+    "thankYouPage": {
+      "title": "已收到",
+      "body": "我们会尽快联系您",
+      "buttonText": "了解更多",
+      "buttonType": "VIEW_WEBSITE",
+      "websiteUrl": "https://www.example.com"
+    }
+  },
+  "campaign": {
+    "name": "Lead-CBO",
+    "dailyBudget": 10,
+    "specialAdCategories": []
+  },
+  "adset": {
+    "name": "Lead-US",
+    "countries": ["US"],
+    "ageMin": 18,
+    "ageMax": 65,
+    "optimizationGoal": "LEAD_GENERATION"
+  },
+  "creative": {
+    "name": "Lead-Creative",
+    "message": "留下联系方式，获取资料",
+    "link": "https://www.example.com/privacy",
+    "headline": "即时表单线索",
+    "imageUrl": "https://www.example.com/lead.jpg"
+  },
+  "ad": {
+    "name": "Lead-Ad"
+  },
+  "plan": {
+    "brand": "ExampleBrand",
+    "customerName": "Example Co.",
+    "siteUrl": "https://www.example.com",
+    "pageUrl": "",
+    "businessOneLiner": "一句话业务",
+    "mainResult": "Instant Form 询盘",
+    "landingType": "产品页询盘 + 广告内即时表单（非仅官网首页）",
+    "creativeSpec": "4:5（1080×1350）或 1:1；图字 <20%",
+    "endorsements": [{ "text": "公开页面可见的认证/年限", "verified": false }],
+    "tracks": [
+      {
+        "id": "A",
+        "name": "产线实拍",
+        "shots": [
+          {
+            "id": "A1",
+            "composition": "车间中景，主体居中",
+            "onImageText": "Precision Aluminum Parts",
+            "tone": "工厂实证",
+            "forbid": "虚假认证、无法核对的数字",
+            "headlines": ["Factory Direct Quote", "Custom Aluminum Parts"],
+            "primaryText": "Hook\nPositioning\nProof + emoji\nCTA",
+            "cta": "Get Quote",
+            "description": "ISO-listed factory"
+          }
+        ]
+      },
+      { "id": "B", "name": "产品特写", "shots": [{ "id": "B1", "headlines": ["EV Motor Housing"], "primaryText": "…", "cta": "Learn More" }] },
+      { "id": "C", "name": "场景应用", "shots": [{ "id": "C1", "headlines": ["Liquid-Cooled Housing"], "primaryText": "…", "cta": "Get Quote" }] }
+    ],
+    "matrix": {
+      "visual": ["产线实拍", "产品特写", "场景应用"],
+      "bodyTone": ["证据向", "痛点向"],
+      "headline": ["规格向", "交付向"]
+    },
+    "complianceNotes": ["年限/客户数投放前核对", "不要写死无法核对的公差"],
+    "emojiPerPost": 2,
+    "adSets": [{ "name": "Lead-US", "countries": ["US"], "note": "本次 create 落地这一组" }]
+  }
+}

package/dist/skill/assets/meta-lead-create-template.md

@@ -0,0 +1,46 @@
+# `meta-ad create` JSON 配置说明
+
+`siluzan-tso meta-ad validate` / `meta-ad create` **仅**接受 `--config-file`。流程见 `workflows.md` **W13**。
+
+模板：同目录 [`meta-lead-create-template.json`](meta-lead-create-template.json)。
+
+---
+
+## Agent 常见坑
+
+| 场景 | 正确做法 |
+| --- | --- |
+| 创建 | `validate` → **写代码**按 `meta-lead-launch-plan-template.md` 投影审查稿（默认 MD；要表格出 xlsx）→ 用户确认 → `create --commit` |
+| 仅出方案 | `account`=`[PENDING_ACCOUNT]`，`pageId`=`[PENDING_PAGE]`；JSON + 审查稿即可，**禁止**因缺账户阻塞 |
+| 金额 | JSON 填**主币种元**（`10` = $10 / ¥10）；CLI 按账户 `currency` 转最小单位。禁止把 `"1000"` 当 $1000 |
+| CBO / ABO | `budgetMode=CBO`：预算只放 `campaign`；`ABO`：只放 `adset`。不能两边都有或都没有 |
+| 主页 | 先 `meta-ad pages -a <id> --json-out`；空数组不要硬填历史 `pageId` |
+| 表单 | 新建填 `form.name` + `privacyPolicyUrl` + `questions`；复用填 `form.reuseId` |
+| 图片 | `imageHash` / `imagePath`（相对 JSON 目录）/ `imageUrl` 三选一；创意用 hash |
+| 投放 | create **不会**自动 ACTIVE；三个对象分别 `campaign-status` / `adset-status` / `ad-status` |
+| 失败续跑 | `--json-out` 含已建成 ID；用原语命令从失败步接着建，**不要**回滚 |
+| 支付方式 | 建广告报「请更新支付方式」→ 停，补付款后只跑 `ad-create` |
+| bid cap | `create` 遇 `BID_AMOUNT_REQUIRED` 会自动按预算带 bid cap 重试；JSON 不必预填 |
+| 拉线索 | `clue -m Meta`（W11），不是本命令 |
+
+---
+
+## 字段
+
+| 键 | 必填 | 说明 |
+| --- | --- | --- |
+| `account` | 是 | `list-accounts -m MetaAd` 的 `mediaCustomerId`（数字或 `act_`） |
+| `pageId` | 是 | `meta-ad pages` 的主页 ID |
+| `budgetMode` | 是 | `CBO` 或 `ABO` |
+| `form.reuseId` | 复用时 | 已有 Instant Form ID |
+| `form.name` / `privacyPolicyUrl` / `questions` | 新建时 | 至少含一个预定义字段（`EMAIL` / `FULL_NAME` / `PHONE` 等）；`CUSTOM` 必须带 `label` |
+| `campaign.name` | 是 | 系列名。CBO 再加 `dailyBudget` 或 `lifetimeBudget` |
+| `adset.name` / `countries` | 是 | ISO 两位国家。ABO 再加组预算 |
+| `adset.optimizationGoal` | 否 | 仅 `LEAD_GENERATION`（默认）/ `QUALITY_LEAD` |
+| `creative.message` / `link` | 是 | `link` 常用隐私政策 URL |
+| `ad.name` | 是 | 广告名 |
+| `plan` | 审查稿建议有 | 品牌/套系/3×2×2/背书；create **不提交**。结构见 `references/meta-ads/meta-lead-launch-plan-template.md` |
+
+`activate` 即使写 `true` 也不会自动投放。
+
+预定义 `questions.type`：`EMAIL`、`FULL_NAME`、`FIRST_NAME`、`LAST_NAME`、`PHONE`、`CITY`、`STATE`、`COUNTRY`、`POST_CODE`、`ZIP`、`COMPANY_NAME`、`JOB_TITLE`、`WORK_EMAIL`、`WORK_PHONE_NUMBER`、`DATE_OF_BIRTH`、`GENDER`、`MARITAL_STATUS`。

package/dist/skill/references/README.md

@@ -12,7 +12,7 @@
 | `references/core/intent-routing.md`           | 报告/分析/拓词话术消歧                   |
 | `references/core/tips.md`                     | `--json-out` 脚本食谱                    |
 | `references/core/playbooks.md`                | 分析/报告工作流（P1–P9）                 |
-| `references/core/workflows.md`                | 操作/管理工作流（W1–W12）                |
+| `references/core/workflows.md`                | 操作/管理工作流（W1–W13）                |
 | `references/core/subagent-orchestration.md`   | 可选：P5/P6/P7 委派 subagent             |
 | `references/core/skill-authoring.md`          | 维护约定（运行时勿加载）                 |
 
@@ -43,6 +43,16 @@
 | `references/analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词         |
 | `references/google-ads/rules/README.md`             | 优化/合规 SOP 索引                     |
 
+## Meta 广告
+
+| 文件                                          | 用途                                      |
+| --------------------------------------------- | ----------------------------------------- |
+| `references/meta-ads/meta-ads.md`             | **Meta Instant Form 索引**（金额/ID）     |
+| `references/meta-ads/meta-ads-read.md`        | 账户/主页/表单/按 ID 读系列组广告         |
+| `references/meta-ads/meta-ads-write.md`       | validate/create 与原语写命令              |
+| `references/meta-ads/meta-lead-launch-plan-template.md` | 出方案/创建前审查稿（MD + 4 Sheet xlsx） |
+| `assets/meta-lead-create-template.json` + `.md` | Lead Ad JSON 契约（**先 Read `.json`**） |
+
 ## 分析与报告
 
 | 文件                                              | 用途                                        |
@@ -82,6 +92,7 @@
 | `meta-period-report-rules.md`           | Meta 周期报告内容丰富度与建议撰写规则                     |
 | `meta-period-report.schema.json`        | Meta 周期报告 Agent JSON Schema                           |
 | `pmax-create-template.md` / `.json`     | PMax 新建契约                                             |
+| `meta-lead-create-template.json` + `.md` | Meta Instant Form Lead Ad 契约                          |
 | `pmax-asset-group-template.json`        | PMax 素材组                                               |
 | `pmax-signals-template.json`            | PMax 信号                                                 |
 | `pmax-assets-update-template.json`      | PMax 素材更新                                             |

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

@@ -167,7 +167,7 @@ siluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./sna
 | 状态       | 含义     | 下一步操作                                                                                                                                                                                                                                           |
 | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Pending`  | 审核中   | 等待，可反复运行此命令轮询；审核周期因媒体而异                                                                                                                                                                                                       |
-| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
+| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Kwai、Yandex 当前没有对应充值界面） |
 | `Rejected` | 被拒     | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服                                                                                                                                         |
 
 ---

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

@@ -490,7 +490,7 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 
 | 功能                                    | 媒体   | 网页路径                                          |
 | --------------------------------------- | ------ | ------------------------------------------------- |
-| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
+| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts` |
 
 **Agent 建议话术**：
 
@@ -499,5 +499,5 @@ siluzan-tso account email-deauth -c <mediaCustomerId> --invitation-id <id> --res
 siluzan-tso config show   # 查看 webUrl 字段
 
 # 账户激活（Google）→ 引导至账户管理页
-# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts
+# https://www-ci.siluzan.com/v3/foreign_trade/tso/manageAccounts
 ```

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

@@ -126,7 +126,7 @@ siluzan-tso config show
 
 ### 充值页链接（按媒体 × 类型）
 
-链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
+链接模式：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/<page>?mediaType=<mediaType>`；丝路赞钱包：`https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。
 
 | 充值类型                  | `<page>`              | 支持媒体（`mediaType` 参数）                |
 | ------------------------- | --------------------- | ------------------------------------------- |

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

@@ -1,6 +1,6 @@
 # 各媒体开户
 
-> 网页链接：`https://www.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
+> 网页链接：`https://www-ci.siluzan.com/v3/foreign_trade/tso/accountOpeningHistory?tso=%2Fv3umijs%2Ftso%2FaccountOpeningHistory`  
 > 多命令串联见 `references/core/workflows.md` § 流程一。
 
 ## Contents

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

@@ -65,7 +65,7 @@ siluzan-tso open-account google-wizard
 
 ```bash
 siluzan-tso account-history -m Google
-# 审核通过后：config show → https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
+# 审核通过后：config show → https://www-ci.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google
 ```
 
 ---

package/dist/skill/references/analytics/rag.md

@@ -1,6 +1,6 @@
 # rag：知识库检索（TSO 广告投放辅助）
 
-知识库管理页面在 https://www.siluzan.com/knowledge-base/
+知识库管理页面在 https://www-ci.siluzan.com/knowledge-base/
 
 为 **广告投放、账户分析、拓词、诊断报告** 等 TSO 业务提供**企业已入库**的产品、行业、客户背景事实依据。
 

package/dist/skill/references/analytics/reporting.md

@@ -190,9 +190,9 @@ siluzan-tso report push receive-emails -m Google [--json-out ./snap]
 
 | 媒体   | 报告类型         | URL 模板                                                    |
 | ------ | ---------------- | ----------------------------------------------------------- |
-| Google | 日报（Daily）    | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
-| Google | 小时报（Hourly） | `https://www.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
-| TikTok | 日报             | `https://www.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 日报（Daily）    | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
+| Google | 小时报（Hourly） | `https://www-ci.siluzan.com/media-report/hour/{entityId}?culture=zh-CN`    |
+| TikTok | 日报             | `https://www-ci.siluzan.com/media-report/publish/{entityId}?culture=zh-CN` |
 
 `entityId` 来自 `siluzan-tso report list --json-out ./snap` 中每条记录的 `entityId` 字段。
 
@@ -205,8 +205,8 @@ siluzan-tso report list -m Google --json-out ./snap
 
 # 第二步：查看 webUrl
 siluzan-tso config show
-# webUrl: https://www.siluzan.com
+# webUrl: https://www-ci.siluzan.com
 
 # 第三步：拼接链接（Google 日报）
-# https://www.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
+# https://www-ci.siluzan.com/media-report/publish/rpt_abc123?culture=zh-CN
 ```

package/dist/skill/references/core/intent-routing.md

@@ -228,6 +228,7 @@
 | **P2**       | **多账户余额** 续航预警                        | 余额扫描、快没钱了、充值预警                                                                                                                | 媒体（可选账户子集）                                       | 列表                                        |
 | **P5**       | **多账户 × 多维度** 批拉                       | 批量分析、多户 google-analysis                                                                                                              | ≥2 户 + ≥2 维度 + 区间                                     | 聚合报告                                    |
 | **W3**       | 根据 **官网 / URL 生成 Google 搜索广告方案**   | 根据网站**出广告**、搜索广告方案/计划/文案/关键词**表**、**生成**投放方案表格                                                               | 官网 URL + **明确要广告方案**（**不**要求账户 ID）         | JSON + 表格投影                             |
+| **W13**      | **Meta / Facebook Instant Form 线索广告**投放  | 建 Meta 线索广告、Facebook 潜在客户表单投放、Instant Form、Lead Ad、**出 Facebook 线索广告方案/表格**                                      | Meta 账户 + 主页；或先出 JSON 方案（可无账户）             | JSON + 审查稿（MD/xlsx）+ validate/create   |
 | **W5**       | **Google Ads 关键词规划** / 拓词（含市场指标） | 见 **§零·C**：拓词、Keyword Planner、长尾词、**月搜索量**、**竞争度**、核心词扩词、读 URL/文章后出词表                                      | 种子词 / 核心词（URL 可选）                                | 词表（指标来自 `keyword` CLI）              |
 | **W7**       | **丝路赞平台内** 已生成的优化报告 / 推送       | Siluzan 优化报告列表、报告推送、邮件推送配置                                                                                                | 按 `reporting.md`                                          | 平台侧列表                                  |
 
@@ -239,6 +240,9 @@
 | 「这个**网站**好不好 / 能不能投 / **是否符合投放要求**」（无广告方案诉求） | **P8**                                            | 误走 W3（因带「Google 广告」）；或 WebFetch 当终稿            |
 | 「**电商/制造**行业怎么样 / 市场格局」（**无 URL**）                       | **P9**                                            | 误走 P8                                                       |
 | 「根据**官网**做 **Google 搜索广告** / 关键词表」                          | **W3**（可无账户先出方案）                        | 误走 P8；或卡在要账户才出方案                                 |
+| 「建 **Meta/Facebook 线索广告** / Instant Form」                           | **W13**                                           | 误走 W11（那是拉已有线索）；误走 P4-FB；误用 Google `ad`      |
+| 「出 **Facebook / Meta 线索广告方案** / 要表格」                           | **W13** 仅出方案 + `meta-lead-launch-plan-template.md` | 误走 W3；跳过 JSON 直接手填表；因缺账户阻塞 |
+| 「把 Meta **表单留资拉下来**」                                             | **W11** `clue -m Meta`                            | 误走 W13 去建广告                                             |
 | 「做 **展示广告** / Display / 自适应展示广告（RDA）」                      | **不支持**（告知用户；可改推 Search / PMax → W3） | 误用 `campaign-create` / `ad-create` 伪装 Display             |
 | 「读**网址/文章** + **核心词** + 要 **月搜索量/竞争度** 长尾词表」         | **W5（§零·C）**                                   | 纯 WebSearch 编数；误走 P8/P9/W3                              |
 | 只要 **Keyword Planner / 拓词** 指标，不要 campaign JSON                   | **W5**                                            | 误走 W3 走 validate/create                                    |

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

@@ -10,7 +10,7 @@
 ## 安装 CLI
 
 ```bash
-npm install -g siluzan-tso-cli
+npm install -g siluzan-tso-cli@beta
 ```
 
 ---
@@ -64,7 +64,7 @@ siluzan-tso config set --api-key <Key>               # 或 config 直接写入
 siluzan-tso config set --token <Token>               # 备用：设置 JWT Token
 ```
 
-API Key 获取入口：`https://www.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
+API Key 获取入口：`https://www-ci.siluzan.com/v3/foreign_trade/settings/apiKeyManagement`
 
 ```bash
 # 第 1 步：让用户报出手机号后，立刻发码（命令立即返回，不会等待输入）
@@ -127,9 +127,9 @@ siluzan-tso config show
 
 ```
   构建环境     : production
-  apiBaseUrl   : https://tso-api.siluzan.com
-  googleApiUrl : https://googleapi.mysiluzan.com
-  webUrl       : https://www.siluzan.com
+  apiBaseUrl   : https://tso-api-ci.siluzan.com
+  googleApiUrl : https://googleapi-ci.mysiluzan.com
+  webUrl       : https://www-ci.siluzan.com
   apiKey       : abcd****1234
 ```
 

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

@@ -1,4 +1,4 @@
-# 工作流目录 · 操作 / 管理类（W1–W12）
+# 工作流目录 · 操作 / 管理类（W1–W13）
 
 > **范围**：调接口 / 写操作类业务（账户读取、开户、广告 CRUD、智投、拓词、优化、报告推送、财务、权限、预警、线索、巡检）。分析/报告类（拉数 → 撰稿 → 交付）见 `references/core/playbooks.md`（P1–P9）。
 > **通用纪律见 `references/core/agent-conventions.md`**（写操作确认 + `--commit`、写后成败报告、ID 口径）；各卡片只写线性步骤。卡片字段：`触发 / 必读 / 步骤 / 产物`。完整参数表见「必读」指向的命令文档。
@@ -17,6 +17,7 @@
 | W10  | 智能预警规则管理                | `references/operations/forewarning.md`                                              |
 | W11  | 广告线索提取                    | `references/operations/clue.md`                                                     |
 | W12  | 日 / 周巡检                     | `references/accounts/accounts-balance-stats.md` + 各域                              |
+| W13  | Meta Instant Form 线索广告      | `meta-ads.md` + **`meta-lead-launch-plan-template.md`** + `meta-ads-write.md` / `read` |
 
 ---
 
@@ -195,7 +196,7 @@
 
 ## W11 · 广告线索提取
 
-- **触发**：拉取 TikTok / Meta 广告表单留资线索。
+- **触发**：拉取 TikTok / Meta 广告表单**已有**留资线索（不是新建表单投放；新建走 **W13**）。
 - **必读**：`references/operations/clue.md`。
 - **步骤**：
   1. 确认账户：TikTok `list-accounts -m TikTok`；Meta 取 Facebook 页面 ID。
@@ -219,3 +220,22 @@
   7. 预警触发：`forewarning records -m <媒体> --start <S>`（见 **W10**）。
   8. 智投/线索（按需）：`ad batch list --state Failed/HasFailed`（**W4**）、`clue …`（**W11**）、`optimize list/records`（**W6**）。
 - **产物**：要与网页首页看板数字完全一致（聚合口径）时引导打开首页（`tso-home.md`）；CLI 给的是单账户粒度的近似巡检；Google 熔断须交付命中表或显式「无命中」；Bing/Yandex/TikTok 巡检交付告警列表（不能写成已自动暂停）。
+
+---
+
+## W13 · Meta Instant Form 线索广告创建与精细管理
+
+- **触发**：新建 Facebook / Meta 线索广告、Instant Form、潜在客户表单投放；改预算/定向/启停已有线索对象。
+- **勿误判**：拉**已有**表单留资 → **W11** `clue -m Meta`；Meta 周期/诊断报告 → **P4-FB**；Google 搜索/PMax → **W3**。
+- **必读**：`references/meta-ads/meta-ads.md` + **`assets/meta-lead-create-template.json`**（先 Read）+ `meta-lead-create-template.md` + **`references/meta-ads/meta-lead-launch-plan-template.md`** + `meta-ads-write.md` / `meta-ads-read.md`。
+- **仅出方案**（「出方案 / 只要表格」、未给账户且未说创建）：跳过 list-accounts / pages；JSON 用 `[PENDING_ACCOUNT]` / `[PENDING_PAGE]` → **写代码**投影审查稿（默认 MD；要表格按模板出 4 Sheet xlsx）→ **停住等确认**。
+- **步骤（创建）**：
+  1. `list-accounts -m MetaAd --page-size 999 --json-out ./snap` 取 `mediaCustomerId`。
+  2. `meta-ad account` / `meta-ad pages`：记下币种与 `pageId`（`--json-out` 主页在 `items[]`，须含 `ADVERTISE`）。**HTTP 403** 或主页为空则停。`spend_capDisplay` ≈ `amount_spentDisplay` → 仍可 PAUSED 创建，ACTIVE 投不出去。
+  3. 落盘同构 JSON（可执行字段 + `plan` 套系/矩阵/背书）。
+  4. 门禁：`meta-ad validate --config-file ./meta-lead.json --json-out ./snap`。
+  5. **写代码**按 `meta-lead-launch-plan-template.md` 投影完整审查稿 → 用户确认（`--commit` 代替不了这步）。
+  6. `meta-ad create --config-file ./meta-lead.json --json-out ./snap --commit "…"`（默认 PAUSED；失败读已建成 ID 用原语续跑）。报「支付方式」则停，不要重头 create。
+  7. 按返回 ID `meta-ad campaign/adset/ad --id` 复核。
+  8. 需要投放：三个对象 `*-status --status ACTIVE --commit`。清理：`DELETED`，顺序广告→组→系列。
+- **产物**：审查稿路径（MD 或 xlsx）+ create 的 `formId` / `imageHash` / `campaignId` / `adSetId` / `creativeId` / `adId`；写后交代成败与是否仍为 PAUSED。

package/dist/skill/references/meta-ads/meta-ads-read.md

@@ -0,0 +1,33 @@
+# Meta 线索广告 · 只读
+
+> 流程见 `workflows.md` **W13**。金额/ID 口径见 [meta-ads.md](meta-ads.md)。
+> **何时 Read**：选主页、复用表单、按 ID 复核刚创建的对象。
+
+## 命令
+
+```bash
+siluzan-tso list-accounts -m MetaAd --page-size 999 --json-out ./snap
+siluzan-tso meta-ad account -a <accountId> --json-out ./snap
+siluzan-tso meta-ad pages -a <accountId> --json-out ./snap
+siluzan-tso meta-ad forms -a <accountId> --page-id <pageId> --json-out ./snap
+siluzan-tso meta-ad campaign -a <accountId> --id <campaignId> --json-out ./snap
+siluzan-tso meta-ad adset -a <accountId> --id <adSetId> --json-out ./snap
+siluzan-tso meta-ad ad -a <accountId> --id <adId> --json-out ./snap
+```
+
+**没有** `meta-ad campaigns` 列表。复核只能用 create 返回的 ID。
+
+## 字段口径
+
+| 字段 | 含义 |
+| --- | --- |
+| `account_status=1` | 账户活跃 |
+| `amount_spent` / `balance` / `spend_cap` / `daily_budget` | 网关最小货币单位字符串 |
+| `*Display` | 主币种元（展示用这个） |
+| `currency` | ISO 币种；换算按此币种小数位（JPY 等零小数不 ×100） |
+| `items[].id`（`meta-ad pages`） | 投放主页；**不含** Page Token。`tasks` 含 `ADVERTISE` 才可投 |
+| `data[].id`（`meta-ad forms`） | Instant Form ID，可写入 JSON `form.reuseId` |
+
+`spend_cap` 与 `amount_spent` 持平 → 花费上限已顶满，ACTIVE 也投不出去。
+
+拉表单留资线索：`clue -m Meta -a <pageId> --start --end`（W11）。

package/dist/skill/references/meta-ads/meta-ads-write.md

@@ -0,0 +1,70 @@
+# Meta 线索广告 · 写入与编辑
+
+> 流程见 `workflows.md` **W13**。金额/ID 口径见 [meta-ads.md](meta-ads.md)。
+> **何时 Read**：创建/编辑/启停；写操作须用户确认与 `--commit`。
+
+## 写操作硬纪律
+
+- **必须** `--commit "…"`；漏了会直接失败。
+- `--json-out <path>`：路径必填；禁止裸 `--json`。
+- 创建默认 **PAUSED**。`meta-ad create` **不会**根据 `activate` 自动投放。
+- 中途失败**不回滚**；读 `--json-out` 里已建成 ID，用原语续跑。
+
+## 主路径（对标 Google `pmax-validate` / `pmax-create`）
+
+| 步骤 | 命令 |
+| --- | --- |
+| 模板 | 复制 `assets/meta-lead-create-template.json`，字段见 `meta-lead-create-template.md` |
+| 主页 | `siluzan-tso meta-ad pages -a <accountId> --json-out ./snap-fb` |
+| 校验 | `siluzan-tso meta-ad validate --config-file ./meta-lead.json [--json-out ./snap]` |
+| 审查稿 | Agent **写代码**按 [meta-lead-launch-plan-template.md](meta-lead-launch-plan-template.md) 从 JSON 投影（默认 MD；要表格出 4 Sheet xlsx）→ 用户确认。`--commit` 不是方案确认 |
+| 创建 | `siluzan-tso meta-ad create --config-file ./meta-lead.json --json-out ./snap --commit "创建 Instant Form 线索广告"` |
+| 复核 | 用返回的 ID：`meta-ad campaign/adset/ad --id … --json-out` |
+| 投放 | 三个对象分别 `*-status --status ACTIVE --commit "投放"` |
+
+## 原语命令
+
+失败续跑或改存量时用。金额参数一律**主币种元**。
+
+```bash
+siluzan-tso meta-ad form-create -a <id> --page-id <pageId> --config-file ./form.json --commit "新建表单"
+siluzan-tso meta-ad image-upload -a <id> --image-url https://… --name lead.jpg --commit "传图"
+siluzan-tso meta-ad campaign-create -a <id> --name Lead-CBO --daily-budget 10 --commit "CBO 系列"
+siluzan-tso meta-ad adset-create -a <id> --campaign-id <cid> --page-id <pageId> --name Lead-US --countries US --commit "建组"
+# 该户报 BID_AMOUNT_REQUIRED 时再加：--bid-strategy LOWEST_COST_WITH_BID_CAP --bid-amount <元>
+siluzan-tso meta-ad creative-create -a <id> --page-id <pageId> --name C --message "…" --link https://…/privacy --image-hash <hash> --form-id <fid> --commit "建创意"
+siluzan-tso meta-ad ad-create -a <id> --adset-id <sid> --creative-id <crid> --name Lead-Ad --commit "建广告"
+```
+
+编辑（只传要改的字段）：
+
+```bash
+siluzan-tso meta-ad campaign-edit -a <id> --id <cid> --daily-budget 20 --commit "上调日预算"
+siluzan-tso meta-ad adset-edit -a <id> --id <sid> --countries US --age-min 18 --age-max 55 --commit "改定向"
+siluzan-tso meta-ad ad-edit -a <id> --id <adId> --creative-id <newCrid> --commit "换创意"
+```
+
+`adset-edit --countries` 是**整份替换**定向，只认国家 / 年龄 / 性别。换主页请新建组。不能靠加一侧预算把 CBO 切成 ABO。
+
+## 启停
+
+```bash
+siluzan-tso meta-ad campaign-status -a <id> --id <cid> --status ACTIVE --commit "开系列"
+siluzan-tso meta-ad adset-status -a <id> --id <sid> --status ACTIVE --commit "开组"
+siluzan-tso meta-ad ad-status -a <id> --id <adId> --status ACTIVE --commit "开广告"
+```
+
+`status` 原样交给网关：`ACTIVE` / `PAUSED` / `DELETED` / `ARCHIVED`。暂停时三个都停。删除用 `DELETED`，顺序 **广告 → 组 → 系列**；表单 / 图 / 创意 **无删除口**（复用的表单不要删）。
+
+## 常见网关错误
+
+| code | 处理 |
+| --- | --- |
+| `VALIDATION` | 按 `message` 改请求 |
+| `CBO_ABO_CONFLICT` | 预算只放系列或只放组 |
+| `BID_AMOUNT_REQUIRED` | `meta-ad create` 会按日/总预算带 `LOWEST_COST_WITH_BID_CAP` 自动重试一次；原语续跑须自己加 `--bid-strategy LOWEST_COST_WITH_BID_CAP --bid-amount <元>` |
+| 请更新支付方式 / 添加有效支付方式 | **停**。读 `--json-out` 已建成 ID；让用户补付款方式后只跑 `ad-create`，不要重头 `create` |
+| HTTP 403（账户/主页） | 当前 Token 无该户 Facebook Ads 权限，换登录或重新授权 |
+| `PAGE_LIST_EMPTY` / `PAGE_NOT_LINKED` / `PAGE_NO_ADVERTISE` | 补主页广告投放权限并重新授权 |
+| `LEAD_TOS_REQUIRED` | 用户在 Ads Manager 勾选条款，接口不代勾 |
+| `RATE_LIMITED` / `GRAPH_RETRY` | 退避后重试同一请求 |

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

@@ -0,0 +1,37 @@
+# Meta Instant Form 线索广告（导航）
+
+> 流程见 `workflows.md` **W13**。命令参数见 [meta-ads-write.md](meta-ads-write.md) / [meta-ads-read.md](meta-ads-read.md)。
+
+## 支持范围（硬边界）
+
+| 能力 | CLI | 说明 |
+| --- | --- | --- |
+| Instant Form 线索广告 | ✅ | `OUTCOME_LEADS`；组优化目标仅 `LEAD_GENERATION` / `QUALITY_LEAD` |
+| 视频 / Advantage+ / 其它目标 | ❌ | 本批不做 |
+| 系列/组/广告列表 | ❌ | 网关无 list，只能按创建返回的 ID `GET` |
+| 拉已有线索 | 走 W11 | `clue -m Meta`，不是 `meta-ad` |
+| 周期/诊断报告 | 走 P4-FB | `facebook-analysis` |
+
+## 何时 Read
+
+| 任务 | Read |
+| --- | --- |
+| 创建 / 编辑 / 启停 | [meta-ads-write.md](meta-ads-write.md) |
+| 读账户 / 主页 / 表单 / 按 ID 读对象 | [meta-ads-read.md](meta-ads-read.md) |
+| JSON 字段 | `assets/meta-lead-create-template.json`（先）+ `assets/meta-lead-create-template.md` |
+| 出方案 / 审查稿 / 要表格 | [meta-lead-launch-plan-template.md](meta-lead-launch-plan-template.md) |
+
+## Gotchas
+
+- **命令族**是 `meta-ad`，**禁止**塞进 Google `ad`，**禁止** `--media MetaAd` 调 `ad campaigns`。
+- `-a` / JSON `account` = `list-accounts -m MetaAd` 的 `mediaCustomerId`（数字或 `act_`）。**禁止**传 `entityId`（UUID）。
+- **金额**：CLI / JSON 填**主币种元**。读出口 `*Display` 已是元；原始 `daily_budget="1000"` 在 USD 是 $10，**禁止**当 $1000。
+- **CBO / ABO**：预算只放一边；本批不能切换。
+- **默认 PAUSED**。投放须系列 / 组 / 广告三个都 `ACTIVE`。
+- **表单 / 图 / 创意无就地改口**。换图或换表单：新建创意，再 `ad-edit --creative-id`。
+- **主页 `--json-out`**：数组在 `items[]`（`id` / `name` / `tasks`），**不是** `pages[]`。`tasks` 须含 `ADVERTISE`。空列表或 `PAGE_LIST_EMPTY` / `PAGE_NOT_LINKED` → 补主页广告投放权限并重新授权，不要硬填历史 `pageId`。
+- **HTTP 403**（账户/主页）：当前 Token 没有该户 Facebook Ads 权限，停；换有权限的登录或重新授权，不要硬跑 `create`。
+- **`LEAD_TOS_REQUIRED`**：主页须在 Ads Manager 勾选潜在客户开发广告服务条款；**禁止**让接口代勾。
+- **`BID_AMOUNT_REQUIRED`**：`meta-ad create` 会按日/总预算带 `LOWEST_COST_WITH_BID_CAP` **自动重试一次**。原语 `adset-create` 才需要自己加 `--bid-strategy LOWEST_COST_WITH_BID_CAP --bid-amount <元>`。不要改成别的出价策略。
+- **支付方式**：建到广告对象时 Graph 可能报「请更新支付方式」。已建成的系列/组/创意会留着，**不要**重头 `create`；停下来让用户在账单与支付中心加有效付款方式，再用 `ad-create` 续跑。
+- 花费上限顶满（`spend_capDisplay` ≈ `amount_spentDisplay`）时对象仍能建成，**ACTIVE 也投不出去**。