WSL 下 DeepSeek Harness 点击“添加工作区”不弹窗?小企鹅窗口卡住的解决方法
最近在 WSL2 Ubuntu 里折腾 DeepSeek Harness,启动后遇到一个很烦的问题:
点击“添加工作区”时,没有弹出目录选择界面,只看到有个小企鹅的页面最小化,怎么点都点不出来。终端里也没有明显报错,浏览器页面看起来一切正常,但就是无法选择工作区。
折腾了一会儿,终于找到解决办法,记录一下,希望能帮到遇到同样问题的朋友。
环境说明
-
Windows 10/11 + WSL2
-
Ubuntu(WSL)
-
Node.js:v22.22.2
-
DeepSeek Harness 启动方式:
npx @deepseek-ai/dsh web
问题现象
启动 DeepSeek Harness 后,浏览器可以正常打开页面。
但是点击“添加工作区”时:
-
没有出现目录选择界面
-
只看到一个小企鹅窗口被最小化
-
点不出来,也无法正常选择目录
-
终端没有明显报错
另外,之前还遇到过一次启动时报错:
EADDRINUSE: address already in use 127.0.0.1:3080
这个属于端口占用问题,后面也会顺带提一下。
原因分析
DeepSeek Harness 默认会调用系统原生的目录选择器。
但在 WSL 环境下,图形界面调用链、窗口焦点、进程调度和 Windows 原生环境不太一样,容易出现:
-
目录选择器窗口已经在后台启动
-
但无法正常显示到前台
-
或者直接卡住,表现为“小企鹅窗口最小化点不出来”
解决思路就是:
禁用系统原生目录选择器,改用浏览器内弹出的目录选择器。
解决方法
1. 停止当前 DeepSeek Harness 服务
在运行 dsh web 的终端里按:
Ctrl + C
2. 编辑配置文件
执行:
mkdir -p ~/.dsh/profiles/web
nano ~/.dsh/profiles/web/cordis.patch.yml
如果文件不存在,nano 会自动创建。
然后把下面内容完整粘贴进去:
- id: directory-picker
disabled: true
- insert:
- id: directory-picker-browse
name: '@deepseek-ai/dsh-host-directory-picker-browse'
- id: ui-directory-picker-browse
name: '@deepseek-ai/dsh-client-ui-directory-picker-browse'
注意 YAML 缩进,建议直接复制,不要手动改空格。
3. 保存并退出
如果用的是 nano:
Ctrl + O
回车
Ctrl + X
4. 重新启动 DeepSeek Harness
npx @deepseek-ai/dsh web
启动完成后,刷新浏览器页面。
再次点击“添加工作区”,这时应该会在浏览器页面内直接弹出目录选择器,而不是再调用那个卡住的系统原生窗口。
验证结果
我这边修改配置并重启后,再点击“添加工作区”,目录选择界面正常出现,可以正常选择工作区,问题解决。
补充:如果启动时报 3080 端口被占用
如果你也遇到:
EADDRINUSE: address already in use 127.0.0.1:3080
说明之前的 dsh web 进程没有完全退出,还占着 3080 端口。
可以先结束占用进程:
lsof -ti:3080 | xargs -r kill -9
或者:
pkill -f "dsh web"
然后再重新启动:
npx @deepseek-ai/dsh web
如果系统没有 lsof,可以先安装:
sudo apt install lsof
总结
在 WSL 中使用 DeepSeek Harness 时,如果点击“添加工作区”不弹窗,只看到小企鹅窗口最小化,大概率是系统原生目录选择器在 WSL 下兼容性不好。
核心解决方法就是修改:
~/.dsh/profiles/web/cordis.patch.yml
禁用默认的 directory-picker,启用浏览器内目录选择器:
- id: directory-picker
disabled: true
- insert:
- id: directory-picker-browse
name: '@deepseek-ai/dsh-host-directory-picker-browse'
- id: ui-directory-picker-browse
name: '@deepseek-ai/dsh-client-ui-directory-picker-browse'
重启服务后即可正常添加工作区。
希望这篇记录能帮到同样在 WSL 里使用 DeepSeek Harness 的朋友。
更多推荐


所有评论(0)