Links2008/DeepSeek-Harness-Desktop

DeepSeek Harness Desktop

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

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

[!IMPORTANT]
v4.2 修复“打不开新对话”，默认启用 Computer Use，内核升级到 0.1.6-alpha.2：修正预设中独占服务挂载被拒导致新建会话失败的问题，随安装包默认提供 Computer Use 能力，并把 Harness 内核升级到官方最新预发布版本。详见 v4.2 更新说明。
v4.0.4 修复新建会话卡顿、设置退出入口与窗口控件动画：修正插件重载与用户操作抢跑导致的“新建会话反复失败”，恢复设置面板的“退出”按钮，并消除窗口控件在隐藏/最小化后的残余动画抖动。详见 v4.0.4 修复说明。
v4.0.3 修复启动黑屏的错误展示问题：旧版桌面样式误隐藏了上游插件失败提示，现在保留该诊断区域。若旧社区插件仍使用失效 SDK，需先升级或适配插件；后台 HTTP 200 不代表主页可用。详见 v4.0.3 修复说明。

v4.0.2：多 IM 接入、内置插件商店，启动与恢复稳定性大幅提升。 在 v4 的“轻量窗口壳 + 常驻用户级 daemon”架构上，修复第三方插件加载失败识别、窗口状态丢失和 Electron 原生模块 ABI 不匹配。内核跟随官方最新发布版本，通过验收后更新；本版使用 0.1.3-alpha.1（上游预发布）。已有配置、会话、凭据和插件继续保留。

v4.2 的重点改进

- 新建会话可用性：上游 0.1.6 的 Computer Use 独占服务行在预设里会发布进程级全局服务，直接挂载会被预设校验拒绝并使新建会话失败；桌面版把它放进带隔离域的 cordis:group，恢复新建会话与对话回复。
- Computer Use 默认启用：随安装包提供官方 Computer Use 服务与 Cua Driver 原生提供方，无需手动安装即可在受支持场景下驱动本机应用。
- 内核跟进官方最新预发布：Harness runtime 升级到 dsh-v0.1.6-alpha.2（见 upstream-lock.json），启动补丁与预设适配同步到新内核结构。

v4.0.2 的重点改进

- 支持各种主流 IM 连接：通过 DSH-IM 安装与配置，接入飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord、WhatsApp。各渠道的账号、凭据和平台权限需要自行配置；并非安装后已自动连接全部平台。
- 内置插件商店：新建桌面 profile 默认加载 dshmarket，可在应用内浏览、安装和管理社区插件。商店包随安装器提供，浏览目录和安装新插件需要联网；已有 profile 不会被覆盖，可通过其插件配置启用商店。
- 启动与恢复稳定性大幅提升：识别不带 /dsh 的插件入口及嵌套依赖加载错误，备份 profile 清单后隔离明确故障的第三方插件，重试恢复并显示诊断；不把核心模块错误当成可忽略的插件问题。
- 窗口位置与尺寸记忆：保存正常窗口边界和最大化状态，兼容多屏、显示器断开和损坏状态文件。
- 可诊断的失败页：显示实际启动错误并提供本机诊断目录入口，不再把所有失败都归为 150 秒超时。
- 可验证的更新交付：原生模块按 Electron ABI 重编译并实际加载检查，CI 验收成功后才上传安装制品，再由维护者人工账号发布。

设置页仍使用上游官方通用设置、模型和插件能力。旧版 /api/settings.describe 等路径已不适用于当前 Typert 接口，不能以旧 URL 返回 404 或缺少旧 client.js 判断设置服务失效。无人值守多会话编排仍是功能提案，不在本版完成范围。

顶部两个 dsh.so 动态徽章来自市场收录邮件，链接到实际条目，分别显示风险检测和安装检测状态；收录不等于人工安全认证，也不代表最新桌面版已重新通过该平台安装检测。

产品预览

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 主题注册形式，避免主题插件升级后的设置入口失配。
- 侧栏和窗口控件动效使用可中断的合成动画；系统“减少动态效果”开启时自动降级。
- 兼容模式保留必要的菜单、对话框和窗口控件动效，不强行启用高成本背景效果。

4. 插件与数据安全

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

完整升级说明见 v4.0.2 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.2.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.2.0 |
| Harness 版本 | 0.1.6-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 与第三方依赖继续遵循各自许可证。