用qyqy-1109的桌面壳在Windows上双击启动DeepSeek Harness

DeepSeek Harness 插件 DeepSeek DSH 桌面应用 主题与外观 Windows 2026-08-18 113 阅读

前言

DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的智能体运行时，目前仍处于 developer preview。官方页面把原则写成一句话：Everything is a plugin——模型、工具、技能、会话、沙箱、存储、调度和界面，都做成可替换的插件。官方启动网页界面的路径也很直接：先装 Node.js，再执行 npx @deepseek-ai/dsh web，浏览器访问 http://127.0.0.1:3080。

这条路径对已经在用 CLI 的人足够。在 Windows 上把 Harness 交给不打算装 Node、也不想记命令的同事时，就会卡在环境上：终端、npx、浏览器三个窗口来回切，关窗口还容易把还在跑的 dsh web 弄丢。

社区里因此出现了一批桌面壳。本文只写 qyqy-1109/deepseek-harness-desktop。GitHub 上同名仓库不少，安装命令、是否内置运行时、平台范围都不一样，不要按名字混用。

本文用到的 DeepSeek Harness 插件库 是社区站点，和 DeepSeek / 幻方没有官方从属关系。目录里的安装命令可以抄，源码和许可证还是要自己打开仓库核对。下面按目录详情页、仓库 README、package.json、GitHub Releases 交叉核对后的内容介绍它。

这是什么

deepseek-harness-desktop 由 qyqy-1109 维护，目录分类为主题与外观。仓库内部 npm 包名是 dsh-codex-desktop，安装后的产品名是 DeepSeek Harness Desktop。主要语言 JavaScript，当前发布版本 v0.1.8（2026-08-17）。截至 2026-08-18，目录页与 GitHub 仓库均显示 9 颗星；目录收录日期是 2026-08-15。

一句话定位：这是一个 Windows 上的 Electron 桌面壳，双击后自动拉起（或复用）官方 dsh web，把网页界面装进独立窗口；安装包内置 dsh CLI、Node 运行时和一组社区插件。仓库里另外附带两个 Web 端主题插件：Codex 风味点缀（dsh-codex-flavor）和背景图库（dsh-background）。目录把它放进「主题与外观」，主要就是因为这两块。

README 文末写明采用 MIT 许可。仓库根目录目前没有被 GitHub 识别到的 LICENSE 文件，安装前仍应自行打开 README 与源码核对。

它不是 DeepSeek 官方桌面客户端，也不另做一套仿制界面。壳负责窗口、托盘、启动和打包；Harness 本体仍是官方 dsh web。

核心功能

仓库 README 与目录简介一致的能力，可以分成下面几块。

1、独立窗口承载官方 Web GUI。不再手开浏览器、也不用记 dsh web。默认探测 http://127.0.0.1:3080：已经有服务在跑就直接复用；没有则自动解析并拉起 dsh web（优先用安装包内 vendor/ 副本，其次 PATH 上的 dsh，再其次 npm 全局安装）。

2、关窗口最小化到托盘。点右上角 × 不会退出，应用驻留在系统托盘。完全退出要托盘右键「退出」。验证清单写明：如果这次服务是应用自己拉起的，退出应用时会一并停掉；复用外部已有实例时，不会误杀别人的进程。

3、自包含运行时。README 写安装包内置完整 dsh CLI 和 Node 运行时（Electron 43 / Node 24），最终用户不需要先装 Node.js 或 dsh。package.json 的 extraResources 会把 vendor/ 里的 @deepseek-ai/dsh、vendor-node/node.exe、内置插件和 pnpm 打进安装包。v0.1.8 的 Release 说明补充：安装包内置自包含 pnpm，启动时加入服务进程 PATH，让插件市场在没有本机 Node 的机器上也能装卸载插件。

4、首次启动自动播种插件。README 称安装包附带 6 个插件，装进全新 web profile：背景图库、Codex 风味、dshmarket、dsh-difyctl、super-injector、mode-boost。当前仓库 vendor-plugins/package.json 能直接核对到的依赖是 dshmarket、dsh-codex-flavor、dsh-background、dsh-difyctl、@dsh-external/dsh-mode-boost。v0.1.5 的 Release 说明还写过 @dsh-external/dsh-super-injector。具体清单以你下载的安装包版本为准。v0.1.7 起还会内置 router-standard / router-spec 两个思维模式预设。

5、应用图标可更换。托盘菜单 →「应用图标」：经典蓝色鲸鱼、黑色鲸鱼，或上传自定义图片。上传后会裁成方形并适配多档桌面图标尺寸，窗口、托盘和桌面快捷方式同步更新。运行时图标写到 %APPDATA%\dsh-codex-desktop\icons\。

