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

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

1. 环境

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

2. 安装 CLI 并初始化 Skill

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

npm install -g siluzan-cso-cli@beta
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             # 强制覆盖已存在文件

注意：当前为测试版（1.0.0-beta.28），供内部测试使用。正式发布后安装命令将改为 npm install -g siluzan-cso-cli。

| 助手 | 建议 --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：交互式登录（推荐）

siluzan-cso login

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

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

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

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 自动读取新凭据，无需额外操作。