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

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

0. 安全与透明性说明

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

运行时依赖

| 项目 | 说明 | | ---------------------- | ---------------------------------------- | | Node.js 18+ | CLI 运行时 | | npm 8+ 或 pnpm | 安装 CLI 全局包 | | siluzan-cso CLI | 由 npm install -g siluzan-cso-cli 安装 | | ffmpeg（可选） | extract-cover 命令截取视频封面帧 |

凭据与网络

| 项目 | 说明 | | --------------- | ------------------------------------------------------- | | API Key / Token | 存储在 ~/.siluzan/config.json，用于所有 API 调用鉴权 | | CSO API | api.siluzan.com（生产）/ api-ci.siluzan.com（测试） | | 前端页面 | cso.siluzan.com（授权回调等浏览器操作） | | 版本检查 | registry.npmjs.org |

可选环境变量

| 变量 | 说明 | | -------------------- | ---------------------------------------------------------- | | SILUZAN_AUTH_TOKEN | 从环境变量读取 Token（优先级高于 config.json，CI/CD 推荐） |

可执行的操作范围

• 只读：查询媒体账号、运营报表、发布任务状态、人设列表、RAG 知识库检索等
• 写入（需用户确认）：上传素材、提交发布任务、创建/更新账号分组、生成 AI 内容规划
• 本地文件操作：extract-cover 截取视频帧输出图片；init 将 Skill 文件写入 AI 助手目录

1. 环境

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

2. 安装 CLI 并初始化 Skill

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

npm install -g siluzan-cso-cli
siluzan-cso init --ai cursor         # 写入 Cursor（默认）
siluzan-cso init --ai cursor,claude  # 同时写入多个平台
siluzan-cso init --ai all            # 写入所有支持的平台
siluzan-cso init -d /path/to/skills  # 写入自定义目录
siluzan-cso 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-cso 与 siluzan-tso 共用同一个凭据（存储在 ~/.siluzan/config.json）。

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

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

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

第 1 步只发送验证码并立即返回；第 2 步用验证码自动创建 API Key 并保存到 ~/.siluzan/config.json。

方式 B：交互式登录

siluzan-cso login

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

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

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

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

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

4. 验证

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

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

完成后，用户可在对话中描述内容发布需求（上传素材、发布视频到抖音/视频号/YouTube/TikTok/Instagram、查看媒体账号、管理站内信等），由已加载的 Skill 指导 siluzan-cso CLI 的使用方式。

5. 更新

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

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

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

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

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

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

6. Token 续期

Token 过期后，重新运行 siluzan-cso login 或 siluzan-cso config set --api-key <新Key> 即可，siluzan-cso 自动读取新凭据，无需额外操作。