用途 Renoise Setup 是 Renoise 官方插件的跨宿主安装流程，用于在任意 agent 主机上安装、更新、配置、连接、登录和诊断 Renoise，并检查依赖。它不预设用户使用 Claude Code、Codex、OpenClaw 或某个特定配置目录，而是把 <PLUGIN_ROOT> 解析为技能目录上两级的目录。其他 Renoise 工作流在预检失败时也可能自动调用此技能。
主要能力
- 插件副本新鲜度检查：在修复 CLI 前，先运行 check-plugin.mjs 检查已安装插件是否落后于最新公开版本。退出码 0 表示当前或更新；退出码 2 时打印宿主机专属升级命令并停止，直到用户更新或重装插件并重启宿主；退出码 1 表示网络/API 失败，警告一次后继续。插件安装由各宿主市场负责，此检查只做引导。
- 连接 Renoise 工具：对话中的所有 Renoise 操作（模型、估算、生成、上传、分析、结果）都通过位于 https://renoise.ai/api/public/mcp 的 Renoise MCP 服务器完成，连接它就是生成所需的唯一步骤。用户只需在浏览器中通过 OAuth 登录一次，绝不索取 API 密钥。不同宿主的连接方式包括：Claude Code 使用 /mcp 选择 plugin:renoise:renoise 认证；Codex / ChatGPT Desktop 需安装 Renoise 市场插件并授权；Codex CLI 可用 codex mcp login renoise；Claude Desktop 和 claude.ai 在设置→连接器中添加 Renoise 连接器；OpenClaw 需添加名为 renoise 的 MCP 服务器并设置 streamable-http 传输与 oauth 认证。不可自行从 shell 启动登录，因为一次性 localhost 回调由用户终端或宿主设置掌控。连接后调用 get_account 工具验证。
- 可选原生 CLI：仅用于标注板、renoise-cli 本地辅助工具和用户自有脚本。先检测 node 与 renoise 是否存在，再用 renoise version 及 help 子命令验证命令契约（task create、task cost、task wait、analyze、auth exec、auth login，以及 --prompt-file、--edit、--mode、--web 等标志）。可用 install-cli.mjs --ensure 无提示地保持受管 CLI 为最新，受管目标在 macOS/Linux 为 ~/.local/bin/renoise，Windows 为 %LOCALAPPDATA%\Renoise\bin\renoise.exe；--check 为干跑；--install 需确认后执行。安装器支持 macOS、Windows、Linux 的 x64 或 ARM64，选择 .tar.gz 或 .zip 并用 checksums.txt 校验。需要修改 PATH 或 shell 配置时须先征得确认。CLI 认证先运行 renoise auth status --json，未认证则由 Agent 运行 renoise auth login --web --json，用户在浏览器中登录并选择 Allow and connect，凭据通过一次性 localhost 回调保存，RENOISE_API_KEY 可供 CI 和容器覆盖。用 renoise account status --json 和 renoise model --json 验证。
- 检查工作流就绪度：检测 jq（Director 批量生成）、ffmpeg 与 ffprobe（组装、尾帧、QC、音频混音、视频检查）、yt-dlp（视频下载）、ImageMagick magick（故事板网格切分与可选 QC 回退）、agent-browser（可选抖音/TikTok 下载回退）。只建议安装相关缺失工具，且安装前需确认。
- 输出报告：返回简短的就绪摘要，涵盖 MCP 连接、生成与媒体分析、CLI、Director/QC、下载、可选浏览器回退等状态。
使用方式 由宿主在插件安装后触发，或在其他 Renoise 工作流预检失败时自动调用；用户按提示在宿主设置或终端中完成浏览器授权。CLI 安装和依赖安装均需显式确认。
适用场景 首次配置 Renoise、升级插件或 CLI、排查连接与登录问题、检查生成和媒体工作流依赖是否齐全。
限制 不索取聊天中的 API 密钥；不擅自安装软件、移动二进制、编辑 PATH 或更改宿主配置；插件替换只能由宿主市场完成；缺少可选工具不阻塞生成与媒体分析；Linux 无官方 Codex Desktop 应用，但 CLI 和技能可在 Codex CLI 与 Claude Code 中使用。