前言¶
DeepSeek Harness (DSH) 强调“一切皆插件”的架构。在 Web 端使用时,开发者可能需要更贴近原生系统的窗口体验,或者在浏览器外独立运行 DSH。针对这一需求,dsh-wx-desktop 提供了一个解决方案:它基于官方 DeepSeek Harness 开发,将 Web GUI 封装为独立的桌面应用,同时保留插件系统的灵活性。
是什么¶
dsh-wx-desktop 是一个独立的 Electron 应用。它内部嵌入了 dsh 运行时,支持复用已配置的 profile 与全部插件。它既可以直接运行,也可以作为 DSH 插件挂载到 web profile,在浏览器 GUI 中提供“打开桌面端”的入口。
核心功能¶
- 独立 Electron 应用:提供原生窗口体验,应用菜单与窗口尺寸由 OS 接管。
- 自包含 dsh 运行时:内置 dsh 运行时与 Electron 内嵌 Node,目标机器无需安装 Node 即可启动。
- 复用已运行安装:智能检测 junction 占用情况,若已有 dsh 安装在运行,则复用该安装,避免冲突。
- 100% 插件兼容:加载完整的 dsh web GUI,支持 host 插件与 client 插件。
- 单实例与优雅关闭:防止重复启动,确保关闭时子进程正确终止。
- 自定义品牌图标:内置 DeepSeek 蓝色系图标。
安装与启用¶
作为 DSH 插件挂载到 web profile:
dsh plugin --profile web add link:E:\code\work\wxDshPlugin\dsh-wx-desktop
挂载后刷新 Web 界面即可使用。
典型用法¶
- 挂载插件后刷新
http://127.0.0.1:3080。 - 侧栏会出现“桌面端”入口。
- 点击入口,会通过本地路由(
POST /dsh-wx-desktop/open)拉起桌面应用。 - 若该 junction 正被另一个 dsh 安装占用,则复用那个安装。
注意事项¶
- 体积与架构:采用自包含内嵌 dsh + Electron 内嵌 Node + HTTP 加载架构。安装包体积较大,自包含 dsh 运行时约 220MB。
- 系统兼容:无需 Node 也能启动。
- 路径共享:桌面端与 web 端共用同一
$DSH_HOME。