# 排障、更新和卸载

| 现象 | 检查 |
| --- | --- |
| 双击程序没有界面 | 主程序是 MCP stdio 服务，正常等待客户端输入；按安装手册接入 |
| 客户端找不到程序 | 使用安装输出的绝对路径，确认解压/安装目录未被清理 |
| count=0 | 首次空目录正常；核对 SSH_CONFIG_PATH，添加自己的目标 |
| 超时很快发生 | timeout 单位是毫秒，10 只有 10 毫秒，10000 才是 10 秒 |
| 中心 401 | 核对自己的中心 URL 和 Key；公开包没有账号，不能接入发布者的私有目录 |
| 新客户端中心连接失败 | 新实例首次启动需要中心可达；现有后台保留最近验证目录不等于新实例可离线启动 |
| SSH 认证失败 | 核对目录中的用户、密钥/密码、实际跳板及 ssh_connection_status；不要自动换用无关账号 |
| helper 无法执行 | helper 是远端 Linux x86_64 程序；保持配套文件，并查看返回的兼容传输路径 |
| Linux 权限拒绝 | 执行 chmod u+x 或重新运行平台安装脚本；目录/配置权限按当前用户设置 |
| Windows 脚本被阻止 | 在当前进程使用文档所示 ExecutionPolicy Bypass，或由已授权 AI 按脚本复制程序；不必改变全局策略 |
| 安装显示成功但客户端仍用旧版 | 文件保存和应用重载是不同状态；重载 MCP 后检查实际 discovery |

更新时使用新的版本目录，核对摘要后只改 SSHMCP command 路径，保留服务器目录、私密 profile、其他 MCP 配置和活动任务。旧版正在运行时不要替换它的 EXE。

卸载时先在实际客户端移除对应 SSHMCP 条目并正常重载，再删除确认不用的安装版本目录。自己的 ssh-config.toml、connection.json、SSH 密钥及备份单独保留或由你明确决定删除；它们不属于可随意清理的程序缓存。
