DSH Desktop

A one-click, decoupled desktop home for DeepSeek Harness on macOS and Windows.

Installation · 中文说明 · ToBeWin plugin suite

DSH Desktop is an independent macOS and Windows desktop host for DeepSeek Harness. It gives the Harness Web UI a native application window while keeping the desktop shell and Harness codebases separate.

This is an independent community project by ToBeWin. It is not affiliated with or endorsed by DeepSeek.

The native window, the original Harness experience

Why this project exists

Harness already has a Web UI. DSH Desktop packages a tested DSH release and its Node runtime behind a small Electron host so end users can launch it as a normal desktop app. The host starts the local Web UI automatically and embeds it in a native window; it does not copy, fork, or modify the Harness source tree.

Features

• One-click bundled mode: starts the included DSH Web Host automatically.
• Attach mode: connects to a DSH Web UI that you have already started.
• macOS and Windows packaging targets.
• Fixed, manifest-backed DSH and Node versions for reproducible releases.
• No Node.js permissions in the embedded renderer; a restricted preload bridge exposes only desktop connection and status operations.
• A lightweight loading indicator remains visible until the Web UI has produced real visible content, avoiding a blank launch window.

Installation

Download the appropriate installer from the Releases page once a release is available:

• macOS: .dmg
• Windows: NSIS installer

Bundled mode does not require a separate Node.js, npm, or Harness installation. Attach mode is intended for advanced users who already run a compatible local DSH Web Host.

Modes

Bundled mode (default)

On launch, DSH Desktop starts the exact DSH version listed in runtime/manifest.json on a random loopback-only port, waits for it to become available, and loads it in the desktop window. Nothing is exposed to your local network.

Attach mode

Attach mode loads a user-provided http://127.0.0.1:<port> or http://localhost:<port> DSH address. It does not manage that external process. Use it when you need a custom local DSH launch configuration.

Version mapping

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

runtime/manifest.json is the source of truth. The build process downloads and checks the exact runtime declared there. Release users do not need to download those dependencies when opening the app.

Privacy and security boundary

• The desktop host communicates with bundled DSH through a local child process and loopback HTTP only.
• It does not read or alter the DeepSeek Harness source code.
• It has no telemetry, account system, or cloud backend.
• External links open in the system browser instead of the embedded Web UI.
• Attach mode should be used only with local addresses you trust.

The data and model-provider behavior inside the embedded Web UI remains that of Harness and the configured providers; DSH Desktop does not proxy model requests or collect prompts.

Development

Prerequisites: Node.js 22+, pnpm, and macOS or Windows for the corresponding packaging target.

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

The packaged runtime is generated locally by pnpm runtime:prepare; it is not committed to the repository. Generated installers belong in GitHub Releases, not in the source repository.

Roadmap

• Signed and notarized desktop releases.
• Safe in-app update and rollback flow.
• Windows physical-device packaging verification.

Contributing

Issues and pull requests are welcome. Include the desktop version, operating system, bundled/attach mode, and reproducible steps. Never include model API keys, full local paths, or private prompts in public issue reports.

License

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:<port> 或 http://localhost:<port> 地址。桌面端不会管理该外部进程，适用于自定义本地启动参数的场景。

版本对应

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