InkWord01/DeepSeekHarness----Desktop
DeepSeek Harness (DSH) desktop client: double-click to use, bundled backend, tray resident, sync with official releases | DSH 桌面客户端, 双击即用, 内置后端
安装Install
dsh plugin --profile web add github:InkWord01/DeepSeekHarness----Desktop把 InkWord01/DeepSeekHarness----Desktop 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeepSeek Harness Desktop（DSH 桌面客户端）
将 DeepSeek Harness（DSH）打包为 Windows 桌面应用：双击即用，无需手动安装 Node.js、无需命令行、无需打开浏览器。
本仓库是 DeepSeek Harness 的非官方桌面壳，前端界面与后端逻辑全部来自官方 DSH， 本项目只负责「启动后端 → 打开窗口 → 托盘常驻」的桌面体验层。
✨ 特性
- 🖥️ 独立桌面窗口：无需浏览器标签页，任务栏/托盘独立图标
- ⚙️ 零配置启动：自动探测并复用已有 DSH 实例（如浏览器打开的 :3080）， 否则自动启动捆绑的后端（自带 Node 运行时与 dsh 依赖，无需预装环境）
- 🧊 托盘常驻：关闭窗口最小化到托盘，后端继续运行；托盘菜单「显示主窗口 / 退出」
- 🧹 干净退出：退出时只终止本应用自启的后端进程，不影响外部 DSH 实例
- 🔄 可随官方同步更新：通过更新
DSH_VERSION重新打包即可跟随官方新版本（见下文）
📦 下载与使用
方式一：安装版（推荐）
从 Releases 页面按你的 CPU 架构下载对应安装包（内置 DSH 后端）：
完整版（推荐，无需任何环境）（约 163MB，内置 Node 运行时）：
DeepSeek-Harness-Desktop-<版本>-x64.exe— 绝大多数 Intel/AMD 电脑DeepSeek-Harness-Desktop-<版本>-arm64.exe— ARM 设备（骁龙 Windows、Apple Silicon Windows 等）
Lite 版（本机已安装 Node.js ≥ 22 时可选）（约 120MB，不含 Node，运行时使用系统 Node）：
DeepSeek-Harness-Desktop-<版本>-x64-lite.exeDeepSeek-Harness-Desktop-<版本>-arm64-lite.exe
不确定架构？任务管理器 → 性能 → CPU 查看架构标识。 不知道自己的电脑有没有 Node.js？直接选完整版即可。
运行安装向导（可自选安装目录），安装后从桌面/开始菜单启动。
首次启动
- 应用自动启动内置的 DSH 后端（约 10-30 秒，日志在
%APPDATA%\DeepSeek Harness Desktop\logs\backend.log） - 若本机
127.0.0.1:3080已有 DSH 在运行（比如浏览器开着 DSH），桌面端会直接复用，不会重复启动 - 会话数据、设置与 Web 版完全一致（存储在
~/.dsh，由 DSH 后端统一管理）
🤖 自动化（CI / 更新 / 便携版）
- GitHub Actions 自动构建：push
v*tag 即自动构建 x64 + arm64 安装包并创建草稿 Release （.github/workflows/build.yml），发布前可人工检查 - 自动更新：应用集成 electron-updater，发现 GitHub 新版本时提示下载更新
- 官方版本提醒：启动后检查官方
@deepseek-ai/dsh最新版，有新版时托盘提示 - 便携版：
npm run dist同时产出*-portable.exe（免安装，双击即用） - 多语言：启动画面与托盘菜单自动跟随系统语言（中/英）
📦 安装包体积优化
- 安装包约 163MB（解压后约 600MB，含完整 DSH 后端 + Node 运行时）
- 构建时自动裁剪多平台二进制（node-pty / sharp / ripgrep 仅保留 win32-x64）， 安装包从 177MB 降至 163MB，解压体积减少约 80MB
- Electron 语言包仅保留中文与英文（46MB → 1MB）
- 启动时显示加载画面，后端就绪后自动进入主界面
🛠️ 从源码构建
环境要求
- Windows 10/11 x64
- Node.js ≥ 20（构建机需要；最终用户不需要）
- 网络（首次构建需下载 Electron 与 npm 依赖）
构建步骤
git clone https://github.com/InkWord01/DeepSeekHarness----Desktop.git
cd DeepSeekHarness----Desktop
npm install
npm run prepare:backend # 安装捆绑后端（dsh 运行时 + node.exe）到 resources/backend
npm run dist # 产出 release/DeepSeek Harness Desktop Setup <ver>.exe
开发调试：npm run dev（复用已有 3080 实例或自动启动后端）。
无管理员权限构建：若构建机无法创建符号链接（winCodeSign 解压报错）， 项目已内置规避方案（
signAndEditExecutable: false+ afterPack 钩子写入图标/版本）， 直接npm run dist即可，无需额外处理。
🔄 随官方新版本同步更新
官方 DSH 发布新版本后，按以下步骤更新本桌面端：
查看官方版本号（如
0.2.0）：https://www.npmjs.com/package/@deepseek-ai/dsh修改
package.json中devDependencies["@deepseek-ai/dsh"]的版本号重新构建：
npm install npm run prepare:backend npm run dist更新
version字段并发布新的 Release（附上构建产物）
这样用户下载新版桌面端即可使用官方最新功能。
🤝 贡献指南（只读仓库）
本仓库为开源只读仓库：代码对所有人开放（MIT License），欢迎任何人 下载、使用、学习，但不允许直接推送修改（只有仓库维护者可以合并变更）。
如果你想改进：
- 提 Issue：报告问题、建议新功能
- 提 Discussion：交流使用心得
- 想贡献代码：请 Fork 后开发，通过 Issue 联系维护者，由维护者评估合并
📁 项目结构
src/main.js # Electron 主进程：后端管理、窗口、托盘、生命周期
src/preload.js # 渲染进程桥（只读信息暴露）
scripts/prepare-backend.mjs # 构建捆绑后端（dsh 依赖树 + node.exe）
scripts/afterPack.js # 打包后写入图标与版本信息
scripts/wcs-mirror.mjs # 本地二进制镜像代理（构建辅助，可选）
build/ # 图标资源
resources/backend/ # 构建时生成：捆绑的 DSH 后端（不入库）
release/ # 构建输出（不入库）
⚙️ 高级配置
| 环境变量 | 作用 | 默认值 |
|---|---|---|
DSH_DESKTOP_PORT |
覆盖后端端口（多开/测试） | 3080 |
DSH_VERSION |
构建捆绑的 dsh 版本（npm run prepare:backend 时） |
^0.1.0-rc.6 |
📄 许可证
- 本仓库（桌面壳代码）：MIT License，见 LICENSE
- 内置的 DeepSeek Harness 后端与界面：版权归 DeepSeek 官方所有
⚠️ 声明
本项目与 DeepSeek 官方无隶属关系，是社区维护的桌面封装。 使用时请遵守 DeepSeek 的服务条款与所在地区法律法规。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
walkinglabs/learn-harness-engineering
Harness engineering beginner tutorial, from 0 to 1
-
YaoApp/yao
✨ All your agents and workspaces in one place, on every device you own. Track tasks on a board, accessible from desktop,…
-
Devin-AXIS/iPolloWork
Enterprise-grade, local-first Agent Workbench for people and agent teams. A unified multi-engine workspace for Codex Har…