dsh-turn-doctor

dsh 的请求可能卡在多个不同层面——dsh 自身的空闲看门狗、SDK 超时计时器、undici 的 HTTP 定时器、模型服务器、甚至某次工具调用——而终端通常只丢出一句模糊的错误信息，让人很难判断该改哪个参数。dsh-turn-doctor 就是为这个痛点而生的诊断插件。

它会对每次模型请求自行计时（首字节耗时、字节间最长间隔、总请求时长），再将这些时序数据与已知故障模式逐一比对，从而定位最可能的失败层：是 undici 的 300 秒 headers 超时、SDK 的 timeoutMs、队列排队超时、上下文溢出、工具调用超时，还是服务器本身崩溃。每次重试单独诊断，时序不足以区分时它会如实说明而非猜测。

适合频繁调参、多模型路由、使用 subagent 并行或工具调用的 dsh 用户，尤其是反复遇到超时却不确定该调哪个设置的人。安装后无需额外配置，判定结果直接打印在终端，也可在聊天中用 /why 查看当前会话的近期诊断记录。