harness-desktop (harness-memory)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# 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.

[![Release](https://img.shields.io/badge/release-v0.1.4-blue)](https://github.com/988hj7tczd-oss/harness-desktop/releases/latest) [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https://github.com/988hj7tczd-oss/harness-desktop/releases) [![English](https://img.shields.io/badge/readme-English-blue)](README_EN.md)

**English README**: [README_EN.md](README_EN.md)

## 彩色外观 · 随你配色

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

![splash](assets/screenshots/splash.png)

## 截图

**启动界面（深色）**

![splash](assets/screenshots/splash.png)

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

![main](assets/screenshots/main.png)

## 特性

- **开箱即用**：内置 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](https://github.com/988hj7tczd-oss/harness-desktop/releases) 下载对应平台安装包（dmg / exe / AppImage / deb）

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

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

**Homebrew**（macOS）：

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

**直接下载**：

| 平台 | 安装包 |
|---|---|
| macOS Apple Silicon | [harness-desktop-0.1.4-arm64.dmg](https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop-0.1.4-arm64.dmg) |
| macOS Intel | [harness-desktop-0.1.4.dmg](https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop-0.1.4.dmg) |
| Windows x64 | [harness-desktop.Setup.0.1.4.exe](https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop.Setup.0.1.4.exe) |
| Linux x64 | [harness-desktop-0.1.4.AppImage](https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop-0.1.4.AppImage) / [harness-desktop_0.1.4_amd64.deb](https://github.com/988hj7tczd-oss/harness-desktop/releases/download/v0.1.4/harness-desktop_0.1.4_amd64.deb) |

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

### 首启

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

**API Key**：前往 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 获取（示例中所有密钥均为占位符 `YOUR_API_KEY`）

> 未提供安装包时可用开发模式运行：
> ```bash
> pnpm install
> pnpm dev
> ```

## 命令行使用

**npm 一键安装 + 启动**：

```bash
# 安装（自动下载对应平台安装包）
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）**：

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

**直接下载安装包**：

```bash
# 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

## 开发指南

```bash
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](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](https://github.com/988hj7tczd-oss/awesome-dsh-plugin) — DeepSeek Harness 插件精选列表（本项目已收录于 Desktop Clients 板块）
- 🖱️ [dsh-computer-use](https://github.com/988hj7tczd-oss/dsh-computer-use) — Computer Use 插件：给 harness-desktop 增加"虚拟鼠标真人操作"能力
- 🌐 独立站：[aibunkhouse.com](https://aibunkhouse.com) · 工具页：[aibunkhouse.com/tools](https://aibunkhouse.com/tools)

## 已知限制（诚实标注）

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

## License

[MIT](LICENSE)

---

*非 DeepSeek 官方产品，与 DeepSeek 无附属关系；DeepSeek Harness 为 [DeepSeek AI](https://deepseek.com) 的开源项目。*