交给 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。本地模式不需要 Key;中心模式复用已有有效 profile,否则使用用户授权的中心地址与 Key。部署新中心先读取 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
开始用工具、参数或返回值不明确 AI_GUIDE.md,再看实际工具 schema
原生节点、P2P、SSH 跳板、多端同步 NATIVE_SYNC.md
持续探测、集群、自动选路 CLUSTERS.md
制作自己的免输入包 PRIVATE_BUNDLES.md
安装、鉴权、连接或卸载问题 TROUBLESHOOTING.md

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