排查常见问题
连接、版本、授权和输出异常的检查顺序。
概览
先确认本机代理运行、管理页已配对、客户端 MCP 指向当前安装目录。若工具不可见，在新会话中检查插件或 stdio 配置；不要通过开放公网端口解决本机连接问题。
边界与检查
审批失败时检查状态、有效期和配置版本。SSH 指纹不符应从可信渠道重新核对，不能关闭验证。输出被截断则按返回游标续读；网络超时后先确认远端是否已执行。
按故障发生的阶段排查
| 现象 | 优先检查 |
|---|---|
| 管理页打不开 | 用活动程序 status 确认后台运行；在服务所在电脑用 open 打开本机页面，不开放公网端口 |
| 首次链接失效 | PIN 尚未设置时重新执行 open 生成新的一次性链接，不刷新旧链接 |
| MCP 工具不可见 | 核对客户端加载的活动程序绝对路径、相同数据目录和 stdio 支持，重载客户端后调用只读能力工具 |
| 凭据库不可用 | 解锁或修复系统凭据库，不改用明文文件或关闭系统安全设置 |
| SSH 主机拒绝 | 核对地址、端口及独立可信来源提供的指纹；不自动接受变化 |
| 审批不可用 | 查有效期、状态、单次消费及目标／模板／凭据版本是否变化 |
| 输出被截断 | 使用返回的游标继续读取保留窗口；已被轮换的旧输出不能靠重跑任务补回 |
| 超时或连接中断 | 查询原运行、目标系统状态和固定错误代码，再判断是否有必要重新申请 |
不要用绕过控制的方法修复
测试连接失败并不授权关闭 TLS、跳过 SSH 主机验证或使用更宽泛账号。HTTP 测试仅发 HEAD；拒绝 HEAD 的服务不代表所有业务接口不可用。数据库返回 cleanup_ok:false 时须核查远端会话；Git 推送与文件覆盖可能已提交，停止本地任务无法撤回。
反馈普通缺陷时，提供产品版本、平台、安装方式、脱敏后的最小复现和清理结果；不要提交密码、PIN、恢复密钥、真实业务地址、个人路径或原始日志。可能的安全漏洞通过私密渠道报告。相关操作见安装、客户端、审批与备份。