Bug: read tcp 错误被误分类为 PI_AI_ERROR，导致 session 直接终止

[xrn1997]

概要

LLM API 返回 TCP 读取错误时（如 "read tcp 1... is not valid JSON"），
classifyPiAiError 没有匹配到 read tcp，将其归类为 PI_AI_ERROR。
由于 PI_AI_ERROR 不在 DEFAULT_RETRYABLE_CODES 中，session 直接终止而非重试。

环境

• dsh 0.1.0-rc.x（npm 安装）
• Windows, Node.js
• 自定义 LLM provider（OpenAI 兼容 API）

错误信息

{"type":"turn/end","reason":{"kind":"error","error":{
  "message":"Unexpected token 'r', \"read tcp 1\"... is not valid JSON",
  "code":"PI_AI_ERROR"
}}}

根因

packages/llm/llm-pi-ai/src/index.ts 中 classifyPiAiError 的 TRANSPORT 正则：

if (/\b(?:network|connection|socket|fetch)\b|\bECONN[A-Z]+\b/i.test(message) || ...)
  return "TRANSPORT";
return "PI_AI_ERROR";  // ← read tcp 落到这里了

正则没有匹配 read tcp，导致 TCP 读取错误被归类为 PI_AI_ERROR，而该错误码不可重试。

修复建议

在 TRANSPORT 正则中加上 read\s+tcp：

if (/\b(?:network|connection|socket|fetch|read\s+tcp)\b|\bECONN[A-Z]+\b/i.test(message) || ...)

临时绕过

在 settings.yaml 的 provider 配置中手动加上 PI_AI_ERROR 到可重试列表：

retryPolicy:
  mode: normal
  retryableCodes: [EMPTY_RESPONSE, RATE_LIMIT, SERVER, TIMEOUT, TRANSPORT, PI_AI_ERROR]

[xrn1997]

这里提供一个修复脚本，官方效率太慢了。
fix-dsh-pi-ai.zip

[weijiafu14]

给你的诊断补一个下层实测，能把修复位置钉得更死：

故障注入打真 pi-ai 0.84.1 传输层（options.fetch 第一次直接抛 fetch failed，cause 为 read tcp …: connection reset by peer / ECONNRESET，第二次真实 200）：pi-ai 自己的重试把连接级错误当瞬时故障处理，第二次尝试成功恢复，最终 stopReason: stop、内容完整。装置与判决：transport-classify-experiment.mjs / transport-classify-results.json（case tcpReset）。

含义：底层传输的重试能力是现成的、而且已经覆盖你撞到的错误族——session 直接终止只能来自上层 classifyPiAiError 把 read tcp 归进不可重试的 PI_AI_ERROR 这一步，跟你的定位完全一致。所以你提的修法（分类器把连接级错误归入可重试）打的就是唯一正确的位置；另一条等价路是让该路由直接透传 pi-ai 自己的重试（它对这类错误的判定已经是对的）。

边界说明：注入的是错误形状，不是你的具体网络环境；Windows 上 read tcp 的具体文案变体是否都被分类器漏掉，以你的复现为准。