DeepSeek Harness (DSH) 的 Web 模式通常在浏览器中运行。如果你需要桌面客户端,同时希望复用现有的 Web 配置、插件和会话状态,dsh-web-desktop 提供了一个非侵入式的 Electron 启动方案。
插件介绍¶
该插件由 ningbonb 维护,定位为 Electron launcher for an existing Web profile。它通过定位打包的 overlay,使用相同的 Web profile 启动 Electron,不修改 DSH 核心。
核心功能¶
- 保持对齐:Web 入口和 Electron 启动器共享同一个 Web profile,包括已安装的插件、会话、模型设置以及
cordis.patch.yml配置。 - 非侵入式扩展:仅作为 profile bundle 和 launcher 安装,不改变 DSH 核心代码、agent loop 或 Web UI 代码。
- 跟随更新:启动器通过当前的
pnpm dsh启动 Web profile,因此 DSH 更新后,它会自动复用更新后的 Web 实现和已安装的插件。
安装与启用¶
安装该插件到现有的 Web profile:
pnpm dsh plugin --profile web add dsh-web-desktop
安装后,DSH 会将此 bundle 追加到 Web profile 中,且在正常的 dsh web 启动过程中保持禁用状态。
典型用法¶
通过命令行启动 Electron 窗口:
pnpm dsh plugin --profile web exec dsh-web-desktop
pnpm dsh web 继续使用浏览器,而 dsh-web-desktop 命令使用 Electron,两者共享同一个 Web profile。
若需要指定端口,可以使用 -- 将参数转发给 Web profile:
pnpm dsh plugin --profile web exec dsh-web-desktop -- --port 8080
适用场景与注意事项¶
该插件适合需要在桌面端使用 DeepSeek Harness,但又希望与浏览器端配置保持一致的开发者。安装前应检查源码与许可证。
注意事项如下:
- 不创建配置:该插件不会创建或复制 profile,它仅定位已存在的 profile。
- 运行模式:首个版本为桌面模式包,不是原生 IPC 客户端。DSH Web Host 继续提供现有的 HTTP 和 WebSocket carrier。
- 进程管理:关闭 Electron 窗口不会停止 Web Host 的运行,这与关闭普通浏览器标签页的行为一致。
- 兼容性:Electron 必须与当前安装的 DeepSeek Harness 保持兼容。