[!CAUTION]
本项目已归档 / This project is archived
官方 DeepSeek Harness Desktop 已发布。请改用官方客户端,勿再装本壳。
The official DeepSeek Harness Desktop has been released. Use the official client. Do not install this shell anymore.
- 产品 / Product: https://www.deepseek.com/en/harness/
- 下载 / Download: https://www.deepseek.com/en/download/
- 上游桌面 README / Upstream desktop README: https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.md
dsh-desktop-shell
English | 中文
DeepSeek Harness(dsh)桌面客户端 / 纯 Electron 外壳。
不打包任何 dsh 代码。启动时执行 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open,读取 CLI 打印的 dsh web: 行(形如 http://127.0.0.1:3080/?token=...),再把这个带启动 token 的地址载入窗口。自 0.1.2 起裸地址不会换到会话 cookie,页面会 401。版本钉在已测过的 0.2.0-rc.2,换版本时改 main.js。对所有插件完全透明。
界面预览
纯壳对插件透明——以下为 DSH Desktop 窗口化运行 dsh web 的实拍,皮肤与插件市场均原样生效。
| 深色 | 浅色 |
|---|---|
![]() |
![]() |
社区皮肤 dsh-web-ui-all(全量皮肤包)—— 纯壳直接加载,无需修改:

插件市场 dsh-market —— 打包版对 dsh-plugin 生态无影响,可正常浏览/安装:

运行
前置
Node.js ^22.19 || >=24(dsh本体要求;外壳也用它来拉起npx)- 推荐
pnpm@11.7.0,npm/yarn亦可
发行版
下载 DSH Desktop Shell Setup 0.1.1.exe 安装后双击 DSH Desktop Shell,首次启动自动 npx 拉取 @deepseek-ai/dsh@0.2.0-rc.2 并打开 Web UI。
源码
git clone https://github.com/<you>/dsh-desktop-shell.git
cd dsh-desktop-shell/dsh-desktop-electron
pnpm install
pnpm start # 调试:拉起本地 npx dsh web
pnpm run build # 打包:electron-builder → dist/DSH Desktop Shell Setup 0.1.1.exe(~80MB,含 Chromium)
无需克隆 deepseek-harness。npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open 是唯一真源,对应上游 dsh web --no-open(web-app 手册)。
架构
main.js 负责 spawn(--no-open,管道读取 stdout/stderr)→ 匹配 dsh web: http(s)://…?token=… → BrowserWindow 加载该地址。关窗口只藏到托盘;托盘「退出」或进程退出时才结束子进程。与所有 dsh-plugin 无冲突(透明壳)。
配置
无配置文件。main.js 常量:启动命令 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open、等待 dsh web: 行 180s、窗口 1280×800。默认监听仍是上游的 127.0.0.1:3080,实际打开的是 CLI 打印的 URL。再次打开窗口时加载该源站的 /,不再重复使用启动 token。
模型可见性
无。作为独立宿壳,不贡献 prompt 片段、工具 schema 或会话事件;模型可见行为完全由被拉起的 dsh 进程及其插件决定。
已知限制
- 固定端口: 外壳不传
--port。上游默认127.0.0.1:3080。端口被占用时,启动页显示失败,而不会去加载别人的服务。 - 单实例:
requestSingleInstanceLock()会把已有窗口调到前台。 - 托盘: 点关闭只隐藏窗口。托盘「退出」或应用退出时才停止我们拉起的
dsh web。没有开机自启。 - 就绪: 等待
dsh web:行,最多 180 秒。超时会结束我们的子进程。失败页有「重试」。 - Chromium 体积: NSIS 安装包大约 81MB,因为 Electron 自带 Chromium。
- Windows 优先:
shell: true以便走npx.cmd。退出时优先taskkill我们的进程树;只有失败时才按端口查找,并且本地地址必须整列相等、PID 必须是我们的进程或其子进程。 - POSIX 进程组: 子进程
detached,正常退出、SIGINT、SIGTERM 会给整个进程组发 SIGTERM。SIGKILL 抓不到,可能留下孤儿dsh web。
许可
MIT,与上游一致。
作者
感谢 Star ❤️ — tonkatsu258 · 个人网站


No comments yet. Be the first to write one.