桌面版封装 YottaMeta/deepseek-harness

DeepSeek Harness Desktop

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

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

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

为什么用桌面版？

| 痛点 | 桌面版怎么做 |
| 新电脑要装 Node、配 npm、全局装 dsh | 安装包内置 Node.js + dsh 运行时，离线也能完成部署 |
| 每次都要开终端敲 dsh web | 双击图标，自动启动服务并打开界面 |
| 浏览器标签容易被误关、和其他网页混在一起 | 独立窗口 + 系统托盘，关窗口可最小化到托盘继续跑 |
| 官方发新版本不知道咋更 | 设置 → 更新 一键跟随官方 rc 版本，会话和配置不动 |
| 大版本不兼容怕把环境搞坏 | 破坏性更新门控：major 跳变等不会静默强更，会提示下载新安装包 |

一句话：把 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 页面 下载最新安装包：

| 文件 | 说明 |
| DeepSeek Harness Desktop__x64-setup.exe | 推荐 — NSIS 安装包（含 Node + dsh 运行时，约 106 MB） |

也可通过 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. 若安装过程中断，重新运行安装包即可修复，已有数据不会因此丢失。

安装程序会自动完成：

| 组件 | 处理方式 |
| Node.js v22.20+ | 内置绿色版，部署到用户目录，无需管理员权限 |
| dsh 运行时 | 内置离线包，解压到用户目录 |
| 更新插件 | 自动注册到 dsh，在 设置 中提供「更新」页 |

功能一览

原生桌面体验

- 自定义标题栏：隐藏系统标题栏，统一深色品牌风格，支持拖动、最大化、关闭。
- 单实例：再次打开会聚焦已有窗口，不会叠一堆重复进程。
- 系统托盘：关闭窗口时可选择「最小化到托盘」或「彻底退出」；托盘驻留时 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。

常见问题

安装后提示环境未就绪 / 一直停在启动页？

请重新运行安装包完成修复。若仍失败，彻底退出应用（托盘 → 退出）后重开；极少数情况下需注销或重启 Windows 以刷新用户 PATH。

更新失败，提示文件被占用？

说明 dsh 服务尚未完全停止。请 彻底退出 桌面版（托盘菜单选择退出，而非最小化），再重新打开并尝试更新。桌面版已内置「先停服务再更新」流程，正常情况无需手动杀进程。

更新后界面没变化？

确认 设置 → 更新 页显示的版本号是否已变。若仍显示旧版，可彻底退出后重开；仍不行则下载最新安装包覆盖安装（数据不受影响）。

聊天记录不见了？

数据通常仍在磁盘上。检查是否更改过 DSH_HOME，或是否存在多个数据目录。恢复思路：找到含 sessions 的目录，确保当前 DSH_HOME 指向该位置后重启应用。

和直接用浏览器访问 127.0.0.1:3080 有啥区别？

功能上加载的是同一套官方 GUI。桌面版额外提供：自动拉起服务、托盘驻留、单实例、内置运行时、一键更新、自定义窗口与关闭确认 —— 适合长期当主力工具用。

和其他 Harness 桌面封装有啥区别？

概括来说：有的方案把 Agent / Cordis 再包进 Electron，安装包更大、内存更高，dsh 更新往往还要走独立下载站；我们壳只负责窗口与生命周期，Harness 直接跑官方 @deepseek-ai/dsh，数据路径与 CLI 一致，小版本在应用内一键更新。你更在意「轻、跟官方、数据通用」可以选这套；更在意内置终端 / 预制 profiles 等一体化能力，可以看看别的方案 —— 各取所需。

这是官方版吗？

不是。这是社区制作的 桌面壳 + 离线安装包，Harness 本体来自 DeepSeek 官方 npm 包。Bug 若复现于官方 CLI / Web，请优先向 deepseek-harness 反馈；安装包、更新流程、窗口与托盘相关问题可在本仓库 Issues 讨论。

相关链接

| 资源 | 地址 |
| 官方 Harness 仓库 | <https://github.com/deepseek-ai/deepseek-harness> |
| 官方 npm 包 | @deepseek-ai/dsh |
| 本仓库 Releases（安装包） | <https://github.com/YottaMeta/deepseek-harness/releases> |
| npm 引导（仅展示下载说明） | npx @yottameta/dsh-desktop |

许可证与免责声明

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

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