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 分叉和原生子智能体活动。
- 可重复的工作。 创建针对
项目和 harness 运行的一次性或周期性计划，并带有本地运行历史。

你可以看到的一些功能
这些是当前 artifact/E2E 套件中的代表性 UI 快照。

可读的活动历史，工具调用已分组。

交互式 MCP App 直接在一轮对话中渲染。

当工作需要更多空间时，将实时结果弹出显示。

主题、语言、密度和字体设置都是一等公民。

支持的 agent

Backchat 目前为以下 agent 提供注册表条目：

| Agent | ACP 条目 | 说明 |
| --- | --- | --- |
| Claude Code | claude-acp | 通过官方 ACP 适配器使用 Claude Code |
| Codex CLI | codex-acp | 通过 codex-acp 使用 Codex |
| DeepSeek Harness | dsh-acp 或 dsh --profile acp | 独立 ACP 服务器或 dsh profile 插件 |
| Gemini CLI | gemini | Gemini CLI 的 ACP 模式 |
| OpenCode | opencode | OpenCode 的 ACP 模式 |
| Hermes | hermes | Hermes ACP 条目 |
| OpenClaw | openclaw | OpenClaw ACP 条目 |

DeepSeek Harness 可以通过以下任一形式连接：

独立 ACP 服务器
npm install -g @openma/deepseek-harness-acp
dsh-acp login

或将其安装到现有的 dsh profile 中
dsh plugin --profile acp add -w @openma/deepseek-harness-acp

有关身份验证、profile、模型、权限和 MCP 配置，请参阅
openma-ai/deepseek-harness-acp。

Agent 二进制文件通过 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 提交；
无需同级检出或本地链接。OpenMA SDK 和守护进程连接快照位于 packages/ 下，
并带有其上游来源信息。

首次启动时，打开 Settings → Agents 以安装 Backchat 或将其指向
兼容 ACP 的 agent，然后选择一个项目并开始聊天。

构建和打包

bash
pnpm build          # 生产环境的渲染进程/主进程打包
pnpm package        # 当前操作系统未签名的本地安装包
pnpm package:dir    # 解包后的应用目录

签名发布打包与公证流程记录在
docs/releasing.md 中。

开发命令
bash
pnpm typecheck
pnpm test:ci        # 精选的契约 + 发布回归测试通道（GitHub Actions）
pnpm test
pnpm test:e2e:fast
pnpm test:verify    # 类型检查 + 完整单元测试 + 快速 E2E 通道

拉取请求会运行 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 agent 作为本地
子进程启动，并保持其真实配置和能力可见。
3. 在一个界面中工作。 对话事件、工具活动、MCP Apps、
文件、浏览器标签页和终端都被投射到同一个任务中。
4. 在有用时分支。 在侧边聊天中继续，在支持时
分叉 ACP 会话，或跟随 harness 发出的原生子代理活动。

状态

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

欢迎提交 issue 和有针对性的拉取请求。为了提供有用的 bug 报告，请包含
你的操作系统、Backchat 构建版本、agent/harness、项目类型，以及最小可靠
复现步骤。

了解更多

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