用途：setup-shiprust 用于完成 ShipRust 与当前 AI 代理的首次连接配置。用户从 ShipRust 控制台复制安装提示后，代理按步骤完成密钥保护、插件/技能安装、MCP 连接与验证，随后即可使用 ShipRust 技能。
主要能力：
- 密钥保护：将提示中的 API 密钥（sr_ 后跟 64 位十六进制字符）视为密码，存入代理的受保护环境或密钥存储，命名为 SHIPRUST_API_KEY，使 MCP 连接与代理 shell 均可读取；只说明存储位置，不回显密钥内容；只允许发送至 https://shiprust.com。
- 按客户端安装：先检测实际客户端及版本，仅对用户正在使用的代理安装，不覆盖已有设置、不关闭审批、不擅自重启共享服务。优先使用原生插件：Claude Code 使用 /plugin marketplace add LVTD-LLC/shiprust-skills 和 /plugin install shiprust-skills@shiprust；Codex 先检查 codex plugin --help，再执行 codex plugin marketplace add LVTD-LLC/shiprust-skills 和 codex plugin add shiprust-skills@shiprust；Cursor、OpenClaw、Hermes、OpenCode、VS Code/Copilot、ChatGPT 等按各自代理安装方式处理。仅在原生插件不可用时，才使用可移植技能加独立 MCP 条目，并向用户说明具体原因；两种方式不并用，原生插件已内置 MCP 服务器时不重复注册。
- 建立连接：MCP 地址为 https://shiprust.com/mcp，传输方式为 Streamable HTTP，请求头为 Authorization: Bearer <key>；变量插值语法因客户端而异，应遵循对应代理的安装说明。如客户端需要，重新加载工具或开启新会话。若 MCP 不可用或被阻止，改用 REST API 及 shiprust 技能中无依赖的辅助脚本 scripts/shiprust_api.py，该脚本读取同一环境变量。
- 只读验证：调用 get_account、list_options、list_projects（或 GET /api/v1/me、/api/v1/options、/api/v1/projects）。保存的配置或工具列表成功不等于验证通过，必须以已鉴权的 get_account 为准。若账户无付费访问权限，引导用户访问 https://shiprust.com/billing，不进行任何购买。
- 汇报：简要说明安装了什么、密钥存储位置（不透露值）、哪种传输方式可用、账户是否有访问权限及剩余限制，并告知用户此后可提出项目需求，例如“创建名为 Acme 的 ShipRust 项目并在本地运行”。
使用方式：用户从 ShipRust 控制台复制安装提示并交给代理，代理按上述步骤执行。若提示中无密钥，则使用环境中的 SHIPRUST_API_KEY；若仍缺失，请用户重新从 https://shiprust.com/dashboard 复制安装提示，不自行编造密钥。若在安装前从 GitHub 阅读此内容，可从 https://raw.githubusercontent.com/LVTD-LLC/shiprust-skills/main/ 获取链接文件。
适用场景：需要让 Claude Code、Codex、Cursor、VS Code/Copilot、ChatGPT 等 AI 代理接入 ShipRust 账户并开始管理项目的用户。
限制：安装阶段不创建或删除项目；不覆盖已有设置；不关闭审批；不擅自重启共享服务；不重复注册 MCP；不打印、记录、提交或回传密钥；不将密钥发送至非 shiprust.com 的域名、生成的应用或代理；账户付费状态与计费细节以用户实际访问 https://shiprust.com/billing 为准。