hairyf/deepseek-harness-desktop · 上手攻略

仓库：hairyf/deepseek-harness-desktop
链接：https://github.com/hairyf/deepseek-harness-desktop
分类：AI Agent · Desktop Application
作者：Jay
更新：2026-08-17

这是什么

hairyf/deepseek-harness-desktop 是 DeepSeek Harness（DSH）的 Tauri 桌面版封装，由 hairyf 个人维护。它将 DSH 这套「插件化 Agent 执行框架」的 Web UI 打包成无需 Node.js / pnpm / Docker 即可运行的本地桌面应用，安装包仅约 5 MB，首次启动自动下载 Node 运行时和 Harness 核心。

核心定位：万物皆插件，桌面本身也是插件——DSH 的核心理念是把 Agent 能力做成可插拔模块，桌面端让这个生态更容易在本地触手可及。

解决什么问题

DeepSeek Harness 本身是一个纯 CLI / Web 应用，依赖 Node.js 环境。对非开发者而言，配置 Node / pnpm / 网络代理是一道门槛。

零配置本地运行：下载安装包 → 运行 → 直接在 http://127.0.0.1:3080 打开 Harness UI
隐私优先：默认监听 127.0.0.1:3080，不主动上报任何遥测数据
自修复核心：每次启动自动比对本地 Bundle 与 GitHub 最新 Release，落后则重新拉取，用户无感升级
跨平台桌面壳：Windows / macOS / Linux 全支持，比浏览器开 tab 更稳定

快速安装

下载安装包（推荐）

直接去 Releases 页面下载对应平台 installer：

平台	要求	说明
Windows	Windows 10+ (64-bit)，需联网首次启动	下载 `.msi` 或 `.exe`
macOS	macOS 10.15+	下载 `.dmg`，首次需在「系统设置 → 隐私与安全」手动 Allow
Linux	WebKit2GTK 环境	下载 `.AppImage`，`chmod +x` 后运行

从源码构建（需 Node 20+ / Rust 1.77+ / pnpm 9+）

git clone https://github.com/hairyf/deepseek-harness-desktop.git
cd deepseek-harness-desktop
pnpm install
pnpm tauri build    # 输出在 src-tauri/target/release/bundle/

CLI 模式（安装后可用）

安装程序会自动注册 dsh 命令到系统 PATH，新开终端即可使用：

dsh --profile web --host 127.0.0.1 --port 3080

核心用法

桌面端使用流程

启动应用 → 自动下载 Node 22.22.0 运行时 + Harness Bundle（约数百 MB，仅首次）
下载完成后自动在 Tauri WebView 中打开 http://127.0.0.1:3080
Harness Web UI 完全在本地运行，断网后已加载的部分仍可用

架构简析

┌─────────────────────────────────┐
│  Tauri WebView (React)          │
│  setup状态机 → 进度条 → iframe  │
│  加载 dsh web UI + 侧边栏控件   │
└──────────────┬──────────────────┘
               │ invoke commands
┌──────────────┴──────────────────┐
│  Tauri Rust Backend            │
│  - service/download: 下载/解压  │
│  - service/workflow: 进程管理  │
│  - task: 健康检查              │
└──────────────┬──────────────────┘
               │
  runtime/ (Node.js) + dependencies/dsh/ (prebuilt bundle)
               │
               ▼
  dsh --profile web --host 127.0.0.1 --port 3080
  数据目录: DSH_HOME=<app-data>/data/dsh

DSH（Harness）核心概念

DSH 是一个 Agent 插件框架，核心工作流：

# DSH_HOME 默认为 <app-data>/data/dsh
# 配置文件在 DSH_HOME/config 下
# 插件目录在 DSH_HOME/plugins 下

# 查看已安装插件（如果 DSH 支持此命令）
dsh plugin list

# 查看版本
dsh --version

⚠️ 具体 DSH CLI 用法需参考上游 deepseek-ai/deepseek-harness，桌面版本质是 Harness 的 UI 容器，DSH 本身的插件体系在此不展开。

典型适用场景

场景	适合原因
快速体验 DeepSeek Harness Agent 生态	无需配 Node 环境，点开即用
本地 AI 工作流调试	一切在本地，不走云端，隐私无虞
Windows 用户尝鲜 DSH	官方主推 Linux/macOS，桌面版补全 Windows
插件开发者预览	独立桌面窗口，比浏览器 tab 更稳定

坑与注意

macOS Gatekeeper：应用未经过苹果公证（notarized），macOS 会拦截。解决方法：系统设置 → 隐私与安全 → 底部「仍要打开」
首次启动必须联网：下载 Node 运行时和 Harness Bundle 约数百 MB，离线环境无法完成初始化
安全警告：DSH 可以在本地执行代码，仅用于可信环境的學習 / 研究 / 测试，切勿在不受信任的环境中运行
上游快速迭代：README 明确提示「Developer preview — upstream dsh is evolving fast with breaking changes」，桌面版紧跟上游，周级版本更新是常态
端口占用：默认 3080，若本机已被占用需查看 DSH 配置文档修改

与同类对比

项目	定位	安装包大小	依赖	隐私
hairyf/deepseek-harness-desktop	DSH 桌面封装	~5 MB	零（自带运行时）	✅ 本地默认
n8n-desktop	工作流自动化	~200 MB+	Electron	⚠️ 可选本地
oobabooga/text-generation-webui	LLM 本地 UI	~500 MB+	Python 环境	✅ 本地
deepseek-ai/deepseek-harness（上游）	Agent 插件框架	—	Node.js 20+	⚠️ 需自配

核心差异：DSH 的差异化在于「插件化 Agent 架构」，而非单纯的聊天 UI。桌面版降低了入门门槛，但真正价值在 DSH 插件生态本身。

一句话结论

如果你想零配置本地体验 DeepSeek Harness 的插件化 Agent 生态，5 MB 的桌面安装包是最快的入口；但如果追求 DSH 插件体系的完整能力，仍需参考上游文档。

来源：GitHub README · Releases · deepseek-harness 上游