README.md

August 28, 2026 · View on GitHub

DeepSeek Harness Desktop

DeepSeek Harness Desktop

轻量、快速、完整离线的 DeepSeek Harness Windows 桌面发行版。

Latest release Downloads Windows 10 and 11 MIT License

下载 v4 · 重大升级 · 软件优点 · 源码构建 · 问题反馈

Important

v4.0.0 是重大升级。 后端运行时由“Electron + 独立 Node”改为 Electron 直接承载 Node,安装包显著轻量化;v3 的配置、会话、凭据和插件目录继续保留。

产品预览

DeepSeek Harness Desktop 主界面

Agent 预设 紧凑侧栏
Agent 预设与模式切换 紧凑侧栏与沉浸工作区

v4 重大升级

1. 安装包轻量化

  • 移除重复打包的独立 node.exe,直接用 Electron 43 内置的 Node 24 启动 Harness。
  • Chromium 只保留简体中文、繁体中文和英文语言包。
  • runtime 不再携带 PDB、ARM64 预构建、测试夹具、TypeScript 类型源码和包内示例文档。
  • 保留完整离线安装:Harness runtime、原生终端、图片处理和插件能力仍随安装包提供。
  • v4.0.0 安装包为 166,768,057 字节(159.04 MiB),较 v3 基线减少 55.36 MiB / 25.82%;Release 同时公布 SHA-256 供复核。

2. 冷启动和首屏响应

  • compile cache 改由正式 Electron Node 生成,构建态与运行态 ABI、Node 版本完全一致。
  • 启动依赖预打包并按 profile 指纹复用,依赖未变化时跳过重复编译。
  • 3080 端口开放后立即预加载主界面,插件树 settle 后再释放启动遮罩。
  • 非关键桌面注入后置,不再阻塞编辑器首屏;启动阶段仍保留可诊断时序。

3. 浅色 UI 与兼容模式

  • 启动页、窗口背景和系统标题区域跟随 Windows 深浅色偏好。
  • 设置页兼容 Aqua 主题注册形式,避免主题插件升级后的设置入口失配。
  • 侧栏和窗口控件动效使用可中断的合成动画;系统“减少动态效果”开启时自动降级。
  • 兼容模式保留必要的菜单、对话框和窗口控件动效,不强行启用高成本背景效果。

4. 插件与数据安全

  • 保留 ~/.dsh 中已有的 DSH-IM、Aqua、会话、模型配置和凭据;升级不会重置 profile。
  • 单个第三方插件缺失构建产物时可隔离故障项,避免拖垮整个后端。
  • DSH-IM 等社区插件仍由用户 profile 管理,桌面安装包不把个人插件和配置写入公共制品。

完整升级说明见 v4.0.0 Release Notes

为什么选择桌面版

优点带来的体验
轻量离线安装一次下载即可使用,不在首启临时下载运行时
原生 Windows 壳单实例、系统通知、无边框窗口、快捷方式和完整卸载
更快启动compile cache、依赖预打包和主界面预加载共同缩短等待
插件兼容保留现有 profile,支持 DSH-IM、Aqua 与 Harness 插件生态
更新可靠下载、校验、退出进程树、静默覆盖安装和快捷方式恢复形成闭环
隐私明确公共仓库和安装包不包含 API Key、Cookie、凭据、会话或本机日志

一分钟开始

  1. 打开 Latest Release
  2. 下载 DeepSeekHarness-Setup-4.0.0.exe
  3. 运行安装向导并选择安装目录。
  4. 从桌面快捷方式或开始菜单启动 DeepSeek Harness

Note

安装包暂未使用商业代码签名证书,SmartScreen 可能显示“未知发布者”。请在 Release 页面核对安装包字节数和 SHA-256。

自动更新

用户点击侧栏更新按钮后,桌面端从本仓库 Releases 检查并下载完整安装包。更新前会终止后端进程树,安装完成后补齐缺失的桌面和开始菜单快捷方式。

GitHub Actions 仅以只读权限执行测试、归档、SHA-512、隔离安装、AppID、Harness 版本、HTTP 200、原生模块、端口释放和卸载验收,不提交代码或发布 Release。通过后由 Links2008 身份人工核对制品并发布为 Latest。

上游与版本谱系

本仓库是独立的 Windows 桌面发行仓库,核心能力来自官方 deepseek-ai/deepseek-harness

项目当前值
桌面版本4.0.0
Harness 版本upstream-lock.json
上游分支master
锁定提交upstream-lock.json
状态文件upstream-lock.json

从源码构建

npm ci
npm test
npm run build:installer

本地完整构建需要先在 bundle/dsh-runtime 组装官方 Harness runtime。Electron 依赖同时提供桌面壳和后端 Node 运行时,不再需要 bundle/node/node.exe。只读自动验收流程见 upstream-sync.yml

安全与隐私

  • 不打包 API Key、Token、Cookie、.credentials.yaml~/.dsh、用户会话或日志。
  • 后端只监听本机 127.0.0.1:3080
  • Release 发布前验证安装、启动、原生模块、清理和卸载。
  • 请勿在公开 Issue 中粘贴凭据或完整用户日志。

贡献与许可证

欢迎通过 Issues 反馈 Windows 安装、启动、界面、插件兼容或更新问题。提交代码前请运行 npm test

桌面壳、构建脚本和配置遵循 MIT License;DeepSeek Harness 与第三方依赖继续遵循各自许可证。