桌面客户端插件市场huihuisire/harness-hub

Harness Hub

Harness Hub — DeepSeek Harness 桌面应用

DeepSeek Harness（dsh）桌面端：免命令行、免环境配置，双击即用；开源插件一站式集成——不用你自己搜、自己装，应用内逛市场、一键安装、自动激活。
一个原生 DeepSeek Harness（dsh）桌面客户端，内置一站式开源插件市场——一键浏览、安装并激活社区插件。无需 CLI，无需 Node.js 环境，无需 Docker。

License
Electron
Platform
dsh

社区开源皮肤插件「黑鲸鱼娘」（dsh-deep-whale）一键安装并自动激活后的 dsh 界面 —— 你的 Agent 工作台，也可以有自己的风格。
一个社区开源皮肤插件（dsh-deep-whale）一键安装并激活后的效果。

黑鲸鱼娘皮肤插件效果 — DeepSeek Harness desktop with community skin plugin

开源插件，一站式集成｜One-Stop Plugin Integration

DeepSeek Harness 的「万物皆插件」生态在 GitHub 上有数千个开源作品，但自己搜仓库、敲命令、处理依赖、排查激活，门槛太高。Harness Hub 把整条链路收进应用内：

- 逛（Browse） — 内置插件市场，实时聚合 GitHub dsh-plugin 标签下的开源插件，按 Star 数 / 最近更新排序，支持搜索与翻页，详情抽屉直接预览仓库 README；
- 装（Install） — 一键安装，不用你找仓库地址、不用敲命令；自动解析仓库真实默认分支，内置 pnpm 完成依赖安装；也支持粘贴 npm 包名 / owner/repo / GitHub 链接手动安装；
- 激活（Activate） — 安装完成自动重启服务加载新插件，无需任何手动操作；「已安装」页实时显示启用状态；
- 放心（Safe） — 每次安装/卸载前自动备份 profile 配置，失败自动回滚，历史备份可随时一键回退，玩坏也能秒恢复。

内置插件市场 — one-stop open-source plugin marketplace for DeepSeek Harness

界面展示｜Demo

demo.gif

为什么选择 Harness Hub？｜Why Harness Hub

DeepSeek Harness 是一个「万物皆插件」的 AI Agent 运行时，但命令行安装、Node 环境、端口排查把很多用户挡在门外。Harness Hub 把这些全部藏到桌面应用背后：

DeepSeek Harness 是一个「万物皆插件」的 AI Agent 运行时——但命令行安装、Node 环境和端口调试把很多用户挡在门外。Harness Hub 把这些全部藏到原生桌面应用背后。

- 零配置启动（Zero setup） — 内置 Node 运行时与 pnpm，不需要你机器上装任何环境；双击安装包即用。
- 服务全自动托管（Managed service） — 自动启动 dsh web 服务、探测与复用端口、崩溃自动恢复，托盘常驻后台。
- 按需联网，启动零等待（On-demand network） — 启动过程不请求任何外部网络；插件市场只在你打开它时才加载，慢网络 20 秒自动中断，绝不卡住首屏。
- 主题跟随（Theme sync） — 自动跟随你在 dsh 设置里选择的浅色/深色主题。
- 与命令行 dsh 共享数据（Shared profile） — 使用同一个 ~/.dsh 目录，桌面端装的插件在命令行里同样生效，反之亦然。

架构一览｜How It Works

┌─────────────────────────── Harness Hub (Electron) ───────────────────────────┐
│                                                                              │
│   Renderer（插件市场 / 已安装 / 备份回滚 / 主题）                               │
│        │  preload (contextBridge)                                            │
│   Main process ──► DshServiceManager：启动/复用/自愈 dsh web，仅绑定 127.0.0.1 │
│        │         └► PluginManager：市场搜索、一键安装、自动备份/回滚（内置 pnpm）│
│        ▼                                                                     │
│   内嵌 webview ──► http://127.0.0.1:3080 （dsh web UI，仅本地回环）             │
└──────────────────────────────────────────────────────────────────────────────┘

快速开始｜Quick Start

直接使用：到 Releases 页下载对应平台安装包（Windows：Harness Hub Setup x.x.x.exe；macOS：.dmg；Linux：.AppImage / .deb）。

从源码运行（开发）：

npm install          # 安装依赖（含 @deepseek-ai/dsh 与内置 pnpm）
npm run fetch-node   # 下载内置 Node 运行时（约 80MB，仅首次）
npm start            # 启动桌面应用

打包发行版：

npm run dist         # Windows（NSIS 安装包 + 便携版）
npm run dist:mac     # macOS（dmg / zip）
npm run dist:linux   # Linux（AppImage / deb）

系统要求｜Requirements

| 项目 | 要求 |
| :--- | :--- |
| 操作系统 | Windows 10+ / macOS 11+ / 主流 Linux 发行版（x64） |
| Node.js | 无需安装（应用内置） |
| 网络 | 仅逛市场/装插件时需要；启动与服务运行完全本地 |

隐私与安全｜Privacy & Security

- dsh web 服务仅绑定 127.0.0.1 本地回环地址，不对外暴露；
- 所有数据保存在你本机的 ~/.dsh 目录，与命令行 dsh 完全一致，应用不上传任何内容；
- 外部链接一律交给系统浏览器打开，应用内 webview 禁止跨源导航；
- 插件为社区开源作品，安装前可在详情抽屉查看仓库 README 自行审查。

常见问题｜FAQ / Troubleshooting

| 现象 | 处理 |
| :--- | :--- |
| 首次启动较慢 | 首次需初始化运行环境，通常几秒；插件市场不在此阶段联网 |
| 端口被占用 | 自动探测 3080–3090 空闲端口，或复用已在运行的 dsh web |
| 插件安装失败 | 配置已自动回滚，不影响现有环境；可在「备份与回滚」页一键回退 |
| Windows SmartScreen 提示 | 社区版未做代码签名，选择「仍要运行」即可 |
| 界面异常/白屏 | 应用会自动重试并记录日志，日志位于 %APPDATA%\Harness Hub\logs\main.log |

关注与交流｜Follow & Community

扫码关注作者公众号「回血氧」，获取版本更新、插件推荐与使用技巧的第一手信息：

生态｜Ecosystem & Related

- 上游项目：deepseek-ai/deepseek-harness — DeepSeek Harness: Everything is a Plugin.
- 插件精选列表：awesome-dsh-plugin
- 插件开发主题标签：dsh-plugin（GitHub topic）

开发｜Development

npm test             # 核心模块无界面自测（服务/端口/插件管理/市场）

代码结构：src/main（主进程：服务管理、插件管理、托盘、IPC）、renderer（渲染层 UI）、scripts（内置运行时下载、图标生成、自测）。

免责声明｜Disclaimer

Harness Hub 是社区维护的第三方封装项目，不是 DeepSeek 官方产品。上游 dsh 处于开发者预览阶段，接口可能发生破坏性变更。

许可证｜License

MIT