6、Codex 风味主题。plugin/dsh-codex-flavor/ 是 DSH client 插件：保留 DSH 品牌蓝、布局和圆角，只在深色模式给代码块加近黑终端面板（#0f1115）和细边框，代码表面改成 Cascadia Code / JetBrains Mono / ui-monospace 等宽栈，成功/状态强调色微调为 Codex 终端绿（#3fb950 系）。四档配置都可以关。

7、背景图片插件。plugin/dsh-background/ 在「设置 → 通用」增加「背景」行：上传本地图片，自动压缩并保存到图库（最多 3 张），透明度和模糊可调，选择存在 localStorage。背景铺在主内容区和侧边栏半透明底下，消息等内层表面保持不透明。

安装与启用

目录页给出的插件命令

社区目录页上的安装命令原文是：

dsh plugin add github:qyqy-1109/deepseek-harness-desktop

插件以当前 dsh 进程的权限运行，安装时可能执行代码。装之前应检查源代码仓库和许可证。若需要可复现安装，目录页建议固定 commit 哈希。当前 main 最新提交为 02b681e1e0b80a23460bd5ccbb99c5c21fda941e（对应 v0.1.8 前后的源码）：

dsh plugin add github:qyqy-1109/deepseek-harness-desktop#02b681e1e0b80a23460bd5ccbb99c5c21fda941e

需要先说明：仓库根目录的 package.json 是 Electron 应用（main 指向 main/main.js），没有 DSH 插件清单字段。真正带 dsh.bundle / dsh.client 声明的是子目录里的 dsh-codex-flavor 和 dsh-background。README 给最终用户写的主路径是下载 Windows 安装包，而不是把整个桌面壳当普通插件 add 进已有 dsh。已经有 dsh web、只想装主题的人，请看下文「单独安装主题插件」。

最终用户：安装包

当前最新安装包是 GitHub Releases 上的 v0.1.8：DeepSeek.Harness.Desktop.Setup.0.1.8.exe，文件大小 200070926 字节（约 191MB）。下载地址：

https://github.com/qyqy-1109/deepseek-harness-desktop/releases/tag/v0.1.8

README 第 1 节的步骤如下（版本号以 Releases 为准，不要沿用 README 里仍写着的 0.1.5 / 176MB）。

  1. 双击安装包。软件未购买代码签名证书，Windows SmartScreen 可能提示「Windows 已保护你的电脑」，点「更多信息」→「仍要运行」。
  2. 等待进度条完成。README 写首次安装 2～10 分钟都正常（文件数量多，杀毒软件会逐个扫描）；超过 15 分钟可以把安装包目录加入 Windows Defender 排除项后重试。
  3. 装完后桌面出现「DeepSeek Harness」快捷方式，应用会自动打开。
  4. 首次启动约 10～20 秒，会初始化 C:\Users\你的用户名\.dsh。v0.1.4 起窗口会先显示「正在启动 dsh web 服务…」加载页，服务就绪后再切到主界面。
  5. 窗口打开后，左侧 设置（⚙️）→ 模型，填入 DeepSeek API Key（没有就到 platform.deepseek.com 申请）。
  6. 回到会话页即可使用。

旧版本（README 写 0.1.0 之前）存在运行时兼容问题，打开后可能报 Failed to load plugins。请用 v0.1.8。v0.1.2 起内置真实 Node 24，是为了避开 Electron 运行时和 dsh 原生模块（目录选择器 koffi、sharp、node-pty 等）的 ABI 不一致。

开发者：从源码运行

环境要求以 README 为准：Node.js ≥ 22.19（推荐 24 LTS），npm ≥ 10。克隆后：

git clone https://github.com/qyqy-1109/deepseek-harness-desktop.git
cd deepseek-harness-desktop
npm install
npm start

Windows 也可以双击 启动-桌面版.cmd（英文名 launch-desktop.cmd）。若 npm 11 拦截了 electron 的 install 脚本：

npm approve-scripts electron
npm install

打包自包含安装包：

npm run dist            # dist\DeepSeek Harness Desktop Setup <版本>.exe
npm run dist:portable   # 便携版（免安装）

package.json 里打包目标只有 Windows（NSIS + portable）。国内网络下 electron-builder 拉 NSIS 组件可能失败，README 给出的临时环境变量是：

set ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/
npm run dist

日常使用

README 把日常操作列成一张表：

操作 方法
启动 双击桌面快捷方式
关闭窗口 点右上角 ×，最小化到托盘
完全退出 托盘图标右键 → 退出
重新打开 双击托盘图标或桌面快捷方式
从浏览器打开 托盘右键 →「在浏览器中打开」
更换应用图标 托盘右键 →「应用图标」

