open-chat 通过原生 ACP(Agent Client Protocol) 与 acp-hub,将你本机安装的 Claude Code、Codex、pi、omp 以及任意自定义 ACP Agent 统一收进一个轻量、克制的桌面工作台。支持以独立桌面窗口运行,也支持一行命令启动为内网/本机 Web 服务。
- 多 Agent 统一入口:通过 ACP 协议直连 Claude Code、Codex、pi、omp 或自定义命令行 Agent,一个窗口管理所有会话与工作目录。
- 一等公民权限审批与计划视图:工具调用权限请求直接浮在消息流内(允许在右、拒绝在左,降低误触),支持推理过程折叠、代码 Diff 预览与执行计划卡片。
- 可靠的会话持久化与续接:会话记录按对话落盘到本地
index.json与conversations/,重开走session/load恢复上下文;无法续接时明确提示,不静默丢状态。 - 零环境折腾的单文件打包:Go 宿主内嵌单文件打包的 Node sidecar 与前端构建产物,桌面端启动自动读取登录 Shell 环境变量,从 Dock 启动也能找到
node/claude/codex。 - 桌面 / 网页双模式共享同一套 UI:同一份二进制既可作为原生桌面应用运行,也可通过
open-chat serve提供 HTTP + SSE 远程访问。
┌──────────────────────────────────────────────────────────┐
│ Go 宿主(mygo) │
│ · 会话与记录落盘(index.json + conversations/<id>.json) │
│ · 登录 shell 环境探测(PATH / API key) │
│ · mygo.Bind 的 Host API ⇄ 页面;serve 模式下换 HTTP+SSE │
│ · 管理下面这个 Node 进程 │
│ │ NDJSON over stdio │
│ ▼ │
│ sidecar(Node,打包成单文件,嵌在二进制里) │
│ · @cc-heart/acp-hub-core 负责 ACP 握手/事件翻译/权限桥接 │
│ · 每个 agent 一个子进程,多个对话共享同一个连接 │
│ │ ACP over stdio │
│ ▼ │
│ Claude Code / Codex / pi / omp / 任意自定义 ACP agent │
└──────────────────────────────────────────────────────────┘
Go 负责桌面该管的事(窗口、目录、对话框、持久化、环境变量),Node 负责 ACP——因为 acp-hub 是 TypeScript 库,而 agent 生态(npx codex-acp 之类)本来就在 Node 里。sidecar 编译成单个 .mjs 用 go:embed 打进二进制,运行时只在缓存目录里落一个文件,用户不需要 pnpm install。
宿主和 sidecar 之间只有一种协议:NDJSON。
pnpm install
pnpm build:sidecar # 打包 sidecar 到 internal/sidecar/dist
pnpm dev # mygo dev:窗口 + vite(端口 5173)
# 只想在浏览器里调 UI:
pnpm dev:web # 另开一个终端:open-chat serve -no-auth没有装任何 agent 也能跑:开发构建默认带一个内置的 Demo Agent(思考、计划、工具调用、diff、权限请求、流式 markdown 全套),生产构建用 OPEN_CHAT_DEMO=1 打开。
pnpm build # mygo build:build/<os>-<arch>/ 下的安装包
go test ./... # 宿主流程(真的起 node + sidecar + demo agent,跑完一轮)同一套 UI 也能不开窗口用:
open-chat serve # 127.0.0.1:4310,打印带 token 的地址
open-chat serve -addr 0.0.0.0:4310 -token xxx
open-chat serve -no-auth # 只在内网/本机HTTP 模式把 Host 的每个方法映射成 POST /api/call/<Method>(body 是参数数组),推送走 GET /api/push 的 SSE。没有 IPC,所以页面代码不用分叉——web/src/api.ts 里 isMyGo() 一处分流。
桌面构建内置 mygo updater:启动约 10 秒后检查一次,此后每天一次;有新版本时弹出更新窗口(发布说明 / 安装 / 稍后 / 跳过),下载完成后校验 Ed25519 签名再原地替换,重启即进入新版本。macOS 的菜单栏有「Check for Updates…」,设置 → 偏好里有「检查更新」。
更新只会在用更新密钥签过名的发布构建里生效:开发构建、open-chat serve、以及包管理器安装的版本不会自动替换自己。
和 Beacon / Gloss 一样:公钥提交在配置里,私钥放进 GitHub 仓库的 Actions secrets(Settings → Secrets and variables → Actions)。本仓库已经生成好一对专用密钥,公钥在 mygo.config.ts 的 updates.publicKey,只差设置私钥:
gh secret set MYGO_UPDATER_PRIVATE_KEY --repo CarlOpenLab/open-chat < \
"$HOME/Library/Application Support/mygo/open-chat-update-keys/mygo-update.key"私钥只放在本地密码管理器和仓库 secret 里,不要提交进仓库。以后换密钥时用 mygo keygen -o <独立目录> 重新生成(默认目录 mygo/update-keys 可能已有其他应用的密钥,-force 会覆盖它们),把新的 .pub 内容写进 updates.publicKey,再更新 secret。本地想做可更新的发布构建时:
MYGO_UPDATER_PRIVATE_KEY="$(cat "$HOME/Library/Application Support/mygo/open-chat-update-keys/mygo-update.key")" pnpm buildGloss 用的是 Apple Development 身份,证书同样放在仓库 secrets 里。它不会让未公证的 App 绕过 Gatekeeper,但让代码签名跨版本稳定,macOS 的「文件与文件夹」授权在自动更新后不用重新给。在 Keychain Access → 我的证书里把 Apple Development: … 导出为 .p12(只导出这一个身份),然后:
base64 -i /path/to/apple-development.p12 | \
gh secret set MACOS_CERTIFICATE --repo CarlOpenLab/open-chat
gh secret set MACOS_CERTIFICATE_PASSWORD --repo CarlOpenLab/open-chatGitHub 的 secret 只能写不能读,所以没法从 Gloss 仓库复制,得用同一个 .p12 给本仓库重新设置一次。没设置时 CI 会警告并回退到 ad-hoc 签名,Release 照常发布。
-
改
package.json的version(mygo.config.ts直接读它),在CHANGELOG.md写## X.Y.Z段落,提交。 -
打标签并推送:
git tag v0.0.3 git push origin v0.0.3
.github/workflows/release.yml 随后会:
- 校验标签与
package.json版本一致,跑pnpm typecheck与go test ./...; - 建一个 draft Release(发布说明取 CHANGELOG 的对应段落);
- 在 macOS / Windows / Linux runner 上执行
mygo build -upload,把 dmg、Windows setup exe、deb / rpm / tar.gz,以及签名更新包、增量包和update-<target>.json上传到该 Release; - 全部成功后把 Release 发布为 latest —— 已安装的应用从此刻起就能检查到新版本。
| 路径 | 内容 |
|---|---|
main.go |
入口:open-chat(桌面窗口)/ open-chat serve |
internal/host/ |
会话、落盘、sidecar 进程管理、Host API、HTTP 服务 |
sidecar/src/main.ts |
acp-hub 宿主:open / prompt / cancel / permission / setMode / setConfig |
sidecar/src/demo-agent.ts |
内置演示 agent(一个完整的 ACP agent 实现) |
web/src/ |
Vue 前端(antdv-next + @antdv-next/x) |
internal/webdist/ |
go:embed 的前端产物 |
- 一个对话 = 一个 ACP session;关掉重开走
session/load续上下文,续不上会给一条提示而不是假装成功。 - 权限请求做成一等公民:卡片浮在消息流里,拒绝比允许难按错(允许在右、拒绝在左)。
- 停止按钮 =
session/cancel;90 秒没有任何事件会提示「可能卡住了」。 - 斜杠命令来自 agent 的
available_commands_update,输入/直接出列表。 - 图片可以粘贴/选择后作为
image内容块发给 agent(需要 agent 声明promptCapabilities.image)。
~/.config/open-chat/settings.json:主题、发送键、自动批准、默认 agent、最近目录、node 路径、agent 覆盖(命令/参数/环境变量)、自定义 agent。UI 里的「设置」改的就是它。
数据(会话与记录)在同一目录下的 index.json 与 conversations/。
- macOS:
TitleBarHiddenInset+ 红绿灯内缩,页面左上留白给红绿灯,其余自绘。 - Windows / Linux:隐藏系统按钮,页面右上自绘最小化/最大化/关闭(
HideWindowButtons)。 - 桌面端启动时向登录 shell 要一次环境变量,所以 Homebrew / mise / nvm 里的
node、claude、codex都能被找到——从 Dock 启动也不会找不到命令。
MIT © 2026 CarlOpenLab


{"id":1,"method":"open","params":{"key":"…","agent":{…},"cwd":"…"}} {"id":1,"result":{…}} {"method":"events","params":{"key":"…","events":[…]}} // 无 id 即通知