前言¶

DeepSeek 在 2026 年 8 月开源了 DeepSeek Harness（dsh）。它的核心设计是「一切皆插件」：模型适配、工具、会话、权限，连界面本身都是可替换的插件。官方入口很直接，装好 Node.js 之后执行：

npx @deepseek-ai/dsh web

本地会在 http://127.0.0.1:3080 起一个 Web UI。对已经熟悉 Node 和终端的人来说，这条路足够用。但对只想在 Windows 上双击启动的人，先装运行时、再记端口、再一条条执行插件命令，门槛就高了。

deepseek-harness-desktop 的做法是：不重写页面，把官方 @deepseek-ai/dsh 本地主机放进 Electron 窗口，再原样加载 Web 界面以及随仓库提供的插件和皮肤。本文按社区插件目录页、GitHub 仓库 README、docs/desktop.md 和 desktop-v2.0.0 Release 说明交叉核对后整理。需要先说清楚：社区插件目录是独立站点，与 DeepSeek / 幻方没有官方从属关系；Release 说明也写明这是社区构建，不是 DeepSeek、OpenAI 或腾讯的官方发行版。

这是什么¶

deepseek-harness-desktop 由 ningbainb 维护，托管在 GitHub 仓库 ningbainb/deepseek-harness-desktop。社区目录把它归在「主题与外观」，2026-08-15 收录；仓库许可证以 LICENSE 文件和 GitHub 登记为准，为 BSD-3-Clause。截至 2026-08-17，GitHub 显示 66 星。当前稳定版是 2.0.0，对应标签 desktop-v2.0.0，发布于 2026-08-16。

它解决的问题可以压成一句话：在 Windows 上得到一份和浏览器版能力对齐的桌面客户端，同时不必自己安装 Node.js、pnpm 或 DSH。

技术说明里的启动方式是：Electron 以 --profile desktop --port 0 拉起官方 @deepseek-ai/dsh，等到回环地址就绪，再把这个 URL 载入主窗口。Web 应用、协议、数据路径、工具和插件系统仍是 DSH 自己的实现。桌面端只用独立的 desktop profile（目录为 ~/.dsh/profiles/desktop），不改写已有默认配置；运行时只监听回环地址。

仓库 NOTICE.md 还标明：界面插件和皮肤集合原先版权属于 zhu1090093659，桌面壳和后续贡献来自本项目贡献者；@deepseek-ai/dsh 是第三方依赖，按各自许可证分发。

核心功能¶

原样托管，而不是重做一套 UI¶

README 反复强调：桌面版不是缩水重写。会话、工具调用、模型选择、权限和插件界面都保留。2.0 随包装了 dsh-web-ui 0.1.15 套件，预装任务看板、Git 图谱、右侧文件/预览面板、SSH、移动端远程、实时令牌统计、鲸鱼娘宠物、Codex Connect、推理强度滑块、插件市场和皮肤中心。下载安装 EXE 后即可使用，不需要再执行插件安装命令。

主界面来自仓库文档中的截图：

独立 profile 与内置运行时¶

安装包自带官方 DSH、pnpm 和原生依赖。产品页写明当前提供 Windows 10 / 11 的 x64 安装包，不需要另外配置 Node.js。

desktop profile 会组合 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app、@linxin666/dsh-web-ui-all、@tencent-connect/dsh-qqbot、dshmarket、dsh-codex-connect 和 reasoning-slider，并保留已经加进该 profile 的社区 bundle。打包进去的插件目录是链接到 profile 的 node_modules，用来做运行时解析，不是第二套配置库。

2.0 里和日常使用直接相关的几项¶

仓库把 desktop-v2.0.0 标为当前稳定版，和桌面使用关系比较大的变化如下。

1. 排队消息按 FIFO 续传：智能体工作时继续发送的消息会排队；取消当前执行后，队列自动恢复，不丢失、不重复、不乱序。已知的取消结果会显示为「当前执行已停止，排队消息将继续发送。」
2. 对话栏 Skills 技能库：输入框左下角可搜索已安装技能，支持最近使用、来源与描述、方向键导航、Enter 插入和 Esc 关闭。
3. 模型 API 有界重试：对限流、超时、断网和可恢复的服务端错误做退避重试；Release 说明写的是最多四次。恢复后继续当前请求，手动取消仍然立即生效。SSH 或插件操作不会被重放。
4. SSH 实时监控：每三秒刷新 CPU、内存、磁盘、负载、进程与失败服务；经过确认后可以终止进程或重启 systemd 服务。
5. 长思考折叠条吸顶：思考区展开后，折叠控制会吸附在会话顶部，不必滚回起点。
6. 运行时完整性预检：启动前检查关键文件。安装不完整时停止重启循环，并提示重新安装。
7. 后台更新：发现新版后后台下载，完成后再由用户阅读说明并确认「重启并安装」。退出时回收完整 DSH 进程树，减少安装器误报文件占用。

