最近在 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 的朋友。

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