✨ 特性

• 🚀 一键安装：NSIS 单文件安装包，自动创建桌面/开始菜单快捷方式
• 🖥️ 原生桌面窗口：不再需要手动开浏览器访问 127.0.0.1:3080
• 🔄 Node.js 自动检测：安装时与应用启动时双重检测，缺失则引导自动安装（winget）或官网下载
• 🛡️ 干净的服务管理：每次启动全新 dsh 实例，退出应用自动回收进程，杜绝残留实例冲突
• 🌐 内置完整 dsh：安装包包含 @deepseek-ai/dsh 全部依赖，无需自行安装 Harness

📦 使用

1. 从 Releases 下载最新安装包：

   

2. 运行安装包（安装后自动创建桌面/开始菜单快捷方式）

3. 打开「DeepSeek Harness」

4. 首次使用：Settings → Models 填入 DeepSeek API Key

5. 点击 Choose workspace 选择工作目录，开始使用

依赖：Node.js ≥ 22.19（需支持 node:zlib 的 zstd，Node 22.15+/24 提供）。 安装包不内置 Node.js——缺失时会自动引导安装。

🛠️ 从源码构建

构建机需 Node.js + npm（仅用于构建，与最终安装包无关）。

npm install      # 安装 electron / electron-builder
npm run build    # 安装 dsh 依赖 + 打包 NSIS 安装包

产物输出到 dist/。分步命令：

npm run setup:runtime   # 只安装 @deepseek-ai/dsh 到 resources/dsh
npm run dist            # 只执行 electron-builder 打包

构建机在中国大陆时，可设置国内镜像加速 electron 二进制下载：

$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"

📁 目录结构

deepseek-harness-desktop/
├── electron/
│   ├── main.js        # 主进程：检测 Node.js、拉起 dsh、打开窗口、回收进程
│   ├── preload.js     # 桥接：向页面推送服务日志
│   ├── loading.html   # 启动加载页
│   └── error.html     # 启动失败页
├── build/
│   └── installer.nsh  # NSIS：安装时检测/安装 Node.js
├── scripts/
│   ├── setup-runtime.js  # 安装 @deepseek-ai/dsh 到 resources/dsh
│   └── build.js          # 一键构建
├── resources/dsh      # 构建时生成：dsh 及全部依赖
├── package.json       # electron-builder 配置
└── dist/              # 构建产物

🔧 架构说明

Node.js 检测策略（不内置 Node 的设计）

时机	机制
安装时	NSIS 脚本检测 Node，缺失则调用 winget install OpenJS.NodeJS.LTS
启动时	主进程检测 PATH/常见目录/注册表，校验版本 + zstd 能力
仍缺失	弹窗引导：自动安装（winget）或打开 nodejs.org

服务管理

• 应用始终启动全新的 dsh 实例，避免连接端口上残留的旧实例
• 若 3080 被占用，弹窗让用户选择「关闭占用进程并重启 / 直接连接 / 退出」
• 退出应用时 taskkill /T /F 回收整个进程树

❓ 常见问题

Q: 双击安装包后桌面没有快捷方式？ A: 若安装被 SmartScreen/杀软拦截会中断。请点「更多信息 → 仍要运行」后重装。

Q: 启动时报 failed to load bundle script？ A: 多为端口残留旧实例导致，已在新版本中修复。请关闭所有 DeepSeek Harness 进程后重启。

Q: 安装包有多大？为什么那么大？ A: 约 154MB。包含 @deepseek-ai/dsh 全部 530+ 个依赖，保证离线可用。

📄 许可

MIT © DeepSeek Harness Desktop contributors

🙏 致谢

• deepseek-ai/deepseek-harness — DeepSeek Harness 本体
• electron / electron-builder