DeepSeek Harness Desktop

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

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

[!TIP]
如果这个项目对你有帮助，欢迎点个 Star 支持一下——制作不易，你的 Star 是持续维护的最大动力。

桌面版功能与相对官方版的增强

提供哪些功能

• 开箱即用的 Windows 应用：一个安装包内提供 Harness runtime、原生终端、图片处理与插件能力，无需自备 Node，也不用手敲命令行启动。
• 常驻后台 daemon：后端独立于窗口运行，关闭窗口不中断正在执行的任务，再次点击快捷方式即可恢复会话。
• 原生 Windows 集成：单实例、系统通知、无边框窗口、桌面与开始菜单快捷方式、完整卸载。
• 内置插件商店与 IM 接入：新 profile 开箱具备 dshmarket 入口，并通过 DSH-IM 配置企业协作与个人消息渠道。
• 自动更新闭环：检查新版本、差分或完整下载、SHA 校验、退出进程树、静默覆盖安装并恢复快捷方式。
• 默认启用 Computer Use：随安装包提供官方 Computer Use 服务与 Cua Driver 原生提供方，无需手动安装。

相对官方版做了什么

• 把环境打包好：官方以 CLI / 服务形态提供内核，桌面版连同运行时、原生模块和依赖一起打包，用户只需安装一个 exe。
• 从“每次冷启”到“常驻 + 预热”：后端拆分为独立 daemon，具备跨进程启动锁、版本/PID/端口握手、随机 token 的 named-pipe 控制通道和三次退避恢复；Windows 登录后静默预热。
• 构建产物与运行态 ABI 对齐：compile cache 改由正式 Electron Node 生成，并锁定 Electron 版本以匹配原生模块的 V8 指纹白名单，避免启动即崩。
• 精简发行体积：移除与 Electron 内置 Node 重复的 node.exe，语言包只保留简体中文、繁体中文和英文，runtime 剔除 PDB、ARM64 预构建、测试夹具、TypeScript 类型源码与包内示例文档。
• 桌面细节适配：深浅色跟随系统，兼容 Aqua 主题注册形式，侧栏切换只提交一次原生控件位置，避免逐帧重排造成卡顿。
• 不污染用户数据：升级不重置 ~/.dsh，不把个人插件、配置和凭据写入公共制品。
• 内核跟随官方最新：当前锁定 dsh-v0.1.7-alpha.2（见 upstream-lock.json），启动补丁与预设适配同步到新内核结构。

优势在哪里

• 一次下载即可离线使用：不在首次启动时临时下载运行时，安装完成即可启用。
• 重开速度接近网页：常驻 daemon、登录预热、compile cache 与主界面预加载共同缩短等待。
• 保留用户配置：沿用同一份 profile，不由安装器清除插件、会话或凭据；上游 0.1.7 的 Session V4 和模型配置变更见发布说明。
• 更新可靠且可复核：Release 同时公布 SHA-256，差分更新显著减小下载量。
• 隐私边界清晰：后端只监听本机 127.0.0.1:3080，仓库与安装包不含 API Key、Cookie、凭据、会话或本机日志。

产品预览

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

v4 重大升级

1. 安装包轻量化

• 移除重复打包的独立 node.exe，直接用 Electron 43 内置的 Node 24 启动 Harness。
• Chromium 只保留简体中文、繁体中文和英文语言包。
• runtime 不再携带 PDB、ARM64 预构建、测试夹具、TypeScript 类型源码和包内示例文档。
• 保留完整离线安装：Harness runtime、原生终端、图片处理和插件能力仍随安装包提供。
• NSIS 使用 7z 与 blockmap 差分更新，不再使用易卡住且体积更大的 ZIP 载荷。
• v4.0.1 安装包为 125,255,184 字节（119.45 MiB），较 v3 基线减少 94.95 MiB / 44.29%；Release 同时公布 SHA-256 供复核。

2. 冷启动和首屏响应

