桌面客户端 Stxr/deepseek-harness-desktop

DeepSeek Harness 桌面版

DeepSeek Harness 官方 Web UI 的轻量桌面客户端，基于 Electrobun，支持 macOS 14+、Windows 11+ 与 Ubuntu 22.04+。

本项目不复制、不 fork、也不重写 Harness 前端。桌面应用直接启动锁定版本的官方 @deepseek-ai/dsh，让系统分配一个回环端口，再把 dsh web 的原生页面装进沙箱 WebView。因此插件、组件、skills、tools、MCP、sessions、workspaces、审批、subagents，以及以后新增的 Web 功能，仍全部由上游实现。

DeepSeek Harness 目前是 developer preview，可能包含不兼容升级。本项目自动发现上游版本并创建 PR，经真实启动测试后再随桌面版本发布。

架构

Electrobun desktop window (sandboxed)
│ http://127.0.0.1:
▼
Bundled Node.js → official dsh --profile web
│
├── official Web UI / client components
├── Cordis plugins and profiles
├── sessions / settings / credentials under DSH_HOME
└── tools / skills / MCP / shell / subagents / workflows

桌面仓库只维护窗口、进程、平台打包和应用更新。Harness 独立放在 runtime/package.json 中，通常升级只会改动该文件和锁文件。

macOS 与 Windows 把 44px 原生标题栏命中区融合进 Harness 已有的首行，不再额外增加一条顶部栏：macOS 保留原生交通灯，Windows 保留原生最小化、最大化/还原与关闭按钮。桌面菜单会把常用快捷键转发给 Harness 自己的 UI：Cmd/Ctrl+N 新建会话，Cmd/Ctrl+, 打开设置。

完整 CLI 与插件

发行包自带固定版本的 Node.js、pnpm 与 dsh 启动器，不要求用户另装运行时。桌面端和 CLI 默认共享 ~/.dsh，所以 profile、插件、组件、会话和设置不会因桌面应用升级而丢失。

开发仓库里可以直接调用同一套内置 CLI：

bun run dsh -- --help
bun run dsh -- --profile web --dump-config
bun run dsh -- plugin --profile web add

发行包内也包含 Resources/app/runtime/bin/dsh（Windows 为 dsh.cmd），保留上游 CLI 的全部命令面。

本地开发

需要 Bun 1.3.12+、Node.js 24+。首次准备时脚本会从 nodejs.org 下载官方 Node 二进制、校验 SHA-256，并安装固定的 Harness 依赖。

bun install
bun run check
bun run dev

桌面启动参数：

bun run dev -- --workspace /absolute/project/path
bun run dev -- --dsh-home /absolute/dsh/home
bun run dev -- --dsh-patch /absolute/overlay.yml
bun run dev -- --dsh-profile web

在当前平台生成未签名开发包：

DSH_DESKTOP_SKIP_SIGNING=1 bun run build

生成稳定通道更新产物：

DSH_DESKTOP_SKIP_SIGNING=1 bun run build:stable

Electrobun 原生构建当前主机的平台与架构；GitHub Actions 分别构建 macOS arm64/x64、Windows x64 和 Linux arm64/x64。Linux 使用系统 GTK 3 与 WebKitGTK 4.1；非 Ubuntu 发行版需要自行提供兼容运行库。

更新策略

- Harness 更新：定时 workflow 查询 npm 的 @deepseek-ai/dsh@latest，只更新 runtime/package.json 与 runtime/package-lock.json，并创建 PR。
- 桌面更新：使用 Electrobun 内置增量更新器，从固定的 GitHub Release updates 下载 manifest、完整包或 patch；下载完成后菜单会变成“Restart to Update”。
- 数据兼容：DSH_HOME 位于应用包外，升级不会覆盖用户数据；上游迁移逻辑仍由 Harness 自己负责。

完整设计见 架构说明，发布与签名见 发布说明。

安全边界

- Harness 强制绑定 127.0.0.1，端口由操作系统随机选择。
- 官方页面运行在 Electrobun sandbox WebView 中，没有 RPC、preload 或 Bun 权限。
- 只有当前 Harness 回环 origin 可以在窗口内导航；其他 HTTP(S) 链接交给系统浏览器。
- 进程输出只保留一个有上限的内存尾部用于启动诊断。
- 本项目不增加遥测；Harness 自身设置仍由上游和 DSH_TELEMETRY_DISABLED 控制。

许可

MIT。它是独立社区项目，并非 DeepSeek 官方产品。第三方归属见 NOTICE.md。