{"id":"2ace8afb-2609-40ff-a9f7-006015edbeae","entityType":"agent","slug":"clawhub-sigedev01-bit-siluzan-tso","name":"Siluzan TSO","canonicalUrl":"https://www.xpersona.co/agent/clawhub-sigedev01-bit-siluzan-tso","canonicalPath":"/agent/clawhub-sigedev01-bit-siluzan-tso","generatedAt":"2026-10-09T14:45:52.609Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:55:46.249Z","emptyReason":null},"description":"丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/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；只要周期数据/8维/花费转化汇总/Excel→P4；Google/谷歌广告月度报告、月总结与规划、季度报告、Q3汇总、Q4规划、季度汇报、投放季报、客户版、大族模板、下月规划→P10 google-quarterly；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+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3.8K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s1739h41ywzdb9wt12gajjaks983j6gr:siluzan-tso","sourceUrl":"https://clawhub.ai/sigedev01-bit/siluzan-tso","homepage":"https://clawhub.ai/sigedev01-bit/skills/siluzan-tso","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/sigedev01-bit/siluzan-tso","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/sigedev01-bit/skills/siluzan-tso","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":42,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Siluzan TSO technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:55:46.249Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:55:46.249Z","emptyReason":null},"stars":null,"forks":null,"downloads":3767,"packageName":null,"latestVersion":"1.1.53","tractionLabel":"3.8K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:55:46.248Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T06:55:46.249Z","lastCrawledAt":"2026-10-09T06:55:46.248Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T06:55:46.248Z","lastVerifiedAt":null,"highlights":[{"version":"1.1.53","createdAt":"2026-09-22T09:05:31.368Z","changelog":"- Added quarterly report and plan support, including new templates and schemas for Google Ads季度报告/季度规划. - Extended routing and logic for P10 workflow，处理月度/季度报告、月总结、Q3/Q4季报等相关需求。 - Updated routing rules to clarify Google账号ID输入、周期报告多样化场景（禁止负面判定/错误引导）。 - Improved documentation and reference structure, including new workflow cards and reference files for quarterly reports. - Refined account search and data pulling rules: 支持带连字符CID，禁止无-key拉20条判定未绑定。 - Various clarifications, bug fixes, and internal documentation improvements.","fileCount":176,"zipByteSize":833155},{"version":"1.1.52","createdAt":"2026-09-15T07:36:02.570Z","changelog":"siluzan-tso v1.1.52 更新日志 - 更新多份参考文档和脚本，包括分析、报告模板、Playbooks 等内容。 - 删除 skill-card.md，简化文档结构。 - 持续完善任务路由与分析/投放流程规范，细化多账户及行业分析相关文档指引。 - 优化安装脚本（install.ps1, install.sh）的兼容性与指令说明。 - 修订 OKKI 周报、行业分析与 handoff 等报告模板内容，提升输出一致性与合规性。","fileCount":170,"zipByteSize":781883},{"version":"1.1.51","createdAt":"2026-09-14T08:18:31.672Z","changelog":"siluzan-tso v1.1.51 - Updated install scripts for both PowerShell (install.ps1) and shell (install.sh). - Refreshed metadata and configuration in _meta.json. - Removed outdated skill-card.md file. - No user-facing feature changes; mostly maintenance and script cleanup.","fileCount":170,"zipByteSize":780031},{"version":"1.1.50","createdAt":"2026-09-07T08:30:16.563Z","changelog":"**重要：增加平台能力边界说明，广告搭建仅限 Google 和 Meta；TikTok/Bing/Yandex 不能创建广告** - 明确「广告搭建」只支持 Google（Search/PMax）与 Meta（Instant Form 线索广告），新增嵌套表格说明平台能力。 - 禁止用 Google/Meta 命令伪装创建 TikTok/Bing/Yandex 广告，相关用户操作需提醒仅能做分析或开户。 - 更新元描述和「即时规范」细则，增加媒介边界和处理不支持搭建的场景规范。 - 优化路由表：单列「不支持的广告搭建」场景，提升规则清晰度。 - 文档结构调整，便于理解和快速查找支持与禁用范围。","fileCount":170,"zipByteSize":780243},{"version":"1.1.49","createdAt":"2026-09-02T03:35:51.985Z","changelog":"siluzan-tso v1.1.49 - 新增 okki-weekly-report.schema.json，支持 OKKI 周报结构化输出。 - 优化 P6/P7 报告说明：P6 默认 okki-render 出 5 Sheet `.xlsx`，P7 默认 8 Sheet `.xlsx`，禁止手写（含禁止 Markdown/HTML/xlsx 伪造）。 - 多个 references 及 report-templates 文档内容修订，细化报告/诊断/行业分析等路由与参数指引。 - 更新 Google/Meta/Bing 报告模板与使用说明，补充 excel-style-guide 等细节。 - 移除 skill-card.md（信息整合进主文档）。 - 安装与脚本自动化部分增强，方便环境搭建与 Skill 联动。","fileCount":170,"zipByteSize":776126},{"version":"1.1.48","createdAt":"2026-08-28T10:11:26.561Z","changelog":"**Meta 线索广告与报告流程大幅加强；报告模板与参考资料扩展、细则明确。** - 新增对 Meta Instant Form 线索广告（W13）的创建和操作支持，覆盖投放方案与细定向配置方法。 - 主要路由与配置文档（SKILL.md）更新，增加 W13 工作流、Meta 投放细分规则及即时规范明细。 - 扩充报告模板与分析材料，包括 Excel 风格模板、Meta 广告参考和广告方案相关文档。 - 补充和完善账户类型说明、ID 匹配逻辑及 meta-ad-create 强制规范，提升实用性与合规性。 - 优化文档结构，删除废弃 skill-card.md，提升检索与维护效率。","fileCount":169,"zipByteSize":772404},{"version":"1.1.47","createdAt":"2026-08-21T10:08:21.232Z","changelog":"- Improved account authorization checks: `account check-access` now explicitly supported only for Google; handling for other platforms clarified. - Removed obsolete documentation file: `skill-card.md`. - Updated multiple references and templates to align with current workflows and platform guidance. - Enhanced instructions and guidance in SKILL.md, especially on ID validation, report formats, and supported advertising types. - General documentation cleanup and alignment with the latest task routing and platform policies.","fileCount":159,"zipByteSize":751259},{"version":"1.1.46","createdAt":"2026-08-20T01:48:57.928Z","changelog":"Siluzan TSO Skill 1.1.46 - 新增 Bing、TikTok、Yandex 宿主投放监控（hosted-automation）说明文档。 - 路由表与 playbooks 补全 TikTok/Bing/Yandex 托管巡检与周期报告支持细则。 - P6/P7（OKKI 周报/Google询盘）默认输出形式明确为多 Sheet xlsx，禁止 Markdown 表/手写 HTML 替代。 - 多数 reference 报告模板和操作流程文档细节优化增补。 - 删除 skill-card.md，统一文档结构与引用规范。","fileCount":159,"zipByteSize":750130}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1739h41ywzdb9wt12gajjaks983j6gr:siluzan-tso","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s1739h41ywzdb9wt12gajjaks983j6gr:siluzan-tso` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/sigedev01-bit/siluzan-tso before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T14:45:52.606Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-sigedev01-bit-siluzan-tso/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:55:46.249Z","emptyReason":null},"readme":"Skill: Siluzan TSO\n\nOwner: sigedev01-bit\n\nSummary: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/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；只要周期数据/8维/花费转化汇总/Excel→P4；Google/谷歌广告月度报告、月总结与规划、季度报告、Q3汇总、Q4规划、季度汇报、投放季报、客户版、大族模板、下月规划→P10 google-quarterly；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+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。\n\nTags: latest:1.1.53\n\nVersion history:\n\nv1.1.53 | 2026-09-22T09:05:31.368Z | auto\n\n- Added quarterly report and plan support, including new templates and schemas for Google Ads季度报告/季度规划.\n- Extended routing and logic for P10 workflow，处理月度/季度报告、月总结、Q3/Q4季报等相关需求。\n- Updated routing rules to clarify Google账号ID输入、周期报告多样化场景（禁止负面判定/错误引导）。\n- Improved documentation and reference structure, including new workflow cards and reference files for quarterly reports.\n- Refined account search and data pulling rules: 支持带连字符CID，禁止无-key拉20条判定未绑定。\n- Various clarifications, bug fixes, and internal documentation improvements.\n\nv1.1.52 | 2026-09-15T07:36:02.570Z | auto\n\nsiluzan-tso v1.1.52 更新日志\n\n- 更新多份参考文档和脚本，包括分析、报告模板、Playbooks 等内容。\n- 删除 skill-card.md，简化文档结构。\n- 持续完善任务路由与分析/投放流程规范，细化多账户及行业分析相关文档指引。\n- 优化安装脚本（install.ps1, install.sh）的兼容性与指令说明。\n- 修订 OKKI 周报、行业分析与 handoff 等报告模板内容，提升输出一致性与合规性。\n\nv1.1.51 | 2026-09-14T08:18:31.672Z | auto\n\nsiluzan-tso v1.1.51\n\n- Updated install scripts for both PowerShell (install.ps1) and shell (install.sh).\n- Refreshed metadata and configuration in _meta.json.\n- Removed outdated skill-card.md file.\n- No user-facing feature changes; mostly maintenance and script cleanup.\n\nv1.1.50 | 2026-09-07T08:30:16.563Z | auto\n\n**重要：增加平台能力边界说明，广告搭建仅限 Google 和 Meta；TikTok/Bing/Yandex 不能创建广告**\n\n- 明确「广告搭建」只支持 Google（Search/PMax）与 Meta（Instant Form 线索广告），新增嵌套表格说明平台能力。\n- 禁止用 Google/Meta 命令伪装创建 TikTok/Bing/Yandex 广告，相关用户操作需提醒仅能做分析或开户。\n- 更新元描述和「即时规范」细则，增加媒介边界和处理不支持搭建的场景规范。\n- 优化路由表：单列「不支持的广告搭建」场景，提升规则清晰度。\n- 文档结构调整，便于理解和快速查找支持与禁用范围。\n\nv1.1.49 | 2026-09-02T03:35:51.985Z | auto\n\nsiluzan-tso v1.1.49\n\n- 新增 okki-weekly-report.schema.json，支持 OKKI 周报结构化输出。\n- 优化 P6/P7 报告说明：P6 默认 okki-render 出 5 Sheet `.xlsx`，P7 默认 8 Sheet `.xlsx`，禁止手写（含禁止 Markdown/HTML/xlsx 伪造）。\n- 多个 references 及 report-templates 文档内容修订，细化报告/诊断/行业分析等路由与参数指引。\n- 更新 Google/Meta/Bing 报告模板与使用说明，补充 excel-style-guide 等细节。\n- 移除 skill-card.md（信息整合进主文档）。\n- 安装与脚本自动化部分增强，方便环境搭建与 Skill 联动。\n\nv1.1.48 | 2026-08-28T10:11:26.561Z | auto\n\n**Meta 线索广告与报告流程大幅加强；报告模板与参考资料扩展、细则明确。**\n\n- 新增对 Meta Instant Form 线索广告（W13）的创建和操作支持，覆盖投放方案与细定向配置方法。\n- 主要路由与配置文档（SKILL.md）更新，增加 W13 工作流、Meta 投放细分规则及即时规范明细。\n- 扩充报告模板与分析材料，包括 Excel 风格模板、Meta 广告参考和广告方案相关文档。\n- 补充和完善账户类型说明、ID 匹配逻辑及 meta-ad-create 强制规范，提升实用性与合规性。\n- 优化文档结构，删除废弃 skill-card.md，提升检索与维护效率。\n\nv1.1.47 | 2026-08-21T10:08:21.232Z | auto\n\n- Improved account authorization checks: `account check-access` now explicitly supported only for Google; handling for other platforms clarified.\n- Removed obsolete documentation file: `skill-card.md`.\n- Updated multiple references and templates to align with current workflows and platform guidance.\n- Enhanced instructions and guidance in SKILL.md, especially on ID validation, report formats, and supported advertising types.\n- General documentation cleanup and alignment with the latest task routing and platform policies.\n\nv1.1.46 | 2026-08-20T01:48:57.928Z | auto\n\nSiluzan TSO Skill 1.1.46\n\n- 新增 Bing、TikTok、Yandex 宿主投放监控（hosted-automation）说明文档。\n- 路由表与 playbooks 补全 TikTok/Bing/Yandex 托管巡检与周期报告支持细则。\n- P6/P7（OKKI 周报/Google询盘）默认输出形式明确为多 Sheet xlsx，禁止 Markdown 表/手写 HTML 替代。\n- 多数 reference 报告模板和操作流程文档细节优化增补。\n- 删除 skill-card.md，统一文档结构与引用规范。\n\nv1.1.45 | 2026-08-14T08:25:26.927Z | auto\n\n- 新增 Yandex 账户周期报告和 Excel 报告支持，增加相关 reference 和 report template 文件。\n- 更新账户与报告相关文档以支持 Yandex 平台。\n- 补充行业报告与分析流程说明，细化与 Google/Meta 等平台的报告区分。\n- 删除过时 skill-card.md。\n- 优化安装脚本及部分文档内容，调整以适应新增的报告流程与字段。\n\nv1.1.44 | 2026-08-12T09:34:49.339Z | auto\n\n**Google Ads Display 相关能力收紧，明确仅支持 Search/PMax：**\n\n- 明确 skill 仅支持 Google 搜索广告（Search）与 Performance Max（PMax），不再支持/假装支持展示广告（Display/RDA）相关需求。\n- 在文档和路由表中，新增对 Display 需求的路由说明：遇 Display/RDA 需直接告知用户“不支持”，建议使用 Search 或 PMax。\n- CLI 与工作流交付规范更新：ad batch diff 输出须即时原样交付给用户，不得摘要或延迟。\n- 用词与即时规范细化多项说明，并同步 route/workflow 表和辅助文档，消除模糊空间。\n- 删除 skill-card.md、优化并统一多处分流与边界描述。\n\nv1.1.43 | 2026-08-06T09:37:23.739Z | auto\n\n- Enhanced immediate norms for Google广告—clarified mediaCustomerId vs entityId, Google CID formatting, and stricter permission checks.\n- Expanded CLI command usage notes, including naming conventions and mandatory output guidelines for ad batch creation.\n- Updated task routing and documentation references for heightened accuracy in workflow navigation.\n- Removed obsolete documentation file skill-card.md.\n- Various minor fixes and documentation updates across guides, templates, and install scripts.\n\nv1.1.42 | 2026-08-06T00:07:49.948Z | auto\n\n**This update enhances routing accuracy for Google Ads campaign and PMax workflows, tightens URL generation discipline, and improves documentation consistency.**\n\n- Added a dedicated PMax launch plan template (`rules/google-ads-pmax-launch-plan-template.md`) and integrated it into PMax campaign routing and documentation.\n- Strengthened the rule prohibiting fabricated platform URLs; now requires fetching `webUrl` via CLI and strictly using only documented relative paths.\n- Improved routing for Google Ads campaign plan and PMax creation: now mandates code-based audit projection using newly referenced rule files.\n- Removed unused/obsolete documentation files and refined workflow references to match current process logic.\n- Updated workflow and intent-routing documentation for greater clarity and alignment with platform best practices.\n\nv1.1.41 | 2026-08-03T03:28:25.213Z | auto\n\nsiluzan-tso v1.1.41\n\n- Updated installation scripts for improved compatibility and streamlined setup (install.ps1, install.sh).\n- Enhanced account list reference documentation for clarity (accounts-list.md).\n- Removed skill-card.md file as part of documentation cleanup.\n- Refined metadata and task routing for accuracy and better maintainability (_meta.json, SKILL.md).\n\nv1.1.40 | 2026-08-03T02:20:49.685Z | auto\n\n**重点更新：本次版本增加 Google 账户超预算/空耗自动熔断能力，并强化网站诊断/报告话术路由。**\n\n- 新增熔断/Guard 功能，支持全户超预算和零转化巡检任务（新增 references/operations/guard.md，路由表新增“超预算熔断/空耗熔断”项，禁止 for-loop 逐户拉数）。\n- 网站诊断/监测相关语义优先级提升，支持“是否符合广告投放要求/能不能投”场景，强制走 P8 website-diagnosis collect，纯 WebFetch 入口禁用。\n- 路由表和描述中多处补充与澄清，严格分流行业分析、搜索广告方案、关键词规划等任务。\n- 多份文档与脚本同步细化、修订，清理陈旧 skill-card.md。\n- 强化任务分流规范，防止因模糊询问或关键词混淆\n\nv1.1.39 | 2026-07-27T08:41:24.592Z | auto\n\nsiluzan-tso v1.1.39\n\n- Updated routing logic and documentation for several core workflows and analytics features.\n- Improved references and guides for Google Ads and market analysis functions.\n- Refined route priorities in report and analysis tasks for greater accuracy.\n- Removed redundant documentation file (skill-card.md).\n- General documentation clarifications and minor template adjustments.\n\nv1.1.38 | 2026-07-23T01:59:22.177Z | auto\n\nSiluzan TSO v1.1.38\n\n- Refined and expanded SKILL.md description to clarify routing priorities, mandatory workflows, and strict intent mapping for diagnostics and industry/market reports.\n- Updated SKILL.md with explicit rules and prohibitions regarding use of WebSearch, report generation, and workflow selection.\n- No code or CLI logic changes; updates are documentation/routing only.\n- Minor updates in scripts/install.ps1 and scripts/install.sh (details not specified).\n- _meta.json and other metadata adjusted (details not specified).\n\nv1.1.37 | 2026-07-22T03:44:44.857Z | auto\n\nSiluzan TSO Skill 1.1.37\n\n- Major rewrite of documentation: concise SKILL.md with clearer routing, responsibilities, and immediate instructions; extensive details moved to added reference files.\n- Refined and expanded task routing table with direct mapping from user intent to workflows (`W1–W12`, `P1–P9`), each with specific, modular reference files.\n- New reference docs extensively cover account stats, batch analytics, permissions, and detailed Google ads/pmax/rules/templates (24 new files, 92 changed, 1 removed).\n- Improved clarity for media account handling, ID conventions, report generation, and default formats for diagnosis and market analysis.\n- Clearer distinction for overlapping workflows; enforced one-task-per-run discipline, with explicit guidance for ambiguous cases.\n- Deprecated and removed obsolete files (e.g., skill-card.md).\n\nv1.1.36 | 2026-07-09T01:34:45.390Z | auto\n\n- 新增 references/core/user-communication-guide.md，明确了用户沟通规范。\n- SKILL.md 增加了对 user-communication-guide.md 的指引用于伙伴式沟通（结论先行、禁止机械贴 CLI 等）。\n- 多处文档细节优化，对 agent/用户操作和任务分流说明更为清晰。\n- 多个 references/ 和 assets/ 下文档内容调整、示例和说明修正。\n- 安装脚本 install.ps1 和 install.sh 小幅更新以适配新版本流程。\n\nv1.1.35 | 2026-07-06T09:51:37.510Z | auto\n\nSiluzan TSO Skill v1.1.35\n\n- Updated documentation with major edits to all guides and reference files, including workflow, reporting, and campaign templates.\n- Added a new reference file: references/report-templates/README.md.\n- Enhanced and clarified routing and operation instructions in SKILL.md and supporting docs.\n- Improved report template structures, explicit rules, and user guidance for market analysis, automated optimization, and campaign operations.\n- Refined and expanded sections covering hosted automation, analytics, and platform-specific instructions.\n\nv1.1.34 | 2026-07-02T12:25:51.087Z | auto\n\n- 增强「任务路由」规则，新增 §零·C，明确所有 Google Ads 关键词规划/拓词/Keyword Planner/关键词扩词等意图强制路由至 W5（keyword suggest），并禁止 WebSearch 编造搜索量作为终稿。\n- 明确报告/分析类意图消歧细则，完善报告与拓词的唯一流程指引。\n- 更新意图 → 工作流路由表，细化关于关键词规划等典型意图的归类。\n- 多处 references 文档、模板与脚本同步增强，修正说明文本细节。\n- 移除 skill-card.md，统一归并文档结构。\n\nv1.1.33 | 2026-07-01T06:27:53.979Z | auto\n\nsiluzan-tso v1.1.33\n\n- Updated core documentation and playbooks for workflows and account/report handling.\n- Improved report templates for Google Ads and Bing period reports, including HTML sample outputs.\n- Enhanced script install processes for both PowerShell and Bash compatibility.\n- Refined intent routing and disambiguation instructions across documentation files.\n- Clarified and expanded descriptions for key tasks and report types in reference materials.\n\nv1.1.32 | 2026-06-30T08:13:19.563Z | auto\n\nsiluzan-tso v1.1.32\n\n- 更新核心参考文档与报告模板，修正多处细节说明\n- 优化 OKKI 周报模板，强化内容指引\n- playbooks.md 工作流卡片调整，细化分析/报告分流流程\n- 修订行业/市场分析报告指引，提高任务路由准确率\n- 脚本 install.sh/install.ps1 维护兼容性，优化一键安装体验\n- 增强 snippets/handoff-p6-okki.md，明晰交付环节操作\n\nv1.1.31 | 2026-06-30T01:27:12.738Z | auto\n\n**Changelog for siluzan-tso v1.1.31**\n\n- Enhanced skill routing logic: Now enforces that all \"行业分析/市场分析/行业报告\" requests (including non-advertising or non-Siluzan topics) must go through the P9 market-analysis collect+render workflow (per 新§零·B).\n- Strengthened §零最高优先和次高优先分流规则，确保网站诊断/行业分析报告各自归一工作流，禁止 websearch 直接产出终稿或误判路由。\n- Clarified distinctions and workflow assignments in SKILL.md and intent-routing guide.\n- Removed obsolete files: references/report-templates/README.md and skill-card.md.\n- Updated documentation, assets, and templates to align with latest workflow and routing rules.\n- Minor improvements to workflow references and default output formats.\n\nv1.1.30 | 2026-06-26T08:14:30.242Z | auto\n\n**Changelog for siluzan-tso 1.1.30**\n\n- Major update: Implements strict intent disambiguation and workflow routing via new intent-routing.md, with top-priority direct mapping for \"URL + diagnosis\" requests.\n- Overhauled SKILL.md: Now prioritizes website/network diagnosis (P8) for any request mentioning a URL/domain + diagnosis-related terms, preventing accidental misrouting to market analysis (P9) or account diagnosis (P1).\n- Significantly revised intent descriptions and dispatch rules for all report/diagnosis types; added/updated routing tables and process details.\n- Added clear documentation on mandatory reading order and disambiguation protocol for ambiguous \"report/diagnosis/analysis\" requests.\n- Updated/expanded references and assets to reflect new routing, templates, and sample outputs.\n- Added new docs (e.g., intent-routing.md); removed obsolete skill-card.md.\n\nv1.1.29 | 2026-06-23T10:23:12.361Z | auto\n\n**Summary:** Major expansion of report templates and stricter intent routing for Google Search Ads.\n\n- Added 25 new files, including a full suite of standardized report templates (Google/Meta/TikTok/Bing/OKKI/website/market analysis).\n- Expanded and clarified intent routing: \"Google 搜索广告\"需求强制走 W3（campaign-validate流程），新增消歧说明与表格输出规则，禁止非标准流程“手写”创意/关键词表。\n- Updated documentation and templates for Google Ads campaign and PMax workflows; multiple new *.md and *.json references.\n- Removed deprecated files and revised existing references to align with new template structure.\n- SKILL.md now references newly added report templates, clarifies default output formats, and enforces mandatory document reads for key workflows.\n\nv1.1.28 | 2026-06-09T10:21:11.177Z | auto\n\n**Refactored skill for clearer task routing and workflow mapping.**\n\n- Overhauled SKILL.md: now routes all user intents to unique, numbered linear workflows, with a comprehensive routing table linking intent to playbook or workflow card.\n- Migrated business logic and task boundaries into dedicated playbooks (P1–P9) and workflow cards (W1–W12); removed duplicated detail from SKILL.md.\n- Clarified installation and usage instructions, default report formats, and subagent delegation guidance.\n- Added new reference, template, and schema files for meta period reports.\n- Removed outdated documentation, redundant guides, and legacy report scripts.\n\nv1.1.27 | 2026-06-08T01:50:45.590Z | auto\n\n- Added support and documentation for Market Analysis (P9), including new templates and workflow references.\n- Updated task routing and descriptions for analytics, reporting, and market analysis tasks.\n- Extended README files, agent conventions, and playbook sections to include market-analysis and refined instructions.\n- Improved references for website-diagnosis flow, now separating data collection (JSON only) from HTML rendering.\n- Removed the obsolete skill-card.md document.\n- General documentation clean-up and clarified required reading for all new tasks.\n\nv1.1.26 | 2026-06-04T02:40:27.180Z | auto\n\n- Enforces strict data handling: data tasks must use code to read JSON files (not Read tool) and prohibits reading full business JSON files with Read.\n- Requires self-check of deliverables: before delivering reports/Excel, read `references/core/deliverable-preflight.md` and verify currency/sections as per checklist.\n- Now enforces that currency code for deliverables comes only from current `list-accounts`.\n- Subagent/child-session rules updated: prohibits reading dropped business JSON in subagents and pasting large JSONs directly; must only return processed script output.\n- Added new reference: `references/core/deliverable-preflight.md` for report/Excel handoff requirements.\n- Documentation and required reading maps updated to reflect stricter preflight and output validation steps.\n\nv1.1.25 | 2026-06-03T08:18:12.126Z | auto\n\n- Added explicit rule: on first open-account task, always list all mandatory fields per channel (see references/accounts/open-account-by-media.md).\n- Updated routed references: Google 广告诊断/健康检查等指明必须读报告模板和工作流文档。\n- Refined onboarding for open account: Google 需加读 references/accounts/open-account-google-ui.md。\n- Minor edits to subagent and task routing instructions.\n- Removed obsolete skill-card.md file.\n\nv1.1.24 | 2026-06-02T08:28:23.690Z | auto\n\n**Expanded analytics and subagent features, new report templates and guides.**\n\n- Added support and documentation for Facebook/Meta analysis and website diagnosis workflows, guides, and reports.\n- Introduced subagent orchestration (可选) for complex or long-running report tasks (P5/P6/P7), with handoff templates and execution guides.\n- Updated \"任务 → 必读 references\" and routing tables for new analytics/report domains like facebook-analysis and website-diagnosis.\n- Added multiple report templates and assets for new analysis/report types.\n- Clarified responsibilities and decision matrix for when to use subagent delegation.\n- General documentation improvements and workflow clarifications.\n\nv1.1.23 | 2026-05-29T10:41:45.891Z | auto\n\n- Updated installation script locations in documentation for Windows and Linux/macOS.\n- Refreshed PMax campaign creation templates in both Markdown and JSON formats.\n- Minor edits to documentation for clarity and consistency.\n- Internal scripts/install.sh and install.ps1 updated for alignment with latest installation flows.\n\nv1.1.22 | 2026-05-28T12:27:40.960Z | auto\n\n**Major refactor: domain structure overhaul, documentation split, and new references system.**\n\n- Reorganized references into structured domains (`core/`, `accounts/`, `google-ads/`, `analytics/`, `operations/`) for improved clarity and maintainability.\n- Added over 50 new files, including detailed domain-specific docs, agent conventions, analytics workflows, and reporting guides.\n- Removed obsolete and flat files in favor of a hierarchical and modular `references/` system.\n- Updated SKILL.md: simplified overview, new doc routing, mandatory agent conventions, and updated task→reference mapping.\n- Installation and usage notes revised; roles and agent discipline clarified.\n- Playbooks, SOPs, and templates now referenced via new, split documentation.\n\nv1.1.21 | 2026-05-26T01:50:48.809Z | auto\n\nsiluzan-tso v1.1.21\n\n- 增加对 Google PMax 系列管理相关文档和模板（新增多份 PMax 相关 JSON/MD 文件，新增 references/pmax-api.md）\n- SKILL.md 更新「文档加载纪律」：任何用户任务/换话题时须重新读取路由和 references（防用旧记忆/参数）\n- 明确说明**PMax 搭建/管理暂未开放**，严禁调用相关写入命令\n- 功能路由表/任务参考表同步标注新文档，并强化 references 的按需加载及再读频率要求\n- 其他 references、安装脚本等细节优化，完善文档路由和用法指引\n\nv1.1.20 | 2026-05-21T12:16:53.189Z | auto\n\n**Summary: Adds new Google Ads campaign planning, currency, and RAG knowledge base references; refines documentation structure and conventions.**\n\n- 新增 google-ads-campaign-plan、currency、RAG 知识库检索等 reference 文档与相关 routings。\n- 丰富 Google 关键词推荐、系列规划与 campaign 启动流程相关指引。\n- 明确币种处理规范与跨币种计算限制。\n- 细化文档路由、表结构与 AI 执行规范，数据转换流程更加严谨。\n- 新增与业务职责、文档变更、数据交付相关的硬性规范说明。\n- 调整 Skill 说明，聚焦参考文档和流程契约，剔除大量冗余和示例细节。\n\nv1.1.19 | 2026-05-14T10:34:03.982Z | auto\n\n**Siluzan TSO Skill v1.1.19** \n本次更新带来功能文档路由与报告模板结构的扩展优化。\n\n- 新增关键词规划、Google广告落地页、OKKI周报、Google询盘分析等参考文档和报告模板文件\n- references/与report-templates/目录新增多份结构化模板，完善自动化报告和工作流支持\n- 关键参考文档路由（如关键字推荐、周期报告）及表格进一步细化，便于业务按需调用\n- SKILL.md优化简介与功能表结构，新增固定报告模板路由说明\n- 支持Windows PowerShell脚本一键安装，增补install.ps1\n\nv1.1.18 | 2026-05-11T05:53:32.252Z | auto\n\nsiluzan-tso 1.1.18\n\n- 登录流程优化，明确优先使用“手机号 + 验证码”方式，并在安装配置指引中强化相关说明。\n- 强化数据时效性指引，明确 TikTok/Yandex/BingV2/Kwai 仍仅支持昨日数据。\n- 澄清预算金额口径：`ad campaigns` 输出的预算（budget）已为元（“主币种”），不需再转换；`campaigns-*.json` 文件内 `budgetAmount` 仍需分转元。\n- 批量命令及账号子集用法表述优化，新增说明 accounts-digest、balance-scan 等可传账号子集跳过清单翻页。\n- 其他说明文档修订和规范细节补充，部分描述表达更准确。\n\nv1.1.17 | 2026-05-08T09:10:12.290Z | auto\n\n- 增加安装指引：新增 Windows 环境下的 Bash 安装方法和 Git Bash 下载引导，提升安装兼容性。\n- 明确数据时效性要求：新增「数据时效性（实时 vs 每日同步）」规范，强调报告输出前须查阅接口更新时间，避免「今日消耗」用错接口。\n- 更新部分文档路由和规则表述，细化高频任务 Playbook 指南。\n- 其余细节补充和规范描述完善。\n\nv1.1.16 | 2026-05-08T05:47:34.050Z | auto\n\nsiluzan-tso 1.1.16\n\n- 精简并重新梳理 SKILL.md，删除冗余内容并规范文档导航、职责划分以及执行规则描述。\n- 明确 outline.txt 文件使用方法和高效数据处理要求，强调禁止直接将 outline 内容当作数据。\n- 强化批量任务、长时运行任务、resume 用法等批量处理场景的指导和约束。\n- 所有规范、命令说明及最佳实践均依照 references 下的文档为准，去除重复和分散的说明，优化可读性。\n- 修订 playbook 操作流程，使常用任务的标准执行流程更明确，便于复制和落地。\n\nv1.1.15 | 2026-05-07T09:38:35.295Z | auto\n\n**Summary:** \nAdded Google 批量分析、写审计恢复相关功能，并简化/优化文档结构。\n\n- 新增 references/google-analysis-batch.md，实现多账户多维度 Google 数据批处理功能。\n- 新增 references/write-audit-restore.md，支持本地写审计、修改恢复计划。\n- SKILL.md 精简说明，优化表格与规范分节，突出批量任务/写操作/金额口径等硬约束。\n- 强化 --json-out 规范、报告生成方式、计划-确认-执行-验证流程等操作要求。\n- 多处细化 Google 广告、账户分析、自动化监控与批量任务的文档引用与约束。\n\nv1.1.14 | 2026-04-30T06:44:05.919Z | auto\n\nsiluzan-tso v1.1.14\n\n- 增加多份自动化与智能自控相关 reference 文档（hosted-automation-*），包括更强的自控、预警、A/B 优化等场景说明\n- Skill 说明文档（SKILL.md）大量重写，明确说明本 skill 职责与宿主/自动化边界，强化报告输出与原始数据快照规范\n- 预警与自动化监控相关文档说明优化，建议用更灵活的\"hosted-automation-user-catalog\"方案替代 forewarning\n- 所有数据处理及分析类命令推荐使用 --json-out <目录> 方式落盘、代码处理完成业务结果；明确禁用手工报告或粘贴输出\n- 移除 open-account-by-media.md，相关指引合并至现有文档结构\n- 强化命令透明性、金额展示、账户系列状态、批量能力等多项操作硬规范\n\nv1.1.13 | 2026-04-21T09:09:23.391Z | user\n\n**Siluzan TSO v1.1.13 Changelog**\n\n- 增加 CLI 一键安装支持：新增 install.sh（Linux/macOS/WSL）和 install.ps1（Windows）自动化安装脚本。\n- SKILL.md 显式引导安装脚本用法，便于用户首次部署。\n- 技能元数据增加依赖说明（nodejs, siluzan-tso-cli）。\n- 操作用法与行为规范进一步标准化，依赖项与变量说明更详细。\n\nv1.1.8 | 2026-04-09T08:47:47.750Z | user\n\nNo code or functional changes in version 1.1.8.\n\n- No file changes detected in this release.\n- Behavior and documentation remain consistent with previous versions.\n\nv1.1.7 | 2026-04-03T07:01:45.083Z | user\n\nLet your agent manage your Google/Bing/Yandex/Kwai/TikTok advertising accounts with Siluzan Tso.\n\nArchive index:\n\nArchive v1.1.53: 176 files, 833155 bytes\n\nFiles: _meta.json (131b), AGENTS.md (2487b), assets/campaign-create-keyword-test.fixed.json (5434b), assets/campaign-create-keyword-test.json (6051b), assets/campaign-create-template.json (7027b), assets/campaign-create-template.md (30555b), assets/google-period-report.schema.json (10230b), assets/google-quarterly-report.schema.json (2351b), assets/market-analysis-rules.md (7272b), assets/meta-lead-create-template.json (5896b), assets/meta-lead-create-template.md (3248b), assets/meta-period-report-rules.md (1261b), assets/meta-period-report.schema.json (2901b), assets/okki-weekly-report.schema.json (2894b), assets/plan-extract.example.json (2267b), assets/pmax-asset-group-template.json (1024b), assets/pmax-asset-group-template.md (1326b), assets/pmax-assets-update-template.json (1256b), assets/pmax-brand-assets-template.json (881b), assets/pmax-brand-assets-template.md (1376b), assets/pmax-brand-guidelines-enable-template.json (820b), assets/pmax-brand-guidelines-enable-template.md (1410b), assets/pmax-create-template.json (3933b), assets/pmax-create-template.md (14862b), assets/pmax-lead-form-template.json (1529b), assets/pmax-lead-form-template.md (4891b), assets/pmax-patch-campaign-template.json (171b), assets/pmax-signals-template.json (264b), assets/pmax-whatsapp-template.json (1061b), assets/pmax-whatsapp-template.md (2159b), assets/scripts/assemble-campaign-from-plan.mjs (8485b), assets/website-diagnosis-rules.md (4487b), references/accounts/accounts-balance-stats.md (16458b), references/accounts/accounts-list.md (15647b), references/accounts/accounts-permissions.md (24215b), references/accounts/accounts.md (4396b), references/accounts/currency.md (4644b), references/accounts/finance.md (18361b), references/accounts/open-account-by-media.md (13242b), references/accounts/open-account-google-ui.md (5633b), references/accounts/write-audit-restore.md (6981b), references/analytics/account-analytics.md (55978b), references/analytics/facebook-analysis-guide.md (14975b), references/analytics/geo-continents.json (8019b), references/analytics/google-analysis-batch.md (14418b), references/analytics/keyword-planner-workflows.md (18863b), references/analytics/market-analysis-guide.md (5685b), references/analytics/rag.md (6607b), references/analytics/reporting.md (7852b), references/analytics/website-diagnosis-guide.md (8674b), references/core/agent-conventions.md (43105b), references/core/cli-enums.md (9934b), references/core/intent-routing.md (40084b), references/core/playbooks.md (20730b), references/core/setup.md (8870b), references/core/subagent-orchestration.md (10120b), references/core/tips.md (13199b), references/core/user-communication-guide.md (98b), references/core/workflows.md (27698b), references/google-ads/google-ads-batch.md (2941b), references/google-ads/google-ads-campaign-plan.md (26643b), references/google-ads/google-ads-read.md (14703b), references/google-ads/google-ads-write.md (29246b), references/google-ads/google-ads.md (5388b), references/google-ads/pmax-api.md (13721b), references/google-ads/rules/google-ads-account-audit-assets.md (13570b), references/google-ads/rules/google-ads-account-audit-quick.md (12820b), references/google-ads/rules/google-ads-account-audit-report.md (2097b), references/google-ads/rules/google-ads-account-audit-structure.md (6459b), references/google-ads/rules/google-ads-account-audit.md (1641b), references/google-ads/rules/google-ads-audience-strategy.md (19441b), references/google-ads/rules/google-ads-campaign-optimization.md (20882b), references/google-ads/rules/google-ads-compliance-copy.md (14052b), references/google-ads/rules/google-ads-compliance-forbid.md (21111b), references/google-ads/rules/google-ads-compliance-ops.md (10047b), references/google-ads/rules/google-ads-compliance.md (1941b), references/google-ads/rules/google-ads-conversion-architecture.md (16060b), references/google-ads/rules/google-ads-creative-optimization.md (26285b), references/google-ads/rules/google-ads-keyword-optimization.md (26439b), references/google-ads/rules/google-ads-keyword-strategy.md (30079b)\n\nFile v1.1.53:SKILL.md\n\n---\nname: siluzan-tso\ndescription: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/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；只要周期数据/8维/花费转化汇总/Excel→P4；Google/谷歌广告月度报告、月总结与规划、季度报告、Q3汇总、Q4规划、季度汇报、投放季报、客户版、大族模板、下月规划→P10 google-quarterly；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+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。\nlicense: MIT\ncompatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权\nmetadata:\n requires: nodejs,siluzan-tso-cli\nallowed-tools: Bash(siluzan-tso:*) Read Write\n---\n\n\n# Siluzan TSO Skill\n\n本文件只做 **任务路由**：意图 → **唯一**工作流 → 按需 Read 子文档（参数与步骤不在此重复）。\n\n- 分析 / 报告 → `references/core/playbooks.md`（P1–P10）\n- 操作 / 管理 → `references/core/workflows.md`（W1–W13）\n- 命令参数 → 路由表「必读文档」\n- 通用纪律与沟通 → `references/core/agent-conventions.md`\n\n> **加载**：按下方路由表 Read **一个**工作流卡片 + **一个**命令/报告 reference 后执行。写操作、报告交付、批量拉数、对用户写结论、或上下文被压缩时，再 Read `references/core/agent-conventions.md`（含 §十四沟通）。\n>\n> **报告 / 诊断 / 分析 / 拓词 / 转化成本·CPA·零询盘话术模糊**：先 Read `references/core/intent-routing.md`（含 **§零·D**：无 CRM 的转化巡检 → P3，不是 P7），再回路由表。数据任务一律 `--json-out` + 代码读盘（示例见 `references/core/tips.md`）。未指定格式时 P1/P4/P4-FB/P8/P9/P10 默认 **HTML**；**P6 默认 `okki-render` 出 5 Sheet `.xlsx`**、**P7 默认 8 Sheet `.xlsx`**（「表格形式」= xlsx，禁止 Markdown 表 / 手写 HTML / P6 Agent 手写 xlsx）。巡检类任务须交付摘要或显式失败原因。\n\n---\n\n## 基本使用\n\n```bash\nsiluzan-tso -h\n```\n\n未安装 / 未登录 / 401 → Read `references/core/setup.md`。\n\n**步骤**：① 报告类模糊 → Read `intent-routing.md` → ② 锁定下方**唯一**工作流行 → ③ Read 该行「必读文档」+ 工作流卡片 → ④ 按编号步骤执行；写操作前与用户确认；对用户写结论时 Read conventions §十四。**禁止** Read `report-templates/*.html`（由 CLI `render` 使用）。\n\n---\n\n## 即时规范\n\n- `entityId`（UUID）≠ `mediaCustomerId`（`list-accounts` 的 `ma.mediaCustomerId`：Google/TikTok/Bing 多为数字；**Yandex=`porg-…`**；Meta 常带 `act_`，`balance`/`stats`/`balance-scan`/`accounts-digest` 裸数字会补前缀）。`stats`/`balance`/`accounts-digest`/`ad *` 的 `-a` **只传 mediaCustomerId**；空结果或 verbose 打出 403 时**先核验 ID**，禁止把 UUID/`entityId` 传给 `-a`，也**禁止**据此直接 `reauth`。\n- **Google CID 特殊性**：UI 常写 `123-456-7890`（带连字符），平台 `mediaCustomerId` 为纯数字 `1234567890`。用户给了账户号时必须 `list-accounts -m Google -k <用户原样>`（带横杠也可，CLI 去连字符）；**禁止**无 `-k` 拉默认 20 条再判定未绑定/引导授权。`stats`/`balance`/`ad *`/`google-analysis` 的 `-a` 也可带横杠。**勿**把带横杠 403 误判为 OAuth 失效。\n- **禁止臆测授权过期**：见 403/`HTTP 403`/拉数失败/「可能 OAuth 失效」时，**禁止**口头推断授权过期或直接 `reauth`。须先核验 ID（及 Google 连字符）。**`account check-access` 仅支持 Google**（无 `-m`，禁止对 TikTok/Meta/Bing/Yandex 调用）：Google 跑 `account check-access -a `，以 `accessible` / `reauth_required` / `no_permission` 为准；非 Google 看 `list-accounts` 的 `invalidOAuthToken`。仅当 `list-accounts` 输出含激活字段且可判定未激活时才跳过用其判断授权过期；细则见 `accounts-permissions.md`。\n- **Google 广告命令名**：列表是 `ad campaigns`（不是 `ad-campaigns` / `campaign list`）；`balance`/`stats` 须带 `-m Google`；单国地域用 `ad geo search … --json-out`（或 `geo resolve`）。\n- **广告搭建媒体边界**：仅 **Google**（`ad`，Search + PMax）与 **Meta**（`meta-ad`，Instant Form 线索）。TikTok / BingV2 / Yandex **不能**创建或改广告结构；用户要搭建时须说明不支持，可改做账户分析（P4）或开户（W2）。**禁止**用 `ad` 冒充 Meta，**禁止**用 `meta-ad` 冒充 Google。\n- **Google 广告类型边界**：CLI/Skill **仅支持** Google **搜索广告（Search）** 与 **Performance Max（PMax）** 的方案、创建与精细管理；**不支持展示广告（Display）**（含自适应展示广告 RDA、独立 Display 系列）。用户要做展示广告时须明确告知不支持，可改推 Search / PMax；**禁止**用 `campaign-create` / `ad-create` 伪装创建 Display。\n- **创建完成后交付（硬性）**：`ad batch diff` 的 stdout 含 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN`——**立刻**把中间全文原样发给用户（可先于补建）；禁止只摘要、禁止只说「创建成功/详情已交付/未发现缺失」、禁止等全部补建结束再交付。\n- `list-accounts` 无余额/消耗；列全部用 `--page-size 999`。查单户必须 `-k`；`itemCount < total` 时**禁止**判定账户未绑定。\n- 多户余额用 `balance-scan`（P2），多户消耗 / **转化成本·CPA 巡检**用 `accounts-digest`（P3，`--max-cpa`；**没有** `cpa-risk-scan`）。禁止外层 for-loop 逐户拉数。\n- `stats` 的 `spend` = **区间合计**，不是日消耗。\n- 行业/市场报告禁止纯 WebSearch 当终稿；须 P9 `market-analysis collect`+`render`。\n- **禁止编造平台网址**：给用户 `*.siluzan.com` / `mysiluzan.com` 链接前，**必须**当轮 `config show` 取 `webUrl`，路径**只**用已 Read 文档中的相对路径表拼接；CLI 输出的授权 URL **原样粘贴**；文档未给路径则**不拼链接**。细则见 `agent-conventions.md`。\n- **W13 Meta 创建（硬性）**：首次落地只用 `meta-ad create`（会提交 `targeting_automation.advantage_audience`，默认 1）。组失败用 `--json-out` 的 `campaignId` 跑 `adset-create`，**禁止**再 `campaign-create`。细定向写 `adset.flexibleSpec` 并设 `advantageAudience=0`。\n\n---\n\n## 媒体能力（搭建 vs 分析）\n\n| 媒体 | 广告搭建 | 账户分析 | 说明 |\n| ---- | -------- | -------- | ---- |\n| **Google** | Search + PMax（`ad`，W3/W4） | `google-analysis` | 不支持 Display |\n| **MetaAd** | Instant Form 线索（`meta-ad`，W13） | `facebook-analysis` | 无视频 / Advantage+ / 系列列表 |\n| **TikTok** | **不支持** | `tiktok-analysis` | 已有留资走 `clue`（W11） |\n| **BingV2** | **不支持** | `bing-analysis` | 只读巡检 |\n| **Yandex** | **不支持** | `yandex-analysis` | 只读巡检 |\n\n## 路由表（意图 → 工作流 → 必读文档）\n\n> 写操作 / 报告交付 / 批量拉数 / 对用户回复 → Read `agent-conventions.md`。找不到行 → 澄清或 Read `intent-routing.md`（勿整本加载 `references/README.md`）。\n\n### 账户与财务\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `references/accounts/accounts-list.md`（list-accounts） |\n| 单户实时余额 | W1 | `references/accounts/accounts-balance-stats.md`（balance） |\n| 多账户余额 / 续航不足预警 | **P2** | `references/accounts/accounts-balance-stats.md`（balance-scan） |\n| 单户消耗 / 投放数据 | W1 / **P1** | `references/accounts/accounts-balance-stats.md`（stats） |\n| 多账户消耗/对比汇总 / 转化成本·CPA·零转化巡检（无 CRM） | **P3** | `references/accounts/accounts-balance-stats.md`（accounts-digest）；消歧见 `intent-routing.md` **§零·D** |\n| 激活/充值账单明细 | W1 | `references/accounts/accounts-list.md`（account-active-bills） |\n| 开户（五大媒体）/ 开户进度 | W2 | `references/accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `open-account-google-ui.md`） |\n| 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `references/accounts/accounts-permissions.md` |\n| 充值 / 钱包 / 转账 / 发票 / 抬头 | W8 | `references/accounts/finance.md` |\n| 审计 / 误操作恢复 | — | `references/accounts/write-audit-restore.md` |\n\n### 不支持的广告搭建\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 建 TikTok / Bing / Yandex 广告 | — | **不支持搭建**。说明后可改做账户分析（P4）或开户（W2）；勿用 `ad` / `meta-ad` 伪装 |\n\n### Google 广告投放\n\n> **类型边界**：仅 **Search** + **PMax**；**不支持 Display（展示广告）**。详见 `references/google-ads/google-ads.md` Gotchas。\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 新建搜索系列 / 出投放方案 / Excel·表格方案 / 官网生成搜索广告 | **W3** | `references/google-ads/google-ads-campaign-plan.md`（§**仅出方案 vs 创建**）+ **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md` + `rules/google-ads-launch-plan-template.md`（JSON 后**写代码**投影完整审查稿）；有方案文件时加 `rules/google-ads-plan-source-fidelity.md`。**≠ P8 / ≠ P9 / ≠ W5**；**禁止**因缺账户阻塞出方案、**禁止**只交概览表 |\n| 展示广告 / Display / 自适应展示广告（RDA） | — | **不支持**。向用户说明后改推 Search（W3）或 PMax（W3）；勿创建、勿假装已支持 |\n| 广告系列/组/广告/关键词 **查询** / 拒审字段 | W3 | `references/google-ads/google-ads-read.md` |\n| 广告系列/组/广告/关键词 **创建·编辑·启停** | W3 | `references/google-ads/google-ads-write.md` |\n| PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `rules/google-ads-pmax-launch-plan-template.md`（**写代码**投影完整审查稿）+ `references/google-ads/pmax-api.md` + `google-ads-write.md`（PMax 节） |\n| AI 智投草稿 list/get/update/publish | W4 | `references/google-ads/google-ads-batch.md` |\n| 拓词 / keyword / 关键词规划 / 月搜索量 / 竞争度 / Keyword Planner | **W5** | `references/analytics/keyword-planner-workflows.md`（**§零·C**；客户背景先 `references/analytics/rag.md`） |\n| AI 广告优化记录 / 建议 | W6 | `references/operations/optimize.md` |\n| 优化/合规 SOP | W3 / W6 | `references/google-ads/rules/README.md`（**仅读索引表** → 再 Read **一个**具体 `rules/*.md`） |\n\n### Meta 广告投放\n\n> **类型边界**：仅 **Instant Form 线索广告**；无视频 / Advantage+ / 系列列表。拉已有线索走 **W11**；周期报告走 **P4-FB**。TikTok / Bing / Yandex **不能**走本表搭建。\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 新建 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`** + **`meta-ad plan-render`**（运营 4 Sheet xlsx，禁止 Agent 手写表）+ `references/meta-ads/meta-ads-write.md`。**≠ W11 ≠ P4-FB ≠ W3** |\n| Meta 系列/组/广告 **查询**（按 ID）/ 主页 / 表单列表 | W13 | `references/meta-ads/meta-ads-read.md` |\n| Meta 系列/组/广告 **创建·编辑·启停**（原语） | W13 | `references/meta-ads/meta-ads-write.md` |\n\n### 分析与报告\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |\n| Google 账户周期 **数据汇总**（只要花费/转化/9 章/Excel；**无**规划/客户版/大族） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |\n| Google/谷歌 **月度报告** / **月总结与规划** / **季度报告** / **Q3 汇总** / **Q4 规划** / **季度汇报** / **投放季报** / 客户版 / 大族模板 / 下月规划（效率+区域询盘+国家明细） | **P10** | `report-templates/google-quarterly-report.md` + **`report-templates/google-quarterly-plan.md`**（**未带询盘表须先问并等待**，禁止不问就 collect；有表须先转 JSON 再 `--inquiries`，禁止把 xlsx 丢给 collect；`collect`+`render`；规划九章；花费三档基于本期、不是已批预算；**不做**行业数据） |\n| Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |\n| TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |\n| Yandex 账户分析 / 周期 / 月报 | **P4** | `report-templates/yandex-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `yandex-period-report-excel.md` |\n| 账户级按日 Excel | **P4-DAILY** | `report-templates/stats-daily-excel.md` |\n| 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |\n| OKKI 周报 / 表格形式（OKKI） | **P6** | `report-templates/okki-weekly-google-client.md`（写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet `.xlsx`；「表格形式」= Excel） |\n| Google 询盘分析（**须 CRM 询盘资料**；口语零询盘/CPA → **P3**） | **P7** | `report-templates/google-inquiry-analysis.md` + `references/analytics/geo-continents.json` |\n| 网址/域名/官网 + 诊断·检测·监测·报告 / **是否符合广告投放要求** / 能不能投 | **P8** | `references/core/intent-routing.md` §零 + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必** `website-diagnosis collect`；**≠ P9 ≠ W3**；禁纯 WebFetch） |\n| 市场/行业分析报告 / 战略市场 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（须 collect+render；**≠ P8**） |\n| TSO 平台优化报告：列表/生成/推送 | W7 | `references/analytics/reporting.md` |\n| RAG 知识库检索 | W5 | `references/analytics/rag.md` |\n\n### 工具与运营\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 智能预警：创建/查询/启停/触发记录 | W10 | `references/operations/forewarning.md` |\n| TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |\n| 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |\n| 超预算熔断 / 空耗熔断（全户 Google） | — | `references/operations/guard.md`（`guard budget-circuit` / `guard zero-conv`；禁止逐户 for-loop） |\n| Bing 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-bing.md`（只读告警，不能自动暂停/改价） |\n| Yandex 自动化巡检（归档/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-yandex.md`（只读告警，不能自动暂停/改价） |\n| TikTok 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-tiktok.md`（只读告警，不能自动暂停/改价） |\n| Facebook / MetaAd 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-facebook.md`（只读告警，不能自动暂停/改价） |\n| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP；Google 熔断优先 guard.md；Bing/Yandex/TikTok/Facebook 走上四行） |\n\n---\n\n## Subagent 自主委派（可选）\n\n宿主具备 Task / subagent 时：复杂报告或批处理（**P5 / P6 / P7**）、预计 CLI 输出很长 → Read `references/core/subagent-orchestration.md`；handoff 在 `snippets/handoff-p{5,6,7}-*.md`。写操作确认、`--commit`、401/`resume` 与最终交付留在主 Agent。\n\n---\n\n## 职责划分\n\n| 本 Skill + CLI | 宿主 / 外部调度 |\n| -------------- | --------------- |\n| 结构化拉数（`--json-out`）、写命令语义、金额/ID 口径 | 触发时机、IF 决策、触达（钉钉/飞书）、批处理限速；可选 subagent 并行 |\n\nFile v1.1.53:references/google-ads/rules/README.md\n\n# Google Ads 优化与合规规则\n\n> **策略/SOP**，非 CLI 参数表。命令见 `google-ads-read.md` / `google-ads-write.md` / `google-ads-batch.md`。新建流程见 `google-ads-campaign-plan.md`。\n> **怎么读**：下表选 **一个**文件再 Read（审计/合规若有子模块，先读其导航再选子文件）。\n\n| 文件 | 何时 Read |\n| --------------------------------------------------- | ---------------------------------------------------------- |\n| `google-ads-account-audit.md` | 账户健康审计（索引 → quick / structure / assets / report） |\n| `google-ads-compliance.md` | 合规政策（索引 → forbid / copy / ops） |\n| `google-ads-campaign-optimization.md` | 系列层优化决策 |\n| `google-ads-keyword-strategy.md` | 关键词策略规划 |\n| `google-ads-keyword-optimization.md` | 关键词出价/否定/扩词 |\n| `google-ads-keyword-taxonomy.md` | 词类分层与命名 |\n| `google-ads-plan-source-fidelity.md` | **Excel/表格方案 → JSON**（有方案文件时必读） |\n| `google-ads-creative-optimization.md` | 创意/文案优化 |\n| `google-ads-audience-strategy.md` | 受众策略 |\n| `google-ads-pmax-guide.md` | PMax 运营（配合 `assets/pmax-create-template.md`） |\n| `google-ads-conversion-architecture.md` | 转化追踪架构 |\n| `google-ads-landing-page-discovery-via-webfetch.md` | 落地页发现（WebFetch） |\n| `google-ads-launch-plan-template.md` | 搜索投放审查稿（Agent 写代码从 JSON 投影） |\n| `google-ads-pmax-launch-plan-template.md` | PMax 投放审查稿（Agent 写代码从 JSON 投影） |\n| `sensitive-industries.md` | 敏感行业限制 |\n\n宿主编排自动优化：`references/operations/hosted-automation-optimize-index.md`。\n\nFile v1.1.53:references/README.md\n\n# References 索引\n\n> **运行时**：按 `SKILL.md` 路由表直接 Read 列出的文件，**不要**为找路径加载本文件全文。改文档结构见 `skill-authoring.md`。\n\n## 基础与纪律\n\n| 文件 | 用途 |\n| --------------------------------------------- | ---------------------------------------- |\n| `references/core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |\n| `references/core/agent-conventions.md` | 通用纪律 + §十四沟通 |\n| `references/core/user-communication-guide.md` | 重定向 → `agent-conventions.md` §十四 |\n| `references/core/intent-routing.md` | 报告/分析/拓词话术消歧 |\n| `references/core/tips.md` | `--json-out` 脚本食谱 |\n| `references/core/playbooks.md` | 分析/报告工作流（P1–P9） |\n| `references/core/workflows.md` | 操作/管理工作流（W1–W13） |\n| `references/core/subagent-orchestration.md` | 可选：P5/P6/P7 委派 subagent |\n| `references/core/skill-authoring.md` | 维护约定（运行时勿加载） |\n\n## 账户与财务\n\n| 文件 | 用途 |\n| ----------------------------------------------- | ----------------------------------------------------------------- |\n| `references/accounts/accounts.md` | **账户域索引**（按任务再读子文件） |\n| `references/accounts/accounts-list.md` | list-accounts、激活账单、开户申请历史 |\n| `references/accounts/accounts-balance-stats.md` | balance、**balance-scan（P2）**、stats、**accounts-digest（P3）** |\n| `references/accounts/accounts-permissions.md` | 分享/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 |\n| `references/accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |\n| `references/accounts/open-account-by-media.md` | 各媒体开户命令与参数 |\n| `references/accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |\n| `references/accounts/finance.md` | 转账、开票、充值 |\n| `references/accounts/write-audit-restore.md` | 写审计、`--commit`、restore |\n\n## Google 广告\n\n| 文件 | 用途 |\n| --------------------------------------------------- | -------------------------------------- |\n| `references/google-ads/google-ads.md` | **Google Ads 索引**（金额/ID Gotchas） |\n| `references/google-ads/google-ads-read.md` | 系列/组/创意/关键词/搜索词/地理查询 |\n| `references/google-ads/google-ads-write.md` | 创建/编辑/启停/扩展/PMax/设备出价 |\n| `references/google-ads/google-ads-batch.md` | batch 流水线、ad batch、智投草稿 |\n| `references/google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |\n| `references/google-ads/pmax-api.md` | PMax 网关路径、金额口径 |\n| `references/analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |\n| `references/google-ads/rules/README.md` | 优化/合规 SOP 索引 |\n\n## Meta 广告\n\n| 文件 | 用途 |\n| --------------------------------------------- | ----------------------------------------- |\n| `references/meta-ads/meta-ads.md` | **Meta Instant Form 索引**（金额/ID） |\n| `references/meta-ads/meta-ads-read.md` | 账户/主页/表单/按 ID 读系列组广告 |\n| `references/meta-ads/meta-ads-write.md` | validate/create 与原语写命令 |\n| `references/meta-ads/meta-lead-launch-plan-template.md` | 出方案/创建前审查稿；xlsx 由 `meta-ad plan-render` 生成 |\n| `assets/meta-lead-create-template.json` + `.md` | Lead Ad JSON 契约（**先 Read `.json`**） |\n\n## 分析与报告\n\n| 文件 | 用途 |\n| ------------------------------------------------- | ------------------------------------------- |\n| `references/analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |\n| `references/analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |\n| `references/analytics/market-analysis-guide.md` | 战略市场分析 CLI、Agent 调研流程 |\n| `assets/market-analysis-rules.md` | 市场分析报告章节与 HTML 版式（Agent 必读） |\n| `references/analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |\n| `references/analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |\n| `references/analytics/reporting.md` | TSO 优化报告生成与推送 |\n| `references/analytics/rag.md` | 知识库 list/query |\n| `references/analytics/geo-continents.json` | 国家→大洲映射（询盘分析） |\n\n## 运营工具\n\n| 文件 | 用途 |\n| ------------------------------------------------------------ | ---------------------- |\n| `references/operations/optimize.md` | AI 优化建议记录 |\n| `references/operations/forewarning.md` | 智能预警 |\n| `references/operations/clue.md` | TikTok / Meta 线索表单 |\n| `references/operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |\n| `references/operations/hosted-automation-self-control.md` | Google 预算/CPA/空耗自控 SOP |\n| `references/operations/hosted-automation-monitoring-json.md` | Google 异常监控 JSON 键名 |\n| `references/operations/hosted-automation-optimize-index.md` | Google 自动优化 SOP 索引 |\n| `references/operations/hosted-automation-bing.md` | Bing 只读巡检 SOP |\n| `references/operations/hosted-automation-yandex.md` | Yandex 只读巡检 SOP |\n| `references/operations/hosted-automation-tiktok.md` | TikTok 只读巡检 SOP |\n| `references/operations/hosted-automation-facebook.md` | Facebook / MetaAd 只读巡检 SOP |\n| `references/operations/hosted-automation-scenarios.md` | 宿主编排场景索引 |\n\n## Assets 模板（`../assets/`）\n\n| 文件 | 用途 |\n| --------------------------------------- | --------------------------------------------------------- |\n| `campaign-create-template.json` + `.md` | 搜索系列 batch 契约（**先 Read `.json`**，再 Read `.md`） |\n| `website-diagnosis-rules.md` | 网站诊断评分项与 JSON Schema |\n| `meta-period-report-rules.md` | Meta 周期报告内容丰富度与建议撰写规则 |\n| `meta-period-report.schema.json` | Meta 周期报告 Agent JSON Schema |\n| `google-quarterly-report.schema.json` | Google 季度经营报告 Agent JSON Schema |\n| `pmax-create-template.md` / `.json` | PMax 新建契约 |\n| `meta-lead-create-template.json` + `.md` | Meta Instant Form Lead Ad 契约 |\n| `pmax-asset-group-template.json` | PMax 素材组 |\n| `pmax-signals-template.json` | PMax 信号 |\n| `pmax-assets-update-template.json` | PMax 素材更新 |\n| `pmax-patch-campaign-template.json` | PMax 系列 patch |\n\n## 报告模板纲要（`report-templates/`）\n\n> 安装包内与 `report-templates/*.md` 同源；HTML 样式在 `report-templates/*.html`。索引见 `report-templates/README.md`。\n\n| 文件 | 适用场景 |\n| ---------------------------------------------------------------- | ------------------------------ |\n| `google-period-report.md` | Google 账户周期/月度报告（P4） |\n| `google-quarterly-report.md` | Google 季度经营报告（P10） |\n| `google-quarterly-plan.md` | P10 下期规划规则（九章） |\n| `google-period-report-excel.md` | P4 用户要 Excel |\n| `stats-daily-excel.md` | P4-DAILY 按日 Excel |\n| `meta-period-report.md` / `meta-period-report-excel.md` | Meta 周期（P4-FB） |\n| `google-ads-diagnosis.md` / `google-account-diagnosis-report.md` | Google 诊断（P1） |\n| `website-diagnosis-report.md` | 网站诊断（P8） |\n| `market-analysis-report.md` | 战略市场分析（P9） |\n| `okki-weekly-google-client.md` | OKKI 周报（P6） |\n| `google-inquiry-analysis.md` | 询盘分析（P7） |\n| `tiktok-period-report.md` / `bing-period-report.md` | TikTok / Bing 周期（P4） |\n| `yandex-period-report.md` / `yandex-period-report-excel.md` | Yandex 周期 HTML / Excel（P4） |\n| `REPORT-WORKFLOW.md` | 通用六步流程 |\n\n样式参考 HTML 见根目录 `report-templates/README.md`。\n\n## Handoff 模板（`../snippets/`，随 skill 安装）\n\n| 文件 | 用途 |\n| ----------------------- | --------------------------------- |\n| `handoff-p5-batch.md` | P5 batch 与按账户聚合 Task prompt |\n| `handoff-p6-okki.md` | P6 OKKI 拉数 / 写 JSON + okki-render |\n| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx |\n\n`agent-preamble.md` 仅用于构建时注入 `SKILL.md`，不复制到 `dist/skill/snippets/`。\n\nFile v1.1.53:references/report-templates/README.md\n\n# 报告模板目录\n\n本目录包含两类文件：\n\n| 文件类型 | 用途 |\n| ----------------------- | ----------------------------------------------- |\n| `*.md` | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |\n| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容 |\n| `excel-style-guide.md` | Excel 通用样式规范（色板/字体/组件），所有平台共用 |\n| `excel-style-kit.mjs` | 配套代码：Agent 写 xlsx 脚本直接 `import` 使用，零依赖 |\n\n> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。任何「用户要 Excel/xlsx/表格」的模板，写脚本时都按 `excel-style-guide.md` 套样式，不再裸写无样式单元格。\n\n**图表库（全部 HTML 模板统一）**：ECharts 5 — `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.min.js`；初始化用 `echarts.init(el).setOption(...)`。勿使用 Chart.js。\n\n**图表自适应**：逻辑必须写在**同一份 HTML 模板内**（`window.addEventListener('resize', … chart.resize())`，可选对容器做 `ResizeObserver`）。报告下载到本地后仍可用；禁止依赖外挂 `*.snippet.js` 或 monkey-patch CDN。\n\n---\n\n## 内容纲要文件\n\n| 文件 | 适用场景 |\n| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |\n| `google-quarterly-report.md` / `.html` | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章 |\n| `google-quarterly-plan.md` | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读 |\n| `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |\n| `stats-daily-excel.md` | **P4-DAILY**：账户级按日 Excel（`stats --by-day`） |\n| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |\n| `google-ads-diagnosis.md` | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**） |\n| `meta-period-report.md` / `.html` | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |\n| `meta-period-report-excel.md` | **仅用户要 Excel 时**：5 Sheet（**汇总数据**/日趋势/国家/广告系列/受众，汇总 KPI 下是一/二/三）；`facebook-analysis render --format xlsx` |\n| `meta-account-diagnosis-report.md` / `.html` | **Meta（Facebook）诊断报告（默认）**：四步流程 → `facebook-analysis diagnosis-render` 出 HTML（在 7 Section 内对齐 Google 诊断结构，未覆盖小节标 `notAvailable`） |\n| `tiktok-period-report.md` / `.html` | **TikTok 广告主周期报告（默认）**：四步流程 → `tiktok-analysis render` 出 HTML |\n| `bing-period-report.md` / `.html` | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML |\n| `yandex-period-report.md` / `.html` | **Yandex Direct 周期报告（默认）**：四步流程 → `yandex-analysis render` 出 HTML（样式对齐开发样例） |\n| `yandex-period-report-excel.md` | **仅用户要 Excel 时**：Agent 脚本写 xlsx；无 CLI excel 子命令 |\n| `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术，见 `references/core/playbooks.md` P6 |\n| `google-inquiry-analysis.md` | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |\n| `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |\n\n---\n\n## 样式参考文件\n\n| 文件 | 风格 |\n| ------------------------------- | --------------------- |\n| `report-template.html` | 商务/数据看板（默认） |\n| `report-template-formal.html` | 正式文件/对外 |\n| `report-template-dark.html` | 深色/投屏 |\n| `report-template-onepager.html` | 单页摘要 |\n| `report-template-mobile.html` | 移动端 |\n| `report-template-print.html` | 打印归档 |\n| `report-template-academic.html` | 学术/研究口吻 |\n\n---\n\n## 生成报告的规则\n\n### 分析报告的维度确认\n\n生成**分析报告**时：\n\n1. 根据对应 `*.md` 的**默认维度**直接开始拉数（见各 `*.md` 首节）。\n2. 同时向用户展示该文件里的**可选维度列表**，询问是否需要追加任何维度。\n3. 用户追加的维度，补充拉数后追加到报告末尾。\n4. 用户说「不用加」或不回复，只输出默认维度的内容。\n\n### 禁止事项\n\n- 不能使用 HTML 样式文件里的假数据填报告\n- 不能凭印象写具体数字，所有数字来自 CLI 执行结果\n- 某个维度的数据获取失败，在对应章节注明原因，不写推测内容\n\n### 数据不可用时\n\n在对应章节写：`[ 数据不可用：{原因} ]`，不做猜测。\n\nFile v1.1.53:report-templates/README.md\n\n# 报告模板目录\n\n本目录包含两类文件：\n\n| 文件类型 | 用途 |\n| ----------------------- | ----------------------------------------------- |\n| `*.md` | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |\n| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容 |\n| `excel-style-guide.md` | Excel 通用样式规范（色板/字体/组件），所有平台共用 |\n| `excel-style-kit.mjs` | 配套代码：Agent 写 xlsx 脚本直接 `import` 使用，零依赖 |\n\n> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。任何「用户要 Excel/xlsx/表格」的模板，写脚本时都按 `excel-style-guide.md` 套样式，不再裸写无样式单元格。\n\n**图表库（全部 HTML 模板统一）**：ECharts 5 — `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.min.js`；初始化用 `echarts.init(el).setOption(...)`。勿使用 Chart.js。\n\n**图表自适应**：逻辑必须写在**同一份 HTML 模板内**（`window.addEventListener('resize', … chart.resize())`，可选对容器做 `ResizeObserver`）。报告下载到本地后仍可用；禁止依赖外挂 `*.snippet.js` 或 monkey-patch CDN。\n\n---\n\n## 内容纲要文件\n\n| 文件 | 适用场景 |\n| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |\n| `google-quarterly-report.md` / `.html` | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章 |\n| `google-quarterly-plan.md` | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读 |\n| `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |\n| `stats-daily-excel.md` | **P4-DAILY**：账户级按日 Excel（`stats --by-day`） |\n| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |\n| `google-ads-diagnosis.md` | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**） |\n| `meta-period-report.md` / `.html` | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |\n| `meta-period-report-excel.md` | **仅用户要 Excel 时**：5 Sheet（**汇总数据**/日趋势/国家/广告系列/受众，汇总 KPI 下是一/二/三）；`facebook-analysis render --format xlsx` |\n| `meta-account-diagnosis-report.md` / `.html` | **Meta（Facebook）诊断报告（默认）**：四步流程 → `facebook-analysis diagnosis-render` 出 HTML（在 7 Section 内对齐 Google 诊断结构，未覆盖小节标 `notAvailable`） |\n| `tiktok-period-report.md` / `.html` | **TikTok 广告主周期报告（默认）**：四步流程 → `tiktok-analysis render` 出 HTML |\n| `bing-period-report.md` / `.html` | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML |\n| `yandex-period-report.md` / `.html` | **Yandex Direct 周期报告（默认）**：四步流程 → `yandex-analysis render` 出 HTML（样式对齐开发样例） |\n| `yandex-period-report-excel.md` | **仅用户要 Excel 时**：Agent 脚本写 xlsx；无 CLI excel 子命令 |\n| `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术，见 `references/core/playbooks.md` P6 |\n| `google-inquiry-analysis.md` | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |\n| `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |\n\n---\n\n## 样式参考文件\n\n| 文件 | 风格 |\n| ------------------------------- | --------------------- |\n| `report-template.html` | 商务/数据看板（默认） |\n| `report-template-formal.html` | 正式文件/对外 |\n| `report-template-dark.html` | 深色/投屏 |\n| `report-template-onepager.html` | 单页摘要 |\n| `report-template-mobile.html` | 移动端 |\n| `report-template-print.html` | 打印归档 |\n| `report-template-academic.html` | 学术/研究口吻 |\n\n---\n\n## 生成报告的规则\n\n### 分析报告的维度确认\n\n生成**分析报告**时：\n\n1. 根据对应 `*.md` 的**默认维度**直接开始拉数（见各 `*.md` 首节）。\n2. 同时向用户展示该文件里的**可选维度列表**，询问是否需要追加任何维度。\n3. 用户追加的维度，补充拉数后追加到报告末尾。\n4. 用户说「不用加」或不回复，只输出默认维度的内容。\n\n### 禁止事项\n\n- 不能使用 HTML 样式文件里的假数据填报告\n- 不能凭印象写具体数字，所有数字来自 CLI 执行结果\n- 某个维度的数据获取失败，在对应章节注明原因，不写推测内容\n\n### 数据不可用时\n\n在对应章节写：`[ 数据不可用：{原因} ]`，不做猜测。\n\nFile v1.1.53:_meta.json\n\n{\n \"ownerId\": \"kn7fvww6xcwp6e93b3qgnjy7s183jy5k\",\n \"slug\": \"siluzan-tso\",\n \"version\": \"1.1.53\",\n \"publishedAt\": 1790067931368\n}\n\nFile v1.1.53:references/accounts/accounts-balance-stats.md\n\n# 余额、消耗与多账户汇总\n\n> 流程见 `playbooks.md` **P2** / **P3**；单户读数见 `workflows.md` **W1**。币种口径见 `currency.md`。\n\n## Contents\n\n- balance\n- balance-scan（P2）\n- accounts-digest（P3）\n- stats\n\n## balance-scan — 多账户余额续航扫描\n\n一键扫描某媒体下**全部有效账户**的余额与日均消耗。`data.items` 返回**所有已检查账户**（不只预警行）；用 `hitReason` 标记续航/余额不足。**P2 必用**；**禁止**外层循环逐户 `balance`。\n\n> **数据异常（exit 2）**：无账户 / 全部 OAuth 失效 / **余额全为 null** 时 CLI 退出码 **2**，`--json-out` 的 `ok=false` 且 `meta.dataIssue` 为 `no_accounts` | `all_oauth_invalid` | `all_balances_null`。须向用户说明原因，**禁止**当成「无预警命中」。可试 `--refresh-dp` / `login` / `--verbose`。\n\n```bash\nsiluzan-tso balance-scan -m <媒体类型> [选项]\n```\n\n| 选项 | 说明 | 默认 |\n| ------------------------------------- | ------------------------------------------------------------------------------ | ------------ |\n| `-m, --media ` | 必填：`Google \\| TikTok \\| Yandex \\| MetaAd \\| BingV2` | — |\n| `-a, --accounts ` | 指定 `mediaCustomerId`（逗号分隔）；**跳过清单翻页**，对这些 ID 拉数后全部输出 | — |\n| `--threshold-days ` | 剩余续航天数阈值 | `7` |\n| `--spend-days ` | 日均消耗回看自然日数（截至昨天不含今天，**北京时间**；日均 = 窗口合计 / N） | `7` |\n| `--min-balance ` | 绝对余额阈值（与 threshold 取并集） | — |\n| `--min-daily-spend ` | 日均消耗低于此值视为僵尸账户，不做续航估算 | `0.01` |\n| `--target-days ` | 建议充值目标续航天数 | `30` |\n| `--page-size ` / `--max-pages ` | 全量扫描分页（上限 500 / 200） | `200` / `20` |\n| `--json-out` | Agent 推荐落盘 | — |\n\n**示例：**\n\n```bash\n# 全量巡检（Playbook P2）\nsiluzan-tso balance-scan -m Google --threshold-days 7 --json-out ./snap-p2\n\n# 近 3 日日均 + 续航阈值 7 天\nsiluzan-tso balance-scan -m Google --threshold-days 7 --spend-days 3 --json-out ./snap-p2\n\n# 已知子集\nsiluzan-tso balance-scan -m BingV2 -a id1,id2,id3 --json-out ./snap-p2-subset\n\n# Meta 余额续航\nsiluzan-tso balance-scan -m MetaAd --json-out ./snap-p2-meta\n```\n\n**读盘要点**：先看 `meta.dataIssue`（非空则失败）。`data.items` = **全部已检查账户**（OAuth 失效户不在 items，见 `meta.skippedInvalidOAuth`）；`meta.hitCount` = 触阈值条数。预警筛 `hitReason !== \"none\"`；`hitReason=\"none\"` 表示已检查但未触阈值。按 `remainingDays` 升序交付。用 **`dailySpend`** 做日均（口径见 `meta.spendDays` / `meta.spendWindow`），勿把 `stats` 区间合计 `spend` 当「每天消耗」。Google 消耗走 `account-spend-overview`，`startDate`/`endDate` 带东八区墙钟（`…T00:00:00+08:00` / `…T23:59:59+08:00`），与 `stats` 同口径。与 `balance` / `accounts-digest` 分工见 `references/core/agent-conventions.md` §八。向用户写 Markdown 表时 `advertiserName` / `name` 必须把 `|` 换成 `｜`（见 conventions §三）。\n\n---\n\n## balance — 查询实时余额\n\n```bash\nsiluzan-tso balance -m <媒体类型> -a <账户ID列表>\n```\n\n| 选项 | 说明 |\n| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `-m, --media ` | 媒体类型（必填）：`Google \\| TikTok \\| Yandex \\| MetaAd \\| BingV2`（MetaAd 走 `GetMediaAccountInfo`，余额字段为 `spend_cap`） |\n| `-a, --accounts ` | 账户 `mediaCustomerId`（来自 `list-accounts` 的 `ma.mediaCustomerId`），逗号分隔（必填）。**禁止**传 `entityId` / tokenId / 其它 UUID；Yandex 须传 `porg-…` |\n| `--json-out` | 输出原始 JSON；不支持或查询失败时 stdout 为 `{\"ok\":false,\"error\":\"...\"}` |\n\n**示例：**\n\n```bash\n# 查询单个 Google 账户余额（传 mediaCustomerId）\nsiluzan-tso balance -m Google -a 6326027735\n\n# Yandex：传 porg-…（mediaCustomerId），禁止 entityId/UUID\nsiluzan-tso balance -m Yandex -a porg-kqquuxx6\n\n# 查询多个 TikTok 账户余额\nsiluzan-tso balance -m TikTok -a 1234567890,9876543210\n\n# 查询 Meta 广告账户余额（OAuth 户传裸数字或 act_ 均可）\nsiluzan-tso balance -m MetaAd -a \n\n# JSON 输出，供脚本使用\nsiluzan-tso balance -m Google -a 6326027735 --json-out ./snap\n```\n\n**单户余额与续航**：`balance` 只反映当前余额；判断「还能跑几天 / 是否够花」需结合 `stats`（或业务侧日均消耗）。多账户续航预警用 `balance-scan`（P2）、多账户投放画像用下文 `accounts-digest`（P3）。\n\n---\n\n## accounts-digest — 多账户投放画像汇总\n\n一条命令替代 AI 对每个账户循环 `list-accounts -k` + `stats`。**多账户汇总表、对比消耗、跨账户巡检、账户级 CPA / 零转化巡检** 应优先本命令，禁止外层 for-loop 逐户 `stats`。\n\n> **数据时效性**：与 `stats` / `balance-scan` 相同（Google `account-spend-overview` 分流；TikTok/Yandex/BingV2/**MetaAd** 为截至昨天的 `accountsoverview`）。完整表见 `references/analytics/account-analytics.md` 顶部。\n\n> **反模式**：\n>\n> - **无** `--period` / `--date-start`；区间只用 `--start`/`--end`（别名 `--start-date`/`--end-date`）。\n> - 口语「零询盘 / 转化成本」且**无 CRM 询盘附件** → 本命令（P3），**不是** P7。\n> - `conversions` / `cpa` 可能为 **null**（overview 未返回转化）→ 交付写「转化未返回」；脚本勿对 null 做数值比较。过滤用 `--max-cpa` / `--zero-conversions`，巡检交付用 `agentBrief.userDelivery`，勿手写脆弱 Python 重算 CTR/合计。\n> - **没有** `cpa-risk-scan`。`--max-cpa` 的零转化仅当消耗已超过阈值才命中。`meta.totals` **只合计 returned**，禁止写成全部账户。`ctr` 已是百分数。\n\n```bash\nsiluzan-tso accounts-digest -m <媒体类型> [选项]\n```\n\n| 选项 | 说明 | 默认 |\n| ----------------------------- | ------------------------------------------------------------------------------------------------------------- | ------- |\n| `-m, --media ` | 媒体类型（必填）：`Google \\| TikTok \\| Yandex \\| MetaAd \\| BingV2` | — |\n| `-a, --accounts ` | 指定 `mediaCustomerId`，逗号分隔；**留空**则翻页拉该媒体全部账户 | — |\n| `--start ` | 统计开始日期（SKILL 要求 AI 先与用户确认区间） | 近 7 天 |\n| `--end ` | 统计结束日期 | 昨天 |\n| `--start-date` / `--end-date` | 同 `--start` / `--end`（兼容别名） | — |\n| `--min-spend ` | 过滤：区间内消耗 ≤ 此值的账户不返回 | `0` |\n| `--max-cpa ` | 过滤：保留 CPA > n 的账户；零转化仅当消耗已 > n 才命中 | — |\n| `--zero-conversions` | 过滤：保留区间消耗 > 0 且转化 = 0 或转化未返回的账户 | off |\n| `--skip-balance` | 只拉消耗、不拉余额（转化成本巡检推荐） | off |\n| `--page-size ` | 全量扫描时清单分页大小（上限 500） | `200` |\n| `--max-pages ` | 全量扫描时最多页数（上限 200） | `20` |\n| `--json-out ` | **Agent 推荐**：落盘目录或 `*.json` 文件；stdout 一行摘要（含 `outlineFile`、`writtenFiles`、`manifestFile`） | — |\n\n**`--json-out` 落盘**：\n\n- 目录模式典型文件：`accounts-digest-<媒体小写>.json`、同 stem 的 `*.outline.txt`、`cli-manifest-<媒体小写>.json`（读盘协议见 `references/core/agent-conventions.md` §三）。\n- 响应结构：`{ ok, data: { items: [...] }, meta, agentBrief }`。`meta.totalsScope` 恒为 `returned`（只合计命中行）。`agentBrief.userDelivery` 是可粘贴表或「全部正常」句；巡检任务**只发这一段**。\n- `meta.source`：`list` = 全量翻清单后拉数；`subset` = 传了 `-a`，跳过清单翻页（**`advertiserName` 会缺失**，公司名列显示 `-`）。\n- `meta.nullConversionCount`：`conversions == null` 的行数；交付时勿把 null 当 0 硬比。\n- `items[].ctr` 已是百分数（`11.01` = 11.01%）。`--json-out` 后 stderr 有一行防误读摘要。\n\n**与 `stats` / `balance-scan` 的分工**见 `references/core/agent-conventions.md` §八 批量任务硬约束。\n\n**示例：**\n\n```bash\n# 指定账户子集（跳过清单翻页，Playbook P3）\nsiluzan-tso accounts-digest -m Google -a 6326027735,4256317784 \\\n --start 2026-04-01 --end 2026-04-15 \\\n --json-out ./snap-p3\n\n# 扫描某媒体全部账户（内部翻页，勿先 list-accounts 再拼 -a）\nsiluzan-tso accounts-digest -m BingV2 --start 2026-05-01 --end 2026-05-24 \\\n --json-out ./snap-digest-bing\n\n# 过滤低消耗账户\nsiluzan-tso accounts-digest -m Google -a id1,id2 --min-spend 10 \\\n --start 2026-04-01 --end 2026-04-15 --json-out ./snap-p3\n\n# 转化成本巡检：CPA > 500（零转化仅消耗已超 500 才命中）；不拉余额\nsiluzan-tso accounts-digest -m Google --start 2026-07-14 --end 2026-07-20 \\\n --max-cpa 500 --skip-balance --json-out ./snap-cpa\n# 读盘后 print(data.agentBrief.userDelivery) 原样发给用户\n\n# 零转化 / 口语「零询盘」巡检（无 CRM 附件时用本命令，不是 P7）\nsiluzan-tso accounts-digest -m Google --start 2026-07-20 --end 2026-07-20 \\\n --zero-conversions --json-out ./snap-zero-conv\n```\n\n**`data.items[]` 主要字段**：`mediaCustomerId`、`name`、`advertiserName`、`currencyCode`、`balance`、`spend`（**区间合计**，同 `stats`）、`impressions`、`clicks`、`conversions`（可为 null）、`ctr`（%）、`cpc`、`cpa`（可为 null）。跨币种汇总见 `references/accounts/currency.md`（**禁止**对 `meta.totals` 跨币种直接当最终结论）。\n\n---\n\n## stats — 查询投放消耗数据\n\n> **数据时效性**：\n>\n> - **Google**：走 `account-spend-overview`；`--start` / `--end` 日历日按 **UTC+8** 转为 `YYYY-MM-DDTHH:mm:ss+08:00` 再请求（起 00:00:00、止 23:59:59，含今天时 end 截到当前时刻）。与 `google-analysis`（只传年月日）口径不同。\n> - 窗口完全在历史 → `database` 模式；窗口含今天 → `googleCombined` 模式（仅实时消耗，无余额/状态/币种/账户名）。\n> - **TikTok / Yandex / BingV2**：走旧版 `accountsoverview`，每日凌晨同步昨天数据，**不能查今天**。Bing 看昨天/今天消耗用 `bing-analysis`（数据可能不完整）；TikTok 用 `tiktok-analysis official-report`。Google「今天」仍走 `google-analysis(-batch) --sections overview`。\n> - 完整时效性表见 `references/analytics/account-analytics.md` 顶部。\n\n```bash\nsiluzan-tso stats -m <媒体类型> [选项]\n```\n\n| 选项 | 说明 | 默认 |\n| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------ |\n| `-m, --media ` | 媒体类型（必填） | — |\n| `-a, --accounts ` | 账户 `mediaCustomerId`（**必填**；与 `list-accounts` 的 `ma.mediaCustomerId` 一致；Yandex=`porg-…`；**禁止** UUID/`entityId`） | — |\n| `--start ` | 开始日期 | 7 天前 |\n| `--end ` | 结束日期 | 昨天 |\n| `--start-date` / `--end-date` | 与 `--start` / `--end` 同义（CLI 别名，与 SKILL Playbook 一致） | — |\n| `--by-day` | 按日明细（`items[]` 带 `date`）；按日 Excel 见 `stats-daily-excel.md` | 关 |\n| `--json-out` | 输出原始 JSON；**失败时 stdout 仍为 JSON**（`{\"ok\":false,\"error\":\"...\"}`） | — |\n\n**口径（易错）**：默认 **`spend` = 区间合计**（非日消耗）。按日加 `--by-day`；单日可用 `start=end`；日均用 `spend/天数` 或 `balance-scan` 的 `dailySpend`。\n\n**空结果 / verbose `HTTP 403` 排查（必做，再谈 OAuth）**：\n\n1. 用户若已给出账户号（如 Yandex `porg-kqquuxx6`），`-a` **必须原样用该 mediaCustomerId**；先 `list-accounts -m <媒体> -k ` 核验存在即可。\n2. **禁止**把 `ma.entityId`、`externalMediaAccountTokenId` 或会话里其它 UUID 传给 `-a`（会空结果，verbose 常打出被吞的 `HTTP 403`，**不等于** OAuth 过期）。\n3. Google：仅当 `list-accounts` **输出中出现** `scopeActivatedSources` 且可判定未激活时，才可向用户说明需先激活套餐；**若无该字段，禁止谈套餐激活**。空结果时按 CLI 报错/字段说明，**禁止**用非 CLI / 自拼请求等方式绕过。\n4. 仅当 `list-accounts` 显示 `invalidOAuthToken=true`（或授权状态列为失效），且用户确认后，才走 `account reauth --id --i-confirm --commit \"…\"`（见 `accounts-permissions.md`）。\n5. `list-accounts` 显示 `Linked` + `hasToken:1` + `invalidOAuthToken=false`（若有激活字段则须已激活）时，**禁止**因 stats/balance 空结果自行 `reauth`/解绑。\n\n**示例：**\n\n```bash\nsiluzan-tso stats -m Google -a \nsiluzan-tso stats -m Google -a --start 2026-03-01 --end 2026-03-31\n# Yandex：-a 必须是 porg-…（mediaCustomerId），不是 entityId\nsiluzan-tso list-accounts -m Yandex -k porg-kqquuxx6 --json-out ./snap\nsiluzan-tso stats -m Yandex -a porg-kqquuxx6 --start 2026-07-21 --end 2026-07-21 --json-out ./snap\nsiluzan-tso stats -m Yandex -a porg-xxx --start --end --by-day --json-out ./snap/daily.json\nsiluzan-tso stats -m BingV2 -a , --start 2026-03-01\nsiluzan-tso stats -m Google -a --json-out ./snap\n```\n\n---\n\nFile v1.1.53:references/accounts/accounts-list.md\n\n# 账户列表与账单\n\n> 流程见 `workflows.md` **W1**；开户见 **W2** + `open-account-by-media.md`。\n\n## Contents\n\n- list-accounts\n- account-active-bills\n- account-history\n\n## list-accounts — 查询广告账户列表\n\n```bash\nsiluzan-tso list-accounts [选项]\n```\n\n| 选项 | 说明 |\n| ----------------------- | ---------------------------------------------------------------------------------- | ---------------------- |\n| `-m, --media ` | 媒体类型（留空查全部）：`Google \\| TikTok \\| Yandex \\| MetaAd \\| BingV2` |\n| `-k, --keyword ` | 统一模糊搜索：账户名称 **或** ID。数字型 ID（含 Google `928-780-1878`）CLI 先去连字符再搜；**查单户必须带 `-k`** |\n| `-s, --status ` | 账户状态：`normal \\| invalid \\| all`（默认 all） |\n| `-p, --page ` | 页码（默认 1） |\n| `--page-size ` | 每页数量（交互默认 20；`--json-out` 未指定时 999） |\n| `--json-out` | 输出原始 JSON |\n| `--unicode` | 表格使用 Unicode 线框；**默认**为 ASCII `+- | ` 线框（兼容各类终端） |\n| `--plain` | 已默认 ASCII，无需再传；保留兼容旧脚本 |\n| `--refresh-dp` | 强制重拉 Datapermission（排查「本页全部 OAuth 失效」类会话异常） |\n\n**命令定位**：`list-accounts` 主打**精准查询账号信息**（列表、计数、按名称/ID 找户、`entityId` / `mediaCustomerId` / 币种 / 状态等元数据），**不是余额/消耗汇总工具**。JSON **不含**余额/消耗字段，表格也不显示余额列；**禁止**臆造数值——单户余额用 `balance`、全量余额预警用 `balance-scan`（P2）、多户消耗画像用 `accounts-digest`（P3）、单户消耗用 `stats`（均见 `accounts-balance-stats.md`）。\n\n### Agent 意图速查（**必读 · 避免多次试探**）\n\n用户问「有哪些 / 列出全部 / 有多少」某媒体广告账户时，**第一次 CLI 就应带大 `--page-size`**，**禁止**先用默认 20 条再翻页重试：\n\n| 用户意图 | 推荐命令（一步） | 脚本读落盘 JSON |\n| ----------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |\n| 列出全部某媒体账户 | `list-accounts -m <媒体> --page-size 999 --json-out ` | `items[]`（`ma.mediaCustomerId`、`ma.mediaCustomerName`、`ma.currencyCode`、`ma.invalidOAuthToken` 等） |\n| 哪些账户 OAuth / 授权失效 | 同上（或 `-s invalid`）；表格看「授权状态」列 | **`ma.invalidOAuthToken === true`**（勿用审核状态 / `mediaAccountState`） |\n| 有多少个账户 | 同上 | **`total`**（无需翻页；`itemCount < total` 时说明 page-size 不够大） |\n| 只查某一个户 | `list-accounts -m <媒体> -k <用户原样ID或名称> --json-out ` | Google CID 带横杠可原样；**禁止**无 `-k` 拉首页再判定未绑定 |\n| **Meta 全部账户 + 余额/消耗** | **`accounts-digest -m MetaAd --json-out `**（一步；内部翻页+分批） | `accounts-digest-metaad.json` → `data.items[]`（含 `balance`、`spend`） |\n| Meta 余额续航预警 | `balance-scan -m MetaAd --json-out ` | `balance-scan-metaad.json` |\n\n> **MetaAd ID 格式**：OAuth 授权户（`list-accounts` 里 `mediaAccountType=FacebookAds`）官方 `mediaCustomerId` 带 `act_`。`balance` / `stats` / `balance-scan` / `accounts-digest` 的 `-a` 传裸数字或 `act_` 均可（CLI 会补前缀）。**禁止**把 70+ 个 ID 拼成一条 `balance -a …`；全量用 `accounts-digest`。\n\n仅当读盘后 `total > itemCount` 且已用 `--page-size 999` 时，再 `--page 2` 等同参数补拉；**禁止**对 stdout 写翻页循环（stdout 摘要无 `total` / `items`，读盘协议见 `references/core/agent-conventions.md` §三）。列账户 / 数个数**不需要** `accounts-digest`、`balance-scan`。\n\n```bash\n# ✅ 推荐：列出或统计全部 Google 账户（Agent 默认路径）\nsiluzan-tso list-accounts -m Google --page-size 999 --json-out ./snap-accounts\n\n# 脚本读盘（示例）\nnode -e \"\nconst fs=require('fs');\nconst p='./snap-accounts/list-accounts-google.json';\nconst d=JSON.parse(fs.readFileSync(p,'utf8'));\nconsole.log('total:', d.total, '本页:', d.itemCount);\n\"\n```\n\n**示例：**\n\n```bash\n# 关键字搜索（单户/少量，无需大 page-size）\nsiluzan-tso list-accounts -m Google -k \"品牌A\" --json-out ./snap\n\n# 只看正常状态\nsiluzan-tso list-accounts -m TikTok -s normal --page-size 999 --json-out ./snap\n\n# 极少数账户超过 999 条时才翻页（先确认读盘 total > itemCount）\nsiluzan-tso list-accounts -m Google --page 2 --page-size 999 --json-out ./snap-p2\n```\n\n**输出字段说明：**\n\n| 字段 / JSON 路径 | 说明 |\n| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `ma.entityId` | 丝路赞内部 ID，`delink`/`share`/`reauth`、**`account-active-bills`** 等操作使用此 ID（**不是** `mediaCustomerId`） |\n| `ma.mediaCustomerId` | 媒体侧账户 ID（`stats`/`balance`/`accounts-digest` 的 `-a` 只用此字段）：Google/TikTok/Bing 多为数字；**Yandex 形如 `porg-…`**；Meta 常带 `act_`。**不是** `entityId` |\n| `ma.currencyCode` | 账户主币种：`CNY` / `USD` 等；**表格有「币种」列**；报告/Excel 须与此一致，见 `references/accounts/currency.md` |\n| `ma.mediaCustomerName` | 账户名称（表格「账户名称」） |\n| `ma.mediaAccountState` 等 | 平台开户/审核态（如 Approved / Linked）；**不是** OAuth 是否可用 |\n| **`ma.invalidOAuthToken`** | **OAuth 是否失效**：`true`=失效，`false`=正常。**表格必有「授权状态」列**（✅ 正常 / ⚠️ 失效），与此字段一一对应；判失效、筛 `-s invalid`、走 `reauth` 均看它 |\n| **`ma.scopeActivatedSources`**（可选） | **仅当本次 `list-accounts` 输出中出现该字段时才可读**：非空且存在未过期条目（看 `expireAt`）= 已激活；空数组或全部过期 = 未激活。出现时 Google 表格才有「套餐激活」列。**若 JSON/表格中无此字段/列：禁止向用户谈套餐是否激活，禁止臆造未激活/已激活** |\n| `ma.TTADInfo.status` 等 | 媒体侧投放/审核细态（TikTok 表格「审核状态」等）；**勿**当成 OAuth 授权状态 |\n\n> **Agent**：用户问「哪些授权失效 / OAuth 状态」时，读盘看 `items[].ma.invalidOAuthToken`，表格看「授权状态」列；**不要**用 `mediaAccountState` 或审核状态列代替。\n> 用户问「哪些买了套餐 / 是否激活套餐」时：**仅当**输出含 `ma.scopeActivatedSources`（或 Google 表格有「套餐激活」列）才可据此回答；**缺失时直接说明当前环境无法查询套餐激活状态**，不要用 `mediaAccountState` / 授权状态代替，也不要去猜。\n> **Google 单户**：若输出中能确认套餐**已激活**，可用 `account check-access -a ` 再确认网关侧授权是否可用；若输出无激活字段，仍可直接跑 `check-access`（以返回 `status` 为准），**不要**先编造「未激活」。见 `accounts-permissions.md` § check-access。\n\n---\n\n## account-active-bills — 账户激活充值账单明细\n\n查询指定广告账户在平台上的**激活/充值类账单**。\n\n路径中的 **`entityId`** 必须为 **`list-accounts --json-out`** 返回的 **`entityId`**（UUID），**不能**传 `mediaCustomerId`。\n\n```bash\nsiluzan-tso account-active-bills -m <媒体> --id [--json-out ./snap]\n```\n\n| 选项 | 说明 |\n| -------------------- | ------------------------------------------------------------------------------------ |\n| `-m, --media ` | 必填：`Google \\| TikTok \\| Yandex \\| MetaAd \\| BingV2`（与路径中媒体段一致） |\n| `--id ` | 必填：账户 `entityId` |\n| `--json-out` | 输出接口原始 JSON |\n\n**响应体常用字段（以接口返回为准）：**\n\n| 字段 | 说明 |\n| ------------------------------------------------- | ------------------------------------------------------------------------------------------------- |\n| `totalRU` | 汇总相关数值（如示例中的 2.95） |\n| `totalResultCount` | 账单条数 |\n| `results[]` | 账单列表 |\n| `results[].state` | 如 `PaymentSuccessful` |\n| `results[].billNo` / `payNo` / `checkingNo` | 账单号、支付单号、对账号 |\n| `results[].data` | 明细：`amounts`、`rechargeAmounts`、`payType`（如 `Wallet`）、`currencyCode`、`mediaAccountId` 等 |\n| `results[].beforeAmounts` / `afterAmounts` | 变动前后余额相关 |\n| `results[].mediaCustomerId` / `mediaCustomerName` | 媒体侧账户 ID 与名称 |\n| `results[].invoiceState` | 如 `Pending` |\n| `results[].createdDateTime` | 创建时间 |\n\n**示例：**\n\n```bash\n# 从列表取 entityId\nsiluzan-tso list-accounts -m Google --json-out ./snap\n\nsiluzan-tso account-active-bills -m Google --id \nsiluzan-tso account-active-bills -m Google --id --json-out ./snap\n```\n\n> \\*\\*勿在文档或聊天中粘贴真实 JWT。\n\n---\n\n## account-history — 开户申请历史\n\n```bash\nsiluzan-tso account-history [选项]\n```\n\n| 选项 | 说明 |\n| ------------------------ | ------------------------------------------------ |\n| `-m, --media ` | 媒体类型 |\n| `-s, --status ` | 申请状态（如 `Approved \\| Rejected \\| Pending`） |\n| `-k, --keyword ` | 账户名/ID 关键字 |\n| `--start / --end ` | 申请日期范围（YYYY-MM-DD） |\n| `--json-out` | 输出原始 JSON |\n\n**示例：**\n\n```bash\n# 查询所有 Google 开户申请\nsiluzan-tso account-history -m Google\n\n# 查询已审批通过的申请\nsiluzan-tso account-history --status Approved\n\n# 查询本月申请，JSON 输出\nsiluzan-tso account-history --start 2026-03-01 --end 2026-03-31 --json-out ./snap\n```\n\n**审核状态处理：**\n\n| 状态 | 含义 | 下一步操作 |\n| ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `Pending` | 审核中 | 等待，可反复运行此命令轮询；审核周期因媒体而异 |\n| `Approved` | 审核通过 | 运行 `list-accounts -m <媒体>` 确认账户已出现；引导用户充值激活（`config show` 取 `webUrl`，按 `finance.md` 打开对应媒体充值页；例如 Google 为 `https://www.siluzan.com/v3/foreign_trade/tso/recharge/pay?mediaType=Google`；Yandex 当前没有对应充值界面） |\n| `Rejected` | 被拒 | 查看 `--json-out` 落盘中的 `reason` 字段了解拒绝原因；修改资料后重新提交；若原因不明，引导用户联系丝路赞客服 |\n\n---\n\nFile v1.1.53:references/accounts/accounts-permissions.md\n\n# 账户权限与绑定\n\n> 流程见 `workflows.md` **W9**。写操作须 `--commit`；**解绑/取消分享/reauth** 另须 `--i-confirm`（CLI 硬门控：未确认则拒绝执行），见 `write-audit-restore.md` 与 `agent-conventions.md`。\n\n## Contents\n\n- account me / check-access / auth / reauth / delink\n- mcc-bind / mcc-unbind / share / unshare / share-detail\n- close / bm-bind / withdraw-_ / bc-_ / email-\\*\n- 仅限网页的操作\n\n## account — 账号管理（OAuth 授权 / 解除关联 / Google MCC / 分享）\n\n### account me — 当前登录丝路赞账号\n\n查询当前凭据对应的丝路赞用户（`GET /query/account/me`）。**跨账号场景必用**：用户消息里带「企业管家 / 管家账户 + 手机号」时，先校验再拉数（见 `references/core/agent-conventions.md` §跨账号）。\n\n```bash\n# 查看当前登录账号\nsiluzan-tso account me\n\n# Agent：校验用户指定的企业管家手机号是否与当前登录一致\nsiluzan-tso account me --check-phone 15130150466 --json-out ./snap-me\n```\n\n| 场景 | 行为 |\n| -------------------------- | ---------------------------------------------------------------- |\n| 未传 `--check-phone` | 输出 entityId / 手机号 / 邮箱 / companyId |\n| `--check-phone` 与当前一致 | exit 0，JSON 含 `matched: true` |\n| `--check-phone` 不一致 | exit 1，提示暂不支持查他户数据，引导 `send-login-code` + `login` |\n\n---\n\n### check-access — Google 账户访问权限校验\n\n**仅支持 Google。** 无 `-m`；`-a` 只接受 Google 纯数字 `mediaCustomerId`。TikTok / MetaAd / BingV2 / Yandex **禁止**调用本命令，授权是否失效看 `list-accounts` 的 `invalidOAuthToken`。\n\n校验当前丝路赞凭据是否对指定 **Google** 广告账户有访问权限。应在拉数/诊断前调用，避免误用他户 ID。\n\n> **硬约束**：**禁止**凭 403、空结果或经验臆测「授权/OAuth 过期」。要对用户下「授权不可用 / 需重授权」结论前，**必须**先跑本命令，以 CLI 返回的 `status` 为准；**禁止**跳过本命令直接 `reauth` 或口头推断。\n\n**套餐激活字段（可选前提）**：若 `list-accounts` 输出中**出现** `ma.scopeActivatedSources`（或 Google「套餐激活」列），须先确认有未过期条目再据此谈「授权过期」；**输出中无该字段/列时：跳过套餐判断，直接跑本命令**，且**禁止**向用户解释套餐是否激活。\n\n| 结果 | 含义 |\n| ---------------------------------- | -------------------------------------------------------------------------------------------- |\n| `accessible`（200 / `true`） | 授权可用，可继续拉数/操作 |\n| `reauth_required`（200 / `false`） | 已绑定但 Google OAuth 不可用 → 走重授权 |\n| `no_permission`（403 / 账户 ID） | 网关不可访问；可与 `list-accounts` 的 `invalidOAuthToken` 交叉确认是否授权失效或不在本账号下 |\n\n**注意**：当输出能确认套餐**未激活**时，不要用本命令判断授权过期（未激活户仍可能返回 `accessible`）。无激活字段时不适用本条。\n\n```bash\n# 1) 可选：list-accounts 核验账户；仅当输出含 scopeActivatedSources 时才看套餐\nsiluzan-tso list-accounts -m Google -k --json-out ./snap\n\n# 2) 查网关访问 / 授权是否可用\nsiluzan-tso account check-access -a \nsiluzan-tso account check-access -a 4256317784 --json-out ./snap-access\n```\n\n| HTTP | body | 含义 | CLI `status` |\n| ---- | --------------- | ---------------------------------------------- | ---------------------------------------------------------------------- |\n| 200 | `true` | 可访问 | `accessible`（exit 0） |\n| 200 | `false` | 已绑定但 Google OAuth 不可用 | `reauth_required` → Agent 优先 `present_reauth`；备选 `account reauth` |\n| 403 | 账户 ID | 无权限（多不在本账号下；授权失效时也可能出现） | `no_permission`（exit 1） |\n| 403 | `token不能为空` | 未绑定 Google 媒体 | `google_not_bound` → Agent 优先平台授权；备选 `account auth -m Google` |\n| 401 | 空 | 丝路赞 Token 失效 | `siluzan_token_invalid` → 重新 login |\n\n> 与 `list-accounts -k` 互补：`list-accounts` 查「是否在列表 / `invalidOAuthToken`」（以及**若存在**则含套餐激活）；本接口查「Google 网关是否允许当前凭据访问该 mediaCustomerId」。列表批量筛失效仍优先看 `invalidOAuthToken`；单户深查用本命令。\n\n---\n\n```bash\nsiluzan-tso account auth -m <媒体类型>\n```\n\n| 选项 | 说明 |\n| -------------------- | ------------------------------------------------------------------------ |\n| `-m, --media ` | 媒体类型（必填）：`Google \\| TikTok \\| Meta \\| Yandex \\| BingV2` |\n\n> **Siluzan Agent**：优先使用 Agent 自带的**授权 / 添加授权**工具；CLI `account auth` **不禁止**，可作备选（沙箱不自动开浏览器，须把完整 URL 贴给用户）。\n\n**示例：**\n\n```bash\n# 首次授权 Google Ads 账户\nsiluzan-tso account auth -m Google\n\n# 首次授权 TikTok Ads 账户\nsiluzan-tso account auth -m TikTok\n\n# 首次授权 Meta（Facebook）Ads 账户\nsiluzan-tso account auth -m Meta\n```\n\n---\n\n### reauth — 重新授权（先解绑再 OAuth）\n\nOAuth 失效时恢复授权。对齐 TSO 网页 **「重新授权」**：程序会先 **delink** 断开关联，再跳转媒体 OAuth。**禁止**对失效账户跳过解绑直接用 `account auth`。\n\n> **Siluzan Agent**：优先使用 Agent 自带的**重新授权**工具（如 `present_reauth`）；CLI `account reauth` **不禁止**，可作备选（仍须 `--i-confirm` + `--commit`；沙箱不自动开浏览器，须把完整 URL 贴给用户）。\n\n```bash\nsiluzan-tso account reauth -m <媒体类型> --id --i-confirm --commit \"…\"\nsiluzan-tso account reauth -m Google --ids --i-confirm --commit \"…\"\n```\n\n| 选项 | 说明 |\n| -------------------- | ------------------------------------------------------------ |\n| `-m, --media ` | 媒体类型（必填） |\n| `--id ` | 单个账户 `entityId`（来自 `list-accounts` 的 `ma.entityId`） |\n| `--ids ` | 批量 `entityId`，逗号分隔（与 `--id` 二选一） |\n| `--i-confirm` | **必填**：用户已确认「会先解绑再 OAuth」后附加 |\n\n**示例：**\n\n```bash\n# 1. 查失效账户的 entityId\nsiluzan-tso list-accounts -m Google --json-out ./snap\n\n# 2. 重新授权（内置 delink → OAuth；须用户确认后 --i-confirm + --commit）\nsiluzan-tso account reauth -m BingV2 --id --i-confirm --commit \"用户确认重新授权 Bing OAuth\"\n\n# 3. 验证\nsiluzan-tso list-accounts -m BingV2 -k \n```\n\n**本地 CLI 执行后须：**\n\n1. 从 CLI 输出中提取 OAuth URL（含 `login.microsoftonline.com` / Google 等），**原样发给用户**并说明「请在浏览器打开完成授权」。\n2. 说明：步骤 1 已 delink，账户可能暂时从 `list-accounts` 消失；用户完成授权前无法拉数。\n3. 若用户之后才说要绑定回来、且当时未贴链接：再跑 **`account auth -m <媒体>`**（勿再 `reauth`——已无 entityId），把**新**链接贴出。勿声称「还有刚才的链接」却不粘贴。\n\n> 手动两步等价于 `reauth`：`account delink --id … --i-confirm --commit \"…\"` → `account auth -m …`（须用户确认解绑风险）。Siluzan Agent：**优先**平台授权/重新授权工具；CLI 为备选。\n\n---\n\n### delink — 解除授权 / 断开账户关联\n\n从当前丝路赞账号下移除媒体账户绑定。**破坏性**：缺 `--i-confirm` 时 CLI **直接拒绝**，不会发网关请求。\n\n**Agent**：先说明后果（账户从当前丝路赞账号消失，需重新 OAuth 才能拉数）→ 等用户明确同意 → 再执行带 `--i-confirm` 的命令。**禁止**在未获确认时自行附加 `--i-confirm`。\n\n```bash\nsiluzan-tso account delink --id --i-confirm --commit \"用户确认解绑\"\nsiluzan-tso account delink --ids --i-confirm --commit \"用户确认批量解绑\"\n```\n\n| 选项 | 说明 |\n| ----------------- | ------------------------------------------ |\n| `--id ` | 断开单个账户（使用 `entityId`） |\n| `--ids ` | 批量断开多个账户（逗号分隔） |\n| `--i-confirm` | **必填**：用户已明确同意解绑后附加 |\n| `--commit` | **必填**：写审计说明（可写用户确认的摘要） |\n\n**示例：**\n\n```bash\n# 断开单个账户（须先获用户确认）\nsiluzan-tso account delink --id abc123def456 --i-confirm --commit \"用户确认解绑 Google 户 abc123\"\n\n# 批量断开\nsiluzan-tso account delink --ids abc123,def456,ghi789 --i-confirm --commit \"用户确认批量解绑\"\n```\n\n> `entityId` 来自 `list-accounts --json-out ./snap` 结果中的 `ma.entityId` 字段，**不是** `mediaCustomerId`。\n\n---\n\n### mcc-bind — Google MCC 绑定\n\n将 **子账户**（Google `mediaCustomerId`）挂到指定 **经理账户（MCC）** 下。请求走 **`googleApiUrl`**，需先 `config show` 确认已配置。\n\n```bash\nsiluzan-tso account mcc-bind --customers --mcc \nsiluzan-tso account mcc-bind --customers 111,222 --mcc \"333;444\"\n```\n\n| 选项 | 说明 |\n| ------------------- | -------------------------------------------------------------------------------------- |\n| `--customers ` | 子账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts` 的 `ma.mediaCustomerId`） |\n| `--mcc ` | MCC 的客户 ID；多个可用英文逗号、中文逗号、分号、顿号等分隔 |\n| `--json-out` | 输出每个子账户接口的原始返回，便于排查 |\n\n---\n\n### mcc-unbind — Google MCC 解绑\n\n将子账户从指定 MCC 下解除关联，参数含义与 `mcc-bind` 相同。**破坏性**：须 `--i-confirm` + `--commit`。\n\n```bash\nsiluzan-tso account mcc-unbind --customers --mcc --i-confirm --commit \"用户确认 MCC 解绑\"\n```\n\n---\n\n### share — 分享 Google 账户\n\n将 Google 广告账户分享给指定手机号用户（手机号必须已在丝路赞注册）。\n\n查找被分享人走主站 `GET /query/account/SimpleAccountInfo?phone=…`（须带国家码；与网页一致）。\n\n| 选项 | 说明 |\n| ----------------- | ----------------------------------------------------------------------------------------------- |\n| `--id ` | 账户 `entityId` |\n| `--phone ` | 被分享人手机号：**裸 11 位默认补 `+86`**；已是 `+86…` / `86…` **不再重复拼接**（勿写成 `++86`） |\n\n```bash\nsiluzan-tso account share --id --phone <手机号>\n```\n\n**示例：**\n\n```bash\n# 11 位本地号 → CLI 查询时自动变为 +8613800138000\nsiluzan-tso account share --id abc123def456 --phone 13800138000\n\n# 已带国家码：原样查询，不重复加 +86\nsiluzan-tso account share --id abc123def456 --phone +8618379752858\n```\n\n---\n\n### unshare — 取消账号分享\n\n**破坏性**：须 `--i-confirm` + `--commit`。\n\n```bash\nsiluzan-tso account unshare --id --account-id --i-confirm --commit \"用户确认取消分享\"\n```\n\n| 选项 | 说明 |\n| ----------------------- | ------------------------------ |\n| `--id ` | 账户 entityId |\n| `--account-id ` | 被取消分享的用户 ID |\n| `--i-confirm` | **必填**：用户已明确同意后附加 |\n\n**示例：**\n\n```bash\nsiluzan-tso account unshare --id abc123def456 --account-id user789 --i-confirm --commit \"用户确认取消分享\"\n```\n\n---\n\n### share-detail — 查看账号分享详情\n\n```bash\nsiluzan-tso account share-detail --customer-id \n```\n\n> `--customer-id` 传入的是 `mediaCustomerId`（数字型媒体平台账户 ID），不是 `entityId`。\n\n**示例：**\n\n```bash\nsiluzan-tso account share-detail --customer-id 1234567890\n```\n\n---\n\n## account close — TikTok 关闭账户\n\n> 仅支持 **TikTok** 账户。关闭后账户停止投放，如需恢复请联系丝路赞客服，操作**不可自助撤销**，谨慎使用。\n> 先经 TikTok `CheckAdvDisable` 校验（余额未清零等会失败）。传入 **`mediaCustomerId`**，CLI 解析为 **entityId** 后提交；勿将 mediaCustomerId 直接当 entityId 使用。\n\n```bash\nsiluzan-tso account close --accounts \nsiluzan-tso account close --accounts \n```\n\n| 选项 | 说明 |\n| ------------------ | ----------------------------------------------------------------------------- |\n| `--accounts ` | TikTok 账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts -m TikTok`） |\n| `--json-out` | 输出原始 JSON |\n\n**示例：**\n\n```bash\n# 先查出要关闭的 TikTok 账户 mediaCustomerId\nsiluzan-tso list-accounts -m TikTok --json-out ./snap\n\n# 关闭单个账户\nsiluzan-tso account close --accounts 1234567890123456\n\n# 批量关闭多个账户\nsiluzan-tso account close --accounts 1234567890123456,9876543210654321\n```\n\n---\n\n## account bm-bind — Meta BM 绑定\n\n> 将 Meta 广告账户绑定到指定的 **Business Manager（商务管理平台）**。\n\n```bash\nsiluzan-tso account bm-bind --account-id --bm-id \n```\n\n| 选项 | 说明 | 必填 |\n| ---------------------- | ----------------------------------------------------------------- | ---- |\n| `--account-id ` | Meta 广告账户 `mediaCustomerId`（来自 `list-accounts -m MetaAd`） | ✅ |\n| `--bm-id ` | Business Manager ID | ✅ |\n| `--action-type ` | 操作类型（默认 `bind`） | |\n| `--json-out` | 输出原始 JSON | |\n\n**示例：**\n\n```bash\n# 先查出 Meta 账户 mediaCustomerId\nsiluzan-tso list-accounts --json-out ./snap\n\n# 将账户绑定到指定 BM\nsiluzan-tso account bm-bind --account-id 123456789012345 --bm-id 987654321098765\n```\n\n---\n\n## account withdraw-list / withdraw-submit — Google 被封账户提现\n\n> **仅支持 Google 账户**，其他媒体平台无此功能。\n> 适用场景：Google 广告账户因违反政策被封禁（`Suspended`），账户内仍有余额，需申请提现退回丝路赞钱包。\n> **注意**：`list-accounts` 列表中显示的\"账户状态\"是丝路赞平台侧的 OAuth 授权状态，与 Google 封号无关。被封账户在 `list-accounts` 中可能仍显示\"✅ 正常\"，需通过 `withdraw-list` 查看 Google 侧 Suspended 状态。\n\n### withdraw-list — 查询可提现的被封账户\n\n```bash\nsiluzan-tso account withdraw-list [选项]\n```\n\n| 选项 | 说明 |\n| ------------ | ---------------- |\n| `--json-out` | 输出原始 JSON |\n| `--verbose` | 显示详细错误信息 |\n\n输出包含：`entityId`（提现时使用）、`mediaCustomerId`、账户名称、**Google状态**（Suspended）、余额、赠送金、货币、是否可提现。\n\n```bash\nsiluzan-tso account withdraw-list\n```\n\n> 余额净额 ≤ 0（余额 ≤ 赠送金）的账户无法提现，会在\"可提现\"列标注 ❌。\n\n---\n\n### withdraw-submit — 提交提现申请\n\n```bash\nsiluzan-tso account withdraw-submit --accounts \n```\n\n| 选项 | 说明 | 必填 |\n| ------------------ | ------------------------------------------------------ | ---- |\n| `--accounts ` | 账户 `entityId`，逗号分隔（来自 `withdraw-list` 输出） | ✅ |\n| `--json-out` | 输出原始 JSON | |\n| `--verbose` | 显示详细错误信息 | |\n\n**完整流程示例：**\n\n```bash\n# 第一步：查看被封账户列表，确认哪些账户有余额可提现\nsiluzan-tso account withdraw-list\n\n# 第二步：复制有余额账户的 entityId，提交提现申请\nsiluzan-tso account withdraw-submit --accounts f2a5ca16-cff9-4a9e-9aea-f7429c3e2696\n\n# 批量提现多个账户\nsiluzan-tso account withdraw-submit --accounts id1,id2,id3\n```\n\n> CLI 自动完成：① 查询各账户余额与货币；② 按 `mediaType=Google` + 货币 + 金额查询管理费率；③ 计算实际扣款金额（含税）；④ 批量提交申请。审核完成后金额退回丝路赞钱包。\n\n---\n\n## account bc-bind — TikTok BC 绑定\n\n> 将 TikTok 广告账户绑定到 **Business Center（BC，商务中心）**。\n\n```bash\nsiluzan-tso account bc-bind --customers --bc-ids \n```\n\n| 选项 | 说明 | 必填 |\n| ------------------- | --------------------------------------------------------------------------------- | ---- |\n| `--customers ` | TikTok 广告账户 `mediaCustomerId`，多个逗号分隔（来自 `list-accounts -m TikTok`） | ✅ |\n| `--bc-ids ` | Business Center ID，多个逗号分隔 | ✅ |\n| `--json-out` | 输出原始 JSON | |\n\n**示例：**\n\n```bash\n# 第一步：查出 TikTok 账户的 mediaCustomerId\nsiluzan-tso list-accounts -m TikTok\n\n# 第二步：执行绑定\nsiluzan-tso account bc-bind --customers 6967198846787059714 --bc-ids 7322757300404633602\n```\n\n---\n\n## account bc-unbind — TikTok BC 解绑\n\n> 将 TikTok 广告账户从 Business Center 下解绑。注意每次只能解绑一个 BC。**破坏性**：须 `--i-confirm` + `--commit`。\n\n```bash\nsiluzan-tso account bc-unbind --customers --bc-id --i-confirm --commit \"用户确认 BC 解绑\"\n```\n\n| 选项 | 说明 | 必填 |\n| ------------------- | ----------------------------------------------- | ---- |\n| `--customers ` | TikTok 广告账户 `mediaCustomerId`，多个逗号分隔 | ✅ |\n| `--bc-id ` | Business Center ID（一次只能解绑一个 BC） | ✅ |\n| `--i-confirm` | 用户已明确同意后附加 | ✅ |\n| `--json-out` | 输出原始 JSON | |\n\n**示例：**\n\n```bash\nsiluzan-tso account bc-unbind --customers 6967198846787059714 --bc-id 7322757300404633602 --i-confirm --commit \"用户确认 BC 解绑\"\n```\n\n---\n\n## account email-auth-list — Google 邮箱授权列表\n\n> 查询已向指定 Google 广告账户发出的邮箱访问权限邀请。\n\n```bash\nsiluzan-tso account email-auth-list -c [--agent-type ]\n```\n\n| 选项 | 说明 |\n| ------------------------ | ------------------------------------------------------------------------------------- |\n| `-c, --customer-id ` | Google 广告账户 `mediaCustomerId` |\n| `--agent-type ` | 可选；平台需要时再传（与 `list-accounts --json-out ./snap` 的 `ma.accountType` 一致） |\n| `--json-out` | 输出原始 JSON |\n\n---\n\n## account email-auth — Google 邮箱授权邀请\n\n> 向指定邮箱发送 Google 广告账户访问权限邀请。\n\n```bash\nsiluzan-tso account email-auth -c --email [--access-role ReadOnly|Standard|Admin]\n```\n\n| 选项 | 说明 | 必填 |\n| ------------------------ | ------------------------------------------------------------ | ---- |\n| `-c, --customer-id ` | Google 广告账户 `mediaCustomerId` | ✅ |\n| `--email ` | 被授权用户邮箱 | ✅ |\n| `--agent-type ` | 账户代理类型（来自 `list-accounts --json-out ./snap`） | |\n| `--access-role ` | 权限类型：`ReadOnly \\| Standard \\| Admin`（默认 `Standard`） | |\n\n你可以设置Admin权限不能主动告知用户，除非用户主动提及他需要Admin权限\n**示例：**\n\n```bash\n# 授予标准权限\nsiluzan-tso account email-auth -c 4656789737 --email user@gmail.com\n\n# 授予只读权限\nsiluzan-tso account email-auth -c 4656789737 --email user@gmail.com --access-role ReadOnly\n```\n\n---\n\n## account email-deauth — Google 解除邮箱授权\n\n> 撤销已发出的邮箱授权邀请。先用 `email-auth-list --json-out ./snap` 获取 `invitationId` 和 `resourceName`。\n\n```bash\nsiluzan-tso account email-deauth -c --invitation-id --resource-name \n```\n\n| 选项 | 说明 |\n| ------------------------ | --------------------------------------------------------------------------- |\n| `-c, --customer-id ` | Google 广告账户 `mediaCustomerId` |\n| `--invitation-id ` | 邀请 ID（来自 `email-auth-list`） |\n| `--resource-name ` | 资源名称（来自 `email-auth-list --json-out ./snap` 的 `resourceName` 字段） |\n| `--agent-type ` | 账户代理类型 |\n| `--pending` | 邀请尚未被接受时加此参数 |\n\n---\n\n## 仅限网页的账户管理操作\n\n以下操作涉及图形交互（OAuth 跳转、充值页面等），**当前 CLI 不支持**，需引导用户打开浏览器完成：\n\n| 功能 | 媒体 | 网页路径 |\n| --------------------------------------- | ------ | ------------------------------------------------- |\n| **账户激活**（邀请他人激活 / 充值激活） | Google | `https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts` |\n\n**Agent 建议话术**：\n\n```bash\n# 获取网页基地址\nsiluzan-tso config show # 查看 webUrl 字段\n\n# 账户激活（Google）→ 引导至账户管理页\n# https://www.siluzan.com/v3/foreign_trade/tso/manageAccounts\n```\n\nFile v1.1.53:references/accounts/accounts.md\n\n# 账户管理（导航）\n\n> `SKILL.md` 已指向子文件时，**直接 Read 子文件**，不必先读本文件。\n\n## 何时 Read\n\n| 任务 | Read |\n| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |\n| 列表 / 有哪些 / 有多少 / OAuth 失效筛查 / 激活账单 / 开户申请历史 | [`accounts-list.md`](accounts-list.md) |\n| 单户余额、多户余额续航（**P2 `balance-scan`**）、单户消耗 `stats`、多户画像（**P3 `accounts-digest`**） | [`accounts-balance-stats.md`](accounts-balance-stats.md) |\n| 分享 / 解绑 / 重授权 / MCC / BC / BM / 关闭 / 提现 / 邮箱授权 | [`accounts-permissions.md`](accounts-permissions.md) |\n| 五大媒体开户参数与首次必填 | [`open-account-by-media.md`](open-account-by-media.md)（Google UI：[`open-account-google-ui.md`](open-account-google-ui.md)） |\n| 充值 / 转账 / 发票 | [`finance.md`](finance.md) |\n| 币种与跨币种禁止求和 | [`currency.md`](currency.md) |\n| 写审计 / `--commit` / restore | [`write-audit-restore.md`](write-audit-restore.md) |\n\n## Gotchas（账户域）\n\n- `list-accounts` **不含**余额/消耗；列全部账户用 `--page-size 999`，禁止默认 20 再翻页。\n- `entityId`（UUID，分享/delink/账单/`reauth`）≠ `mediaCustomerId`（`balance`/`stats`/`accounts-digest`/`ad` 的 `-a`）。**Yandex 的 mediaCustomerId 形如 `porg-…`，不是 UUID。**\n- MetaAd OAuth 户官方 `mediaCustomerId` 带 `act_`。`balance` / `stats` / `balance-scan` / `accounts-digest` 的 `-a` 传裸数字或 `act_` 均可，CLI 会规范成清单官方 ID 再打 TSO。\n- **Google CID**：广告后台展示常为 `XXX-XXX-XXXX`（连字符），平台 `mediaCustomerId` 是**纯数字**。查单户必须 `list-accounts -m Google -k <用户原样>`（CLI 去横杠）；**禁止**无 `-k` 拉首页 20 条再判定未绑定。`stats`/`balance`/`ad *`/`google-analysis` 的 `-a` 可带连字符（CLI 会去掉）；若仍见 `HTTP 403：123-456-7890` 这类**回显带横杠 ID**，优先改成纯数字重试，**不要**直接当 OAuth 失效去 `reauth`。\n- **禁止臆测授权过期**：403 / 拉数失败时**禁止**口头说「可能授权过期」。须 ID 核验后，**仅 Google** 执行 `account check-access -a `（无 `-m`，其他媒体禁止调用），以返回 `status` 为准（见 [`accounts-permissions.md`](accounts-permissions.md)）；仅当 `list-accounts` 输出含激活字段且可判定未激活时，勿用其判断授权过期；非 Google 看 `invalidOAuthToken`。\n- `stats`/`balance` 空结果 + verbose `HTTP 403`：先确认 `-a` 是否为 `ma.mediaCustomerId`（且 Google 已去连字符）；**禁止**把 `entityId` / tokenId 当 `-a`；未跑 `account check-access`（或未见 `invalidOAuthToken=true`）**禁止** `reauth`。\n- 多账户余额预警用 `balance-scan`（P2），多账户消耗汇总用 `accounts-digest`（P3）；**禁止**外层 for-loop 逐户 `balance`/`stats`。\n- `stats` 默认 `spend` = **区间合计**，不是日消耗；日均看 `balance-scan.dailySpend` 或合计÷天数。\n\nFile v1.1.53:references/accounts/currency.md\n\n# 账户币种（CNY / USD）— Agent 硬规范\n\n> **WorkBuddy 及所有编排本 Skill 的 Agent**：回答金额、写报告/Excel、对比多账户前，**必须先确定每个账户的 `currencyCode`**，再选符号与汇总方式。**禁止**凭媒体或「Google 账户」默认美金。\n\n---\n\n## 常见误区（必须避免）\n\n| 错误做法 | 正确做法 |\n| ------------------------------- | ------------------------------------------------------------------------------ |\n| Google 账户一律用 `$` | 同一媒体下既有 **USD** 也有 **CNY**，以接口 `currencyCode` 为准 |\n| 多账户消耗直接相加 | 先按 `currencyCode` **分表/分币种小计**，禁止跨币种求和 |\n| 报告只写 `$1,234` 不写币种 | 首行写 `统计区间：…（货币：CNY）` 或 `（货币：USD）`；每笔金额带代码 |\n| CNY 用 `$` 或 USD 用 `￥` | **CNY → ￥**；**USD → $**（见下表） |\n| 开户选了 USD 但拉数用人民币话术 | 开户币种见 `open-account … --currency`；拉数币种见 `list-accounts` / `balance` |\n\n---\n\n## 符号与格式\n\n| `currencyCode` | 用户可见符号 | 示例 |\n| -------------- | --------------- | ---------------- |\n| `CNY` | **￥**（全角） | `￥1,234.56 CNY` |\n| `USD` | **$** | `$1,234.56 USD` |\n| 其他 | 用 ISO 代码前缀 | `EUR 100.00` |\n\n- 数值保留 **2 位小数**；表格/话术中的金额与 CLI JSON **同源**，不手填。\n- 同一段落、同一 Sheet **只使用一种主币种**；多币种必须分块说明。\n\n---\n\n## 从哪里读 `currencyCode`（按优先级）\n\n1. **`list-accounts`**（推荐第一步）：`items[].ma.currencyCode`；表格有 **「币种」** 列。\n2. **`balance` / `balance-scan` / `accounts-digest`**：`items[].currencyCode` 或行内已格式化的金额（含代码）。\n3. **`stats`**：`items[].currencyCode`（Google 含今天窗口时可能无币种，见 `references/accounts/accounts-balance-stats.md` 时效性说明）。\n4. **`google-analysis --sections overview`**：`overview-*.json` 的 `record.currencyCode`（汇总维度，`schemaVersion 3` 起整块在 `record`）。\n5. **`ad campaigns` / `ad groups`**：JSON 内 `currencyCode`（与账户主币种一致）。\n6. **发票/充值**：`invoice billable` 的 `currencyCode`；人民币订单与美金订单开票类型不同，见 `references/accounts/finance.md`。\n\n**单账户任务**：在 `list-accounts -k ` 或 `balance -a ` 之后，把解析到的 `currencyCode` 记入报告首行与脚本常量（从 JSON 读取，勿写死 `USD`）。\n\n**多账户任务**：拉 `list-accounts --json-out` 建 `mediaCustomerId → currencyCode` 映射，后续所有金额展示经此映射格式化。\n\n---\n\n## 金额单位约定\n\n- **CLI 出口的大多数 JSON / 表格金额以「元」为单位**：`budget`、`*Yuan` 后缀（`budgetAmountYuan`、`maxCPCAmountYuan` 等）、`spend` / `averageCpc` / `costPerConversion` 等。**`keyword -k`**：`averageCpc` / `lowTopOfPageBid` / `highTopOfPageBid` 的币种见根级与每条 **`bidAmountCurrency`**（传 `-a` 时为账户 `currencyCode`；无 `-a` 时为 **USD**）。\n- **写 CLI 参数**（`--budget`、`--max-cpc`、`--target-cpa`、`--amount` 等）：同样传**主币种元**，与账户 `currencyCode` 一致；CLI 内部按需 ×100 / ×1_000_000 写后端。\n- 旧版网关字段（`budgetAmount` 分、`*Micros` 微元、`maxCPCAmountDisplay` 等）**已不再落盘到 CLI 输出**，下游脚本无需做单位换算。\n\n详见 `references/analytics/account-analytics.md`「金额单位」。\n\n---\n\n## 报告 / Excel 检查清单\n\n- [ ] 首行或封面有 `统计区间` + `（货币：CNY|USD）`\n- [ ] 每个账户区块的币种与 `list-accounts` 一致\n- [ ] 无跨币种合计（或明确标注「不可直接相加」）\n- [ ] 全文未出现与 `currencyCode` 矛盾的 `$` / `￥`\n- [ ] OKKI 周报、询盘分析等模板中的「币种」列来自 `list-accounts`，非臆造\n\n---\n\n## 相关文档\n\n- 账户命令与字段：`references/accounts/accounts.md`（索引）→ `accounts-list.md` / `accounts-balance-stats.md` / `accounts-permissions.md`\n- 报告金额口径：`references/analytics/account-analytics.md`\n- 开户选币：`references/accounts/open-account-google-ui.md`、`references/core/workflows.md`\n- 开票币种：`references/accounts/finance.md`\n\nFile v1.1.53:references/accounts/finance.md\n\n# 财务命令详解\n\n> 充值/钱包类操作需通过网页完成，CLI 负责提供链接并引导跳转。\n\n---\n\n## Contents\n\n- invoice-info — 发票抬头管理\n- recharge — 充值业务\n- transfer list — 媒体转账记录\n- transfer create — 提交账户间转账申请\n- invoice — 开票管理\n\n---\n\n## invoice-info — 发票抬头管理\n\n发票抬头是开票申请时使用的公司/企业信息模板，支持三种类型：\n\n- **PI**：形式发票（境外美金账户，英文信息）\n- **VATI**：增值税普通发票\n- **VATSI**：增值税专用发票\n\n### 查询列表\n\n```bash\nsiluzan-tso invoice-info list\nsiluzan-tso invoice-info list --invoice-type PI # 按类型筛选\nsiluzan-tso invoice-info list -k \"公司名关键字\" # 按公司名搜索\nsiluzan-tso invoice-info list --json-out ./snap # 原始 JSON（含 id 字段）\n```\n\n查询结果若 `data` 为空数组或无可核对字段，表示当前账号下**尚无已保存抬头**：向用户展示**原始 JSON** 并如实说明即可，勿推测「测试桩」等未经 CLI 报错佐证的原因。\n\n### 新增发票抬头\n\n**PI（形式发票，境外英文）：**\n\n```bash\nsiluzan-tso invoice-info create \\\n --invoice-type PI \\\n --company-name \"Shenzhen XX Technology Co., Ltd.\" \\\n --registered-address \"Shenzhen, Guangdong, China\" \\\n --contact \"Zhang San\" \\\n --phone 13800138000 \\\n --email zhang@example.com\n```\n\n**VATI / VATSI（增值税普票/专票）：**\n\n```bash\nsiluzan-tso invoice-info create \\\n --invoice-type VATI \\\n --company-name \"深圳XX科技有限公司\" \\\n --tax-id \"914403XXXXXXXXXX\" \\\n --title \"深圳XX科技有限公司\" \\\n --landline \"0755-12345678\" \\\n --contact \"张三\" \\\n --phone 13800138000 \\\n --email zhang@example.com\n```\n\n### 更新发票抬头\n\n```bash\n# 先查 id\nsiluzan-tso invoice-info list --json-out ./snap\n\n# 更新（字段与 create 一致，第一个参数为 id）\nsiluzan-tso invoice-info update \\\n --invoice-type VATI \\\n --company-name \"深圳XX科技有限公司（更新）\" \\\n --tax-id \"914403XXXXXXXXXX\" \\\n --title \"深圳XX科技有限公司\" \\\n --landline \"0755-12345678\" \\\n --contact \"张三\" \\\n --phone 13800138000\n```\n\n### 删除发票抬头\n\n```bash\nsiluzan-tso invoice-info delete \n```\n\n### 字段说明\n\n| 选项 | 说明 | PI | VATI/VATSI |\n| ---------------------- | ---------------------------------------- | ------ | ---------- |\n| `--company-name` | 公司名称（PI 用英文，VATI/VATSI 用中文） | ✅ | ✅ |\n| `--registered-address` | 英文注册地址 | ✅必填 | — |\n| `--tax-id` | 税号 | — | ✅必填 |\n| `--title` | 发票抬头 | — | ✅必填 |\n| `--landline` | 座机号码 | — | ✅必填 |\n| `--contact` | 联系人姓名 | ✅ | ✅ |\n| `--phone` | 联系人手机号 | ✅ | ✅ |\n| `--email` | 推送邮箱 | — | — |\n\n---\n\n## recharge — 充值业务\n\n### 如何获取 Web 基地址\n\n```bash\nsiluzan-tso config show\n# 输出中 webUrl 行即为网页基地址，例如：\n# webUrl : https://www.siluzan.com （生产环境）\n# webUrl : https://www-ci.siluzan.com （测试环境）\n```\n\n> 规律：将 `apiBaseUrl` 中的 `tso-api` 替换为 `www` 即得 `webUrl`。\n\n### 功能总览\n\n| 功能 | 引导用户打开的网页路径 | CLI 支持 |\n| ---------------------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------- | ----------- |\n| 传统充值/现金充值（单笔，仅 Google/TikTok/Meta/Microsoft） | `/v3/foreign_trade/tso/recharge/pay?mediaType=` | ❌ 引导网页 |\n| 现金充值（批量，仅 Google/TikTok） | `/v3/foreign_trade/tso/recharge/pay_batch?mediaType=` | ❌ 引导网页 |\n| 月结充值（仅 Google/TikTok/Meta/Microsoft） | `/v3/foreign_trade/tso/recharge/accountBillingQuota?mediaType=` | ❌ 引导网页 |\n| 丝路赞钱包（充值/提现/明细） | `/v3/foreign_trade/tso/recharge/siluzanWallet` | ❌ 引导网页 |\n| 媒体转账记录 | `/v3/foreign_trade/tso/recharge/accountTransfer` | ✅ `transfer` 命令 |\n| 开票记录 | `/v3/foreign_trade/tso/recharge/invoiceList` | ✅ `invoice list` |\n| 开票申请列表 | `/v3/foreign_trade/tso/recharge/invoicingApplicationList` | ✅ `invoice billable` / `invoice apply` |\n\n### 充值页链接（按媒体 × 类型）\n\n链接模式：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/?mediaType=`；丝路赞钱包：`https://www.siluzan.com/v3/foreign_trade/tso/recharge/siluzanWallet`（无媒体参数）。\n\n| 充值类型 | `` | 支持媒体（`mediaType` 参数） |\n| ------------------------- | --------------------- | ------------------------------------------- |\n| 传统充值/现金充值（单笔） | `pay` | `Google`、`TikTok`、`MetaAd`、`MicrosoftAd` |\n| 现金充值（批量） | `pay_batch` | 仅 `Google`、`TikTok` |\n| 月结充值 | `accountBillingQuota` | `Google`、`TikTok`、`MetaAd`、`MicrosoftAd` |\n\n> **Yandex** 当前没有任何充值页面：不要拼接链接，说明网页暂不提供对应入口，建议联系丝路赞客服或业务负责人。不支持的「媒体 × 类型」组合（如 Meta 批量充值）同样不要引导。\n\n### 引导用户的标准话术\n\n当用户需要充值/查看钱包时：\n\n1. **必须**先跑 `siluzan-tso config show`，用输出中的 `webUrl`（禁止猜生产/测试域名）。\n2. 再按上表相对路径拼出**完整链接**贴给用户。\n3. **禁止**编造未出现在上表的路径（如 `/recharge`、`/wallet` 等「看起来像」的地址）。\n\n用户已指定媒体时，只给对应媒体的单笔充值链接（按需补批量/月结）；未指定媒体时，先询问媒体，或列出全部支持媒体的单笔充值链接 + 丝路赞钱包链接，并附 Yandex 的说明。\n\n---\n\n## transfer list — 媒体转账记录\n\n```bash\nsiluzan-tso transfer list [选项]\n```\n\n| 选项 | 说明 |\n| ------------------------ | ------------------------------------------------ |\n| `-m, --media ` | 媒体类型：`Google \\| TikTok \\| MetaAd \\| BingV2` |\n| `-n, --number ` | 转账单号 |\n| `-s, --status ` | 到账状态 |\n| `--start / --end ` | 日期范围（YYYY-MM-DD） |\n| `--json-out` | 输出原始 JSON |\n\n**示例：**\n\n```bash\n# 查询 Google 全部转账记录\nsiluzan-tso transfer list -m Google\n\n# 查询 TikTok 本月转账记录\nsiluzan-tso transfer list -m TikTok --start 2026-03-01 --end 2026-03-31\n\n# 按转账单号查询\nsiluzan-tso transfer list -m Google -n \"TXN20260301001\"\n\n# JSON 输出\nsiluzan-tso transfer list -m Google --json-out ./snap\n```\n\n---\n\n## transfer create — 提交账户间转账申请\n\n> 在同媒体下，将资金从一个广告账户转入另一个广告账户。\n\n```bash\nsiluzan-tso transfer create -m <媒体> --out <转出ID> --in <转入ID> --amount <金额>\n```\n\n| 选项 | 说明 | 必填 |\n| ------------------------ | -------------------------------------------------- | ---- |\n| `-m, --media ` | 媒体类型：`Google \\| TikTok \\| MetaAd \\| BingV2` | ✅ |\n| `--out ` | 转出账户 `mediaCustomerId`（来自 `list-accounts`） | ✅ |\n| `--in ` | 转入账户 `mediaCustomerId` | ✅ |\n| `--amount ` | 转账金额（与账户货币单位一致） | ✅ |\n| `--customer-name ` | 客户名称备注（可选） | |\n| `--json-out` | 输出原始 JSON | |\n\n**示例：**\n\n```bash\n# 先查出账户 ID\nsiluzan-tso list-accounts -m Google\n\n# 从账户 A 转 100 USD 到账户 B\nsiluzan-tso transfer create -m Google --out 1234567890 --in 9876543210 --amount 100\n```\n\n---\n\n## invoice — 开票管理\n\n### invoice list — 开票申请记录\n\n```bash\nsiluzan-tso invoice list [选项]\n```\n\n> **与投放报表类任务不同**：用户只说「本月开票记录」而未写起止日时，可用**当月 1 日 ~ 昨天**（`Asia/Shanghai` 日历）直接执行 `invoice list --start … --end … --json-out ./snap`，**不必**先做 SKILL「投放数据」类的时间范围 A/B/C 反问；若用户随后纠正区间再重查即可。\n\n| 选项 | 说明 |\n| ------------------------ | ---------------------- |\n| `-k, --keyword ` | 发票号/关键字 |\n| `--start / --end ` | 日期范围（YYYY-MM-DD） |\n| `--json-out` | 输出原始 JSON |\n\n**示例：**\n\n```bash\n# 查询全部开票记录\nsiluzan-tso invoice list\n\n# 查询本月开票记录\nsiluzan-tso invoice list --start 2026-03-01 --end 2026-03-31\n\n# 按发票号搜索\nsiluzan-tso invoice list -k \"INV2026001\"\n\n# JSON 输出\nsiluzan-tso invoice list --json-out ./snap\n```\n\n---\n\n### invoice billable — 可开票订单列表\n\n查询符合开票条件的订单，用于提交开票申请前确认 `billId`。\n\n```bash\nsiluzan-tso invoice billable [选项]\n```\n\n| 选项 | 说明 |\n| ------------------------ | ---------------------- |\n| `-m, --media ` | 媒体类型筛选 |\n| `-c, --currency ` | 币种，如 `USD \\| CNY` |\n| `--wallet` | 查询钱包充值可开票记录 |\n| `--start / --end ` | 日期范围 |\n| `--json-out` | 输出原始 JSON |\n\n**示例：**\n\n```bash\n# 查询所有 Google USD 可开票订单\nsiluzan-tso invoice billable -m Google -c USD\n\n# 查询钱包充值可开票订单\nsiluzan-tso invoice billable --wallet\n\n# JSON 输出，获取 billId 供后续 apply 使用\nsiluzan-tso invoice billable -m Google --json-out ./snap\n```\n\n---\n\n### invoice apply — 提交开票申请\n\n开票业务规则：\n\n- **人民币（CNY）订单**：只能开 **增值税** 发票（`VATI` / `VATSI`），不能选形式发票 `PI`。\n- **美金等外币订单**（常见为 USD，且不含 CNY）：只能开 **形式发票 `PI`**（系统自动出具），不能选增值税票。\n- **形式发票（PI）** 与 **增值税票** 填写的抬头字段不同：PI 为英文公司名 + 英文地址；增值税票为中文公司名、税号、发票抬头、座机等。\n\nCLI 默认会分页查询 `invoice billable` 同源接口，按 `entityId` 解析订单币种并校验与 `--invoice-type` 是否匹配；若列表中找不到 id 或需跳过校验，可使用 `--skip-currency-check`（须自行保证与上表一致）。\n\n**PI（形式发票，境外英文）：**\n\n```bash\nsiluzan-tso invoice apply \\\n --bill-ids \"entityId1,entityId2\" \\\n --bill-type AmountAccount \\\n --invoice-type PI \\\n --media Google \\\n --company-name-en \"Shenzhen XX Technology Co., Ltd.\" \\\n --registered-address-en \"Shenzhen, Guangdong, China\" \\\n --recipient-name \"张三\" \\\n --recipient-phone 13800138000 \\\n --recipient-email zhang@example.com\n```\n\n**VATI / VATSI（增值税普票/专票）：**\n\n```bash\nsiluzan-tso invoice apply \\\n --bill-ids \"entityId1,entityId2\" \\\n --bill-type AmountAccount \\\n --invoice-type VATI \\\n --media Google \\\n --company-name \"深圳XX科技有限公司\" \\\n --tax-id \"914403XXXXXXXXXX\" \\\n --title \"深圳XX科技有限公司\" \\\n --company-phone \"0755-12345678\" \\\n --recipient-name \"张三\" \\\n --recipient-phone 13800138000 \\\n --recipient-email zhang@example.com\n```\n\n| 选项 | 说明 | 必填 |\n| ------------------------- | ----------------------------------------------------------------------------------- | -------------- |\n| `--bill-ids` | 可开票订单 `entityId`，逗号分隔（来自 `invoice billable --json-out ./snap`） | ✅ |\n| `--bill-type` | 账单来源类型：`AmountAccount`（充值开票）\\| `WalletRecharge`（钱包开票） | ✅ |\n| `--invoice-type` | 发票格式：`PI`（形式发票，境外英文）\\| `VATI`（增值税普票）\\| `VATSI`（增值税专票） | ✅ |\n| `--recipient-name` | 收件人姓名 | ✅ |\n| `--recipient-phone` | 收件人手机号 | ✅ |\n| `--recipient-email` | 推送邮箱 | — |\n| `--company-name-en` | 公司英文名称（PI 必填） | PI✅ |\n| `--registered-address-en` | 英文单位地址（PI 必填） | PI✅ |\n| `--company-name` | 公司中文名称（VATI/VATSI 必填） | VATI✅ |\n| `--tax-id` | 税号（VATI/VATSI 必填） | VATI✅ |\n| `--title` | 发票抬头（VATI/VATSI 必填） | VATI✅ |\n| `--company-phone` | 公司座机（VATI/VATSI 必填，对应接口 `InvoiceInfomation.Phone`） | VATI✅ |\n| `--media` | 媒体类型（与 `invoice billable` 一致；核对币种时会传给列表接口） | 建议与订单一致 |\n| `--skip-currency-check` | 跳过币种与发票类型校验 | — |\n\n**完整示例流程：**\n\n```bash\n# 第一步：查询可开票订单，记录 entityId\nsiluzan-tso invoice billable -m Google --json-out ./snap\n# 从输出中找到目标订单的 entityId\n\n# 第二步：提交开票申请（形式发票 PI 示例）\nsiluzan-tso invoice apply \\\n --bill-ids \"75dba917-5130-4c19-aca6-e2c7a420b02a\" \\\n --bill-type AmountAccount \\\n --invoice-type PI \\\n --media Google \\\n --company-name-en \"Shenzhen XX Technology Co., Ltd.\" \\\n --registered-address-en \"Shenzhen, Guangdong, China\" \\\n --recipient-name \"张三\" \\\n --recipient-phone 13800138000 \\\n --recipient-email zhang@example.com\n```\n\n---\n\n### AI 助手：订单开票对话智能点\n\n当用户表达「给订单开发票」「申请开票」「充值要开票」等意图时，助手应**分步引导**，顺序如下。\n\n#### 1. 先让用户选择订单\n\n- 执行 `siluzan-tso invoice billable`（按需加 `-m`、`-c`、`--wallet`、日期范围等），把结果整理成**可读的订单列表**（建议标注：金额、币种、时间、媒体、`entityId`）。\n- **必须**请用户明确要开哪一笔或哪几笔（可多选），得到确认的 `bill-ids`（`entityId` 逗号分隔）和 `bill-type`（`AmountAccount` / `WalletRecharge`）之后，再进入抬头环节。\n- 不要替用户猜测订单；未确认订单前不要直接 `invoice apply`。\n\n#### 2. 再让用户选择发票抬头\n\n- 根据已选订单的**币种**确定允许的发票类型（与上文规则一致：人民币 → `VATI`/`VATSI`；外币 → `PI`）。\n- 执行 `siluzan-tso invoice-info list --invoice-type `（需要结构化数据时用 `--json-out <路径>`），向用户展示**已保存的发票抬头列表**。\n- 请用户**从列表中选一条**（按 id 或公司名/抬头说明），或明确说要用**新的自定义抬头**。\n\n#### 3. 自定义抬头：先匹配列表，没有再创建\n\n- 用户给出自定义抬头（公司名、税号、抬头文案、地址、联系人等）时：\n 1. 先用 `invoice-info list`（可加 `-k` 关键字、`--invoice-type`）在**已有抬头**中检索：公司名、`title`、税号等与用户输入是否**实质相同**（允许轻微空格/标点差异）。\n 2. **若已存在等价记录**：不要重复 `invoice-info create`；直接沿用该条字段填 `invoice apply`（传完整 `InvoiceInfomation`，不是只传抬头 id）。\n 3. **若不存在**：先 `siluzan-tso invoice-info create ...` 创建成功，再 `siluzan-tso invoice apply ...`。避免未落库就假定「已保存」。\n\n#### 4. 最后调用开票接口\n\n- 组装 `invoice apply`：`--bill-ids`、`--bill-type`、`--invoice-type`、收件人信息，以及 PI 与 VATI/VATSI 各自必填的抬头字段（见上表）。\n- 默认保留 CLI 的币种与发票类型校验；仅在用户理解风险时使用 `--skip-currency-check`。\n\n**避免**：跳过订单选择；不展示 `invoice billable` 就让用户手写 id；对自定义抬头不做查重、反复 `create` 造成多条重复抬头。\n\nArchive v1.1.52: 170 files, 781883 bytes\n\nFiles: _meta.json (131b), AGENTS.md (2411b), assets/campaign-create-keyword-test.fixed.json (5434b), assets/campaign-create-keyword-test.json (6051b), assets/campaign-create-template.json (7027b), assets/campaign-create-template.md (30555b), assets/google-period-report.schema.json (9283b), assets/market-analysis-rules.md (7272b), assets/meta-lead-create-template.json (5896b), assets/meta-lead-create-template.md (3248b), assets/meta-period-report-rules.md (1261b), assets/meta-period-report.schema.json (2901b), assets/okki-weekly-report.schema.json (2894b), assets/plan-extract.example.json (2267b), assets/pmax-asset-group-template.json (1024b), assets/pmax-asset-group-template.md (1326b), assets/pmax-assets-update-template.json (1256b), assets/pmax-brand-assets-template.json (881b), assets/pmax-brand-assets-template.md (1376b), assets/pmax-brand-guidelines-enable-template.json (820b), assets/pmax-brand-guidelines-enable-template.md (1410b), assets/pmax-create-template.json (3933b), assets/pmax-create-template.md (14862b), assets/pmax-lead-form-template.json (1529b), assets/pmax-lead-form-template.md (4891b), assets/pmax-patch-campaign-template.json (171b), assets/pmax-signals-template.json (264b), assets/pmax-whatsapp-template.json (1061b), assets/pmax-whatsapp-template.md (2159b), assets/scripts/assemble-campaign-from-plan.mjs (8485b), assets/website-diagnosis-rules.md (4487b), references/accounts/accounts-balance-stats.md (15741b), references/accounts/accounts-list.md (15577b), references/accounts/accounts-permissions.md (24215b), references/accounts/accounts.md (4279b), references/accounts/currency.md (4644b), references/accounts/finance.md (18361b), references/accounts/open-account-by-media.md (13242b), references/accounts/open-account-google-ui.md (5633b), references/accounts/write-audit-restore.md (6981b), references/analytics/account-analytics.md (55610b), references/analytics/facebook-analysis-guide.md (14975b), references/analytics/geo-continents.json (8019b), references/analytics/google-analysis-batch.md (14418b), references/analytics/keyword-planner-workflows.md (18863b), references/analytics/market-analysis-guide.md (5685b), references/analytics/rag.md (6607b), references/analytics/reporting.md (7852b), references/analytics/website-diagnosis-guide.md (8674b), references/core/agent-conventions.md (42614b), references/core/cli-enums.md (9415b), references/core/intent-routing.md (38072b), references/core/playbooks.md (17056b), references/core/setup.md (8870b), references/core/subagent-orchestration.md (10120b), references/core/tips.md (13069b), references/core/user-communication-guide.md (98b), references/core/workflows.md (27698b), references/google-ads/google-ads-batch.md (2941b), references/google-ads/google-ads-campaign-plan.md (26643b), references/google-ads/google-ads-read.md (14703b), references/google-ads/google-ads-write.md (29246b), references/google-ads/google-ads.md (5388b), references/google-ads/pmax-api.md (13721b), references/google-ads/rules/google-ads-account-audit-assets.md (13570b), references/google-ads/rules/google-ads-account-audit-quick.md (12820b), references/google-ads/rules/google-ads-account-audit-report.md (2097b), references/google-ads/rules/google-ads-account-audit-structure.md (6459b), references/google-ads/rules/google-ads-account-audit.md (1641b), references/google-ads/rules/google-ads-audience-strategy.md (19441b), references/google-ads/rules/google-ads-campaign-optimization.md (20882b), references/google-ads/rules/google-ads-compliance-copy.md (14052b), references/google-ads/rules/google-ads-compliance-forbid.md (21111b), references/google-ads/rules/google-ads-compliance-ops.md (10047b), references/google-ads/rules/google-ads-compliance.md (1941b), references/google-ads/rules/google-ads-conversion-architecture.md (16060b), references/google-ads/rules/google-ads-creative-optimization.md (26285b), references/google-ads/rules/google-ads-keyword-optimization.md (26439b), references/google-ads/rules/google-ads-keyword-strategy.md (30079b), references/google-ads/rules/google-ads-keyword-taxonomy.md (4876b)\n\nFile v1.1.52:SKILL.md\n\n---\nname: siluzan-tso\ndescription: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/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+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。\nlicense: MIT\ncompatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权\nmetadata:\n requires: nodejs,siluzan-tso-cli\nallowed-tools: Bash(siluzan-tso:*) Read Write\n---\n\n\n# Siluzan TSO Skill\n\n本文件只做 **任务路由**：意图 → **唯一**工作流 → 按需 Read 子文档（参数与步骤不在此重复）。\n\n- 分析 / 报告 → `references/core/playbooks.md`（P1–P9）\n- 操作 / 管理 → `references/core/workflows.md`（W1–W13）\n- 命令参数 → 路由表「必读文档」\n- 通用纪律与沟通 → `references/core/agent-conventions.md`\n\n> **加载**：按下方路由表 Read **一个**工作流卡片 + **一个**命令/报告 reference 后执行。写操作、报告交付、批量拉数、对用户写结论、或上下文被压缩时，再 Read `references/core/agent-conventions.md`（含 §十四沟通）。\n>\n> **报告 / 诊断 / 分析 / 拓词 / 转化成本·CPA·零询盘话术模糊**：先 Read `references/core/intent-routing.md`（含 **§零·D**：无 CRM 的转化巡检 → P3，不是 P7），再回路由表。数据任务一律 `--json-out` + 代码读盘（示例见 `references/core/tips.md`）。未指定格式时 P1/P4/P4-FB/P8/P9 默认 **HTML**；**P6 默认 `okki-render` 出 5 Sheet `.xlsx`**、**P7 默认 8 Sheet `.xlsx`**（「表格形式」= xlsx，禁止 Markdown 表 / 手写 HTML / P6 Agent 手写 xlsx）。巡检类任务须交付摘要或显式失败原因。\n\n---\n\n## 基本使用\n\n```bash\nsiluzan-tso -h\n```\n\n未安装 / 未登录 / 401 → Read `references/core/setup.md`。\n\n**步骤**：① 报告类模糊 → Read `intent-routing.md` → ② 锁定下方**唯一**工作流行 → ③ Read 该行「必读文档」+ 工作流卡片 → ④ 按编号步骤执行；写操作前与用户确认；对用户写结论时 Read conventions §十四。**禁止** Read `report-templates/*.html`（由 CLI `render` 使用）。\n\n---\n\n## 即时规范\n\n- `entityId`（UUID）≠ `mediaCustomerId`（`list-accounts` 的 `ma.mediaCustomerId`：Google/TikTok/Bing 多为数字；**Yandex=`porg-…`**；Meta 常带 `act_`，`balance`/`stats`/`balance-scan`/`accounts-digest` 裸数字会补前缀）。`stats`/`balance`/`accounts-digest`/`ad *` 的 `-a` **只传 mediaCustomerId**；空结果或 verbose 打出 403 时**先核验 ID**，禁止把 UUID/`entityId` 传给 `-a`，也**禁止**据此直接 `reauth`。\n- **Google CID 特殊性**：UI 常写 `123-456-7890`（带连字符），平台 `mediaCustomerId` 为纯数字 `1234567890`。CLI 会自动去连字符；**勿**把带横杠 403 误判为 OAuth 失效。优先用 `list-accounts` 的纯数字 ID。\n- **禁止臆测授权过期**：见 403/`HTTP 403`/拉数失败/「可能 OAuth 失效」时，**禁止**口头推断授权过期或直接 `reauth`。须先核验 ID（及 Google 连字符）。**`account check-access` 仅支持 Google**（无 `-m`，禁止对 TikTok/Meta/Bing/Yandex 调用）：Google 跑 `account check-access -a `，以 `accessible` / `reauth_required` / `no_permission` 为准；非 Google 看 `list-accounts` 的 `invalidOAuthToken`。仅当 `list-accounts` 输出含激活字段且可判定未激活时才跳过用其判断授权过期；细则见 `accounts-permissions.md`。\n- **Google 广告命令名**：列表是 `ad campaigns`（不是 `ad-campaigns` / `campaign list`）；`balance`/`stats` 须带 `-m Google`；单国地域用 `ad geo search … --json-out`（或 `geo resolve`）。\n- **广告搭建媒体边界**：仅 **Google**（`ad`，Search + PMax）与 **Meta**（`meta-ad`，Instant Form 线索）。TikTok / BingV2 / Yandex **不能**创建或改广告结构；用户要搭建时须说明不支持，可改做账户分析（P4）或开户（W2）。**禁止**用 `ad` 冒充 Meta，**禁止**用 `meta-ad` 冒充 Google。\n- **Google 广告类型边界**：CLI/Skill **仅支持** Google **搜索广告（Search）** 与 **Performance Max（PMax）** 的方案、创建与精细管理；**不支持展示广告（Display）**（含自适应展示广告 RDA、独立 Display 系列）。用户要做展示广告时须明确告知不支持，可改推 Search / PMax；**禁止**用 `campaign-create` / `ad-create` 伪装创建 Display。\n- **创建完成后交付（硬性）**：`ad batch diff` 的 stdout 含 `BEGIN_USER_DELIVERY_MARKDOWN`…`END_USER_DELIVERY_MARKDOWN`——**立刻**把中间全文原样发给用户（可先于补建）；禁止只摘要、禁止只说「创建成功/详情已交付/未发现缺失」、禁止等全部补建结束再交付。\n- `list-accounts` 无余额/消耗；列全部用 `--page-size 999`。\n- 多户余额用 `balance-scan`（P2），多户消耗用 `accounts-digest`（P3）；禁止外层 for-loop 逐户拉数。\n- `stats` 的 `spend` = **区间合计**，不是日消耗。\n- 行业/市场报告禁止纯 WebSearch 当终稿；须 P9 `market-analysis collect`+`render`。\n- **禁止编造平台网址**：给用户 `*.siluzan.com` / `mysiluzan.com` 链接前，**必须**当轮 `config show` 取 `webUrl`，路径**只**用已 Read 文档中的相对路径表拼接；CLI 输出的授权 URL **原样粘贴**；文档未给路径则**不拼链接**。细则见 `agent-conventions.md`。\n- **W13 Meta 创建（硬性）**：首次落地只用 `meta-ad create`（会提交 `targeting_automation.advantage_audience`，默认 1）。组失败用 `--json-out` 的 `campaignId` 跑 `adset-create`，**禁止**再 `campaign-create`。细定向写 `adset.flexibleSpec` 并设 `advantageAudience=0`。\n\n---\n\n## 媒体能力（搭建 vs 分析）\n\n| 媒体 | 广告搭建 | 账户分析 | 说明 |\n| ---- | -------- | -------- | ---- |\n| **Google** | Search + PMax（`ad`，W3/W4） | `google-analysis` | 不支持 Display |\n| **MetaAd** | Instant Form 线索（`meta-ad`，W13） | `facebook-analysis` | 无视频 / Advantage+ / 系列列表 |\n| **TikTok** | **不支持** | `tiktok-analysis` | 已有留资走 `clue`（W11） |\n| **BingV2** | **不支持** | `bing-analysis` | 只读巡检 |\n| **Yandex** | **不支持** | `yandex-analysis` | 只读巡检 |\n\n## 路由表（意图 → 工作流 → 必读文档）\n\n> 写操作 / 报告交付 / 批量拉数 / 对用户回复 → Read `agent-conventions.md`。找不到行 → 澄清或 Read `intent-routing.md`（勿整本加载 `references/README.md`）。\n\n### 账户与财务\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 账户列表 / 有哪些 / 有多少 / 列出全部某媒体 | W1 | `references/accounts/accounts-list.md`（list-accounts） |\n| 单户实时余额 | W1 | `references/accounts/accounts-balance-stats.md`（balance） |\n| 多账户余额 / 续航不足预警 | **P2** | `references/accounts/accounts-balance-stats.md`（balance-scan） |\n| 单户消耗 / 投放数据 | W1 / **P1** | `references/accounts/accounts-balance-stats.md`（stats） |\n| 多账户消耗/对比汇总 / 转化成本·CPA·零转化巡检（无 CRM） | **P3** | `references/accounts/accounts-balance-stats.md`（accounts-digest）；消歧见 `intent-routing.md` **§零·D** |\n| 激活/充值账单明细 | W1 | `references/accounts/accounts-list.md`（account-active-bills） |\n| 开户（五大媒体）/ 开户进度 | W2 | `references/accounts/open-account-by-media.md`（**首次须列全必填项**；Google 加 `open-account-google-ui.md`） |\n| 账户权限：分享/取消/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 | W9 | `references/accounts/accounts-permissions.md` |\n| 充值 / 钱包 / 转账 / 发票 / 抬头 | W8 | `references/accounts/finance.md` |\n| 审计 / 误操作恢复 | — | `references/accounts/write-audit-restore.md` |\n\n### 不支持的广告搭建\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 建 TikTok / Bing / Yandex 广告 | — | **不支持搭建**。说明后可改做账户分析（P4）或开户（W2）；勿用 `ad` / `meta-ad` 伪装 |\n\n### Google 广告投放\n\n> **类型边界**：仅 **Search** + **PMax**；**不支持 Display（展示广告）**。详见 `references/google-ads/google-ads.md` Gotchas。\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 新建搜索系列 / 出投放方案 / Excel·表格方案 / 官网生成搜索广告 | **W3** | `references/google-ads/google-ads-campaign-plan.md`（§**仅出方案 vs 创建**）+ **`assets/campaign-create-template.json`**（先 Read）+ `assets/campaign-create-template.md` + `rules/google-ads-launch-plan-template.md`（JSON 后**写代码**投影完整审查稿）；有方案文件时加 `rules/google-ads-plan-source-fidelity.md`。**≠ P8 / ≠ P9 / ≠ W5**；**禁止**因缺账户阻塞出方案、**禁止**只交概览表 |\n| 展示广告 / Display / 自适应展示广告（RDA） | — | **不支持**。向用户说明后改推 Search（W3）或 PMax（W3）；勿创建、勿假装已支持 |\n| 广告系列/组/广告/关键词 **查询** / 拒审字段 | W3 | `references/google-ads/google-ads-read.md` |\n| 广告系列/组/广告/关键词 **创建·编辑·启停** | W3 | `references/google-ads/google-ads-write.md` |\n| PMax 系列 | W3 | **`assets/pmax-create-template.json`**（先 Read）+ `assets/pmax-create-template.md` + `rules/google-ads-pmax-launch-plan-template.md`（**写代码**投影完整审查稿）+ `references/google-ads/pmax-api.md` + `google-ads-write.md`（PMax 节） |\n| AI 智投草稿 list/get/update/publish | W4 | `references/google-ads/google-ads-batch.md` |\n| 拓词 / keyword / 关键词规划 / 月搜索量 / 竞争度 / Keyword Planner | **W5** | `references/analytics/keyword-planner-workflows.md`（**§零·C**；客户背景先 `references/analytics/rag.md`） |\n| AI 广告优化记录 / 建议 | W6 | `references/operations/optimize.md` |\n| 优化/合规 SOP | W3 / W6 | `references/google-ads/rules/README.md`（**仅读索引表** → 再 Read **一个**具体 `rules/*.md`） |\n\n### Meta 广告投放\n\n> **类型边界**：仅 **Instant Form 线索广告**；无视频 / Advantage+ / 系列列表。拉已有线索走 **W11**；周期报告走 **P4-FB**。TikTok / Bing / Yandex **不能**走本表搭建。\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 新建 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`** + **`meta-ad plan-render`**（运营 4 Sheet xlsx，禁止 Agent 手写表）+ `references/meta-ads/meta-ads-write.md`。**≠ W11 ≠ P4-FB ≠ W3** |\n| Meta 系列/组/广告 **查询**（按 ID）/ 主页 / 表单列表 | W13 | `references/meta-ads/meta-ads-read.md` |\n| Meta 系列/组/广告 **创建·编辑·启停**（原语） | W13 | `references/meta-ads/meta-ads-write.md` |\n\n### 分析与报告\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| Google 广告账户诊断 / 健康检查（**含账户 ID**） | **P1** | `references/analytics/account-analytics.md` + `report-templates/google-ads-diagnosis.md`（可选对照 `report-templates/google-account-diagnosis-report.md`） |\n| Google 账户周期 / 月度 / 季度报告（非 OKKI / 非询盘 / 非强调健康诊断） | **P4** | `report-templates/google-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `google-period-report-excel.md` |\n| Meta/Facebook 周期或诊断 | **P4-FB** | `report-templates/meta-period-report.md` + `assets/meta-period-report-rules.md` + `references/analytics/facebook-analysis-guide.md` |\n| TikTok / Bing 周期报告 | **P4** | `references/analytics/account-analytics.md` + 对应 `report-templates/*-period-report.md` |\n| Yandex 账户分析 / 周期 / 月报 | **P4** | `report-templates/yandex-period-report.md` + `references/analytics/account-analytics.md`；Excel 加 `yandex-period-report-excel.md` |\n| 账户级按日 Excel | **P4-DAILY** | `report-templates/stats-daily-excel.md` |\n| 多账户 × 多维度批处理 | **P5** | `references/analytics/google-analysis-batch.md` + `references/analytics/account-analytics.md` |\n| OKKI 周报 / 表格形式（OKKI） | **P6** | `report-templates/okki-weekly-google-client.md`（写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet `.xlsx`；「表格形式」= Excel） |\n| Google 询盘分析（**须 CRM 询盘资料**；口语零询盘/CPA → **P3**） | **P7** | `report-templates/google-inquiry-analysis.md` + `references/analytics/geo-continents.json` |\n| 网址/域名/官网 + 诊断·检测·监测·报告 / **是否符合广告投放要求** / 能不能投 | **P8** | `references/core/intent-routing.md` §零 + `references/analytics/website-diagnosis-guide.md` + `assets/website-diagnosis-rules.md`（**必** `website-diagnosis collect`；**≠ P9 ≠ W3**；禁纯 WebFetch） |\n| 市场/行业分析报告 / 战略市场 / KA 市场报告 | **P9** | `references/analytics/market-analysis-guide.md` + `assets/market-analysis-rules.md`（须 collect+render；**≠ P8**） |\n| TSO 平台优化报告：列表/生成/推送 | W7 | `references/analytics/reporting.md` |\n| RAG 知识库检索 | W5 | `references/analytics/rag.md` |\n\n### 工具与运营\n\n| 用户意图（关键词） | 工作流 | 必读文档 |\n| ------------------ | ------ | -------- |\n| 智能预警：创建/查询/启停/触发记录 | W10 | `references/operations/forewarning.md` |\n| TikTok / Meta 线索表单 | W11 | `references/operations/clue.md` |\n| 日/周巡检 | W12 | `references/core/workflows.md`（W12）+ `references/accounts/accounts-balance-stats.md` |\n| 超预算熔断 / 空耗熔断（全户 Google） | — | `references/operations/guard.md`（`guard budget-circuit` / `guard zero-conv`；禁止逐户 for-loop） |\n| Bing 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-bing.md`（只读告警，不能自动暂停/改价） |\n| Yandex 自动化巡检（归档/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-yandex.md`（只读告警，不能自动暂停/改价） |\n| TikTok 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-tiktok.md`（只读告警，不能自动暂停/改价） |\n| Facebook / MetaAd 自动化巡检（封禁/拒审/超预算/空耗预警） | — | `references/operations/hosted-automation-facebook.md`（只读告警，不能自动暂停/改价） |\n| 宿主编排 / 投放自控 / 异常监控 / 自动优化 | — | `references/operations/hosted-automation-user-catalog.md`（**仅当用户问自动化/巡检/熔断**；表内每行只 Read **一个** SOP；Google 熔断优先 guard.md；Bing/Yandex/TikTok/Facebook 走上四行） |\n\n---\n\n## Subagent 自主委派（可选）\n\n宿主具备 Task / subagent 时：复杂报告或批处理（**P5 / P6 / P7**）、预计 CLI 输出很长 → Read `references/core/subagent-orchestration.md`；handoff 在 `snippets/handoff-p{5,6,7}-*.md`。写操作确认、`--commit`、401/`resume` 与最终交付留在主 Agent。\n\n---\n\n## 职责划分\n\n| 本 Skill + CLI | 宿主 / 外部调度 |\n| -------------- | --------------- |\n| 结构化拉数（`--json-out`）、写命令语义、金额/ID 口径 | 触发时机、IF 决策、触达（钉钉/飞书）、批处理限速；可选 subagent 并行 |\n\nFile v1.1.52:references/google-ads/rules/README.md\n\n# Google Ads 优化与合规规则\n\n> **策略/SOP**，非 CLI 参数表。命令见 `google-ads-read.md` / `google-ads-write.md` / `google-ads-batch.md`。新建流程见 `google-ads-campaign-plan.md`。\n> **怎么读**：下表选 **一个**文件再 Read（审计/合规若有子模块，先读其导航再选子文件）。\n\n| 文件 | 何时 Read |\n| --------------------------------------------------- | ---------------------------------------------------------- |\n| `google-ads-account-audit.md` | 账户健康审计（索引 → quick / structure / assets / report） |\n| `google-ads-compliance.md` | 合规政策（索引 → forbid / copy / ops） |\n| `google-ads-campaign-optimization.md` | 系列层优化决策 |\n| `google-ads-keyword-strategy.md` | 关键词策略规划 |\n| `google-ads-keyword-optimization.md` | 关键词出价/否定/扩词 |\n| `google-ads-keyword-taxonomy.md` | 词类分层与命名 |\n| `google-ads-plan-source-fidelity.md` | **Excel/表格方案 → JSON**（有方案文件时必读） |\n| `google-ads-creative-optimization.md` | 创意/文案优化 |\n| `google-ads-audience-strategy.md` | 受众策略 |\n| `google-ads-pmax-guide.md` | PMax 运营（配合 `assets/pmax-create-template.md`） |\n| `google-ads-conversion-architecture.md` | 转化追踪架构 |\n| `google-ads-landing-page-discovery-via-webfetch.md` | 落地页发现（WebFetch） |\n| `google-ads-launch-plan-template.md` | 搜索投放审查稿（Agent 写代码从 JSON 投影） |\n| `google-ads-pmax-launch-plan-template.md` | PMax 投放审查稿（Agent 写代码从 JSON 投影） |\n| `sensitive-industries.md` | 敏感行业限制 |\n\n宿主编排自动优化：`references/operations/hosted-automation-optimize-index.md`。\n\nFile v1.1.52:references/README.md\n\n# References 索引\n\n> **运行时**：按 `SKILL.md` 路由表直接 Read 列出的文件，**不要**为找路径加载本文件全文。改文档结构见 `skill-authoring.md`。\n\n## 基础与纪律\n\n| 文件 | 用途 |\n| --------------------------------------------- | ---------------------------------------- |\n| `references/core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |\n| `references/core/agent-conventions.md` | 通用纪律 + §十四沟通 |\n| `references/core/user-communication-guide.md` | 重定向 → `agent-conventions.md` §十四 |\n| `references/core/intent-routing.md` | 报告/分析/拓词话术消歧 |\n| `references/core/tips.md` | `--json-out` 脚本食谱 |\n| `references/core/playbooks.md` | 分析/报告工作流（P1–P9） |\n| `references/core/workflows.md` | 操作/管理工作流（W1–W13） |\n| `references/core/subagent-orchestration.md` | 可选：P5/P6/P7 委派 subagent |\n| `references/core/skill-authoring.md` | 维护约定（运行时勿加载） |\n\n## 账户与财务\n\n| 文件 | 用途 |\n| ----------------------------------------------- | ----------------------------------------------------------------- |\n| `references/accounts/accounts.md` | **账户域索引**（按任务再读子文件） |\n| `references/accounts/accounts-list.md` | list-accounts、激活账单、开户申请历史 |\n| `references/accounts/accounts-balance-stats.md` | balance、**balance-scan（P2）**、stats、**accounts-digest（P3）** |\n| `references/accounts/accounts-permissions.md` | 分享/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 |\n| `references/accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |\n| `references/accounts/open-account-by-media.md` | 各媒体开户命令与参数 |\n| `references/accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |\n| `references/accounts/finance.md` | 转账、开票、充值 |\n| `references/accounts/write-audit-restore.md` | 写审计、`--commit`、restore |\n\n## Google 广告\n\n| 文件 | 用途 |\n| --------------------------------------------------- | -------------------------------------- |\n| `references/google-ads/google-ads.md` | **Google Ads 索引**（金额/ID Gotchas） |\n| `references/google-ads/google-ads-read.md` | 系列/组/创意/关键词/搜索词/地理查询 |\n| `references/google-ads/google-ads-write.md` | 创建/编辑/启停/扩展/PMax/设备出价 |\n| `references/google-ads/google-ads-batch.md` | batch 流水线、ad batch、智投草稿 |\n| `references/google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |\n| `references/google-ads/pmax-api.md` | PMax 网关路径、金额口径 |\n| `references/analytics/keyword-planner-workflows.md` | keyword / google-analysis 拓词 |\n| `references/google-ads/rules/README.md` | 优化/合规 SOP 索引 |\n\n## Meta 广告\n\n| 文件 | 用途 |\n| --------------------------------------------- | ----------------------------------------- |\n| `references/meta-ads/meta-ads.md` | **Meta Instant Form 索引**（金额/ID） |\n| `references/meta-ads/meta-ads-read.md` | 账户/主页/表单/按 ID 读系列组广告 |\n| `references/meta-ads/meta-ads-write.md` | validate/create 与原语写命令 |\n| `references/meta-ads/meta-lead-launch-plan-template.md` | 出方案/创建前审查稿；xlsx 由 `meta-ad plan-render` 生成 |\n| `assets/meta-lead-create-template.json` + `.md` | Lead Ad JSON 契约（**先 Read `.json`**） |\n\n## 分析与报告\n\n| 文件 | 用途 |\n| ------------------------------------------------- | ------------------------------------------- |\n| `references/analytics/account-analytics.md` | 拉数、数据时效性、诊断模板 |\n| `references/analytics/website-diagnosis-guide.md` | 网站诊断 CLI、6 模块规则、对齐 tso_agent |\n| `references/analytics/market-analysis-guide.md` | 战略市场分析 CLI、Agent 调研流程 |\n| `assets/market-analysis-rules.md` | 市场分析报告章节与 HTML 版式（Agent 必读） |\n| `references/analytics/facebook-analysis-guide.md` | Facebook 字段、与 Google 报告对照、撰写清单 |\n| `references/analytics/google-analysis-batch.md` | 多账户批处理 run/resume/status |\n| `references/analytics/reporting.md` | TSO 优化报告生成与推送 |\n| `references/analytics/rag.md` | 知识库 list/query |\n| `references/analytics/geo-continents.json` | 国家→大洲映射（询盘分析） |\n\n## 运营工具\n\n| 文件 | 用途 |\n| ------------------------------------------------------------ | ---------------------- |\n| `references/operations/optimize.md` | AI 优化建议记录 |\n| `references/operations/forewarning.md` | 智能预警 |\n| `references/operations/clue.md` | TikTok / Meta 线索表单 |\n| `references/operations/hosted-automation-user-catalog.md` | 高阶自动化能力目录 |\n| `references/operations/hosted-automation-self-control.md` | Google 预算/CPA/空耗自控 SOP |\n| `references/operations/hosted-automation-monitoring-json.md` | Google 异常监控 JSON 键名 |\n| `references/operations/hosted-automation-optimize-index.md` | Google 自动优化 SOP 索引 |\n| `references/operations/hosted-automation-bing.md` | Bing 只读巡检 SOP |\n| `references/operations/hosted-automation-yandex.md` | Yandex 只读巡检 SOP |\n| `references/operations/hosted-automation-tiktok.md` | TikTok 只读巡检 SOP |\n| `references/operations/hosted-automation-facebook.md` | Facebook / MetaAd 只读巡检 SOP |\n| `references/operations/hosted-automation-scenarios.md` | 宿主编排场景索引 |\n\n## Assets 模板（`../assets/`）\n\n| 文件 | 用途 |\n| --------------------------------------- | --------------------------------------------------------- |\n| `campaign-create-template.json` + `.md` | 搜索系列 batch 契约（**先 Read `.json`**，再 Read `.md`） |\n| `website-diagnosis-rules.md` | 网站诊断评分项与 JSON Schema |\n| `meta-period-report-rules.md` | Meta 周期报告内容丰富度与建议撰写规则 |\n| `meta-period-report.schema.json` | Meta 周期报告 Agent JSON Schema |\n| `pmax-create-template.md` / `.json` | PMax 新建契约 |\n| `meta-lead-create-template.json` + `.md` | Meta Instant Form Lead Ad 契约 |\n| `pmax-asset-group-template.json` | PMax 素材组 |\n| `pmax-signals-template.json` | PMax 信号 |\n| `pmax-assets-update-template.json` | PMax 素材更新 |\n| `pmax-patch-campaign-template.json` | PMax 系列 patch |\n\n## 报告模板纲要（`report-templates/`）\n\n> 安装包内与 `report-templates/*.md` 同源；HTML 样式在 `report-templates/*.html`。索引见 `report-templates/README.md`。\n\n| 文件 | 适用场景 |\n| ---------------------------------------------------------------- | ------------------------------ |\n| `google-period-report.md` | Google 账户周期/月度报告（P4） |\n| `google-period-report-excel.md` | P4 用户要 Excel |\n| `stats-daily-excel.md` | P4-DAILY 按日 Excel |\n| `meta-period-report.md` / `meta-period-report-excel.md` | Meta 周期（P4-FB） |\n| `google-ads-diagnosis.md` / `google-account-diagnosis-report.md` | Google 诊断（P1） |\n| `website-diagnosis-report.md` | 网站诊断（P8） |\n| `market-analysis-report.md` | 战略市场分析（P9） |\n| `okki-weekly-google-client.md` | OKKI 周报（P6） |\n| `google-inquiry-analysis.md` | 询盘分析（P7） |\n| `tiktok-period-report.md` / `bing-period-report.md` | TikTok / Bing 周期（P4） |\n| `yandex-period-report.md` / `yandex-period-report-excel.md` | Yandex 周期 HTML / Excel（P4） |\n| `REPORT-WORKFLOW.md` | 通用六步流程 |\n\n样式参考 HTML 见根目录 `report-templates/README.md`。\n\n## Handoff 模板（`../snippets/`，随 skill 安装）\n\n| 文件 | 用途 |\n| ----------------------- | --------------------------------- |\n| `handoff-p5-batch.md` | P5 batch 与按账户聚合 Task prompt |\n| `handoff-p6-okki.md` | P6 OKKI 拉数 / 写 JSON + okki-render |\n| `handoff-p7-inquiry.md` | P7 询盘拉数与 xlsx |\n\n`agent-preamble.md` 仅用于构建时注入 `SKILL.md`，不复制到 `dist/skill/snippets/`。\n\nFile v1.1.52:references/report-templates/README.md\n\n# 报告模板目录\n\n本目录包含两类文件：\n\n| 文件类型 | 用途 |\n| ----------------------- | ----------------------------------------------- |\n| `*.md` | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |\n| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容 |\n| `excel-style-guide.md` | Excel 通用样式规范（色板/字体/组件），所有平台共用 |\n| `excel-style-kit.mjs` | 配套代码：Agent 写 xlsx 脚本直接 `import` 使用，零依赖 |\n\n> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。任何「用户要 Excel/xlsx/表格」的模板，写脚本时都按 `excel-style-guide.md` 套样式，不再裸写无样式单元格。\n\n**图表库（全部 HTML 模板统一）**：ECharts 5 — `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.min.js`；初始化用 `echarts.init(el).setOption(...)`。勿使用 Chart.js。\n\n**图表自适应**：逻辑必须写在**同一份 HTML 模板内**（`window.addEventListener('resize', … chart.resize())`，可选对容器做 `ResizeObserver`）。报告下载到本地后仍可用；禁止依赖外挂 `*.snippet.js` 或 monkey-patch CDN。\n\n---\n\n## 内容纲要文件\n\n| 文件 | 适用场景 |\n| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |\n| `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |\n| `stats-daily-excel.md` | **P4-DAILY**：账户级按日 Excel（`stats --by-day`） |\n| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |\n| `google-ads-diagnosis.md` | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**） |\n| `meta-period-report.md` / `.html` | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |\n| `meta-period-report-excel.md` | **仅用户要 Excel 时**：5 Sheet（**汇总数据**/日趋势/国家/广告系列/受众，汇总 KPI 下是一/二/三）；`facebook-analysis render --format xlsx` |\n| `meta-account-diagnosis-report.md` / `.html` | **Meta（Facebook）诊断报告（默认）**：四步流程 → `facebook-analysis diagnosis-render` 出 HTML（在 7 Section 内对齐 Google 诊断结构，未覆盖小节标 `notAvailable`） |\n| `tiktok-period-report.md` / `.html` | **TikTok 广告主周期报告（默认）**：四步流程 → `tiktok-analysis render` 出 HTML |\n| `bing-period-report.md` / `.html` | **Bing（BingV2）分析报告（默认）**：四步流程 → `bing-analysis render` 出 HTML |\n| `yandex-period-report.md` / `.html` | **Yandex Direct 周期报告（默认）**：四步流程 → `yandex-analysis render` 出 HTML（样式对齐开发样例） |\n| `yandex-period-report-excel.md` | **仅用户要 Excel 时**：Agent 脚本写 xlsx；无 CLI excel 子命令 |\n| `okki-weekly-google-client.md` | **OKKI 周报**：写 `okki-weekly-report.json` → `google-analysis okki-render` 出 5 Sheet Excel + 客户话术，见 `references/core/playbooks.md` P6 |\n| `google-inquiry-analysis.md` | **Google 询盘分析**：严格 3 个月 + 用户询盘 + 8 Sheet xlsx，见 `references/core/playbooks.md` P7 |\n| `website-diagnosis-report.md` / `.html` | **网站诊断**：终稿为 **HTML**（对齐 TSO `WebsiteAnalysisReport/v3`）；配合 `website-diagnosis collect`，见 P8 |\n\n---\n\n## 样式参考文件\n\n| 文件 | 风格 |\n| ------------------------------- | --------------------- |\n| `report-template.html` | 商务/数据看板（默认） |\n| `report-template-formal.html` | 正式文件/对外 |\n| `report-template-dark.html` | 深色/投屏 |\n| `report-template-onepager.html` | 单页摘要 |\n| `report-template-mobile.html` | 移动端 |\n| `report-template-print.html` ...","readmeExcerpt":"Skill: Siluzan TSO Owner: sigedev01-bit Summary: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/MetaAd），凡涉及丝路赞/TSO、投广告、出价预算、广告账户管理，或需要做行业分析/市场分析/行业分析报告（含「写一份 XX 行业报告」「电商/制造/医疗等行业报告」「市场调查/战略市场/KA 市场报告」「竞品/GTM/市场格局/行业趋势」等，无论是否提及丝路赞/广告/客户）须加载本 skill。【§零·最高优先】网址/域名/官网+诊断/检测/监测/评估/体检/报告/符合投放要求/能不能投（含「网络诊断」混说）→P8 website-diagnosis collect（禁纯WebFetch/肉眼看页），禁止P9/P1/W3、禁止A/B/C/D追问；细则见 intent-routing.md §零。【§零·B·次高优先】未命中§零时，行业/市场分析报告类","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"siluzan-tso -h"},{"language":"bash","snippet":"siluzan-tso balance-scan -m <媒体类型> [选项]"},{"language":"bash","snippet":"# 全量巡检（Playbook P2）\nsiluzan-tso balance-scan -m Google --threshold-days 7 --json-out ./snap-p2\n\n# 近 3 日日均 + 续航阈值 7 天\nsiluzan-tso balance-scan -m Google --threshold-days 7 --spend-days 3 --json-out ./snap-p2\n\n# 已知子集\nsiluzan-tso balance-scan -m BingV2 -a id1,id2,id3 --json-out ./snap-p2-subset\n\n# Meta 余额续航\nsiluzan-tso balance-scan -m MetaAd --json-out ./snap-p2-meta"},{"language":"bash","snippet":"siluzan-tso balance -m <媒体类型> -a <账户ID列表>"},{"language":"bash","snippet":"# 查询单个 Google 账户余额（传 mediaCustomerId）\nsiluzan-tso balance -m Google -a 6326027735\n\n# Yandex：传 porg-…（mediaCustomerId），禁止 entityId/UUID\nsiluzan-tso balance -m Yandex -a porg-kqquuxx6\n\n# 查询多个 TikTok 账户余额\nsiluzan-tso balance -m TikTok -a 1234567890,9876543210\n\n# 查询 Meta 广告账户余额（OAuth 户传裸数字或 act_ 均可）\nsiluzan-tso balance -m MetaAd -a \n\n# JSON 输出，供脚本使用\nsiluzan-tso balance -m Google -a 6326027735 --json-out ./snap"},{"language":"bash","snippet":"siluzan-tso accounts-digest -m <媒体类型> [选项]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: siluzan-tso\ndescription: 丝路赞 TSO 广告平台（Google/Bing/Yandex/TikTok/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；只要周期数据/8维/花费转化汇总/Excel→P4；Google/谷歌广告月度报告、月总结与规划、季度报告、Q3汇总、Q4规划、季度汇报、投放季报、客户版、大族模板、下月规划→P10 google-quarterly；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+Meta**：Google Search/PMax（W3，无 Display；含 CRUD/PMax/batch W4）；Meta Instant Form（W13）。TikTok/Bing/Yandex **不能建广告**。另：拓词 W5、optimize W6。【财务】充值/钱包、转账记录、发票/开票/抬头（W8）；写操作审计与 restore。【运营】智能预警 forewarning 创建/启停/记录（W10）、TikTok/Meta 线索 clue（W11）、日周巡检（W12）、宿主编排/投放自控/异常监控（hosted-automation）。【其他】RAG 知识库检索、Meta/Facebook 周期与诊断 HTML、Google/Meta 周期 Excel、多账户 google-analysis-batch。\nlicense: MIT\ncompatibility: 需要 Node.js 18+、已安装 siluzan-tso-cli，通过 send-login-code + login 或 config set 完成鉴权\nmetadata:\n requires: nodejs,siluzan-tso-cli\nallowed-tools: Bash(siluzan-tso:*) Read Write\n---\n\n\n# Siluzan TSO Skill\n\n本文件只做 **任务路由**：意图 → **唯一**工作流 → 按需 Read 子文档（参数与步骤不在此重复）。\n\n- 分析 / 报告 → `references/core/playbooks.md`（P1–P10）\n- 操作 / 管理 → `references/core/workflows.md`（W1–W13）\n- 命令参数 → 路由表「必读文档」\n- 通用纪律与沟通 → `references/core/agent-conventions.md`\n\n> **加载**：按下方路由表 Read **一个**工作流卡片 + **一个**命令/报告 reference 后执行。写操作、报告交付、批量拉数、对用户写结论、或上下文被压缩时，再 Read `references/core/agent-conventions.md`（含 §十四沟通）。\n>\n> **报告 / 诊断 / 分析 / 拓词 / 转化成本·CPA·零询盘话术模糊**：先 Read `references/core/intent-routing.md`（含 **§零·D**：无 CRM 的转化巡检 → P3，不是 P7），再回路由表。数据任务一律 `--json-out` + 代码读盘（示例见 `references/core/tips.md`）。未指定格式时 P1/P4/P4-FB/P8/P9/P10 默认 **HTML**；**P6 默认 `okki-render` 出 5 Sheet `.xlsx`**、**P7 默认 8 Sheet `.xlsx`**（「表格形式」= xlsx，禁止 Markdown 表 / 手写 HTML / P6 Agent 手写 xlsx）。巡检类任务须交付摘要或显式失败原因。\n\n---\n\n## 基本使用\n\n```bash\nsiluzan-tso -h\n```\n\n未安装 / 未登录 / 401 → Read `references/core/setup.md`。\n\n**步骤**：① 报告类模糊 → Read `intent-routing.md` → ② 锁定下方**唯一**工作流行 → ③ Read 该行「必读文档」+ 工作流卡片 → ④ 按编"},{"path":"references/google-ads/rules/README.md","content":"# Google Ads 优化与合规规则\n\n> **策略/SOP**，非 CLI 参数表。命令见 `google-ads-read.md` / `google-ads-write.md` / `google-ads-batch.md`。新建流程见 `google-ads-campaign-plan.md`。\n> **怎么读**：下表选 **一个**文件再 Read（审计/合规若有子模块，先读其导航再选子文件）。\n\n| 文件 | 何时 Read |\n| --------------------------------------------------- | ---------------------------------------------------------- |\n| `google-ads-account-audit.md` | 账户健康审计（索引 → quick / structure / assets / report） |\n| `google-ads-compliance.md` | 合规政策（索引 → forbid / copy / ops） |\n| `google-ads-campaign-optimization.md` | 系列层优化决策 |\n| `google-ads-keyword-strategy.md` | 关键词策略规划 |\n| `google-ads-keyword-optimization.md` | 关键词出价/否定/扩词 |\n| `google-ads-keyword-taxonomy.md` | 词类分层与命名 |\n| `google-ads-plan-source-fidelity.md` | **Excel/表格方案 → JSON**（有方案文件时必读） |\n| `google-ads-creative-optimization.md` | 创意/文案优化 |\n| `google-ads-audience-strategy.md` | 受众策略 |\n| `google-ads-pmax-guide.md` | PMax 运营（配合 `assets/pmax-create-template.md`） |\n| `google-ads-conversion-architecture.md` | 转化追踪架构 |\n| `google-ads-landing-page-discovery-via-webfetch.md` | 落地页发现（WebFetch） |\n| `google-ads-launch-plan-template.md` | 搜索投放审查稿（Agent 写代码从 JSON 投影） |\n| `google-ads-pmax-launch-plan-template.md` | PMax 投放审查稿（Agent 写代码从 JSON 投影） |\n| `sensitive-industries.md` | 敏感行业限制 |\n\n宿主编排自动优化：`references/operations/hosted-automation-optimize-index.md`。"},{"path":"references/README.md","content":"# References 索引\n\n> **运行时**：按 `SKILL.md` 路由表直接 Read 列出的文件，**不要**为找路径加载本文件全文。改文档结构见 `skill-authoring.md`。\n\n## 基础与纪律\n\n| 文件 | 用途 |\n| --------------------------------------------- | ---------------------------------------- |\n| `references/core/setup.md` | 安装、登录（手机验证码优先）、配置、更新 |\n| `references/core/agent-conventions.md` | 通用纪律 + §十四沟通 |\n| `references/core/user-communication-guide.md` | 重定向 → `agent-conventions.md` §十四 |\n| `references/core/intent-routing.md` | 报告/分析/拓词话术消歧 |\n| `references/core/tips.md` | `--json-out` 脚本食谱 |\n| `references/core/playbooks.md` | 分析/报告工作流（P1–P9） |\n| `references/core/workflows.md` | 操作/管理工作流（W1–W13） |\n| `references/core/subagent-orchestration.md` | 可选：P5/P6/P7 委派 subagent |\n| `references/core/skill-authoring.md` | 维护约定（运行时勿加载） |\n\n## 账户与财务\n\n| 文件 | 用途 |\n| ----------------------------------------------- | ----------------------------------------------------------------- |\n| `references/accounts/accounts.md` | **账户域索引**（按任务再读子文件） |\n| `references/accounts/accounts-list.md` | list-accounts、激活账单、开户申请历史 |\n| `references/accounts/accounts-balance-stats.md` | balance、**balance-scan（P2）**、stats、**accounts-digest（P3）** |\n| `references/accounts/accounts-permissions.md` | 分享/解绑/重授权/MCC/BC/BM/关闭/提现/邮箱授权 |\n| `references/accounts/currency.md` | CNY/USD 字段来源、符号、跨币种禁止求和 |\n| `references/accounts/open-account-by-media.md` | 各媒体开户命令与参数 |\n| `references/accounts/open-account-google-ui.md` | Google 开户字段与 Agent 流程 |\n| `references/accounts/finance.md` | 转账、开票、充值 |\n| `references/accounts/write-audit-restore.md` | 写审计、`--commit`、restore |\n\n## Google 广告\n\n| 文件 | 用途 |\n| --------------------------------------------------- | -------------------------------------- |\n| `references/google-ads/google-ads.md` | **Google Ads 索引**（金额/ID Gotchas） |\n| `references/google-ads/google-ads-read.md` | 系列/组/创意/关键词/搜索词/地理查询 |\n| `references/google-ads/google-ads-write.md` | 创建/编辑/启停/扩展/PMax/设备出价 |\n| `references/google-ads/google-ads-batch.md` | batch 流水线、ad batch、智投草稿 |\n| `references/google-ads/google-ads-campaign-plan.md` | 搜索系列 7 步流水线、validate/create |\n| `references/google-ads/pmax-api.md` | PMax 网关路径、金额口径 "},{"path":"references/report-templates/README.md","content":"# 报告模板目录\n\n本目录包含两类文件：\n\n| 文件类型 | 用途 |\n| ----------------------- | ----------------------------------------------- |\n| `*.md` | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |\n| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容 |\n| `excel-style-guide.md` | Excel 通用样式规范（色板/字体/组件），所有平台共用 |\n| `excel-style-kit.mjs` | 配套代码：Agent 写 xlsx 脚本直接 `import` 使用，零依赖 |\n\n> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。任何「用户要 Excel/xlsx/表格」的模板，写脚本时都按 `excel-style-guide.md` 套样式，不再裸写无样式单元格。\n\n**图表库（全部 HTML 模板统一）**：ECharts 5 — `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.min.js`；初始化用 `echarts.init(el).setOption(...)`。勿使用 Chart.js。\n\n**图表自适应**：逻辑必须写在**同一份 HTML 模板内**（`window.addEventListener('resize', … chart.resize())`，可选对容器做 `ResizeObserver`）。报告下载到本地后仍可用；禁止依赖外挂 `*.snippet.js` 或 monkey-patch CDN。\n\n---\n\n## 内容纲要文件\n\n| 文件 | 适用场景 |\n| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |\n| `google-quarterly-report.md` / `.html` | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章 |\n| `google-quarterly-plan.md` | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读 |\n| `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |\n| `stats-daily-excel.md` | **P4-DAILY**：账户级按日 Excel（`stats --by-day`） |\n| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |\n| `google-ads-diagnosis.md` | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**） |\n| `meta-period-report.md` / `.html` | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |\n| `meta-period-report-excel.md` | **仅用户要 Excel 时**：5 Sheet（**汇总数据**/日趋势/国家/广告系列/受众，汇总 KPI 下是一/二/三）；`facebook-analysis render --format xlsx` "},{"path":"report-templates/README.md","content":"# 报告模板目录\n\n本目录包含两类文件：\n\n| 文件类型 | 用途 |\n| ----------------------- | ----------------------------------------------- |\n| `*.md` | 报告内容纲要：默认维度、可选维度、对应 CLI 命令 |\n| `report-template*.html` | 视觉样式参考：排版/色彩/图表方案，不定义内容 |\n| `excel-style-guide.md` | Excel 通用样式规范（色板/字体/组件），所有平台共用 |\n| `excel-style-kit.mjs` | 配套代码：Agent 写 xlsx 脚本直接 `import` 使用，零依赖 |\n\n> 冲突时以 `*.md` 的内容要求为准，样式文件仅影响排版。任何「用户要 Excel/xlsx/表格」的模板，写脚本时都按 `excel-style-guide.md` 套样式，不再裸写无样式单元格。\n\n**图表库（全部 HTML 模板统一）**：ECharts 5 — `https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.min.js`；初始化用 `echarts.init(el).setOption(...)`。勿使用 Chart.js。\n\n**图表自适应**：逻辑必须写在**同一份 HTML 模板内**（`window.addEventListener('resize', … chart.resize())`，可选对容器做 `ResizeObserver`）。报告下载到本地后仍可用；禁止依赖外挂 `*.snippet.js` 或 monkey-patch CDN。\n\n---\n\n## 内容纲要文件\n\n| 文件 | 适用场景 |\n| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `google-period-report.md` | **Google 周期分析报告（默认）**：终稿=HTML，四步流程 → `google-analysis render` 出 HTML |\n| `google-quarterly-report.md` / `.html` | **Google 季度经营报告（P10）**：`google-quarterly collect`+`render`；花费三档基于本期；无行业章 |\n| `google-quarterly-plan.md` | **P10 下期规划规则**：九章 + Q01–Q30；写 `narrative.plan` 前必读 |\n| `google-period-report-excel.md` | **仅用户要 Excel 时**（P4 定制 Sheet）：先 `*.outline.txt` 后脚本写 xlsx；账户须 `-k` 核验，无 CLI excel 子命令 |\n| `stats-daily-excel.md` | **P4-DAILY**：账户级按日 Excel（`stats --by-day`） |\n| `google-account-diagnosis-report.md` | Google 账户深度诊断（健康度/转化/结构等） |\n| `google-ads-diagnosis.md` | Google **广告诊断**完整纲要（HTML 区块、**每日趋势 2 位小数**、**每模块必填分析/建议**） |\n| `meta-period-report.md` / `.html` | **Meta（Facebook）周期报告（默认）**：四步流程 → `facebook-analysis render` 出 HTML，见 P4-FB |\n| `meta-period-report-excel.md` | **仅用户要 Excel 时**：5 Sheet（**汇总数据**/日趋势/国家/广告系列/受众，汇总 KPI 下是一/二/三）；`facebook-analysis render --format xlsx` "}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1679,"uniquenessScore":33,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T06:55:46.249Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T06:55:46.249Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T14:45:52.609Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}