Deepseek-Harness-Desktop
DeepSeek Harness 官方 Web UI 的桌面客户端
下载安装即可使用，不用自己起 dsh web
中文 · English · 下载 · DeepSeek Harness
安装
到 Releases 下载，装完不需要本机 Node。当前正式版是 0.2.7。
| Windows x64 | Deepseek-Harness-Desktop-Setup-0.2.7.exe |
| macOS Apple Silicon | Deepseek-Harness-Desktop-0.2.7-mac-arm64.dmg |
| Intel Mac、Linux | 从源码运行 |
macOS 安装包未签名：下载后右键打开，或执行 xattr -cr /Applications/Deepseek-Harness-Desktop.app。校验见同页 SHA512SUMS.txt。
0.2.7 更新
- 冷启动启动器 — 先开启动器再启桌面：查正式版、导入官方数据、版本页、插件 Recovery Board；可「关闭桌面端」而不退出应用。
- 独立家目录 — 会话、设置、市场插件只在应用数据下的
dsh-home，不读、不迁、不改官方 CLI 的~/.dsh。 - Harness
0.1.1-rc.1— 安装包钉官方dsh-v0.1.1-rc.1。 - 终端资源 — Ghostty wasm / 字体打进安装包；源码启动缺资源则拒绝启动。
- 识图与网关 — 自定义网关不再误写官方
DEEPSEEK_*；主模型不识图时走官方兜底。
完整说明见 Release Notes。
[!CAUTION] 升级后不会自动带上旧对话，侧栏可能是空的。 请先完全退出应用（托盘也要退）。推荐冷启动进入 启动器 → 导入。不要拷
profiles。旧 rc 的 SQLite 会话库与本版不兼容，不要硬开。
启动器不可用时的 Windows PowerShell 兜底：
$old = "$env:USERPROFILE\.dsh"
$new = "$env:APPDATA\Deepseek-Harness-Desktop\dsh-home"
Copy-Item "$old\sessions\*" "$new\sessions\" -Recurse -Force
if (Test-Path "$old\attachments") {
Copy-Item "$old\attachments\*" "$new\attachments\" -Recurse -Force
}
macOS 把 $HOME/.dsh/sessions 拷到 ~/Library/Application Support/Deepseek-Harness-Desktop/dsh-home/sessions（附件同理）。拷完后打开当时聊天用的工作区路径。
若终端仍见 Unable to load libghostty-vt (404)，或装过 0.2.4 / 0.2.5，请改装 0.2.7。
功能
- 官方界面 — 对话、工具调用、审批就是
dsh web，没有另做一套聊天页。 - 启动器 — 冷启动先开启动器（更新询问、导入、版本、插件问诊）；托盘可随时再打开。
- Git — 标题栏切分支、提交、推送、开变更请求。
- 文件与终端 —
Ctrl+\打开右栏（Files / Diff / Browser / Agents）；Ctrl+`打开底栏终端，选区可送进对话。 - 模型 — 第三方思考强度、识图兜底；最新一条用户消息可改完再发。
- 外观 — 浅色 / 深色主题。壁纸在外观里选或点「浏览」打开图库（分类、搜索、收藏，确认后按窗口比例裁切）；毛玻璃和像素化也在外观里调。
- 扩展 — 设置里管理 MCP、技能和插件。市场是随应用内置的 dsh-market（
dshmarket），没有独立窗口。 - 桌面壳 — 关闭进托盘、自动更新；Harness 挂了会回到故障页并自动重启。用户插件把启动弄挂时，启动器可以按包禁用或先跳过用户插件。
Ctrl+, 打开设置。
数据目录
桌面 Harness 不读 官方 CLI 的 ~/.dsh。会话、设置、市场插件在应用数据目录的 dsh-home：
| Windows | %APPDATA%\Deepseek-Harness-Desktop\dsh-home |
| macOS | ~/Library/Application Support/Deepseek-Harness-Desktop/dsh-home |
| 插件 | dsh-home/profiles/web |
工作区路径和壳层 API key 在上一层目录的 config.json / credentials.json。底栏终端里自己跑的官方 dsh 仍用 ~/.dsh。
 |
 |
 |
 |
从源码运行
需要 Windows 10+ 或 macOS 14+（Apple Silicon），Node 22.19+ / 24+，pnpm 11。
git clone https://github.com/ChisaAlter/Deepseek-Harness-Desktop.git
cd Deepseek-Harness-Desktop
npm install
npm run setup:harness
npm start
第一次 setup:harness 会构建随仓库提供的 vendor/deepseek-harness，比较慢。安装版和源码启动会互相抢锁，开发前先退出已安装的应用。
开发
改界面请改 vendor/deepseek-harness，并遵守 设计语言 和 动效。产品蓝图、流程与模块入口见 产品手册；改行为契约见 Feature Spine。改完客户端源码后，在该目录执行 pnpm run build:lib:client 再重启桌面端。
当前官方基线写在 vendor/harness-upstream.json，现为 0.1.1-rc.1（dsh-v0.1.1-rc.1 / 528c682e061696f5a160f363f236ecbf53cbd006）。npx 兜底是官方 @deepseek-ai/dsh@0.1.1-rc.1，不含标题栏、Git、右栏 surfaces 和底栏终端；那些只在源码启动和安装包路径里。
npm test # 桌面壳单测
npm run sync:harness -- --ref dsh-v0.1.1-rc.1 --sha 528c682e061696f5a160f363f236ecbf53cbd006
npm run dist # Windows 安装包
npm run dist:mac # macOS 安装包（须在 macOS 上）
推送与 package.json 一致的 v* 标签，GitHub Actions 会出 Windows 和 macOS 安装包。对外发布前必须对 CI windows artifact（与即将上传的 Setup 同一 SHA）走完 生产验收表；本机 npm run dist 不能当那张表的 Pass。
交流
扫码进群。Issue 和 PR 也欢迎。感谢 Linux.do。