启动页换成粒子鲸鱼，标题栏、扩展坞和启动页做了视觉统一。这些是界面变化，不影响上面的工作流。

扩展坞、QQ Bot 和 Codex¶

原生菜单 Tools > Extension Dock 打开扩展坞。社区插件安装接受 npm 包名，例如 @scope/dsh-bundle@1.2.3；URL、本地路径、空白、shell 元字符和选项式输入会被拒绝。包必须声明 DSH bundle patch。打开扩展坞时才检查社区包更新；兼容版本可直接更新，已知不兼容会拦截并说明原因，元数据不足的版本需要明确确认。安装会先预取，再离线切到精确版本；校验或重启失败则回滚清单、锁文件和运行时。

QQ Bot 默认禁用。在扩展坞打开卡片获取二维码，用手机 QQ 扫码后，私聊和群聊可以接到本机 Harness。AppSecret 用 Electron safeStorage 结合 Windows 凭据保护加密，不会送到渲染页面、写入日志或明文进入 cordis.patch.yml，运行时只通过子进程环境注入。

Codex 相关能力来自内置的 dsh-codex-connect：设置页通过系统浏览器完成 ChatGPT OAuth，启用 OpenAI Codex 模型。它不会默认替换当前模型。检测到已有 Codex Provider 时会保留现有配置，OAuth 凭据只保存在本机 DSH home。推理强度滑块只展示当前模型实际支持的档位。

皮肤中心¶

皮肤中心提供 11 款皮肤，支持先试穿再应用：试穿即时生效，退出完全还原，确认后再一键应用。README 点名的包括 Windows XP（Luna）、Minecraft、Blue Fantasy、鲸吟、初音未来、交易终端，以及 QQ2008、同花顺风格、龙的传人等。11 款都适配右侧面板。

安装与启用¶

社区目录页给出的标准安装命令是：

dsh plugin add github:ningbainb/deepseek-harness-desktop

dsh CLI 会从 GitHub 解析该仓库并安装到当前配置。需要可复现安装时，按目录页的写法固定 commit 哈希：

dsh plugin add github:ningbainb/deepseek-harness-desktop#commit

把 #commit 换成实际提交哈希。目录页同时提醒：插件以当前 dsh 进程的权限运行，安装时可能执行代码；安装前应检查源代码仓库和许可证。

这条命令面向已经在用 dsh CLI 的环境。若目标是 Windows 桌面客户端本身，仓库 README 和产品页给出的主路径是下载安装包，而不是再执行插件命令。

1. 打开 GitHub Releases，下载最新 Windows x64 安装包。2.0.0 的文件名是 DeepSeek-Harness-Desktop-Setup-2.0.0-x64.exe（Release 页标注约 146.2 MB）。
2. 同一 Release 里下载 SHA256SUMS.txt，比对安装包 SHA-256。
3. 运行安装程序。推荐使用默认的按用户安装路径；自定义根目录应尽量短，因为部分原生工具仍受传统 Win32 的 260 字符路径限制。
4. 启动应用。DSH、插件、皮肤、pnpm 和原生依赖已随包提供。

当前安装包没有商业代码签名，Windows SmartScreen 可能显示「未知发布者」。Release 说明要求只从本项目 Release 页面下载，并核对校验和。

覆盖升级不会删除既有 DSH_HOME、桌面 profile、社区 bundle、桌宠状态、皮肤配置或已加密的 QQ Bot 凭据。应用启动后以及每六小时会检查稳定版 GitHub Release；菜单 Help > Check for Updates 可立即检查。下载完成后仍需用户确认才会重启安装。

从源码打包时，文档要求 Node.js 24 和 pnpm 11.21.0：

corepack enable
pnpm install --frozen-lockfile
pnpm desktop:test
$env:CSC_IDENTITY_AUTO_DISCOVERY = 'false'
pnpm desktop:pack
pnpm --filter @deepseek-ai/dsh-desktop pack:verify

安装器输出到 apps/dsh-desktop/dist。

典型用法¶

下面的操作都来自仓库 README 和 docs/desktop.md，可以按原文复现。

1. 换皮肤¶

打开皮肤中心，先试穿再应用。试穿会立刻改界面，退出后还原；确认满意再点应用。亮色 / 暗色模式都保留。

