Siluzan TSO Skill — 给大模型的安装说明

当用户发来本页面的 URL 时，请按顺序协助用户完成安装。

0. 安全与透明性说明

本 Skill 是 instruction-only（纯指令型），不包含可执行代码文件。它通过指导 AI 助手调用 siluzan-tso CLI 来操作丝路赞广告管理平台。

运行时依赖

| 项目 | 说明 | | ---------------------- | ---------------------------------------- | | Node.js 18+ | CLI 运行时 | | npm 8+ 或 pnpm | 安装 CLI 全局包 | | siluzan-tso CLI | 由 npm install -g siluzan-tso-cli 安装 |

凭据与网络

| 项目 | 说明 | | --------------- | ------------------------------------------------------ | | API Key / Token | 存储在 ~/.siluzan/config.json，用于所有 API 调用鉴权 | | 前端页面 | www.siluzan.com（充值、激活等浏览器操作） | | 错误追踪 | o605862.ingest.us.sentry.io（匿名崩溃日志） | | 版本检查 | registry.npmjs.org |

可执行的操作范围

• 只读：查询账户列表、余额、消耗数据、报告、预警记录等
• 写入（需用户确认）：创建/修改/发布广告、开户申请、创建预警规则、报告推送配置
• 破坏性（必须用户确认；解绑/取消分享/reauth 另须 CLI --i-confirm）：账户解绑/关闭、MCC/BC 解绑、删除预警/报告/广告、发票申请

报告模板外部资源

HTML 报告模板外部资源：ECharts 统一使用 https://staticpn.siluzan.com/assets/slz/homeCDN/echarts.min.js；图表 resize 自适应写在各模板 HTML 内部。其余样式/脚本可能引用 cdn.tailwindcss.com、cdnjs.cloudflare.com、fonts.googleapis.com 等。

1. 环境

• Node.js 18+
• 可执行 npm 或 pnpm

2. 安装 CLI 并初始化 Skill

在用户的目标项目根目录执行（根据用户使用的助手选择 --ai）：

npm install -g siluzan-tso-cli
siluzan-tso init --ai cursor         # 写入 Cursor（默认）
siluzan-tso init --ai cursor,claude  # 同时写入多个平台
siluzan-tso init --ai all            # 写入所有支持的平台
siluzan-tso init -d /path/to/skills  # 写入自定义目录
siluzan-tso init --force             # 强制覆盖已存在文件

| 助手 | 建议 --ai | | ----------------------- | ------------------------------------ | | Cursor | cursor | | Claude Code | claude | | OpenClaw（项目内技能） | openclaw 或 openclaw-workspace | | OpenClaw（全局技能） | openclaw-global | | WorkBuddy（项目内技能） | workbuddy 或 workbuddy-workspace | | WorkBuddy（全局技能） | workbuddy-global | | 一次写入多处 | all |

3. 登录 / 鉴权

siluzan-tso 与 siluzan-cso 共用同一个凭据（存储在 ~/.siluzan/config.json）。

若用户已安装 siluzan-cso 并完成登录，无需重复操作，直接跳到第 4 步。

推荐顺序：① 手机号 + 验证码（首选）完整参数与排错见 references/core/setup.md（随 Skill 安装到本地）。

方式 A：手机号 + 验证码（推荐）

siluzan-tso send-login-code --phone <手机号>
siluzan-tso login --phone <手机号> --code <6位验证码>

不向终端索要交互输入；Agent 先发码、用户回填验证码后再执行第二步。手机号须已在丝路赞注册。

方式 B：交互式登录（需真人 TTY）

siluzan-tso login

按提示访问丝路赞控制台「个人设置 → API Key 管理」页面创建 API Key 后粘贴到终端，自动保存。也可跳过交互直接传入：

siluzan-tso login --api-key <YOUR_API_KEY>

方式 C：直接设置（适合自动化场景）

siluzan-tso config set --api-key <你的ApiKey>

方式 D：Token 登录（已有 siluzan-cso 账号）

npm install -g siluzan-cso-cli
siluzan-cso login

向导会提示用户访问 https://www.siluzan.com 注册登录，在「个人设置 → API Token」页面复制 Token 粘贴到命令行，自动保存后 siluzan-tso 会读取该 Token。

提醒用户：不要将 Token / API Key 提交到 Git。

4. 验证

确认以下路径已存在且含 SKILL.md 和 _meta.json：

| 助手 | Skill 文件路径 | | ---------------- | ------------------------------------------ | | Cursor | .cursor/skills/siluzan-tso/SKILL.md | | Claude Code | .claude/skills/siluzan-tso/SKILL.md | | OpenClaw 工作区 | skills/siluzan-tso/SKILL.md | | OpenClaw 全局 | ~/.openclaw/skills/siluzan-tso/SKILL.md | | WorkBuddy 项目级 | .workbuddy/skills/siluzan-tso/SKILL.md | | WorkBuddy 全局 | ~/.workbuddy/skills/siluzan-tso/SKILL.md |

完成后，用户可在对话中描述广告账户管理需求（查账户、查余额、查消耗、充值、开户、绑定 MCC/BC/BM、管理 Google 广告等），由已加载的 Skill 指导 siluzan-tso CLI 的使用方式。

5. 更新

CLI 在每次命令执行后会静默检查是否有新版本可用，有更新时会提示：

💡 发现新版本 x.x.x（测试版），运行以下命令升级：
   npm install -g siluzan-tso-cli@beta

发现提示后，Agent 应主动执行以下两步完成升级：

# 第一步：升级 CLI
{{INSTALL_CMD}}

# 第二步：用新版 CLI 重新写入 Skill 文件（--force 覆盖旧版）
siluzan-tso init --ai xxx --force

--ai 参数换成实际使用的平台（如 claude、openclaw-global 等）。 若不确定当前安装在哪个平台，可查看 ~/.siluzan/config.json 中的 tsoInstalledTargets 字段。

6. Token 续期

Token 过期后：优先再走一遍方式 A（手机验证码）签发新 API Key；或 siluzan-cso login / siluzan-tso config set --api-key <新Key>，siluzan-tso 自动读取新凭据。