• 桌面窗口与 Harness 后端彻底解耦：常驻 daemon 独立管理后端、插件恢复和会话，关闭窗口不终止正在运行的任务。
• Windows 登录后静默预热 daemon；用户再次打开时跳过后端冷启动，直接连接本机 127.0.0.1:3080。
• daemon 具备跨进程启动锁、版本/PID/端口握手、随机 token 的 named-pipe 控制通道和三次退避恢复。
• compile cache 改由正式 Electron Node 生成，构建态与运行态 ABI、Node 版本完全一致。
• 启动依赖预打包并按 profile 指纹复用，依赖未变化时跳过重复编译。
• 3080 端口开放后立即预加载主界面，插件树 settle 后再释放启动遮罩。
• 非关键桌面注入后置，不再阻塞编辑器首屏；启动阶段仍保留可诊断时序。

以下是 v4 架构升级时的历史基线，不代表 v4.0.2 新内核的性能承诺：三次隔离解包态实测（毫秒，中位数 / 最差值），完整冷启动 HTTP 3224 / 3231，冷启动首屏 4628 / 4736，普通关窗后快捷方式重开 141 / 143，强制结束前台壳后复用 daemon 457 / 459。全新安装后第一次首屏会受 Windows 新文件扫描影响，当时本机验收为 31120 ms。

3. 浅色 UI 与兼容模式

• 启动页、窗口背景和系统标题区域跟随 Windows 深浅色偏好。
• 设置页兼容 Aqua 主题注册形式，避免主题插件升级后的设置入口失配。
• 侧栏状态经同一事件循环消抖后只提交一次原生控件位置，避免逐帧 WebContentsView 重排。
• 兼容模式保留必要的菜单、对话框和窗口控件动效，不强行启用高成本背景效果。

4. 稳定性大幅提升与数据安全

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

本次升级见 v4.4.0 Release Notes，历史架构说明见 v4.0.1 Release Notes。

为什么选择桌面版

优点	带来的体验
轻量离线安装	一次下载即可使用，不在首启临时下载运行时
原生 Windows 壳	单实例、系统通知、无边框窗口、快捷方式和完整卸载
接近网页的重开速度	常驻 daemon、登录预热、compile cache 和主界面预加载共同缩短等待
插件兼容	保留现有 profile，支持 DSH-IM、Aqua 与 Harness 插件生态
内置插件商店	新 profile 开箱具备 dshmarket 入口，按需扩展社区插件
多 IM 连接	通过 DSH-IM 配置企业协作和个人消息渠道
更新可靠	下载、校验、退出进程树、静默覆盖安装和快捷方式恢复形成闭环
隐私明确	公共仓库和安装包不包含 API Key、Cookie、凭据、会话或本机日志

一分钟开始

1. 打开 Latest Release。
2. 下载该 Release 的 DeepSeekHarness-Setup-<版本>.exe（当前为 4.4.0）。
3. 运行安装向导并选择安装目录。
4. 从桌面快捷方式或开始菜单启动 DeepSeek Harness。

关闭窗口会隐藏并保留已就绪页面，后台任务继续运行；再次点击快捷方式可瞬时恢复。需要完全退出桌面壳时按 Ctrl+Q。

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

自动更新

用户点击侧栏更新按钮后，桌面端从本仓库 Releases 检查并下载差分或完整安装包。只有进入安装流程时才停止 daemon 和后端进程树；普通关窗不会中断任务。安装完成后会补齐缺失的桌面和开始菜单快捷方式。

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

维护者可在本机安装并登录 GitHub CLI 后运行 npm run release:github。该命令会在发布前校验账号不是 bot、工作树和 origin/main 一致、当前 HEAD 的非定时 Actions 已成功、标签未被占用、EXE/blockmap/latest.yml 完整且 SHA-512 相符；任何一项不满足都会拒绝发布。建议直接发布该次 CI 已验收的制品：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/publish-release.ps1 -UseValidatedArtifact -Publish

提交和人工触发验收使用 upstream-lock.json 的固定 commit。每日定时兼容性监控选取上游官方最新发布的 DSH 标签（含预发布、排除草稿），不追逐未发布的 master 提交。监控通过不等于自动安装或自动发布：维护者核对结果、更新锁文件并再次验收后，才发布新的桌面版本。这样既保持跟进，也避免把未经验证的上游变化直接推给用户。

verify-installed-runtime.ps1 的安装/卸载测试只应在干净 CI runner 或虚拟机运行；检测到已有正式安装时会拒绝执行，避免测试清理影响实际安装及快捷方式。

上游与版本谱系

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

项目	当前值
桌面版本	4.4.0
Harness 版本	0.1.7-alpha.2，以 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 与第三方依赖继续遵循各自许可证。