ToBeWin/DSH-Desktop

DSH Desktop

为 macOS 和 Windows 上的 DeepSeek Harness 打造的一键式、解耦的桌面之家。

安装 · 中文说明 · ToBeWin 插件套件

DSH Desktop 是一个独立的 macOS 和 Windows 桌面宿主，用于 DeepSeek Harness。它为 Harness Web UI 提供了一个原生应用程序窗口，同时保持桌面外壳与 Harness 代码库相互分离。

这是由 ToBeWin 开发的独立社区项目。它与 DeepSeek 无关联，也未获得其认可。

原生窗口，原汁原味的 Harness 体验

为什么会有这个项目

Harness 已经拥有 Web UI。DSH Desktop 将经过测试的 DSH 版本及其 Node 运行时打包在一个小型 Electron 宿主之后，让最终用户能够像启动普通桌面应用一样启动它。该宿主会自动启动本地 Web UI，并将其嵌入原生窗口；它不会复制、分叉或修改 Harness 源代码树。

功能特性

- 一键式捆绑模式：自动启动内置的 DSH Web Host。
- 附加模式：连接到您已经启动的 DSH Web UI。
- macOS 和 Windows 打包目标。
- 固定的、由清单支持的 DSH 和 Node 版本，以实现可复现的发布。
- 嵌入式渲染器中没有 Node.js 权限；受限的预加载桥仅暴露桌面连接和状态操作。
- 轻量级加载指示器会一直可见，直到 Web UI 产生真正可见的内容，从而避免启动窗口空白。

安装

当有可用版本时，从 Releases 页面 下载相应的安装程序：

- macOS：.dmg
- Windows：NSIS 安装程序

捆绑模式不需要单独安装 Node.js、npm 或 Harness。附加模式面向已经运行兼容本地 DSH Web Host 的高级用户。

模式

捆绑模式（默认）
启动时，DSH Desktop 会在仅限回环的随机端口上启动 runtime/manifest.json 中列出的确切 DSH 版本，等待其可用，然后将其加载到桌面窗口中。不会向你的本地网络暴露任何内容。

附加模式

附加模式会加载用户提供的 http://127.0.0.1: 或 http://localhost: DSH 地址。它不会管理该外部进程。当你需要自定义的本地 DSH 启动配置时使用它。

版本映射

| DSH Desktop | DeepSeek Harness | Node |
| --- | --- | --- |
| 0.1.0 | 0.1.0-rc.6 | 22.22.3 |

runtime/manifest.json 是唯一事实来源。构建过程会下载并校验其中声明的确切运行时。发布版用户打开应用时无需下载这些依赖项。

隐私与安全边界

- 桌面宿主仅通过本地子进程和回环 HTTP 与捆绑的 DSH 通信。
- 它不会读取或修改 DeepSeek Harness 源代码。
- 它没有遥测、账户系统或云后端。
- 外部链接会在系统浏览器中打开，而不是在嵌入式 Web UI 中打开。
- 附加模式只应与你信任的本地地址一起使用。

嵌入式 Web UI 内部的数据和模型提供商行为仍由 Harness 和已配置的提供商决定；DSH Desktop 不会代理模型请求或收集提示词。

开发

前提条件：Node.js 22+、pnpm，以及 macOS 或 Windows（用于对应的打包目标）。

git clone https://github.com/ToBeWin/DSH-Desktop.git
cd DSH-Desktop
pnpm install
pnpm dev

pnpm check
pnpm build
pnpm package:mac
pnpm package:win

打包后的运行时会由 pnpm runtime:prepare 在本地生成；它不会提交到仓库中。生成的安装程序应放在 GitHub Releases 中，而不是源代码仓库中。

路线图

- 已签名并公证的桌面版本。
- 安全的应用内更新和回滚流程。
- Windows 物理设备打包验证。

贡献

欢迎提交 issue 和 pull request。请包含桌面版本、操作系统、捆绑/附加模式以及可复现步骤。切勿在公开 issue 报告中包含模型 API 密钥、完整本地路径或私人提示词。

许可证

MIT © ToBeWin

中文说明

DSH Desktop 是面向 macOS 和 Windows 的 DeepSeek Harness 独立桌面宿主。它让 Harness Web UI 以原生应用窗口形式运行，同时保持桌面端与 Harness 代码库完全分离。

本项目由 ToBeWin 独立维护，与 DeepSeek 无隶属或官方背书关系。

项目目标

Harness 已有 Web UI。DSH Desktop 用一个轻量 Electron 宿主打包经过验证的 DSH 发行包与 Node 运行时，用户可以像普通桌面应用一样启动。桌面端自动运行本地 Web UI 并嵌入窗口，但不会复制、fork 或修改 Harness 源码。

功能

- 默认内置模式：打开应用即可自动启动随应用提供的 DSH Web Host。
- Attach 模式：连接用户已经启动的 DSH Web UI。
- 支持 macOS 与 Windows 打包目标。
- 使用清单锁定 DSH 和 Node 版本，保证发行包可复现。
- 嵌入网页无 Node.js 权限，仅有受限的预加载桥接。
- 启动时使用轻量加载动画，直到 Web UI 已绘制真实内容，避免白屏。

安装

正式版本发布后，请从 Releases 下载：

- macOS：.dmg
- Windows：NSIS 安装包
内置模式不要求用户另行安装 Node.js、npm 或 Harness。Attach 模式适合已自行启动兼容 DSH Web Host 的高级用户。

两种运行方式

Bundled（默认）：启动时，DSH Desktop 会在随机的本机回环端口启动 runtime/manifest.json 中指定的 DSH 版本，待其可用后载入桌面窗口；不会对局域网开放服务。

Attach（高级）：连接用户提供的 http://127.0.0.1: 或 http://localhost: 地址。桌面端不会管理该外部进程，适用于自定义本地启动参数的场景。

版本对应

| DSH Desktop | DeepSeek Harness | Node |
| --- | --- | --- |
| 0.1.0 | 0.1.0-rc.6 | 22.22.3 |

runtime/manifest.json 是唯一版本清单。构建过程会下载并校验其中指定的运行时；发行包用户无需再单独下载依赖。

隐私与安全边界

- 桌面宿主仅通过本地子进程和回环 HTTP 与内置 DSH 通信。
- 不读取、不修改 Harness 源码。
- 没有遥测、账号系统或云端后端。
- 外部链接会交给系统浏览器打开。
- Attach 模式只应连接可信的本机地址。

嵌入 Web UI 内的模型提供商、数据处理和隐私行为仍由 Harness 与用户配置决定；DSH Desktop 不代理模型请求，也不收集提示词。

开发

前置要求：Node.js 22+、pnpm，以及对应平台的 macOS 或 Windows。

git clone https://github.com/ToBeWin/DSH-Desktop.git
cd DSH-Desktop
pnpm install
pnpm dev

pnpm check
pnpm build
pnpm package:mac
pnpm package:win

pnpm runtime:prepare 会在本机生成打包运行时，它不会被提交进仓库。安装包应发布到 GitHub Releases，而不是提交到源代码仓库。

后续计划与贡献

后续将支持应用签名和公证、安全的应用内更新/回退，以及 Windows 实机打包验证。

欢迎提交 Issue 和 PR。请提供桌面端版本、操作系统、Bundled / Attach 模式和复现步骤；请勿在公开反馈中提交模型 API Key、完整本机路径或私有提示词。

许可证

MIT © ToBeWin