fellow99/deepseek-harness-workspace

| English

DeepSeek Harness 工作区

一个单仓库工作区，汇集了将 deepseek-harness 作为一流桌面应用发布所需的全部项目——在 Windows/Linux 上通过 Electron 外壳，在 HarmonyOS 上通过 "Electron-on-HarmonyOS" 运行时。所有仓库都以 git 子模块 的形式固定，因此工作区布局能够精确复现每个封装项目构建脚本所期望的同级目录结构（../deepseek-harness、../dsh-market、../harmonypc-electron）。

这是什么

DeepSeek Harness（dsh）是 DeepSeek AI 推出的开源智能体框架，基于“一切皆插件”的架构构建；其原生入口是 dsh web（一个浏览器 Web UI）。两个同级封装项目将该 Web UI 转变为原生桌面应用——完全复用 dsh 前端，并在进程内托管 dsh Host：

- deepseek-harness-desktop —— 面向 Windows / Linux 的 Electron 桌面外壳（macOS 后续支持）
- deepseek-harness-harmony —— 基于 Electron-on-HarmonyOS 运行时的 HarmonyOS 桌面移植版（2in1 / 平板，打包为 HAP）

两个封装项目使用相同的上游构建模块。本工作区就是将这些构建模块（作为子模块）并排放在一起的容器，使这两个封装项目能够在一处完成克隆、构建和开发——它们的 ../sibling 引用都能在工作区内正确解析。

仓库布局

deepseek-harness-workspace/            # 本仓库 —— 子模块容器
├── deepseek-harness-desktop/          # [子模块] Electron 桌面封装（Windows/Linux）
├── deepseek-harness-harmony/          # [子模块] HarmonyOS 桌面封装（2in1/平板，HAP）
├── deepseek-harness/                  # [子模块] dsh —— 被封装的智能体宿主（上游）
├── dsh-market/                        # [子模块] 可视化插件市场（npm 包 "dshmarket"）
├── harmonypc-electron/                # [子模块] Electron-on-HarmonyOS 运行时（Electron 37 / Node 22.17.0）
├── deepseek-harness-desktop-website/  # [子模块] 两个封装项目的网站
└── harmonypc-electron-versions/       # （普通目录，非子模块）运行时发布归档 + Electron 头文件指南

角色一览

| 目录 | 角色 | 使用者 |
|---|---|---|
| deepseek-harness-desktop | Electron 桌面外壳 —— 主要封装项目 | — |
| deepseek-harness-harmony | HarmonyOS 桌面移植版（以桌面版为基准） | — |
| deepseek-harness | 被封装的智能体宿主（dsh，上游源码参考） | 两个封装项目 |
| dsh-market | 内置可视化插件市场 | 两个封装项目 |
| harmonypc-electron | Electron-on-HarmonyOS 运行时（原生 SO + ArkTS 桥接） | 仅 harmony |
| deepseek-harness-desktop-website | 两个封装项目的产品网站 | — |
| harmonypc-electron-versions | HarmonyOS 上的 Electron 发布归档（v34/v37/v40）+ Node 头文件指南，用于重建 better-sqlite3 等原生模块 | harmony 工具链 |

当前版本

| 项目 | 版本 | dsh 版本 |
|---|---|---|
| deepseek-harness-desktop | 0.1.5 | dsh-v0.1.5-rc.2 |
| deepseek-harness-harmony | 0.1.5 | dsh-v0.1.5-rc.2 |
| deepseek-harness（子模块锁定） | — | dsh-v0.1.5-rc.2 |

两个封装层锁定同一个上游 dsh 标签，该标签会在各自项目的构建脚本中选择 patches/dsh-v0.1.5-rc.2/。
当任一封装层推进时，请同步更新此表以及两个产品的 README。

共享架构

dsh 已完成其 Host/Client 拆分，其 webserver 同时提供 SPA dist 和 /api。因此两个封装层都使用相同的 进程内 Host + webserver + 同源数据平面：

- 封装层的主进程动态导入 dsh 的 runProfile('desktop')，并在进程内托管 dsh Host（webserver + apiProxy + connection，全部绑定在同一端口上）。
- 就绪后，渲染进程对该 webserver 执行 loadURL(...)，运行标准、未经修改的 dsh Web UI，复用其现有的 WebApiClient（HTTP 上行 + WebSocket 下行）。
- 结果：零 CORS、零认证、零自定义协议、零新增 IPC 载体——零上游改动（仅幂等补丁）。

平台特定适配

| 方面 | 桌面端（Electron） | HarmonyOS（HarmonyOS 上的 Electron） |
|---|---|---|
| 目标平台 | Windows + Linux（macOS 后续支持） | HarmonyOS 2in1 / 平板（HAP） |
| Webserver 绑定 | 127.0.0.1: | 0.0.0.0: + 渲染进程通过局域网 IP 连接，并重写 Host/Origin（HarmonyOS NEXT 回环网络隔离） |
| dsh 补丁 | 2 个（禁用 HMR、禁用原生选择器） | 5 个（共享的 2 个 + symlink→cpSync 复制、允许所有接口、flock openharmony 桩） |
| MVP 能力 | 脚手架 + dsh 消费已完成；托盘 / 通知 / 原生标题栏 / 剪贴板图片粘贴（实时状态见 README） | 已在设备上验证——HarmonyOS 6.1.0.135（API 24）；Web UI 功能完整；会话持久化 + 插件市场已接入；终端 / 进程沙箱未接入（缺少 aarch64 产物） |

快速开始

git clone --recursive https://github.com/fellow99/deepseek-harness-workspace.git
cd deepseek-harness-workspace
git submodule update --init --recursive   # refresh all pinned submodules

工作区布局已满足每个封装层的同级前置条件（../deepseek-harness、../dsh-market、../harmonypc-electron）。构建和运行说明维护在每个封装层内部，可能与本概览有所出入：

- 桌面端：参见 deepseek-harness-desktop/README.md（npm run build:dsh 应用这 2 个补丁并构建 dsh + dsh-market，然后执行 npm start / npm run package）。
- HarmonyOS：参见 deepseek-harness-harmony/README.md（三阶段构建 collect-runtime → build-dsh → collect-dsh，然后通过 DevEco Studio / hvigor 进行 HAP 构建 + 签名）。

harmony 构建的第一阶段会从 ../harmonypc-electron 子模块复制运行时；harmonypc-electron-versions/ 存放独立的发布归档，以备你需要固定子模块之外的运行时版本。

子模块

所有条目均记录在 .gitmodules 中：

| 路径 | 远程仓库 |
|---|---|
| deepseek-harness-desktop | https://github.com/fellow99/deepseek-harness-desktop.git |
| deepseek-harness-harmony | https://github.com/fellow99/deepseek-harness-harmony.git |
| deepseek-harness | https://github.com/deepseek-ai/deepseek-harness.git |
| dsh-market | https://github.com/dsh-market/dsh-market.git |
| harmonypc-electron | https://atomgit.com/jianguoxu/harmonypc-electron.git |
| deepseek-harness-desktop-website | https://github.com/fellow99/deepseek-harness-desktop-website.git |

使用 git submodule update --remote 推进固定的提交（例如获取新的 dsh 版本），然后提交新的指针。

许可证

MIT © 2026 fellow99