DeepSeek Harness Desktop 是一个由社区维护的 Windows 桌面封装。它将 DeepSeek Harness 完整的 dsh web 运行时与 Web GUI 放进独立 Electron 窗口，让用户像使用普通桌面软件一样启动 Harness，无需每次打开终端、输入命令或手动管理后台进程。

[!IMPORTANT] 这是社区项目，不是 DeepSeek 官方桌面客户端，也不代表 DeepSeek 官方立场。

界面预览

专注的桌面工作区

完整保留 Harness 设置能力

项目亮点

• 双击即用：将命令行启动流程封装为标准 Windows 应用，安装版和便携版均可构建。
• 原生桌面体验：独立窗口、自绘标题栏、最小化/最大化/关闭控制，以及经过统一设计的深色主题。
• 完整 Harness 能力：保留工作区、模型、插件、Agent 预设、权限和语言等原生功能。
• 本机安全运行：dsh web 仅监听 127.0.0.1 随机端口；关闭窗口时同步结束服务进程。
• 无缝复用配置：直接使用现有 DSH_HOME（默认 %USERPROFILE%\.dsh），命令行版与桌面版共享设置和会话。
• 上游版本感知：每天最多检查一次 DeepSeek Harness major/minor 更新，并提供源码重建更新流程。
• 可复现构建：运行时部署、依赖补齐、junction 展平、冒烟测试和 Electron 打包均由脚本完成。
• 隐私优先开源：源码仓库明确排除账号凭据、历史会话、日志、缓存、签名材料和本机构建产物。

工作方式

启动桌面应用
    ↓
在本机随机端口启动 dsh web
    ↓
Electron 窗口加载 Web GUI 并注入桌面主题
    ↓
关闭窗口时回收 Harness 子进程

隐私

仓库只包含桌面壳源码、构建脚本和必要图标，不包含：

• .dsh、API 凭据、登录状态或历史会话
• 日志、缓存、数据库和本机配置
• node_modules、打包产物、内置运行时或 Node 可执行文件
• 代码签名证书、私钥或环境变量文件

应用会在运行时读取本机的 DSH_HOME；这些数据不会被复制到项目目录。

开发运行

要求 Node.js 20+：

cd app
npm ci
npm start

开发模式需要先准备 staging/payload/runtime 和 staging/payload/node.exe。运行时来自上游 DeepSeek Harness，不提交到本仓库。

构建

1. 将上游仓库克隆到本机，例如 ..\deepseek-harness。
2. 安装 pnpm，并在上游仓库安装依赖。
3. 运行：

powershell -ExecutionPolicy Bypass -File scripts\sync-update.ps1 `
  -Checkout ..\deepseek-harness `
  -BuildOnly

生成文件位于 dist/。更新脚本不会依赖任何固定用户名或绝对路径。

自动更新说明

桌面应用根据打包时生成的 version.json 检查上游 DeepSeek Harness 版本。收到 major/minor 更新提示后，更新脚本会拉取用户本机的上游源码、重建运行时并重新打包。该流程需要 Git、Node.js、pnpm 和完整源码工作区，并非下载未知二进制覆盖安装。

上游与许可

桌面封装代码以 MIT License 发布。DeepSeek Harness 及其依赖仍分别适用各自的许可证和商标条款；分发包含上游运行时的安装包前，请自行核对并遵守对应许可。