Siluzan TSO

Siluzan TSO Skill

本 Skill 只保留任务边界、文档路由与执行规则。具体业务细节、参数、模板、流程与示例均以下方 references 文档为准。遇到具体业务时，先读对应 references

一键安装

如果 CLI 尚未安装，直接帮用户执行对应平台的安装脚本：

  bash <(curl -fsSL https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.sh)
  

  irm https://unpkg.com/siluzan-tso-cli@latest/dist/skill/scripts/install.ps1 | iex
  

脚本会自动完成 Node.js 检测/安装、CLI 安装、Skill 全局注册，并引导用户配置 API Key。无需选择，本脚本专为 siluzan-tso-cli 定制。

前置条件与运行时依赖

使用本 Skill 前，以下组件必须已安装并就绪：

可选环境变量

| 变量 | 说明 | | ------------------------- | ------------------------------------------------------------------ | | SILUZAN_API_KEY | 从环境变量读取 API Key（优先级高于 config.json，CI/CD 推荐） | | SILUZAN_AUTH_TOKEN | 从环境变量读取 JWT Token（优先级高于 config.json） | | SILUZAN_DATA_PERMISSION | 从环境变量读取数据权限标识（优先级高于 config.json，跳过自动拉取） |

如果上述依赖缺失，请先参照 references/setup.md 完成安装与配置。

功能以及对应文档

本skill包含以下功能，实现用户要求时，请先阅读对应功能文档： | 文档 | 功能 | |------|------| | references/setup.md | 安装、登录、配置、环境切换、更新 | | references/workflows.md | 多步骤业务流程、跨命令串联；入口指向宿主编排自控详页 | | references/tips.md | Agent 拉数一律 --json-out（目录或 *.json 文件）+ 读 cli-manifest.json / 各 *.json + *.outline.txt（TS 式类型）；stdout 一行摘要仅 outlineFile 等短字段；账户分析同口径（见 account-analytics.md） | | references/accounts.md | 账户列表、余额、消耗、开户记录、授权/解绑/分享/MCC/BC/BM/邮箱授权 | | references/open-account-by-media.md | 各媒体开户、参数与资料要求 | | references/google-ads.md | Google Ads 创建、修改、优化与管理主流程；含 ad list 等读命令的 JSON 拒审字段（policyApprovalStatusV2、approvalStatusDetails 等，见该文档「拒审与政策字段」）；账户分析口径见 google-analysis … --json-out（account-analytics.md） | | references/reporting.md | Siluzan TSO 优化报告（Google/TikTok）的生成、推送与查看 | | references/account-analytics.md | 广告平台账户分析数据拉取与分析/诊断报告模板 | | references/optimize.md | AI 优化建议记录、详情与历史查询 | | references/clue.md | TikTok / Meta 线索表单 | | references/forewarning.md | Siluzan提供的全流程的智能预警规则与通知服务，功能有限、你只需要负责创建，剩下的由Siluzan服务来完成，不推荐使用这个来处理预警 | | references/hosted-automation-user-catalog.md | （推荐用于预警处理）更强大的智能预警，由你全流程控制（创建+定时检测+通知用户）基础包括，预算/ROI 自控、异常监控、自动优化、自动化风控。详情请阅读这个文件references/hosted-automation-user-catalog.md| | references/finance.md | 转账、开票、发票抬头、充值网页引导 | | report-templates/report-template.html | 默认 HTML 报告样式参考（多格式交付见 references/account-analytics.md） |

职责划分

定位：siluzan-tso + 本 Skill 提供 可组合的读能力（检查项） 与 可验证的写能力（最终操作）；不负责在进程内长期驻留、定时轮询、复合条件规则引擎、或替代宿主的通知渠道。

| 由 本 Skill + CLI 保证 | 由 宿主客户端 / 外部调度 负责 | |---------------------------|-----------------------------------| | 单次/按需调用下，命令能拉取验证所需的 结构化字段（Agent：--json-out <目录> 落盘后读文件；账户分析子命令同 --json-out；分页见 references/tips.md） | 何时跑一轮检查（cron、事件、对话触发） | | 写操作命令语义清晰，且文档给出 写后如何用读命令复核（成对验证） | IF 条件（多指标 AND/OR、滑动时间窗、相对预算比例等）的计算与决策 | | 金额与 ID 口径与文档一致（*Display、entityId vs mediaCustomerId 等硬规范） | 命中后的 触达（钉钉/飞书/Slack 等）与内部 P1/工单 流程 | | references/google-ads.md 等与命令、字段含义对齐 | 多账户、多系列的 批处理循环、限速、失败重试策略 |

宿主集成时的推荐约定：

1. 监控与编排：配置定时或事件；每轮用本 Skill 指明的命令拉数，在宿主侧用脚本 / node -e 做条件判断。 2. 执行写操作：仍遵守本 Skill 计划 →（按策略）确认 → 执行 → 验证；若宿主策略为「全自动写」，须由用户或配置显式授权，避免与默认安全规范冲突。 3. 验证：每次写入后，用文档中的 读命令对同一 id 再拉一次（例如 ad campaign-status 后 ad campaigns --json-out

mkdir -p ./snap-p2
siluzan-tso balance-scan -m BingV2 --threshold-days 7 --json-out ./snap-p2
筛绝对余额：再叠加 --min-balance 100
自定义续航目标：--target-days 60 会算出"充到够用 60 天"的建议充值额

{
  "ok": true,
  "data": { "items": [{ "mediaCustomerId": "...", "balance": 42.3, "dailySpend": 7.1, "remainingDays": 5.9, "recommendedTopup": 170.69, ... }] },
  "meta": { "media": "BingV2", "scannedAccounts": 117, "hitCount": 23, "thresholds": { ... } }
}

mkdir -p ./snap-p3
siluzan-tso accounts-digest -m Google \
  -a 4251234567,7209009390,... \
  --start 2026-04-01 --end 2026-04-15 \
  --json-out ./snap-p3