桌面安装包LodeKennes/deepseek-harness-desktop

DeepSeek Harness

适用于 DeepSeek Harness（dsh）的桌面安装程序。
英语 · 中文

DeepSeek Harness 是来自 DeepSeek AI 的开源智能体运行框架。一切皆插件，由 Cordis 提供支持。本仓库不包含该源代码。它将一个固定版本打包为 Windows、macOS 和 Linux 安装程序，并添加了连接现有订阅的首次运行路径。

最终用户无需 Node.js、pnpm 或 C++ 工具链。安装后大小约为 0.5 GB。

下载最新版本
·
上游仓库
·
deepseek.com/harness

开发者预览版

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

这些桌面构建版本未签名。Windows SmartScreen 和 macOS Gatekeeper 会发出警告；Linux 软件包没有签名。没有应用内自动更新。请将操作系统的信任界面视为正确提示。本打包项目并非 DeepSeek 官方产品页面。

安装

从最新的 GitHub Release 中选择适用于你的操作系统和 CPU 的资产，或使用包管理器。详情：docs/user-install.md。图库状态：packaging/README.md。

macOS
brew tap LodeKennes/deepseek-harness-desktop https://github.com/LodeKennes/deepseek-harness-desktop
brew install --cask deepseek-harness

Windows
winget install LodeKennes.DeepSeekHarness   # after the first community PR landssh
scoop bucket add deepseek-harness https://github.com/LodeKennes/deepseek-harness-desktop
scoop install deepseek-harness
choco install deepseek-harness              # 社区包获批后

Arch
yay -S deepseek-harness-desktop-bin         # AUR 仓库创建后

官方 CLI 方式仍为 npx @deepseek-ai/dsh web —— 参见上游 README。

| 平台 | 推荐 | 同时发布 |
| --- | --- | --- |
| Windows x64 / arm64 | NSIS 安装程序（.exe） | 便携版 .zip |
| macOS Apple Silicon / Intel | .dmg | 同一应用的 .zip |
| Debian / Ubuntu | .deb（apt install ./…） | |
| Fedora / RHEL | .rpm | |
| Arch / Manjaro | .pkg.tar.zst | |
| 任意 Linux | | AppImage（FUSE 或 --appimage-extract-and-run；以 --no-sandbox 运行） |

macOS，复制到“应用程序”后：
sh
xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"

Windows：更多信息 → 仍要运行。NSIS 的“将 dsh 添加到 PATH”复选框默认保持关闭，以免遮蔽全局 CLI 安装。

连接订阅

首次启动时，连接一个你已付费的账户。应用会启动一个仅限 localhost 的辅助程序，打开提供商真实的浏览器登录页面，发现模型，并配置 Harness。

| 你拥有 | 你连接 |
| --- | --- |
| ChatGPT / Codex | ChatGPT |
| Claude | Claude |
| Google Antigravity | Google |
| SuperGrok / Grok Build | xAI / Grok |
| Kimi Code | Kimi |

跳过此屏幕，稍后可在 Settings → Models 下添加 API 密钥。可从 Subscriptions → Manage subscriptions… 重新打开。

账户文件保存在 ~/.dsh/desktop/cliproxyapi/auth（或 %USERPROFILE%\.dsh\…）下。它们不会发送到此仓库。该辅助程序是 CLIProxyAPI。

桌面端与 CLI 共享 ~/.dsh。请勿同时运行 dsh 和此应用 —— 每次启动都会将 $DSH_HOME/profiles/node_modules 修复为其自身的安装。

社区与支持

请使用上游渠道。本打包者不单独托管社区。

- 反馈与缺陷报告：DeepSeek Harness Discussions
- 桌面端特有的打包问题：本仓库的 issues
- 插件作者：添加 dsh-plugin 话题
- DeepSeek Harness Discord

版本锁定

versions.json 是本仓库的唯一事实来源。它不是 Harness 的唯一事实来源。

| 字段 | 当前 |
| --- | --- |
| 桌面端基础 | 0.1.2-rc.1 · ai.deepseek.harness.desktop |
| Harness | 0.1.2-rc.1，位于 a66e4702047846cdaa10c66c9d3df3951f5ea70d |
| Node（内置） | 24.19.0 |
| pnpm | 11.21.0 |
| Electron | 43.4.0 |
| CLIProxyAPI | 7.2.132 |
推送到 master 会发布 desktop-v0.1.2-rc.1-build-N。桌面基础版本与 Harness 匹配，而 build-N 是一个全局递增的桌面构建计数器。在此处提升 Harness 版本和 SHA 是一次刻意的提交。没有 git 子模块，也没有 vendored Harness 树。

开发

你需要 Git、jq、Node 24 和 pnpm 11.21.0。这些脚本不会安装它们。
sh
./scripts/stage-runtime.sh      # pin → build Harness → stage sidecar + Node
./scripts/stage-cliproxyapi.sh  # pin → verify → stage CLIProxyAPI
pnpm start                      # tsc && electron .
pnpm test
./scripts/package.sh            # host OS/arch only; no cross-compile

品牌和桌面专属补丁位于 styling.json 和 resources/ 中。参见 docs/development.md。

关于 agent 本身，请从上游的开发指南、架构和 AGENTS.md 开始。

许可证

MIT。上游 Harness 和捆绑的 CLIProxyAPI 二进制文件也是 MIT；它们的许可证随安装程序一同分发。