工具指南
抢救方案
能修问题的那个 agent 正是坏掉的那个。所以抢修不能从它出发：你需要一双不和它同归于尽的手，以及一个固定的检查顺序。
这治的是什么
「agent 坏了」其实是四种毛病，彼此几乎不相干。花十分钟把层次说清楚，能省掉一小时装错东西。
- 根本起不来。安装包、运行库、权限、杀毒隔离，或者某个配置文件已经不是合法 JSON 了。
- 起来了，但打字没反应。输入层：窗口有焦点但输入框没有，输入法卡住，别的程序的全局热键把按键吃了。
- 起来了，每个请求都报错。账号层：key 过期、base URL 写错、中间有代理或 VPN、系统时间差太多导致 TLS 失败。
- 答得好好的，东西就是没落地。写入层：目录只读、进程在沙箱里、或者指向了一个已经没了的目录。
先准备好抢救包
- 第二个 agent，已经装好并登录。换一家，免费档就行。它不需要多聪明，只需要能在这台机器上跑、能读文件、能执行命令。
- 一条你信得过的终端。PowerShell 或终端，在 agent 之外。如果你只会用 agent 执行命令，那才是真问题。
- 配置目录的副本——放 agent 设置的那个目录，拷到第二块盘，带日期。不是把 key 抄出来，是留一份「配置长什么样」，好对比是哪一行变了。
- 一张写着位置的小纸条：安装路径、配置路径、日志路径。三行。趁一切正常时写，出事以后你就查不到了。
按这个顺序诊断
- 先看日志，别先动手。看第一条错误，不是最后一条。多数故障在第三行就说清了原因，后面四十行都是后果。
- 查时钟和磁盘。系统时间差几分钟，TLS 就会以证书为由失败；盘满了，写入会以权限为由失败。两个都是五秒钟的检查，两个都常被误判成「厂家挂了」。
- 把账号和客户端分开。用同一个 key，换另一个客户端（也就是那个备用 agent）去调同一个接口。能通，说明 key 没事、客户端坏了；不通，说明客户端没事、账号坏了。
- 用干净配置启动一次。把配置目录改名，启动，看能不能起来。能起来，问题就在你配置的某一行——恢复一半、再恢复一半地二分。
- 覆盖安装。不是先卸再装。覆盖装会保留本地数据，卸载经常不会。安装器里有「修复」就选修复。
- 剩下的交给备用 agent。把日志粘给它，让它去读文件、去搜。坏掉的那个在旁边待着。
容易翻车的地方
- 先卸载。这是把「十分钟能修好」变成「丢一下午本地历史、保存的提示词和会话文件」最常见的方式。永远先试覆盖安装。
- 从另一台机器拷配置目录。它会带着那台机器的路径过来，报出来的错看起来像权限问题。要拷就拷文件，然后把路径改掉。
- 第一步就换 key。于是你同时有两个变化要推理，而旧 key 已经没了。先换客户端验证，再决定要不要换 key。
- 「重新开始」把日志删了。日志是这次故障唯一的证人。挪走，别删。
- 让 agent 自己诊断自己。网络栈坏掉的客户端，会用十足把握告诉你服务器挂了。
复查清单
- 在动任何东西之前，你能用一句话说清是四层里的哪一层坏了。
- 第二个 agent 已装、已登录，而且今天在这台机器上读过文件。
- 故障日志存在一个重装也碰不到的地方。
- 配置目录已备份，带日期，放在第二块盘。