li363920783/deepseek-harness-ui

DeepSeek Harness 桌面客户端

一个开箱即用的桌面应用，把 DeepSeek Harness（dsh）智能体框架装进一个窗口——不用敲命令行，双击即用。

桌面端图标

这是什么

DeepSeek Harness 是 DeepSeek 开源的 agent harness（智能体框架），一切皆插件，自带强大的 Web UI，但原生只有 CLI 启动方式。本项目在它之上开发了：

| 客户端 | 状态 | 说明 |
|---|---|---|
| 桌面端（apps/desktop） | ✅ 可用 | Electron 应用，内嵌 dsh 运行时，零配置启动 |
| 移动端（apps/mobile） | 🚧 待开发 | React Native 远程客户端，协议验证已通过，App 开发中 |

桌面端特性

- 一键启动：自动启动内嵌的 dsh 运行时并打开 Web UI，无需手动执行命令
- 零 UI 重写：直接复用上游 React Web UI，功能与上游完全同步
- 托盘常驻：关闭窗口应用不退出，常驻系统托盘随叫随到
- 优雅退出：Quit 时按上游规范停止运行时（SIGTERM + 5 秒 drain），不丢状态
- 跨平台打包：macOS dmg / Windows exe / Linux AppImage（electron-builder 已配置）

快速开始

环境要求

- Node.js：^22.19.0 || >=24.0.0
- pnpm：11.7.0（仓库已用 corepack 锁定，corepack enable 即可）

三步跑起来

1. 克隆并安装
git clone https://github.com/li363920783/deepseek-harness-ui.git
cd deepseek-harness-ui
corepack enable && pnpm install

2. 构建运行时产物（首次必需）
pnpm run build

3. 启动桌面端
pnpm --filter @deepseek-ai/dsh-desktop run start

稍等片刻（首次冷启动较慢），桌面窗口会自动打开 Web UI。

国内网络提示：Electron 二进制下载慢时设置
ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" 重装；
个别依赖在镜像源失败时临时加 --registry=https://registry.npmjs.org。

运行方式

日常使用

pnpm --filter @deepseek-ai/dsh-desktop run start

- 桌面壳自动挑选空闲端口启动运行时，绑定回环地址（仅本机可访问）
- 关闭主窗口 → 隐藏到托盘；托盘菜单 Show 恢复、Quit 退出
- 已有一个在跑的 dsh web 服务？设置 DSH_DESKTOP_URL=http://127.0.0.1:3080 让桌面壳直接接管

验证与打包

pnpm --filter @deepseek-ai/dsh-desktop run smoke      # 冒烟测试：启动→探测 SPA 与 RPC→优雅停止
pnpm --filter @deepseek-ai/dsh-desktop run dist:mac   # macOS：dmg（当前机器架构）
pnpm --filter @deepseek-ai/dsh-desktop run dist:win   # Windows：NSIS 安装包 exe
pnpm --filter @deepseek-ai/dsh-desktop run dist:linux # Linux：AppImage

打包前会先用 export-runtime 通过 pnpm deploy 导出一份自包含的 dsh 运行时
（约 330 MB），由 afterPack 钩子原样嵌入 resources/dsh-runtime；
安装包产物在 apps/desktop/release/，装好后完全独立运行，不依赖源码检出。
在 macOS 上交叉打包 Windows/Linux 时 electron-builder 会自动下载对应工具链
（国内网络可设置 ELECTRON_MIRROR / ELECTRON_BUILDER_BINARIES_MIRROR 指向镜像站）。

环境变量

| 变量 | 作用 |
|---|---|
| DSH_DESKTOP_URL | 接管已运行的 dsh web 服务，不再自启运行时 |
| DSH_DESKTOP_NODE | 指定启动运行时用的 Node 可执行文件（默认从 PATH 解析） |

🚧 移动端（待开发）

移动端定位为 React Native 远程客户端：连接桌面端或服务器上运行的 dsh 服务，手机上远程监控与审批。

当前进度：

- ✅ 协议连通性验证通过——非浏览器载体（fetch + WebSocket）可完整驱动 /api RPC 与事件流（见 apps/mobile/spikes/protocol-probe.mjs）
- 🚧 Expo 工程脚手架、会话监控界面：开发中
- 🔜 配对认证、审批推送：规划中

在移动端 App 完成前，手机可在同一局域网用浏览器直连：

pnpm dsh web --host 0.0.0.0 --trusted-host 你的局域网IP
手机浏览器访问 http://你的局域网IP:3080

路线图

| 里程碑 | 内容 | 状态 |
|---|---|---|
| M1 | Electron 桌面壳：运行时监管、托盘常驻、优雅退出、打包配置 | ✅ 已完成 |
| M2 | 移动端：Expo 脚手架、会话列表与执行轨迹只读监控 | 🚧 进行中 |
| M3 | 配对/token 认证、移动端审批（approve/deny）、推送通知 | 🔜 规划 |
| M4 | 桌面端原生增强（审批通知、全局快捷键）+ 移动端体验打磨 | 🔜 规划 |

致谢与上游
本项目基于 DeepSeek 开源的 deepseek-harness。上游原始文档见 UPSTREAM.md（英文）与 UPSTREAM.zh.md（中文），上游功能文档见 docs/。

上游处于开发者预览阶段，迭代快且有破坏性变更风险；本客户端通过版本锁定 + 定期同步策略跟进。

许可

MIT