在 Windows 上,DeepSeek Harness(DSH)桌面应用的无头 shell 完全不可用,
pwsh与python均以退出码0xC0000135(STATUS_DLL_NOT_FOUND)失败。本文完整记录定位与修复过程,含可直接复用的 PowerShell 脚本。
在通过 DeepSeek Harness 改版网站(Web GUI)使用智能体时,发现无头 shell 完全不可用:pwsh 与 python 都无法启动,任何命令都无法执行。于是展开本次排查与修复,并沉淀出这个开源项目,记录完整的定位思路、根因与可复用的修复脚本。
DSH 桌面应用(D:\Program Files\dsh)的无头 shell 不可用:
pwsh启动失败,退出码0xC0000135python启动失败,退出码0xC00001350xC0000135=STATUS_DLL_NOT_FOUND(十进制3221225781)
| 组件 | 路径 | 状态 |
|---|---|---|
| DSH 桌面应用 | D:\Program Files\dsh |
正常 |
| PowerShell 7.6.6 | D:\Program Files\PowerShell-7\pwsh.exe |
非标准安装位置,不在 PATH |
| DSH 自带 Python 3.12.14 | C:\Users\Administrator\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\python\python.exe |
可用,但不在 PATH |
| 系统 PATH 上的 Python 管理器 | C:\Program Files\PyManager\python.exe |
会遮蔽用户 PATH 中的 python |
DSH 的 pwsh 工具通过 @deepseek-ai/dsh-pwsh-local 的 resolvePwshPath() 解析 shell 路径,查找顺序为:
C:\Program Files\PowerShell\7\pwsh.exe(标准位置)PATH中各目录下的pwsh.exeC:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe(Windows PowerShell 5.1 回退)
本机 PowerShell 7 装在非标准位置 D:\Program Files\PowerShell-7,既不在标准位置、也不在 PATH 上,因此解析器静默回退到 Windows PowerShell 5.1——表面能跑,但并非预期的 pwsh。
python 完全不在 PATH 上,无法解析。更隐蔽的是:Windows 合并环境变量时系统 PATH 优先于用户 PATH,因此即使把 python 目录加入用户 PATH(HKCU\Environment),系统 PATH 上的 C:\Program Files\PyManager\python.exe(Python 版本管理器)仍会抢先解析——用户级修复不会真正生效。
0xC0000135(STATUS_DLL_NOT_FOUND)表示进程已找到、但依赖的动态链接库缺失。在本例中,pwsh / python 均未被正确解析到完整可用的安装,导致启动阶段即失败。
把 D:\Program Files\PowerShell-7 前置写入系统 PATH:
HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment
→ Path(前置,保留原值类型 REG_SZ)
同时写入用户 PATH,双保险。
把 DSH 自带 python 目录前置写入系统 PATH,使其排在 C:\Program Files\PyManager\ 之前,确保 python 解析到 DSH 的 3.12.14 而非 PyManager。
调用 WM_SETTINGCHANGE 广播,让运行中的进程重新读取环境变量。
在 C:\Windows 目录下(模拟“其他目录调用”),用注册表构建的“系统 + 用户”有效 PATH 验证:
| 命令 | 解析路径 | 版本 | 退出码 |
|---|---|---|---|
pwsh.exe |
D:\Program Files\PowerShell-7\pwsh.exe |
7.6.6 | 0 |
python.exe |
...\dependencies\python\python.exe |
3.12.14 | 0 |
注册表回读确认两个目录均已持久化。
- 当前已运行的 DSH 进程缓存了旧环境,需重启 DSH 后其 shell 工具才使用新解析结果;新启动的进程 / 终端立即生效。
- PyManager 未受影响:仍保留在 PATH 中(位于 DSH python 之后),可通过
py命令使用;只是不再作为默认python。 - 用户级 PATH 添加(
HKCU\Environment)对python不足以胜出(系统 PATH 优先),故 python 必须写入系统 PATH 并前置。 - PowerShell 7 建议安装到标准位置
C:\Program Files\PowerShell\7,或确保安装目录在 PATH 上。
| 脚本 | 作用 |
|---|---|
scripts/add-pwsh-user-path.ps1 |
将 D:\Program Files\PowerShell-7 加入用户 PATH 并验证 |
scripts/add-pwsh-system-path.ps1 |
将 D:\Program Files\PowerShell-7 加入系统 PATH 并验证 |
scripts/add-python-user-path.ps1 |
将 DSH python 目录加入用户 PATH 并验证 |
scripts/add-python-system-path.ps1 |
将 DSH python 目录前置写入系统 PATH 并验证 |
MIT License,见 LICENSE。
这个仓库放的是技术实现本身。想看图文并茂的完整折腾记录(踩坑过程、对比测试、效果截图),请关注公众号 绿启未来工坊——每个项目的完整记录都在那里。
- 🌐 网站:www.greenzx.com —— 微型技术服务:小团队系统故障排查 / 轻量化网站搭建 / AI 提效落地
- 💻 全部项目:github.com/zseagate
- ✉️ 联系:[email protected]
一个人做的硬核交付:代码开源、过程留痕、踩坑记录全公开。