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 镜像拉取新版本（国内默认可用）
安装与首次启动
- 运行
DeepSeek Harness Desktop_*_x64-setup.exe，按向导完成安装。 - 从开始菜单或桌面快捷方式启动 DeepSeek Harness Desktop。
- 首次启动会看到品牌启动页，随后自动进入官方 GUI（通常 1–2 分钟内就绪，视机器性能而定）。
- 若安装过程中断，重新运行安装包即可修复，已有数据不会因此丢失。
安装程序会自动完成：
| 组件 | 处理方式 |
|---|---|
| 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 运行时（日常，推荐）
- 打开应用 → 设置 → 更新
- 点击 检查更新
- 若有新版本，点击 立即更新，等待自动重启即可
也可：托盘 → 检查更新… → 按页面提示操作。
更新桌面壳本身（大版本 / 安装包升级）
当官方出现 不兼容的大版本变更 时，应用会提示需要下载新版安装包，而不是强行在线替换。届时到本仓库 Releases 下载最新 setup.exe 覆盖安装即可，数据仍在原目录。
与官方 CLI 的关系
桌面版内置的是官方 @deepseek-ai/dsh npm 包。官方在 GitHub / npm 发新版本后，你通过上述「设置 → 更新」即可跟进，无需自己执行 npm install -g。
常见问题
安装后提示环境未就绪 / 一直停在启动页？请重新运行安装包完成修复。若仍失败，彻底退出应用（托盘 → 退出）后重开；极少数情况下需注销或重启 Windows 以刷新用户 PATH。
更新失败，提示文件被占用？说明 dsh 服务尚未完全停止。请 彻底退出 桌面版（托盘菜单选择退出，而非最小化），再重新打开并尝试更新。桌面版已内置「先停服务再更新」流程，正常情况无需手动杀进程。
更新后界面没变化？确认 设置 → 更新 页显示的版本号是否已变。若仍显示旧版，可彻底退出后重开；仍不行则下载最新安装包覆盖安装（数据不受影响）。
聊天记录不见了？数据通常仍在磁盘上。检查是否更改过 DSH_HOME，或是否存在多个数据目录。恢复思路：找到含 sessions 的目录，确保当前 DSH_HOME 指向该位置后重启应用。
功能上加载的是同一套官方 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 反馈。
No comments yet. Be the first to write one.