[Windows] pwsh 工具报 "PTY shell exited during startup" 后该会话永久报废——环境修复也不会自愈

[Jiang-XiaoYa]

摘要

pwsh 工具在某会话中一旦出现 PTY shell exited during startup，该会话此后所有
调用都会失败，即使把导致首次失败的环境问题完全修好也不会恢复。换一个新会话
立刻正常。

环境修复（安装 pwsh、重装 DSH、更换 PowerShell 安装形态）全程无效，只有
新会话或改变审批策略才会恢复。判断为 owner-scoped 持久 shell 把「创建失败」
的结果缓存住了。

同类现象已有至少 3 份报告，见文末。

环境

项	值
系统	Windows 11 24H2 (build 26100)，x64
主机名	LAPTOP-CFC760AM
DSH Desktop	0.2.1-rc.5
权限策略（出问题时）	需要审批（受限路径）
PowerShell	7.6.9，MSI 安装，C:\Program Files\PowerShell\7\pwsh.exe，真实目录
安装位置	E:\Deep Seek\

现象

调用 pwsh 工具，无论命令内容为何（echo ok、1+1、$PSVersionTable 全部一样）：

Error: PTY shell exited during startup

.dsh\logs 无任何新增记录；错误未携带 exit code / stderr。

决定性证据：故障与会话绑定，与宿主机无关

同一台机器、同一个 DSH 进程、同一个 pwsh：

	出问题的会话	新建会话
pwsh 工具	❌ 恒定 PTY shell exited during startup	✅ 正常
退出码	—	0
1..5 | %{ $_ * 2 }	—	2,4,6,8,10
pwsh 版本	—	7.6.9

→ 故障不随环境变化，只随会话变化。

时间线（说明为什么环境修复无效）

1. 会话 A 首次调用 pwsh 时，机器上确实没有 pwsh（PowerShell 7 非系统自带）
2. 工具报 PTY shell exited during startup
3. 之后依次完成：
   • 安装 PowerShell 7（先 MSIX，后改为 MSI 标准安装）
   • 验证 pwsh -NoProfile -Command "echo msi-ok" → 正常
   • 验证 Modules 目录 14 个模块 → 完整
   • 卸载重装 DSH 桌面版
4. 会话 A 依然每次失败；新建会话 B → 立刻正常

推断的根因

@deepseek-ai/dsh-tool-pwsh-persistent 为每个 agent 会话维护一个 owner-scoped
持久 shell。若该 shell 的首次创建失败，失败状态被留在 owner cache 中，后续调用
不会重新创建，因此该会话被永久锁死。

这与观察到的三点一致：

• 环境修好后失败不变（缓存未失效）
• 新会话正常（无缓存）
• 切换审批策略后恢复（推测触发了实例重建）

相关代码（app.asar，dsh-tool-pwsh-persistent）：

if (result.waitReason === "session_exit")  throw new Error("PTY shell exited during startup");
if (result.waitReason === "timeout")       throw new Error("PTY shell did not reach readiness before startup timeout");
if (result.waitReason === "stdin_read")    break;   // 就绪条件

抛出点已持有 result.sessionStatus（含 exitCode / signal），但未透出。

建议
失败不缓存（最重要）：open 阶段抛错时应丢弃本次创建结果，下次调用重新尝试， 而不是把失败态留在 owner cache 里。
错误可诊断：抛出 PTY shell exited during startup 时附带 sessionStatus.exitCode / signal / 已收集的 stderr 尾部。
日志落地：PTY 创建失败写入 .dsh\logs，而不是完全无声。
给其他用户的临时方案
换一个新会话（最快，10 秒）
或更改会话的审批策略，触发终端实例重建
该故障不会自愈，重启 DSH 也可以（但会丢当前会话上下文）
可能相关的另一条线索
有报告指出桌面端在 workspace-write 下，受限令牌缺少登录会话 SID （S-1-5-5-*），导致子进程以 0xC0000142（STATUS_DLL_INIT_FAILED） 在 DLL 初始化阶段死亡。若属实，它正好是「首次创建失败」的一种触发条件—— 叠加本 issue 的缓存行为，就会演变成会话级永久故障。

<img width="689" height="449" alt="DeepSeek_Harness_LCo2jQgBbn" src="https://github.com/user-attachments/assets/f1dc8284-4cd5-4661-9745-6ec9b06bf94a" />
<img width="689" height="449" alt="DeepSeek_Harness_LCo2jQgBbn" src="https://github.com/user-attachments/assets/63b4a5b1-2fa9-43da-bc70-d2301ef65921" />

[Jiang-XiaoYa]

这是另外三个用户案例https://github.com/deepseek-ai/deepseek-harness/discussions?discussions_q=%5BBug%5D+PTY+shell+exited+during+startup+on+Windows+11+24H2

[Jiang-XiaoYa]

更根本的原因：极简模式

设置 → 内置插件 中，persistent-bash 的配置状态显示「极简模式」，
terminal-bash 与 terminal-pwsh 均为「已停用」。

即：极简组合下，Windows 唯一的 PTY 后端（terminal-pwsh）不挂载，
persistent-pwsh 工具没有可用后端，首次调用必然失败。

但按文档，缺少后端时首调应报 no PTY backend registered for "shell"，
实际却报 PTY shell exited during startup —— 错误码误导是本 issue 的另一半：
它把「后端缺失」伪装成了「shell 启动失败」，导致排查方向完全跑偏。
若该失败态再被 owner cache 保留，就会演变成会话级永久故障。

[WorthIts]

确实感觉比较鸡肋，windows最基础的命令行都跑不起来，这个模式感觉就是给一般用户做简单回答的