DeepSeek Harness Desktop

DeepSeek Harness 的 Windows 桌面版 —— 装完就能用，不用配环境，不用开终端。

本仓库发布 安装包（Releases），不提供源码。桌面版基于 Tauri 构建，在原生窗口中运行官方 DeepSeek Harness（dsh web），体验接近独立 App，同时始终跟随官方 npm 包更新 —— 轻壳 + 官方核，而不是再包一层自研 Host。

说明：本项目为社区维护的桌面封装，非 DeepSeek 官方产品。核心能力来自官方 @deepseek-ai/dsh 与 deepseek-harness 仓库。

为什么用桌面版？

一句话：把 DeepSeek Harness 当正经桌面软件用，而不是当「又一个本地 Web 项目」伺候。

这一套有什么不同？

市面上也有把 Harness 包进桌面 App 的做法。我们的取向很直接：壳要轻，Harness 要正，更新要省心。

更轻：少背一层运行时

• 基于 Tauri + 系统 WebView2，不内嵌完整 Chromium，内存占用和安装体积都更克制。
• 完整离线安装包 约 106 MB（含 Node + dsh 运行时）；主程序壳本体只有数 MB 量级。

更正：不另起炉灶的 Host

• 界面加载的是官方 dsh web，不是把 Cordis / Agent 逻辑再封装一遍的「第二套运行时」。
• 官方 npm 发版，你就跟官方 npm 走 —— 少一层中间商，行为与 CLI 用户看到的一致。
• 数据落在标准 ~/.dsh / ~/.agents，和直接用 @deepseek-ai/dsh 的用户同一套目录；换电脑、备份、迁移都按官方习惯来，不搞私有数据格式。

更省心：更新在应用里闭环

• 日常 rc / 小版本：设置 → 更新 → 立即更新，自动停服务、替换运行时、重启应用，不用切出去浏览器找下载页。
• 更新过程有完整等待界面，失败会尝试恢复服务，数据目录全程不碰。
• 只有真正不兼容的大版本才提示换安装包 —— 该保守时保守，该一键时一键。

更稳：离线能装，在线能跟

• 首次安装可把 Node + dsh 运行时一次性打进包，没网也能在新机器上部署完。
• 后续跟进官方版本走 npm 镜像，国内可用，不必依赖某个第三方下载站是否在线。

如果你已经在用官方 CLI、或希望「桌面化但别改 my Harness 长什么样」——这套就是往这个方向做的。

下载

👉 Releases 页面 下载最新安装包：

也可通过 npm 引导包查看下载说明（不会自动安装桌面程序）：

npx @yottameta/dsh-desktop

系统要求

• 操作系统：Windows 10 / 11，64 位
• WebView2：多数 Win10/11 已预装；若缺失，安装程序会引导安装
• 磁盘：建议预留 500 MB+（运行时、缓存与会话数据会随使用增长）
• 网络：
  • 首次安装：可完全离线（运行时已打包进安装包）
  • 后续更新 dsh：需要联网从 npm 镜像拉取新版本（国内默认可用）

安装与首次启动

1. 运行 DeepSeek Harness Desktop_*_x64-setup.exe，按向导完成安装。
2. 从开始菜单或桌面快捷方式启动 DeepSeek Harness Desktop。
3. 首次启动会看到品牌启动页，随后自动进入官方 GUI（通常 1–2 分钟内就绪，视机器性能而定）。
4. 若安装过程中断，重新运行安装包即可修复，已有数据不会因此丢失。

安装程序会自动完成：

功能一览

原生桌面体验

• 自定义标题栏：隐藏系统标题栏，统一深色品牌风格，支持拖动、最大化、关闭。
• 单实例：再次打开会聚焦已有窗口，不会叠一堆重复进程。
• 系统托盘：关闭窗口时可选择「最小化到托盘」或「彻底退出」；托盘驻留时 dsh 服务继续在后台运行，再次打开秒进界面。
• 残留进程自愈：异常强杀后重启，会自动清理孤儿 node 进程并重新拉起服务。

内置更新（跟随官方 dsh）

• 路径：设置 → 更新
• 检查当前版本与 npm 上的最新 @deepseek-ai/dsh
• 同 major 内的小版本 / rc 更新：一键安装，过程中会短暂停止服务、替换运行时、自动重启应用
• 更新过程有与启动页一致的等待界面，无需手动操作
• 你的数据目录不会被触碰 —— 会话、MCP 配置、插件设置都保留

托盘菜单里的「检查更新…」同样可用；详细操作与版本信息以 设置 → 更新 为准。

数据与安全边界

• 用户数据（会话、配置、插件等）保存在本机用户目录，默认包括：
  • ~/.dsh — Harness 主数据
  • ~/.agents — Agent 相关数据
• 可通过环境变量 DSH_HOME、DSH_AGENTS_HOME 自定义位置（适合多盘、同步盘或迁移场景）。
• 卸载桌面版不会删除上述数据；重装或覆盖安装后，只要数据目录还在，聊天记录与配置仍在。
• 运行时更新只替换 dsh 程序文件，不迁移、不覆盖你的 DSH_HOME。

离线能力

• 在从未装过 dsh 的新机器上，仅靠安装包即可完成部署并启动 —— 不依赖系统已装 Node、不依赖 clone 官方 GitHub 仓库。
• 适合内网、出差笔记本、给同事「扔一个安装包就能用」的场景。

如何更新

更新 dsh 运行时（日常，推荐）

1. 打开应用 → 设置 → 更新
2. 点击 检查更新
3. 若有新版本，点击 立即更新，等待自动重启即可

也可：托盘 → 检查更新… → 按页面提示操作。

更新桌面壳本身（大版本 / 安装包升级）

当官方出现 不兼容的大版本变更 时，应用会提示需要下载新版安装包，而不是强行在线替换。届时到本仓库 Releases 下载最新 setup.exe 覆盖安装即可，数据仍在原目录。

与官方 CLI 的关系

桌面版内置的是官方 @deepseek-ai/dsh npm 包。官方在 GitHub / npm 发新版本后，你通过上述「设置 → 更新」即可跟进，无需自己执行 npm install -g。

常见问题

相关链接

许可证与免责声明

• DeepSeek Harness 及其官方资源遵循各自开源协议；使用前请阅读官方仓库说明。
• 本桌面封装按「现状」提供，作者不对因使用本安装包导致的任何直接或间接损失负责。
• 安装包名称与 DeepSeek Harness 相关标识仅用于说明兼容性，不代表 DeepSeek 官方背书。

装一次，后面就当普通软件用。 有问题欢迎到 Issues 反馈。