2. 用扩展坞装社区插件或导入技能¶

从原生菜单打开 Tools > Extension Dock。安装社区 bundle 时只填 npm 包名和版本。技能发现按优先级扫描项目 .dsh/skills、项目 .agents/skills、用户 DSH 技能和用户 Agents 技能；导入会把通过校验的技能文件夹复制到 ~/.dsh/skills，不会覆盖已有同名技能。符号链接、覆盖写入、超过 50 MiB 或超过 2000 个条目的包会被拒绝。

3. 扫码接入 QQ¶

在扩展坞打开 QQ Bot 卡片，用手机 QQ 扫码。未绑定前插件保持禁用，不会在后台空等终端扫码。绑定成功后桌面端会启用插件并重启 DSH。取消、重新绑定和解绑都在同一张卡片里完成。

4. 打开 Codex 与推理强度¶

在设置页走系统浏览器完成 ChatGPT OAuth。启用后可以选用 OpenAI Codex 模型；已有 Provider 不会被默认替换。模型选择器里的推理强度滑块只显示该模型支持的档位，切换模型时会回到有效值。

5. 手机远程接手当前工作区¶

侧边栏底部的手机图标打开配对面板。扫码或复制链接后，手机进入独立的移动端界面，查看与新建会话、收发消息、切换模型和思考强度、调整权限预设，与桌面端同步。配对令牌一次性且限时，「停止」可吊销全部设备。二维码默认走局域网，也可以开 cloudflared 公网隧道。

6. SSH 运维¶

侧边栏「SSH」入口打开远程面板。主机支持密钥 / 密码认证，可从 ~/.ssh/config 导入；配置存在 ~/.dsh/dsh-ssh.json。已配置主机可以开 Web 终端、SFTP 传文件、把本地隧道指到远程内网服务（只监听 127.0.0.1），也可以按别名 / 环境 / 标签对多台主机做集群执行。2.0 增加了 Linux 监控页。Agent 与面板共用同一份主机配置。

适用场景与注意事项¶

适合这几类情况：

• 在 Windows 10 / 11 x64 上使用 DSH，不想先装 Node.js
• 需要和浏览器版对齐的完整 Web 界面，而不是一套重写过的精简壳
• 希望皮肤、插件坞、技能导入、QQ Bot、SSH、移动端远程放在同一个桌面窗口里
• 已有 dsh 配置，又不想被桌面版覆盖——它使用独立的 desktop profile

使用前需要接受这些边界：

• 不是官方发行版。 社区目录、仓库 NOTICE.md 和 2.0.0 Release 都写明：这是社区项目，不是 DeepSeek、OpenAI 或腾讯官方产品。
• 只提供 Windows x64 安装包。 文档没有提供 macOS / Linux 桌面安装器。
• 安装包未做商业代码签名。 SmartScreen 可能报警；只从 GitHub Release 下载，并核对 SHA256SUMS.txt。
• 权限模型与普通 dsh 插件相同。 目录页写明插件以当前 dsh 进程权限运行，安装时可能执行代码。SECURITY.md 进一步说明：社区插件和技能拥有 DSH 授予的权限，安装前应审查第三方代码。桌面端本身把官方 DSH 绑在随机回环端口，渲染进程开启沙箱和上下文隔离、关闭 Node 集成，导航限制在当前回环源，外链走系统浏览器。
• 首次启动可能较慢。 docs/desktop.md 在 Windows 11 开发机上测到，2.0.0 首次冷启动文件扫描大约 25.2 秒；之后会复用已安装文件和 profile 链接。这是参考数据，不是承诺值。
• 根目录 package.json 的 license 字段写的是 Apache-2.0，与 LICENSE 文件、GitHub 仓库许可证和目录页的 BSD-3-Clause 不一致。以 LICENSE 文件和 GitHub 登记的 BSD-3-Clause 为准，安装前仍应自己打开仓库核对。

小结¶

deepseek-harness-desktop 把官方 DSH 本地主机和完整 Web 界面装进 Windows EXE：独立 desktop profile、回环监听、随包运行时，以及皮肤、扩展坞、技能库、QQ Bot、SSH 和移动端远程。当前稳定版是 2.0.0。它是社区开源项目，不是 DeepSeek 官方客户端；安装前检查源码、许可证和校验和。

• 社区目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-ningbainb/
• GitHub 仓库：https://github.com/ningbainb/deepseek-harness-desktop
• 最新安装包：https://github.com/ningbainb/deepseek-harness-desktop/releases/latest
• DeepSeek Harness 官方仓库：https://github.com/deepseek-ai/deepseek-harness