Myoontyee/deepseek-harness-desktop

DeepSeek Harness Desktop

DeepSeek Harness 的桌面端入口——下载、安装、双击，就是 DeepSeek Harness，而且永远是最新版。

基于 deepseek-ai/deepseek-harness 官方项目的非官方桌面壳（Tauri 2 + WebView2），自动同步官方 master 分支。

官方网站
 · 
DeepSeek Harness 官方源码仓

简体中文 · English

📸 预览

⬇️ 下载

| 平台 | 架构 | 安装包 | 下载 |
| --- | --- | --- | --- |
| Windows | x64 | Setup 安装器（95MB，内置运行环境与源码快照） | 下载 |
| macOS | Apple Silicon | DMG（73MB） | 下载 |
| Linux | x64 | AppImage（141MB） | 下载 |
| Debian / Ubuntu | x64 | deb（82MB） | 下载 |

所有历史版本见 GitHub Releases。

[!IMPORTANT]
这是非官方社区包装，早期项目。Windows 构建未做商业代码签名，macOS 构建未做 Apple notarization。

✨ 为什么有这个项目

DeepSeek Harness 已经提供了完整的 Agent 运行时与 Web UI。本项目提供桌面产品所需的宿主能力：

- 零前置依赖：内置便携版 Node.js 与 pnpm，目标机器无需安装任何运行时
- 离线优先：安装包内置官方源码快照（18MB），首次运行零网络初始化，网络不可用时照常工作
- 永远最新：联网时自动同步官方 master 分支，主仓更新即应用更新
- 中国网络适配：自动读取系统代理（Clash 等）注入 git，多级降级（快照 → clone → ZIP）不假死
- 系统托盘常驻：关闭窗口隐藏到托盘，服务持续运行；单实例互斥
- 故障自愈：Web 启动失败自动重载，端口冲突自动切换

🧱 架构

┌──────────────────────────────────────────────────────────────┐
│  DeepSeek Harness Desktop（本仓库）                           │
│  ├─ 桌面壳（Tauri 2 + WebView2，约 3MB，Rust）                │
│  ├─ 内置运行时工具 tools/（随安装包分发）                     │
│  │   ├─ node/    便携版 Node.js                               │
│  │   └─ pnpm     便携版 pnpm                                  │
│  ├─ 内置源码快照 dsh-runtime-snapshot.zip（离线初始化）        │
│  └─ 运行时目录 %LOCALAPPDATA%\DeepSeekHarness\runtime\        │
│      └─ DeepSeek Harness 官方源码（自动保持 master 最新）     │
└──────────────────────────────────────────────────────────────┘
│ 启动流程
▼
┌──────────────────────────────────────────────────────────────┐
│  1. 校验 tools/（Node + pnpm）                                │
│  2. 同步 runtime（内置快照 → git clone → ZIP，三级降级）      │
│  3. pnpm install（依赖变化时才执行）                          │
│  4. pnpm run build（版本变化时才执行）                        │
│  5. 等待服务就绪（含插件端点探活）                            │
│  6. 窗口加载本地服务（启动页 → Web UI，失败自动重载）         │
└──────────────────────────────────────────────────────────────┘

🚀 快速开始

1. 从上方下载对应平台的安装包
2. 双击安装并打开——首次启动使用内置代码初始化，无需联网；联网时自动更新到官方最新版
3. 在界面「设置」中填入你的 DeepSeek API Key（或设置环境变量 DEEPSEEK_API_KEY 后重启应用）

依赖要求

- Windows 10/11（自带 WebView2）· macOS 11+ · Linux（WebKitGTK 4.1）
- 约 2GB 可用磁盘空间
- 在线更新需要能访问 GitHub 与 npm registry（首次离线初始化不需要）

🔨 从源码构建

前置条件

- Rust stable 工具链（Windows: MSVC；macOS: Xcode CLT；Linux: gcc）
- 便携版运行时工具 tools/（构建脚本自动从官方下载；Windows 也可手动准备）

构建

生成官方源码快照（发布时 CI 自动执行）
git -C  archive --format=zip -o src-tauri/dsh-runtime-snapshot.zip HEAD

构建桌面壳 + 安装包
pnpm dlx @tauri-apps/cli@2 build
产物：src-tauri/target/release/bundle/{nsis,dmg,appimage,deb}/

图标

src-tauri/icons/ 由 generate-icon.ps1 从 assets/whale.svg（官方白底黑鲸鱼）生成；
修改后运行 pnpm dlx @tauri-apps/cli icon app-icon.png 刷新全套尺寸。

🏷️ 版本策略

桌面壳版本号独立演进（自 1.0.0 起），与官方代码仓版本解耦：

| 位置 | 版本来源 |
| --- | --- |
| 桌面壳（本仓库） | 独立版本号 1.0.0（Cargo.toml / tauri.conf.json） |
| 本仓库 git tag | v（如 v1.0.0） |
| Harness（官方） | package.json 的 version（如 0.1.0-rc.5），随官方演进 |
| 启动页封面 | 动态显示 Harness  · Desktop  |

发版流程：壳功能迭代 → 提升壳版本 → 打 v* tag → CI 自动构建 Windows/macOS/Linux 安装包 → 发布 GitHub Release。官方代码更新由应用内「一键升级」自动同步，不依赖壳发版。

⚙️ 环境变量

| 变量 | 作用 | 默认 |
| --- | --- | --- |
| DSH_PORT | 服务端口（被占用时自动切换） | 3080 |
| DSH_RUNTIME_DIR | 运行时源码目录 | %LOCALAPPDATA%\DeepSeekHarness\runtime |
| DSH_TOOLS_DIR | 内置 Node/pnpm 目录 | exe 同目录 tools |
| DSH_LOCAL_SOURCE | 本地 git 源（开发测试） | 无 |
| DSH_SKIP_UPDATE=1 | 跳过更新检查，直接使用现有运行时 | 无 |

📁 目录结构

deepseek-harness-desktop/
├── assets/               # 图标源（whale.svg 等）
├── ui/                   # 内置启动页（白底杂志风，嵌入 exe）
├── docs/                 # README 截图
├── tools/                # 便携式运行时（Node + pnpm，随安装包分发）
├── src-tauri/
│   ├── src/main.rs       # 桌面壳主体（启动编排/服务生命周期/故障自愈）
│   ├── tauri.conf.json   # Tauri 配置（窗口/打包/标识/安全）
│   ├── icons/            # 应用图标全套
│   └── capabilities/     # Tauri 权限
├── generate-icon.ps1     # 图标生成脚本
└── main/                 # 便携部署产物（不入库）

❓ 常见问题

- 首次启动很慢？ 内置快照初始化只需几秒（带百分比进度条）；在线更新时取决于网络。
- 启动后白屏/插件未激活？ 应用内置自动重载（最多 3 次）；仍失败查看 server.log 定位。
- 端口被占用？ 自动切换到空闲端口；服务复用检测可识别真正的 dsh 实例。
- 离线环境可用吗？ 首次安装后设置 DSH_SKIP_UPDATE=1 即可完全离线使用。
- 重复双击会怎样？ 单实例互斥——第二个启动会自动聚焦已有窗口。

已知限制

- macOS Intel 构建暂未发布（GitHub runner 资源限制，可手动构建）
- 构建未签名：Windows SmartScreen / macOS Gatekeeper 可能提示，选择“仍要运行”即可

License

MIT