xuan-ao-1/deepseek-harness-workbench
> DeepSeek Harness 官方架构的 Windows 桌面发行版 —— 把官方 dsh Agent Harness 打包成开箱即用的桌面应用。 > 不是新的 Harness、聊天框架、插件框架或 IDE 框架；它只是官方架构的一个桌面发行状态（Application Carrier）。
catalog 简介 / catalog descriptioncatalog description：DeepSeek Harness 官方架构的 Windows 桌面发行版 (Desktop distribution of the official DeepSeek Harness)
安装Install
dsh plugin --profile web add github:xuan-ao-1/deepseek-harness-workbench把 xuan-ao-1/deepseek-harness-workbench 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeepSeek Harness Workbench
DeepSeek Harness 官方架构的 Windows 桌面发行版 —— 把官方
dshAgent Harness 打包成开箱即用的桌面应用。 不是新的 Harness、聊天框架、插件框架或 IDE 框架；它只是官方架构的一个桌面发行状态（Application Carrier）。
✨ 特性
- 开箱即用：单个安装包内置 Node.js 运行时 + 官方
dsh（@deepseek-ai/dsh@0.1.0-rc.6）+ 预生成 Profile 模板，无需预先安装 Node/pnpm/DSH，装完即用。 - 无边框沉浸式窗口：Windows 完全自绘标题栏与最小化/最大化/关闭按钮（对齐 Windows 11 / TraeWork 风格），自适应浅色/深色主题。
- 官方原生 UI：直接加载官方
dsh-web-appWeb 界面（Phase 0 loopback），非自研聊天界面。 - 插件生态：完整兼容官方 DeepSeek Harness 插件体系 —— 官方 DSH 插件不改版即可运行。
- 数据隔离可选：安装版用户数据在
~/.dsh（与命令行dsh共享）；便携版数据在 exe 旁data/.dsh（绿色携带、零残留）。 - 架构合规：不 fork Core、不建第二套插件 API、所有能力通过官方 Profile + Bundle 组合（详见
docs/）。
🖼 界面预览
⚖️ 与官方 dsh CLI 的对比
官方 dsh CLI |
DeepSeek Harness Workbench | |
|---|---|---|
| 安装 | 需手动装 Node.js / pnpm / DSH | 单个 exe 装完即用，内置全部运行时 |
| 界面 | 终端命令 + 手动开浏览器 | 独立无边框窗口，原生 Web UI，自动启动 |
| 窗口控制 | 无（浏览器标签页） | 自绘标题栏 + 最小化/最大化/关闭（Win11/TraeWork 风格） |
| 插件生态 | 官方 dsh plugin |
完全兼容，同一套 Profile + Bundle，不改版 |
| 数据 | ~/.dsh |
安装版共用 ~/.dsh；便携版隔离到 exe 旁 |
| 上手成本 | 高（多条命令） | 低（双击运行，配一个 API Key 即可对话） |
它不是对 DSH 的分叉或替代，而是官方架构的桌面发行状态 —— 省掉环境配置，换来原生窗口体验，底层能力完全一致。
📥 下载
从 Releases 页面下载最新版：
| 版本 | 说明 |
|---|---|
| Setup 安装版 | DeepSeek-Harness-Workbench-x.y.z-Setup-x64.exe —— 标准安装，创建桌面/开始菜单快捷方式，支持自定义安装目录 |
| Portable 便携版 | DeepSeek-Harness-Workbench-x.y.z-Portable-x64.exe —— 绿色免安装，解压到任意目录直接运行，数据在 exe 旁，可 U 盘携带 |
首次启动 Portable 版需要解压（约 3-4 分钟），请耐心等待。 校验文件完整性请使用随 Release 附带的
SHA256SUMS.txt。
⚡ 一键安装（PowerShell）
不用下载页面，复制下面任意一行到 PowerShell 回车即可：
# 安装 Setup 版（静默安装，自动建快捷方式）
irm https://raw.githubusercontent.com/xuan-ao-1/deepseek-harness-workbench/main/scripts/install.ps1 | iex
# 部署 Portable 版（放到 %USERPROFILE%\DeepSeek Harness Workbench）
irm https://raw.githubusercontent.com/xuan-ao-1/deepseek-harness-workbench/main/scripts/install.ps1 | iex -Args "-Portable"
# 自定义便携版目录
irm https://raw.githubusercontent.com/xuan-ao-1/deepseek-harness-workbench/main/scripts/install.ps1 | iex -Args "-Portable -InstallDir D:\Apps\DeepSeek Harness"
脚本自动完成：查询最新 Release → 下载安装包 → SHA256 完整性校验 → 静默安装/就位 → 启动应用。
🚀 快速开始
- 下载 Setup 或 Portable 版本并运行。
- 启动后首次运行会从内置模板离线创建 Profile（无需网络）。
- 在界面中配置 DeepSeek API Key（
DEEPSEEK_API_KEY或界面设置）。 - 开始对话 —— 可让 Agent 读写工作区文件、执行命令、调用工具。
🛠 本地开发
# 环境要求：Node.js >= 20, pnpm
pnpm install # 安装 workspace 依赖
pnpm arch:check # 架构守卫扫描（无需依赖，纯 Node）
pnpm -C apps/electron run build # 编译 Electron 主进程/预加载脚本
pnpm -C apps/electron run dev # 热重载开发（tsc watch + electronmon 自动重启）
node build/scripts/package.mjs # 完整打包：prepare-runtime → build → NSIS/Portable + SHA256SUMS
node build/smoke-tests/smoke.mjs # 冒烟测试（真实启动 Runtime）
产物输出到 release/：
DeepSeek-Harness-Workbench-<version>-Setup-x64.exeDeepSeek-Harness-Workbench-<version>-Portable-x64.exeSHA256SUMS.txt
📚 文档
- ARCHITECTURE — 当前实际架构（三层：Electron 应用 → DSH Profile → 官方 Runtime）
- DECISIONS — 架构决策记录（ADR）
- STATUS — 项目状态与版本矩阵
- RELEASE — 发布政策与门槛
- KNOWN_ISSUES — 已知问题
- ROADMAP — 路线图（M1 → M2 Official Electron Carrier）
- UPSTREAM — 上游 DSH 版本 pin 与阅读结论
🏗 架构
┌──────────────────────────────────────┐
│ Electron Application │
│ Window / IPC / Process / Update │
│ Frameless + self-drawn controls │
└────────────────┬─────────────────────┘
▼
┌──────────────────────────────────────┐
│ DSH Profile │
│ dsh-base + official bundles │
│ + workbench-desktop bundle │
│ + user bundles + cordis.patch.yml │
└────────────────┬─────────────────────┘
▼
┌──────────────────────────────────────┐
│ Official DeepSeek Harness │
│ Host/Client Cordis Runtime │
│ Services / Tools / Agents │
│ Subagents / Workflow / UI Slots │
└──────────────────────────────────────┘
📄 License
本项目基于官方 deepseek-ai/deepseek-harness（MIT）构建，发行层亦采用 MIT License。详见 LICENSE。
致谢：基于 deepseek-ai/deepseek-harness 官方开源架构构建。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
-
nexu-io/open-design
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
esengine/DeepSeek-Reasonix
DeepSeek-native AI coding agent for your terminal. Engineered around prefix-cache stability — leave it running.
-
anywhere-labs/deepseek-harness-desktop
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」，桌面本身也是「插件」。
-
walkinglabs/learn-harness-engineering
Harness engineering beginner tutorial, from 0 to 1
-
YaoApp/yao
✨ All your agents and workspaces in one place, on every device you own. Track tasks on a board, accessible from desktop,…
-
Devin-AXIS/iPolloWork
Enterprise-grade, local-first Agent Workbench for people and agent teams. A unified multi-engine workspace for Codex Har…