deepseek-harness-desktop

English | 中文

关于本仓库（Fork）：这是官方 DeepSeek Harness 的 fork，在官方项目基础上增加了桌面应用打包，把 DeepSeek Harness 的 Web UI 封装成 macOS / Windows / Linux 桌面应用，双击即用、无需命令行。

• 下载安装包：Releases 页面（macOS zip、Windows exe、Linux AppImage）
• 打包实现：native/mac-app（macOS，Swift 壳）｜native/electron（Windows / Linux，Electron 壳）
• 自动发布：sync-upstream 每天自动同步上游源码；check-npm-updates 每天检测官方 @deepseek-ai/dsh 新版，自动回写版本号、重新打包并发布三平台 Release

安装

从 Releases 页面 下载对应平台的安装包。安装包按 DeepSeek-Harness-<版本>-<平台>-<架构>[-<类型>] 命名，例如 DeepSeek-Harness-0.1.2-macos-arm64.zip。

macOS

1. 下载 DeepSeek-Harness-*-macos-arm64.zip（Apple Silicon）

2. 解压，把 DeepSeek Harness.app 拖入「应用程序」文件夹

3. 首次打开若被 Gatekeeper 拦截，右键 App →「打开」，或执行：

   xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"
   

Windows

1. 下载安装器 DeepSeek-Harness-*-windows-x64-setup.exe（需安装）或便携版 DeepSeek-Harness-*-windows-x64-portable.exe（免安装）
2. 安装器：双击运行，按提示安装；便携版：双击直接运行
3. 首次运行若出现 SmartScreen 提示，点「更多信息」→「仍要运行」

Linux

1. 下载 DeepSeek-Harness-*-linux-x64.AppImage

2. 赋予执行权限：

   chmod +x DeepSeek-Harness-*.AppImage
   

3. 运行：

   ./DeepSeek-Harness-*.AppImage
   

首次启动后，在 App 内配置模型 API 密钥即可使用。

自动发布

发布流程完全自动化，每天自动运转，无需手动操作：

1. 同步上游源码：sync-upstream 工作流每天 08:00 UTC 将官方 deepseek-harness 的 master 合并进本仓库；若出现合并冲突，运行会失败并在 GitHub 通知你，master 保持原样，需手动解决后重跑。
2. 检测 npm 新版：check-npm-updates 工作流每天 09:17 UTC 对比 npm 上 @deepseek-ai/dsh 的最新版本与 native/mac-app/DSH_VERSION 中记录的版本。
3. 自动打包发布：发现新版后，先把新版本号回写进 DSH_VERSION（保证次日检测不会重复触发），再触发 macOS / Windows / Linux 三个打包工作流，自动创建 v<dsh版本> Release、上传安装包，并更新 macOS 的 Sparkle appcast 与 Windows 的 latest.yml 更新源。
4. 客户端更新：见下节「自动更新」。

手动推送 v0.1.x 标签仍可用于发布打包修复，但不影响更新判定——App 版本号始终等于所打包的 dsh 运行时版本。

自动更新

• macOS / Windows（安装版）：应用内置自动更新。启动时自动检查新版本，也可通过菜单「检查更新…」手动检查；新版下载完成后按提示重启即完成更新。
• Windows 便携版：便携版无法自动更新，请从 Releases 页面 下载新版安装包。
• Linux AppImage：自动安装暂不支持，菜单「检查更新…」会检查新版并打开下载页面。

版本号说明：App 的版本号即所打包的 dsh 运行时版本（如 0.1.0-rc.6），Release 标签（v0.1.x）仅用于标识打包构建，两者不同步不会触发更新。安装过 v0.1.7 及更早安装包的用户，因旧版本号高于新版体系（0.1.7 > 0.1.0-rc.x），需要手动下载一次最新安装包完成切换，之后即可正常自动更新。

原项目

以下为原项目 README 内容。

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。

它采用一切皆插件的架构，并由 Cordis 驱动，其设计参见论文 A Programming Paradigm for Spatiotemporal Composability。

开发者预览

DeepSeek Harness 目前处于 开发者预览 阶段，正在快速迭代。未来将出现破坏兼容性的变更。

运行

通过 npm 运行

安装 Node.js，然后运行：

npx @deepseek-ai/dsh web

该命令默认会在 http://127.0.0.1:3080 启动 Web UI，本机启动时还会用默认浏览器打开页面。通过 SSH 启动时只打印宿主机 URL，因为本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器。详见 Web UI 指南。

从源码运行

如需从仓库源码运行：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 会准备仓库产物。pnpm dsh web 会直接使用这些已构建产物，不会重新构建。

社区与支持

• 欢迎通过 GitHub Discussions 提交反馈或 bug 报告。
• 为你的插件仓库添加 dsh-plugin 话题，便于被发现。
• 欢迎加入 DeepSeek Harness 企微群：扫码添加企微小助手并填写入群问卷，完成后小助手会邀请你入群。

参与贡献

参见 CONTRIBUTING.md。

开发

请先阅读开发指南与架构文档。

面向 agent：请遵循 AGENTS.md。

许可证

MIT

第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。