可选环境变量（全部可选，开发或排障时用）：

变量 默认 作用
DSH_DESKTOP_PORT / DSH_PORT 3080 dsh web 监听端口
DSH_WEB_URL http://127.0.0.1:<port> 直接指定 GUI 地址，跳过探测
DSH_BIN 自动解析 显式指定 dsh 可执行文件路径
DSH_DESKTOP_TRAY 1 设为 0：关窗口直接退出，不驻留托盘
DSH_HOME ~/.dsh dsh web 的工作目录

v0.1.6 起启动日志在 %APPDATA%\dsh-codex-desktop\startup.log，记录播种、启动和错误事件。

单独安装主题插件

已经有 dsh web、只想加 Codex 风味或背景图的人，不必装整个桌面壳。前置是 pnpm 可用（corepack enable 或加入 PATH），并且要装进 web profile。

Codex 风味：

cd plugin/dsh-codex-flavor
corepack enable
dsh plugin --profile web add .
dsh --profile web --dump-config | findstr codex

插件集合变化必须重启 dsh web，再刷新页面。patch 行默认配置：

config:
  enabled: true          # 总开关
  codexCodeBlocks: true  # 终端面板质感代码块
  codexFont: true        # 代码等宽字体栈
  codexAccent: true      # 成功绿微调

卸载：

dsh plugin --profile web remove dsh-codex-flavor

背景图库（README 强调 -w 必需，因为 profile 是 pnpm workspace 根）：

cd plugin/dsh-background
dsh plugin --profile web add -w <本目录绝对路径>

同样需要重启 dsh web。验证 Codex 插件时，浏览器开发者工具 Network 应能看到 /plugins/dsh-codex-flavor/client.js?rev=... 返回 200。

适用场景与注意事项

适合这几类人：Windows 上想双击打开官方 dsh 网页界面、不想先装 Node 和 CLI 的最终用户；需要把 Harness 交给同事、又希望开箱带上主题和插件市场的人；已经有 dsh web、只想给深色模式代码块加一点终端质感或换背景图的开发者。

它目前只打包 Windows。README 和 electron-builder 配置都没有 macOS / Linux 安装包。需要那些平台时，应去看其他维护者的桌面壳，不要假设这份仓库能跨平台。

使用前建议核对这几条：

  1. 插件以当前 dsh 进程权限运行，安装时可能执行代码。桌面壳还会在本机拉起 dsh web，权限等同你自己在终端里跑 Harness。安装前检查源码和许可证，只装自己信任的来源。
  2. 这是社区项目，不是官方应用商店里的官方客户端。社区目录 https://deepseek-harness-plugin.com 与 DeepSeek / 幻方没有官方从属关系。Harness 仍在 developer preview，接口可能不兼容。
  3. 安装包未代码签名，SmartScreen 警告是 README 写明的预期现象，不是安装成功的证明。下载请走 GitHub Releases，并核对本机文件大小是否接近 191MB（v0.1.8）。
  4. 调用模型仍要能访问 DeepSeek API，并在设置里填 Key。README 写配置 API 本身不需要梯子，国内可直接访问 DeepSeek API；这只覆盖「填 Key、调官方接口」这一段，不代表所有社区插件的下载源都畅通。
  5. 关掉窗口不等于退出。任务栏里找不到时，先看托盘。需要彻底退出时用托盘菜单。
  6. GitHub 上存在多个 deepseek-harness-desktop / dsh-desktop 仓库。本文对应的安装命令和维护者是 qyqy-1109，目录页 slug 是 deepseek-harness-desktop-qyqy-1109。

小结

qyqy-1109 的 deepseek-harness-desktop 把官方 dsh web 装进 Windows 独立窗口：自动拉起或复用本地服务、关窗进托盘、安装包内置 CLI 与 Node 运行时。目录分类落在主题与外观，是因为同一仓库还带了克制的 Codex 风味主题和背景图库。它解决的是「Windows 上双击打开 Harness」这件事，并不替代官方 CLI，也不是 DeepSeek 官方桌面版。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-qyqy-1109/

GitHub：https://github.com/qyqy-1109/deepseek-harness-desktop

相关文章

Windows10安装Linux子系统Ubuntu 2017-05-14 TensorFlow的安装 2018-07-08 使用 dsh-gitbash-preset 在 Windows 上启用 DeepSeek Harness 极简模式 2026-08-17 用 deepseek-harness-desktop 把完整 DSH 网页界面装进 Windows 2026-08-17 Windows 也能跑 DSH 极简模式：dsh-gitbash-preset 工作流插件 2026-08-25
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