doctor 找出原因。
doctor 按依赖顺序逐一检查 dev 会话的控制通道各环节——从磁盘上的就绪契约一直到对扩展内执行器的实时探测——并指出第一个失败的环节和具体修复方法，而不是让你面对每条命令各自的死胡同报错。
何时使用 doctor
extension logs或某个 act verb 连不上，你想知道是哪个环节断了。- agent 或脚本通过
ready.json驱动会话，需要一个机器可读的健康检查。 - dev 会话看起来还活着，但扩展不再响应。
用法
参数与 flag
检查内容
检查按依赖顺序运行。当某个环节失败时，依赖它的后续检查会标记为 skip，并注明是被哪个检查阻塞的——skip 不等于通过。
pretty 输出每个检查打印一行，并附上第一个失败检查的修复建议。全部通过时退出码为
0，任一检查失败时为 1，CI 和脚本可以直接据此把关。
机器可读输出
--output json 把检查结果打印为一个 JSON 数组，每个检查一个对象：
status 为 pass、fail 或 skip；有已知修复方法的失败会带 remediation。
典型流程
- 启动会话：
extension dev --browser=chromium --allow-control（需要 eval verb 时加--allow-eval）。 - 后续命令连不上时，在同一项目根目录运行
extension doctor。 - 按第一个失败检查给出的修复建议处理，然后再次运行
doctor确认。