harness-desktop — DeepSeek Harness 彩色桌面端（开箱即用版）

开箱即用的 AI 助手工作台 · The out-of-the-box desktop client for DeepSeek Harness. Download, install, double-click, and chat — no terminal, no environment setup.

English README: README_EN.md

彩色外观 · 随你配色

把这台工作台调成你的颜色：深色 / 浅色 / 跟随系统三种主题，DeepSeek 蓝 / 绿 / 紫 / 橙四种主题色，再加上字体大小与消息密度——全部即时生效、重启保留，让每一天的 Harness 都换个心情。

截图

启动界面（深色）

主界面（浅色 · 官方 DeepSeek Harness Web UI 集成 + 品牌）

特性

• 开箱即用：内置 DeepSeek Harness 引擎，装完即聊；首启 4 步向导 3 分钟上手
• 原汁原味的官方 UI：窗口直接加载引擎官方 Web UI（同源加载，非 iframe）——会话、轨迹、设置都是官方体验，不做第二套界面
• 官网同源背景皮肤：复刻 DeepSeek Harness 官网 hero 的 WebGL2 流体辉光背景（深/浅双主题配方、鼠标辉光交互、低配机自动降级静态渐变），官方界面侧栏/输入区同步质感
• 一键更新：左下角「更新」按钮自动发现新版本——后台静默下载、进度可视化、一键重启安装；保持最新则无打扰
• 流式聊天：打字机输出 + 思考过程可视化，如 ChatGPT 般顺滑
• 任务面板：任务追踪 / 自动复盘 / 失败重试，一条消息一个任务
• Agent 进化：记忆自动沉淀（偏好/项目约定/成功做法）+ 同类任务自动提炼技能，越用越顺手
• 安全：严格 CSP / 单实例锁 / 附件限制 / safeStorage 密钥加密
• 系统托盘常驻：关闭最小化到托盘，后台持续运行
• 三平台原生构建：GitHub Actions 矩阵，macOS / Windows / Linux 各自在原生 runner 上构建

快速开始

安装（三平台）

macOS / Windows / Linux 安装包：GitHub Releases 下载对应平台安装包（dmg / exe / AppImage / deb）

npm 一键安装（自动下载对应平台安装包）：

npm install -g harness-desktop
# npm 新版默认拦截安装脚本，如需自动下载安装包加参数：
npm install -g --allow-scripts=harness-desktop harness-desktop
harness-desktop        # 启动安装

Homebrew（macOS）：

brew tap 988hj7tczd-oss/harness-desktop
brew install harness-desktop

直接下载：

国内加速（Gitee 镜像）：https://gitee.com/jerryweizhihao/harness-desktop

首启

运行 → 4 步向导（欢迎 → 配置 API Key → 选择工作区 → 完成）→ 开始对话

API Key：前往 platform.deepseek.com 获取（示例中所有密钥均为占位符 YOUR_API_KEY）

未提供安装包时可用开发模式运行：

pnpm install
pnpm dev

命令行使用

npm 一键安装 + 启动：

# 安装（自动下载对应平台安装包）
npm install -g harness-desktop
# npm 新版默认拦截安装脚本，如需自动下载加参数：
npm install -g --allow-scripts=harness-desktop harness-desktop

# 启动安装（打开已下载的 dmg/exe/AppImage）
harness-desktop

# 检查是否已下载
harness-desktop --check

Homebrew（macOS）：

brew tap 988hj7tczd-oss/harness-desktop
brew install harness-desktop

直接下载安装包：

# macOS (Apple Silicon)
curl -L -o harness-desktop.dmg "https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop-0.1.4-arm64.dmg"
# Windows
curl -L -o harness-desktop.exe "https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop.Setup.0.1.4.exe"
# Linux
curl -L -o harness-desktop.AppImage "https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop-0.1.4.AppImage"
chmod +x harness-desktop.AppImage && ./harness-desktop.AppImage

国内加速（Gitee 镜像）：https://gitee.com/jerryweizhihao/harness-desktop

开发指南

pnpm install      # 安装依赖
pnpm dev          # 开发模式：vite + electron（HMR）
pnpm build        # 构建 renderer + main
pnpm test         # 运行单元测试（Vitest）
pnpm typecheck    # TS 类型检查
pnpm dist         # 打包 macOS dmg + Windows exe（输出到 out/）
pnpm dist:mac     # 仅 macOS
pnpm dist:win     # 仅 Windows

macOS 签名与公证流程见 docs/SIGNING.md。

技术栈

• 引擎：DeepSeek Harness @deepseek-ai/dsh@0.1.1-rc.2（跟踪官方 latest，同步官方功能）
• 桌面壳：Electron 43 + electron-builder
• 前端：React 18 + TypeScript + Vite（手写 CSS + --dsw-* token，无重型 UI 库）
• 隔离层：adapter/ 独立封装 dsh API，上游变更只改 adapter，renderer 永不见 dsh 原始字段

DSH 生态

• 📦 awesome-dsh-plugin — DeepSeek Harness 插件精选列表（本项目已收录于 Desktop Clients 板块）
• 🖱️ dsh-computer-use — Computer Use 插件：给 harness-desktop 增加"虚拟鼠标真人操作"能力
• 🌐 独立站：aibunkhouse.com · 工具页：aibunkhouse.com/tools

已知限制（诚实标注）

• 未签名：当前 macOS/Windows 产物未做代码签名/公证，安装时系统可能提示"无法验证开发者"；macOS 应用内自动更新依赖代码签名（未签名时静默跳过，请用 GitHub Release 手动下载更新）；签名流程见 docs/SIGNING.md
• 体积：安装包约 130-230MB（内置完整 dsh 引擎 + Electron 框架）
• 三平台：macOS / Windows / Linux 均已在各自原生环境构建（GitHub Actions 矩阵），Windows 已实机验证可用
• dsh 引擎：处于 rc 预览期，本项目跟踪官方 latest 0.1.1-rc.2

License

MIT

非 DeepSeek 官方产品，与 DeepSeek 无附属关系；DeepSeek Harness 为 DeepSeek AI 的开源项目。