排障、更新和卸载
| 现象 | 检查 |
|---|---|
| 双击程序没有界面 | 主程序是 MCP stdio 服务，正常等待客户端输入；按安装手册接入 |
| 客户端找不到程序 | 使用安装输出的绝对路径，确认解压/安装目录未被清理 |
| count=0 | 首次空目录正常；核对安装 profile 的模式/目录来源，用户提供目标后再添加 |
| 超时很快发生 | timeout 单位是毫秒，10 只有 10 毫秒，10000 才是 10 秒 |
| 中心 401 | 核对自己的中心 URL 和 Key；公开包没有账号，不能接入发布者的私有目录 |
| 新客户端中心连接失败 | 新实例首次启动需要中心可达；现有后台保留最近验证目录不等于新实例可离线启动 |
| SSH 认证失败 | 核对目录中的用户、密钥/密码、实际跳板及 ssh_connection_status；不要自动换用无关账号 |
| helper 无法执行 | helper 是远端 Linux x86_64 程序；保持配套文件，并查看返回的兼容传输路径 |
| Linux 权限拒绝 | 执行 chmod u+x 或重新运行平台安装脚本；目录/配置权限按当前用户设置 |
| Windows 脚本被阻止 | 核对文件来源、签名/下载标记及当前用户策略；必要时按已授权范围仅对当前进程处理，仍须校验完整包，不放宽全局策略 |
| 自动更新为 deferred | 关闭已完成的业务会话/隧道，等待正在执行的操作或原生流结束；见 UPDATES.md |
| 自动更新失败 | 检查更新状态和私密日志；原程序保留，安装失败另核对 rollbackSucceeded |
| 安装显示成功但客户端仍用旧版 | 文件保存和应用重载是不同状态；重载 MCP 后检查实际 discovery |
更新时使用新的版本目录，核对摘要后只改 SSHMCP command 路径，保留服务器目录、私密 profile、其他 MCP 配置和活动任务。旧版正在运行时不要替换它的 EXE。
卸载时先在实际客户端移除对应 SSHMCP 条目并正常重载，再删除确认不用的安装版本目录。自己的 ssh-config.toml、connection.json、SSH 密钥及备份单独保留或由你明确决定删除；它们不属于可随意清理的程序缓存。
工具选错、ID/路径/参数不明确或返回部分成功时，先读 AI_GUIDE.md 的选用与结果表。原生节点和路由故障先 inspect，再据实际观察制定修复计划；不要自动更换用户账号、跳板或中心。