前言¶
DeepSeek Harness（dsh）是 DeepSeek AI 开源的智能体框架，官方仓库把架构概括成一句话：一切皆插件。打开网页界面的官方路径也很直接——先装 Node.js，再执行 npx @deepseek-ai/dsh web，浏览器访问 http://127.0.0.1:3080。
这条路径对已经在用 CLI 的人足够，在 Windows 上却不一定顺手。每次开终端、等 npx、再切浏览器，窗口一关还容易把还在跑的会话弄丢。社区里因此出现了一批桌面壳，把官方 Web UI 装进独立窗口。
deepseek-harness-desktop 就是其中之一。它由 chyra-moon 维护，MIT 开源，被社区插件目录归在「界面增强」。仓库 README 置顶写了：这是社区项目，不是官方出品；DeepSeek Harness 本体和 @deepseek-ai/* 软件包的版权仍归 deepseek-ai。社区目录 https://deepseek-harness-plugin.com 也是独立站点，和 DeepSeek / 幻方没有官方从属关系。
这是什么¶
一句话定位：这是一个 Windows x64 上的 Electron 桌面壳，把官方 dsh 网页界面 1:1 加载进独立窗口，并顺带托管或复用官方 dsh 服务器。
它要解决的是「怎么在 Windows 上双击打开官方界面」，而不是另做一套仿制皮肤。目录页简介和 GitHub 描述一致：Windows 桌面壳，与官方网页界面 1:1 复刻。截至 2026-08-18，目录页与 GitHub 仓库均显示 11 颗星；当前发布版本是 v0.1.0，主要语言是 JavaScript，打包目标只有 Windows x64。
核心功能¶
根据仓库 README、v0.1.0 Release 说明和 src/main.js 源码，可以核对到下面这些能力。
1、零配置启动。安装包自带 Electron 运行时和依赖，README 写明不用单独装 Node.js、不用敲命令，装完双击就是官方界面。界面本身加载的是官方前端，不是仿制皮肤。
2、服务器内置，也能复用现有实例。应用先探测 127.0.0.1:3080：若网页版或 CLI 已经在跑，就直接复用，会话数据互通；否则用内置的 @deepseek-ai/dsh 自建。当前 package.json 把该依赖锁在 0.1.0-rc.6。内置入口缺失或失败时，会自动回退到 npx -y @deepseek-ai/dsh web。
3、断线自愈。运行期间每 5 秒探活；外部服务器被关掉后，应用会在约 5 秒内接管并重启，然后自动重载页面。源码注释写的目标是避免「界面还在但发不了消息」。
4、桌面壳行为。托盘驻留、窗口位置记忆、单实例锁、崩溃后自动重启、无菜单栏的纯净窗口。关闭窗口默认进托盘，托盘右键可以退出或查看关于信息。
5、启动时的鲸鱼加载动画。README 说明按官方鲸鱼图标做蓝/白光点，肚皮、眼睛、水花三处细节对齐，并带呼吸式起伏。v0.1.0 的 Release 还提到侧边栏悬停：打开后自动收起，鼠标移入展开、移出收起。
快捷键在 README 和主进程里都能对上：
Ctrl+Shift+I：开发者工具Ctrl+R/F5：重载Ctrl+Shift+O：在系统浏览器里打开当前服务器地址
安装与启用¶
社区目录给出的安装命令如下，在 DeepSeek Harness 终端中运行即可：
dsh plugin add github:chyra-moon/deepseek-harness-desktop
如需可复现安装，按目录页说明固定 commit 哈希：
dsh plugin add github:chyra-moon/deepseek-harness-desktop#commit
目录页同时提醒：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。
就本仓库的实际形态来说，README 把日常路径写成「下载 Windows 安装包、双击启动」。仓库根目录是 Electron 应用（入口是 src/main.js），并不是往现有 dsh web 里再挂一层皮肤。若目标是独立桌面窗口，按 GitHub Releases 安装更贴近项目说明。
v0.1.0 提供三种包，都只覆盖 Windows x64：
1、安装版（README 推荐）：DeepSeek.Harness-0.1.0-x64.exe，会创建桌面和开始菜单快捷方式。
2、解压版：DeepSeek.Harness-0.1.0-win32-x64.zip，解压即用，解压过程带进度。
3、免安装便携版：DeepSeek.Harness-0.1.0-portable-x64.exe，单文件；首次启动要后台解压数分钟，且没有进度提示。
下载入口：https://github.com/chyra-moon/deepseek-harness-desktop/releases/latest
从源码运行需要本机已有 Node.js 与 npm。README 注明首次使用前要先生成图标：
npm run icon
npm install && npm start
打包可用 npm run dist。官方 dsh 发新版后，仓库用 Dependabot 开升级 PR，合并后再跑 npm run update:dsh 即可重新出包。
典型用法¶
1、安装并双击启动。窗口会先显示状态页，后台探测或拉起 dsh 服务器，就绪后再加载官方前端。源码提示首次启动或复用外部服务器时，可能需要几秒到几十秒。
2、已经在用网页版或 CLI 时，可以先照常执行官方命令：
npx @deepseek-ai/dsh web
再打开桌面版。应用会复用 127.0.0.1:3080 上已有的官方服务器，两边会话数据互通。README 也写了：若想跟官方最新版走，跑最新的 npx @deepseek-ai/dsh web，桌面版会自动复用。
3、关窗口不等于退出。默认会驻留托盘；要从托盘彻底退出，用托盘右键菜单里的「退出」。
4、不想关窗口驻留托盘时，在应用数据目录的 settings.json 里改：
{
"closeToTray": false
}
5、远程桌面环境下工作区选择器打不开时，把同一文件改成应用内浏览选择器：
{
"directoryPicker": "browse"
}
默认值是 "native"，走 Windows 原生对话框。源码里这个开关会让 dsh 挂上应用内选择器，用来规避远程桌面会话下原生对话框 worker 崩溃。
适用场景与注意事项¶
适合 Windows x64 上想双击打开官方 dsh 网页界面的人，也适合已经在用 dsh web / CLI、希望桌面窗口和现有会话共用一份数据的人。走安装包路径时，不必先配 Node.js。
当前仓库徽章和打包配置都只写了 Windows x64，macOS、Linux 和 Windows ARM 不在说明范围内。也不适合把它理解成官方客户端——README 置顶写了社区项目、非官方出品。
使用前建议核对这几件事：
1、安装前检查源码和许可证。本项目采用 MIT 许可证。社区目录写明：插件以当前 dsh 进程的权限运行，安装时可能执行代码。桌面版会在本机拉起或复用 dsh 服务器，权限边界与官方网页版相当，不要把它当成沙箱。
2、杀毒软件可能报毒。README 把它归为社区未签名应用的常见误报，并建议自行审计源码或从源码构建。
3、内置 dsh 版本会落后于官方最新。package.json 当前依赖 @deepseek-ai/dsh 的 0.1.0-rc.6。官方仓库说明 DeepSeek Harness 仍处于开发者预览，可能出现破坏兼容性的变更。跟最新官方版的办法是先跑 npx @deepseek-ai/dsh web，让桌面壳复用外部服务器。
4、便携版首次启动较慢且无进度，README 写明这是正常现象；更透明的是解压版。
小结¶
deepseek-harness-desktop 做的事情很具体：在 Windows 上给官方网页界面加一层可双击的壳，服务器能自建也能复用，断线后会尝试自己拉起来。它不替代 dsh 的插件生态，也不改官方前端。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-chyra-moon/
GitHub：https://github.com/chyra-moon/deepseek-harness-desktop
