deepseek-harness-desktop

基于 Electron 构建的非官方 DeepSeek Harness Windows 桌面端封装。

DeepSeek Harness Desktop 将官方 @deepseek-ai/dsh Web 配置文件封装为专注的桌面使用体验。它保留了 Harness 的会话、模型、工具、技能、插件、Agent 预设、目标、计划、子 Agent、工作流、终端和工作区管理等功能，并补充桌面应用生命周期与 Windows 系统集成。

功能特点

• 以仅绑定 127.0.0.1 的私有子进程运行 Harness Web 运行时。
• 使用原生文件夹选择器选择工作区，并在下次启动时自动记住。
• 通过 DSH_HOME 将配置、凭据、设置与会话数据保存在 Electron 的用户数据目录中。
• 提供重启、切换工作区、打开日志目录及打开数据目录等桌面操作。
• 在隔离的 WebContentsView 中加载 Harness UI，禁用 Node 集成。
• 外部链接使用系统默认浏览器打开，不在应用内跳转。
• 退出应用或切换工作区时，会停止相应的 Harness 进程树。

环境要求

• Windows 10 或更高版本
• 当前 Node.js LTS 版本和 npm（从源码运行时需要）
• 可在 Harness 设置中配置的模型服务商及 API Key

从源码运行

git clone https://github.com/Strom9898/deepseek-harness-desktop.git
cd deepseek-harness-desktop
npm install
npm start

首次启动时，应用会初始化官方 web 配置文件。请在 Harness 的设置页面中配置模型服务商和 API Key。凭据始终保存在本地 Harness 数据目录中，不会暴露给桌面渲染进程。

构建

生成用于冒烟测试的解压版应用：

npm run pack

生成便携式 Windows 可执行文件：

npm run dist:win

生成推荐的 Windows 安装程序：

npm run dist:win:installer

安装程序会将应用固定安装到本地目录，后续启动无需重复解包。便携版适合临时使用，但首次启动可能因解包大量运行时文件而耗时较长。

构建产物会写入 release/，该目录已被 Git 忽略，不会提交到仓库。

架构

Electron 主进程
  - 原生窗口、菜单、对话框与日志
  - @deepseek-ai/dsh web --host 127.0.0.1 --port <可用端口>
  - WebContentsView -> 官方 Harness Web UI

Electron 渲染进程
  - 桌面工具栏与启动/错误提示界面

本仓库不修改 Harness 的产品逻辑。升级 @deepseek-ai/dsh 会同时升级嵌入的运行时和 Web UI，但仍需遵循上游版本兼容性要求。

安全与隐私

运行时只监听本机回环地址（127.0.0.1），应用数据保存在本地 Electron 用户数据目录。请勿提交 API Key、会话数据或本地运行时目录。如发现安全问题，请按 SECURITY.md 所述方式私下报告。

项目说明

这是独立的社区项目，并非 DeepSeek 官方产品。“DeepSeek”及相关标识归其各自权利人所有。有关上游项目与依赖的归属信息，请参阅 THIRD_PARTY_NOTICES.md。

贡献

欢迎提交 Issue 和 Pull Request。提交前请阅读贡献指南。

开源协议

本仓库中的桌面端封装采用 MIT License 发布；其依赖项仍分别受各自许可证约束。