DeepSeek Harness Desktop

官方 DeepSeek Harness 体验的轻量、自包含桌面宿主。

English · 简体中文

![DeepSeek Harness Desktop](docs/images/readme-hero-zh-CN.png) DeepSeek Harness Desktop 把官方 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI 和运行时放进桌面窗口，并自动管理本机 Harness 进程。用户无需另外安装 Node.js，也不用手动启动 `dsh web`。 > [!IMPORTANT] > 这是独立社区项目，不是 DeepSeek AI 官方产品。DeepSeek Harness 仍处于开发者预览阶段，后续版本可能包含不兼容改动。 ## 核心能力 - **开箱即用** —— 内置固定版本的 Node.js sidecar、官方 Harness 运行时、原生模块和发行时运行检查。 - **原生桌面集成** —— macOS 使用 Tauri 与系统 WKWebView，Windows 使用 Electron；Harness 只绑定到随机的 `127.0.0.1` 端口。 - **macOS 用量概览** —— 标题栏展示今日和近七天 Token、估算费用、运行任务数与所有运行任务的合计吞吐率。 - **克制的界面增强** —— macOS 原生标题栏跟随 Harness 主题；两个平台都内置默认开启、可在通用设置关闭的平滑流式输出。 - **更安全的 macOS 插件流程** —— 使用内置工具安装，重启后验证真实运行时；变更失败时恢复最近可用 profile。 - **兼容官方 CLI** —— 与官方 CLI 共用 `~/.dsh`，并能安全解析文档中的完整安装命令，不会把粘贴内容交给 shell 执行。费用来自本地 Token 记录和可用的公开模型价格，只作为估算。无法匹配价格的模型会明确显示为未定价，不会被当作免费。 ## 下载安装包发布在[最新 GitHub Release](https://github.com/chokwinlee/deepseek-harness-desktop/releases/latest)。 | 平台 | 架构 | 文件 | | --- | --- | --- | | macOS | Apple Silicon | `mac-arm64.dmg` | | macOS | Intel | `mac-x64.dmg` | | Windows 10/11 | x64 安装版 | `win-x64.exe` | | Windows 10/11 | x64 便携版 | `win-x64.zip` | Release 同时提供 ZIP 和 `SHA256SUMS.txt`。macOS 构建会启用 Hardened Runtime；没有配置 Developer ID 时使用 ad-hoc 签名。Windows 构建目前没有代码签名，因此系统可能显示安全确认。继续前请确认文件来自本仓库。 ## 快速开始 1. 安装并打开 DeepSeek Harness Desktop。 2. 进入 **设置 → 模型**，配置模型服务商和 API Key。 3. 添加或选择工作区。 4. 新建 Harness 会话。配置、工作区和会话与官方 CLI 使用相同的 `DSH_HOME`，默认位于 `~/.dsh`。 ## 插件与恢复在 macOS 打开 **设置 → 插件 → 安装与管理**。安装器接受 npm 包、`github:owner/repo`、公开 GitHub HTTPS 地址，也可以直接粘贴： ```bash dsh plugin --profile web add github:owner/repo ``` 桌面端只解析受支持的命令结构，不会执行粘贴的 shell 文本。它使用内置 DSH 和 pnpm，只重启受监护的 Harness 进程，并验证新 profile 是否能稳定运行五秒；启动失败时会恢复变更前的插件事务文件。第三方插件会在本机运行代码，安装前请检查来源与发布者。 ## 架构 ```text 桌面宿主 → 仅回环地址的 dsh web → 官方 Harness UI / 运行时 └──── 共用 DSH_HOME，保存设置、会话和插件 ``` 本项目不分叉或重新实现 Harness agent 运行时，只负责桌面打包、进程生命周期、导航边界、故障恢复、原生集成和发行验证。 ## 开发开发环境需要 Node.js 22.19 或更高版本。 ```bash git clone https://github.com/chokwinlee/deepseek-harness-desktop.git cd deepseek-harness-desktop npm ci npm test npm start ``` 运行 `npm run build:mac` 构建 macOS Tauri 发行包，运行 `npm run dist` 构建 Windows Electron 发行包。涉及打包的变更还应通过[发行工作流](.github/workflows/release.yml)中的真实运行时检查。 ## 项目 - 提交 Pull Request 前请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。 - 安全问题请按照 [SECURITY.md](SECURITY.md) 私下报告。 - 产品与界面决策遵循 [PRODUCT.md](PRODUCT.md)。 - 桌面宿主采用 MIT 许可证；Harness 与内置依赖保留各自许可证，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。