deepseek-harness-desktop

DeepSeek Harness Desktop

面向 DeepSeek Harness 用户的本地优先、插件友好、Cursor 式 AI coding workbench。

Unofficial community project · source preview · 不是 DeepSeek 官方 Desktop，也不代表官方背书。

English · 市场调研 · 路线图 · 架构 · AI Agent 开发指南

为什么需要 DHD

DeepSeek Harness 已经是一个强大的、可组合的 Agent runtime：模型负责推理，Harness 负责工具、技能、会话、权限、沙箱和工作区。DHD 不重写它，而是把它放进一个开发者可以每天使用的本地工作台：

打开仓库 → 选择上下文 → Agent 执行 → 审阅变更 → 运行测试 → 提交或回滚

我们希望 DHD 成为 Harness-native 的 Agent IDE control plane，而不是一个只能打开网页的 Electron 窗口：

• 保留 Harness 语义：Session、Trajectory、Skills、MCP、审批和工具仍由上游 Host 负责。
• Cursor 式工作流：文件树、Monaco 编辑器、终端、Git、搜索、命令面板和行内编辑同屏工作。
• 本地优先：项目、凭证和会话默认留在本机；外部 Host、远程访问和云服务必须显式选择。
• 可组合：以版本化 Desktop capability、Host adapter 和未来的 ACP/CLI adapter 对接不同 coding agent。
• 可恢复：进程、PTY、搜索、watcher、窗口和 Host 都有明确的 owner、取消和退出路径。

当前状态（请先读）

当前仓库是 0.1.0 source preview，不是已经完成签名/公证的安装包。

重要限制：

• Agent 面板的完整默认 surface 仍是带 token URL 的 <iframe>；workspace sync 后会尝试建立同一 Host/Session 的 native controls，但它不是已完成的原生 dsh-client 嵌入。
• “发送选区”在 native channel 可用时写入结构化 Session context；iframe/剪贴板仍是明确 fallback。
• Changes 面板仍是仓库级 Git diff；native change-projection 目前只显示 changed paths。
• defaultModel、defaultPreset 和 sandboxMode 的桌面设置不能自动等同于 Host effective settings。
• 打包配置现在有 target-specific Harness/Node/pnpm/rg closure staging 和 macOS arm64 post-pack resource check；安装后启动、正式签名/公证和跨平台发行证据仍未完成。runtime manifest 不完整时 packaged Host 会 fail closed，不会静默回退到系统 Node/npx。
• 外层仓库当前没有完整 unit/E2E 测试套件；pnpm test:contract 覆盖 capability、IPC/preload、Host IPC/Session fixture 和上游 Desktop 静态兼容门，typecheck 和 build 不等于真实 provider/model 验证。

完整、绑定版本的支持矩阵见 docs/support-matrix.md。

五分钟从源码运行

环境

• Node.js ^22.19.0 或 >=24
• pnpm 10.14.0（根 workspace 锁定版本；Harness 子模块使用自己的 pnpm 版本）
• Git submodule
• 已安装依赖的 Harness checkout

启动

git clone --recursive git@github.com:davidtan2008/deepseek-harness-desktop.git
cd deepseek-harness-desktop
pnpm install
cd harness && pnpm install && pnpm run build && cd ..
pnpm doctor:env
pnpm dev

如果 Electron 下载困难：

export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
pnpm install

打开一个项目后，右侧会显示 Harness Agent surface；左侧是工作台。Host 启动失败时，优先查看终端输出和 用户指南 的故障排查，而不是直接修改 harness/。

架构一览

flowchart LR
  User[用户] --> Main[Electron Main]
  Main -->|spawn / adopt| Host[DeepSeek Harness Host]
  Main -->|typed preload IPC| UI[React Workbench]
  UI --> Editor[Monaco + Explorer + Search]
  UI --> Terminal[xterm + PTY]
  UI --> Git[Git panel]
  UI --> Agent[Agent iframe\nHarness Web UI]
  Host --> Session[Session / Tools / Skills / MCP / Sandbox]
  Main --> AgentRuntime[Native Session transport]
  AgentRuntime --> Host
  Main --> Platform[FS / watcher / credentials / updater]

当前关键边界：

• Main 不执行 Agent 工具，不直接写 Session log，不在 Electron Main 挂载 Cordis；native runtime 只通过 Host Remote API 发送 prompt/读取 events。
• Renderer 无 Node 集成，只通过 packages/shared/src/api.ts 的白名单 API。
• Host 解析顺序是 DHD_HARNESS_ROOT → 仓库 harness/ → 兼容旧目录 → 打包资源；也可用 DHD_HARNESS_URL 采用外部 Host。
• 详细的启动、workspace sync、PTY、watcher、退出和目标 transport 见 docs/architecture.md。

功能状态

文档导航

给插件作者和 Agent 开发者

DHD 的长期方向是公开、版本化、可替换的 capability contract，而不是让插件猜 Electron 私有对象：

• packages/shared/src/protocol.ts：IPC channel 和事件真源。
• packages/shared/src/api.ts：Renderer 可见 API 真源。
• packages/shared/src/capabilities.ts：能力发现 manifest。
• docs/adr/：进程边界、transport 和 capability negotiation 决策。

当前还没有承诺稳定的第三方 Desktop extension API。请先阅读 AI Agent 开发指南 和 Harness 插件开发文档。

常用环境变量

贡献前检查

pnpm docs:check
pnpm upstream:check
pnpm typecheck
pnpm test:contract
pnpm build
git diff --check

发行前额外运行 runtime staging、closure smoke 和 fail-closed gate（签名、公证及跨平台安装证据仍未完成）：

pnpm runtime:prepare
pnpm smoke:runtime-closure
pnpm smoke:packaged-host
pnpm release:check

涉及 Host、PTY、搜索、窗口、打包或多 Agent 的改动，还需要对应的真实流程验证；请在 PR 中写明实际执行的命令和未覆盖的平台。Harness gitlink、锁文件和版本号应由单独、可回滚的提交更新。

与上游的关系

• 上游项目：deepseek-ai/deepseek-harness
• 产品哲学：Everything is a plugin
• Cordis / 论文：arXiv:2608.25512
• 上游当前已包含自己的 Desktop 源码实现；DHD 是独立社区项目，不替代官方实现。

License

DHD 使用 MIT。上游 Harness、Electron、Monaco、xterm、node-pty 和其它依赖遵循各自许可证；发布前必须生成完整的第三方 notices 和 runtime manifest。