# 交给 AI 安装

这是 SSHMCP 公开安装包，包含 Linux / Windows x86_64 程序。先只读检查平台、包摘要和现有安装；再按用户已经选定的范围执行。

## 先确定两件事

| 选择 | 可用值 |
| --- | --- |
| 安装方式 | 本地独立使用、接入已有中心、部署自己的中心 |
| 客户端 | Codex、Snow、Pi、Claude Code、Claude Desktop，或只安装程序 |

**当前对话或下载页生成的指令已经给出选择，就直接沿用。** 只询问仍缺的项目，不因检测到某个客户端就自动安装到它。`--clients auto` 只用于用户明确选择所有已安装的受支持客户端；`none` 表示不改客户端配置。

## 按顺序完成

1. **校验与定位**：检查外层 ZIP 和对应平台 `SHA256SUMS`；确认 Windows 或 Linux x86_64。macOS、ARM 或缺失文件时停止该安装路径，不猜下载地址。
2. **读取一条安装路径**：[INSTALL.md](docs/INSTALL.md)。本地模式不需要 Key；中心模式复用已有有效 profile，否则使用用户授权的中心地址与 Key。部署新中心先读取 [CENTER_SETUP.md](docs/CENTER_SETUP.md)，确定目标和范围。下载站不是公共 MCP 中心。
3. **运行包内脚本**：从解压包根目录使用相应平台安装器，显式传入已选 `--clients`。不要手写另一套旧版 `--stdio` 配置，不替换用户的 AI 客户端。Key 使用原生隐藏输入或私密文件，不要求贴在聊天里。
4. **核对安装回执**：读取输出中的 `installed_binary`、`profile`、`configured_clients`、`verification`、`automaticUpdate`。用返回的真实程序与 profile 执行 `doctor`。保留无关配置、身份、备份、活动任务；不强制结束客户端。
5. **验证实际客户端**：让选定客户端正常重载 MCP，再从该客户端调用 `ssh_list_servers`。返回 `count=0` 是有效空目录。用户提供目标后再添加，并对那个目标执行一个只读命令；不要遍历登录所有服务器。
6. **分别报告**：程序已安装、配置已保存、新进程已验证、当前客户端已加载。没有完成哪一层就说明哪一层待验证；不以新进程代替用户当前客户端。

## 需要时再读

| 任务 | 下一步 |
| --- | --- |
| 已有客户端升级、更新 deferred | [UPDATES.md](docs/UPDATES.md) |
| 开始用工具、参数或返回值不明确 | [AI_GUIDE.md](docs/AI_GUIDE.md)，再看实际工具 schema |
| 原生节点、P2P、SSH 跳板、多端同步 | [NATIVE_SYNC.md](docs/NATIVE_SYNC.md) |
| 持续探测、集群、自动选路 | [CLUSTERS.md](docs/CLUSTERS.md) |
| 制作自己的免输入包 | [PRIVATE_BUNDLES.md](docs/PRIVATE_BUNDLES.md) |
| 安装、鉴权、连接或卸载问题 | [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) |

默认不新增系统启动项。确需登录或开机常驻时才设置 `--startup`。中心模式默认自动更新；没有更新器的旧版需首次安装升级并重载，不能只换中心就声称旧客户端已更新。