Deepseek-Harness-Desktop

DeepSeek Harness 官方 Web UI 的桌面客户端
下载安装即可使用，不用自己起 dsh web

中文 · English  ·  下载  ·  DeepSeek Harness

安装

到 Releases 下载，装完不需要本机 Node。当前正式版是 0.2.7。

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 的产品形态但已与上游分离），没有独立窗口。
• 桌面壳 — 关闭进托盘、自动更新；Harness 挂了会回到故障页并自动重启。用户插件把启动弄挂时，启动器可以按包禁用或先跳过用户插件。

Ctrl+, 打开设置。

数据目录

桌面 Harness 不读 官方 CLI 的 ~/.dsh。会话、设置、市场插件在应用数据目录的 dsh-home：

工作区路径和壳层 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。

许可证

MIT