多智能体桌面 openma-ai/backchat

Backchat

面向 Agent Client Protocol（ACP）的桌面端，多智能体协作，统一管理 harness、工具与输出。

访问官网 →

新功能：通过 dsh-plugin 和 dsh-acp 支持 DeepSeek Harness。
沿用你现有的 dsh 配置档，或从同一个桌面端启动独立的 ACP 服务器。

Backchat 给开发者智能体一张共享桌面，同时不剥夺每个 harness 各自的优势。把多个智能体拉进同一段对话，内置浏览器、文件、终端、MCP Apps 和 Codex 插件都触手可及。

为什么选 Backchat

- 一个工作区，多个智能体。 Claude Code、Codex CLI、DeepSeek Harness、Gemini CLI、OpenCode、Hermes、OpenClaw 都能在同一个桌面界面里跑。
- 懂智能体，不套模板。 Backchat 直接呈现当前 harness 上报的能力、命令、模型、模式和权限，不另造一层通用能力抽象。
- 上下文按项目隔离。 会话按工作目录分组，文件、终端、浏览器状态和对话都留在工作发生的那个项目里。
- 项目可以跨多个相关文件夹。 主文件夹提供聊天 cwd、Git 上下文和项目指令；次级文件夹通过 ACP additionalDirectories 扩展智能体的文件范围。
- 内置工具不打断思路。 浏览网页、查看文件、开终端、贴图片，全程不用离开对话。
- 原生扩展与应用。 在对话轮次里直接渲染可交互的 MCP Apps，Codex 插件照常使用，不会被压成通用文本输出。
- 多智能体对话。 把多个 harness 拉进同一段聊天，也可以用侧边聊天、ACP fork，以及原生子代理活动（如果支持）。
- 可重复的工作。 创建一次性或周期性计划，针对某个项目和 harness 运行，并保留本地运行历史。

你能看到的几样东西

这些截图来自 E2E 测试套件（e2e/readme-screenshots.spec.ts）。

每轮对话把工作折叠成一行可读的活动记录。

浅色与深色主题，文件预览带语法高亮。

工作需要更多空间时，把实时结果弹出来看。

交互式 MCP App 直接渲染在对话轮次里。

支持的智能体

Backchat 目前内置以下注册表条目：

| 智能体 | ACP 条目 | 说明 |
| Claude Code | claude-acp | 通过官方 ACP 适配器接入 Claude Code |
| Codex CLI | codex-acp | 通过 codex-acp 接入 Codex |
| Pi | openma-acp-pi-acp | 通过 @openma/pi-acp 接入 Pi |
| DeepSeek Harness | dsh-acp 或 dsh --profile acp | 独立 ACP 服务器，或 dsh 配置档插件 |
| Gemini CLI | gemini | Gemini CLI 的 ACP 模式 |
| OpenCode | opencode | OpenCode 的 ACP 模式 |
| Hermes | hermes | Hermes ACP 条目 |
| OpenClaw | openclaw | OpenClaw ACP 条目 |

DeepSeek Harness 两种形式都能接入：

Standalone ACP server
npm install -g @openma/deepseek-harness-acp
dsh-acp login

Or install it into an existing dsh profile
dsh plugin --profile acp add -w @openma/deepseek-harness-acp

认证、配置档、模型、权限和 MCP 配置，见 openma-ai/deepseek-harness-acp。

智能体二进制文件在 Settings → Agents 中发现或配置。注册表和安装层刻意与聊天 UI 分开，因此新增或更新 harness 不需要改动对话模型。

快速开始

从源码运行

要求：Node.js 24 和 pnpm 11.24.0（与 CI 一致）。

git clone https://github.com/openma-ai/backchat.git
cd backchat
pnpm install --frozen-lockfile
pnpm dev

共享依赖 @openma/common 锁定在不可变的 Git 标签 v0.7.3 上，不需要同级仓库检出或本地链接。OpenMA SDK 和守护进程连接快照放在 packages/ 下，并保留上游来源信息。

首次启动时，打开 Settings → Agents，安装 Backchat 或把它指向一个兼容 ACP 的智能体，然后选一个项目，开始聊天。

构建与打包

pnpm build # production renderer/main bundles
pnpm package # unsigned local installer for the current OS
pnpm package:dir # unpacked app directory

签名发布打包与公证的流程见 docs/releasing.md。

开发命令

pnpm typecheck
pnpm test:ci # curated contract + release-regression lane (GitHub Actions)
pnpm test
pnpm test:e2e:fast
pnpm test:verify # typecheck + full unit tests + fast E2E lane

拉取请求会跑 test:ci 和 test:e2e:fast。推送到 main 还会构建未签名的 macOS DMG，然后检查打包后的应用能否导入自己的运行时，并完成第一次提示词交互。网站上的下载按钮始终指向 https://github.com/openma-ai/backchat/releases/latest/download/Backchat-arm64.dmg ；打标签的发布会把同一个稳定文件名和带版本号的 DMG 一起上传。这些检查之外，还会跑 GitHub 官方的 Dependency Review、CodeQL，以及针对 Actions 的 Dependabot。

桌面外壳用 Electron、TypeScript、React、Vite、Tailwind CSS 和 shadcn/ui 构建。ACP 运行时取自 open-managed-agents，并针对本地桌面场景做了裁剪。

各部分如何协作

1. 选一个项目。 项目就是一个工作目录，也是会话和本地产物的锚点。
2. 选一个 harness。 Backchat 把选中的 ACP 智能体作为本地子进程启动，并让它真实的配置和能力保持可见。
3. 在一个界面里工作。 对话事件、工具活动、MCP Apps、文件、浏览器标签页和终端都投射到同一个任务里。
4. 需要时开分支。 在侧边聊天里继续，在支持时 fork 一个 ACP 会话，或者跟随 harness 发出的原生子代理活动。

状态

Backchat 处于预发布阶段，正在积极开发中。产品形态、打包方式、持久化格式和 ACP 集成接口在稳定版发布前都可能变化。它目前适合本地评估和开发，还不承诺向后兼容。

欢迎提 issue 和聚焦的拉取请求。想写出有用的 bug 报告，请附上你的操作系统、Backchat 构建版本、智能体/harness、项目类型，以及最小可靠复现步骤。

了解更多

- Agent Client Protocol
- ACP 会话与子代理模型
- Codex / ChatGPT 插件兼容性
- 文件优先存储 RFC
- 发布与签名指南