桌面客户端hsiaozzz/dshdesktop

dshdesktop

CI
许可证：MIT

dshdesktop 是 DeepSeek Harness 的非官方 Windows 桌面客户端。它在本机运行官方 @deepseek-ai/dsh Web profile，并通过专用 Electron 窗口提供桌面体验。

应用将 Harness 运行时与自身可执行文件分开管理。首次启动时，它会把 npm 上推荐的官方版本安装到 Electron 应用数据目录。使用帮助 > 更新到最新版本即可暂存、校验并切换到最新推荐的 Harness 版本，不会修改本仓库或全局 npm 安装。

dshdesktop 是独立的社区项目，与 DeepSeek 无隶属关系，也未获得 DeepSeek 官方背书。

功能

- 紧凑的 Windows 无边框顶栏与原生窗口控制按钮。
- 顶栏浅色、深色主题跟随 Harness 当前外观。
- 文件、编辑、视图、帮助菜单，以及顶栏侧边栏开关。
- 独立管理官方 @deepseek-ai/dsh npm 包。
- 一键更新 Harness，包含版本校验、启动探测与失败回滚。
- 首次关闭时选择最小化到托盘或退出，之后记住选择。
- 同时生成安装版与便携版 Windows 程序。
- Electron renderer 隔离并启用沙箱，Harness 页面无法访问 Node.js。

系统要求

- Windows 10 或 Windows 11，x64。
- Node.js ^22.19.0 或 >=24.0.0，并包含 npm。
- 首次启动和检查更新时可以访问已配置的 npm registry。

打包后的程序仍然依赖 Node.js。dshdesktop 使用系统 Node.js 执行官方 npm 包，不会额外捆绑第二份 Node.js 发行版。

安装

从仓库的 Releases 页面下载以下任一文件：

- DSHDesktop-Setup--x64.exe：安装版，可以自定义安装目录。
- DSHDesktop-Portable--x64.exe：无需安装，但应用数据仍保存在 Electron 的常规用户数据目录。

项目目前没有可信的 Authenticode 数字签名。Windows SmartScreen 可能会提示风险；运行前请确认文件来自本仓库。

首次启动

安装 Node.js 后启动 DSH Desktop。加载页面会显示托管运行时的安装与启动进度。首次 npm 下载耗时取决于 registry 和网络速度，可能需要几分钟。

托管服务监听随机的 127.0.0.1 端口，只能由本机访问。就绪探测成功后，应用会打开 Harness Web UI。

启动前设置 DSH_DESKTOP_WORKSPACE 可以指定初始工作目录。默认值是当前用户的主目录，也可以之后通过文件 > 打开文件夹切换。

更新

使用帮助 > 检查更新比较已安装 Harness 与 npm registry 上的版本。使用帮助 > 更新到最新版本安装最新推荐的 @deepseek-ai/dsh。

更新程序会比较官方 latest、next、alpha 三个 dist-tag，并推荐其中版本号最高的一版。当 alpha 严格更新时（例如 latest 仍是 0.1.5-rc.1，而 alpha 已是 0.1.6-alpha.1），更新流程会安装该更新的预发布版。检查/更新对话框会标明所用通道。

更新程序先安装到暂存目录并校验版本，再停止当前服务、切换运行时并等待新版 Web UI 就绪。如果启动失败，应用会恢复上一版运行时。

这些命令只更新 DeepSeek Harness，不更新 dshdesktop 可执行文件。桌面客户端新版本通过 GitHub Releases 单独发布。

关闭与托盘行为

首次关闭窗口时，应用会询问最小化到系统托盘、退出或取消。dshdesktop 会记住最小化或退出选择。托盘模式下，单击图标可恢复窗口，也可以通过右键菜单退出。

如需重置选择，请彻底退出 dshdesktop，再删除 Electron 用户数据目录中的 desktop-preferences.json。

开发

克隆仓库、安装依赖并启动 Electron：

git clone https://github.com/hsiaozzz/dshdesktop.git
cd dshdesktop
corepack enable
pnpm install
pnpm dev

开发模式使用开发版 Electron 应用标识对应的托管运行时目录。测试可能破坏运行时的场景前，请使用单独的操作系统用户配置，或先移动该目录。

测试与构建

运行确定性的测试与 JavaScript 语法检查：

pnpm test
pnpm run syntax

构建 Windows 安装版和便携版：

pnpm run dist

产物写入 dist/。可选的集成 smoke test 会实际执行 npm 安装并启动官方 Harness Web profile，因此需要网络连接且耗时更长：

pnpm run smoke

如果 smoke test 需要在特定目录启动 Harness，请设置 DSH_DESKTOP_WORKSPACE。

存储与隐私

Electron 用户数据目录包含：

- 托管的 npm 安装；
- dsh.log，其中可能包含服务输出和本地文件路径；
- desktop-preferences.json，其中保存关闭行为。

Harness 的设置、凭据、会话与 profile 仍位于常规 DSH_HOME。dshdesktop 不会复制或检查这些内容。将 dsh.log 附加到公开 Issue 前，请先检查并遮盖敏感内容。

安全设计

顶栏与弹出菜单页面启用上下文隔离和 renderer 沙箱，并禁用 Node 集成。它们的 preload 只暴露少量桌面控制，IPC handler 会校验消息发送方。Harness 页面运行在独立的沙箱化 WebContentsView 中，不包含 preload，也没有桌面 API。应用拒绝页面权限请求，外部导航会在系统浏览器中打开。

安全漏洞请按 SECURITY.md 报告。普通错误和功能请求请提交到 GitHub Issues。

限制

- 目前只支持 Windows x64 打包。
- 必须单独安装 Node.js 和 npm。
- 首次启动与 Harness 更新需要访问 npm registry。
- 顶栏集成依赖 Harness 当前的 DOM 标签与主题标记；上游 UI 变化可能需要更新 dshdesktop。
- 桌面可执行文件不会自动更新。
- 配置信任的代码签名服务前，公开二进制文件没有数字签名。

参与贡献

欢迎贡献。提交 Pull Request 前请阅读 CONTRIBUTING.md。

许可证

dshdesktop 使用 MIT License。项目包含从 DeepSeek Harness 衍生的代码；归属信息与项目身份见 NOTICE。