跳到正文

基于 ACP 协议的远程 Agent 控制台

 Agent

手机、平板、另一台电脑的浏览器里,继续本机正在跑的会话。Agent 仍然在你自己的机器上读文件、跑命令;浏览器只负责掌控。

一个进程、一个端口,同时提供 Web 界面和接口。

α² Cap β Cap θ Cap ι Cap ζ Cap δ Cap γ Cap ω Cap CAPRICORNUS · 8 ★

三个组件

总览:一个进程、一个端口,同时提供 Web 界面和接口。

:5173

浏览器控制台

Capri FE

React 19 · TypeScript · Vite · Tailwind

对齐终端界面常用能力的 Web 前端:斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆。左上角随手切换机器。

  • 会话续传,不重放全量历史
  • 权限审批与作用域记忆
  • 图片、后台任务、子代理视图
  • 密钥只存在这台浏览器里
:8765

Agent 节点

Capri Host

Go 1.26 · ACP · stdio JSON-RPC

跑在有 Agent 的那台机器上,自动拉起内核,并把 Web 界面一起端出来。不用 nginx,不用另起静态服务器。

  • 单进程内嵌前端构建产物
  • 本机直连或中继两种模式
  • 无人订阅时暂停上报省流量
  • 配对 token 落盘,重启免配对
:8787

中继节点

Capri Hub

Go 1.26 · QUIC · WebSocket

汇集你所有的节点:家里的、办公室的、服务器上的。它不执行任何命令,只做配对、发现和转发。

  • QUIC 主通道,挡了自动回退
  • 六位配对码,十五分钟有效
  • 浏览器门禁与 CORS 收口
  • 只在一台机器上用时不必部署

能力

八颗星,八件事

上面星图里的每一颗都对应下面一格。点星点会跳过来。

01α² Cap

换个屏幕,接着说

在手机、平板、另一台电脑的浏览器里,继续本机正在跑的会话。恢复会话不重放全量历史,打开就能接上。

02β Cap

多台机器,一个入口

左上角切换节点:家里的、办公室的、服务器上的。每台机器一个标识,中继负责找到它。

03θ Cap

该有的都有

斜杠命令、权限审批、图片、后台任务、Git / MCP / 记忆——对齐终端界面的常用能力。

04ι Cap

代码不出你的机器

Agent 在节点那台机器上自己读文件、跑命令。浏览器只发指令、看结果。中继不执行任何命令。

05ζ Cap

一个进程,一个端口

节点二进制里嵌着前端构建产物,打开根路径就是界面,同端口提供接口。不用 nginx。

06δ Cap

先 QUIC,挡了就退

节点到中继默认走 QUIC;UDP 被挡时自动回退 WebSocket,功能不受影响。域名经代理丢 UDP 时可强制拨号地址。

07γ Cap

配一次,之后就忘了它

中继启动打印六位配对码,十五分钟有效。配对成功后 token 写在那台机器上,重启只需要中继地址。

08ω Cap

没人看的时候安静

中继模式下没有浏览器订阅时,节点暂停实时上报以省流量;打开页面自动恢复。

架构

一次请求要走的路

浏览器任何设备

只负责掌控:发指令、看结果、审批权限。门禁密钥存在本地,不进构建产物。

中继HTTP 8787

配对、发现、转发三件事。不执行命令,不落业务数据。可选,单机场景省掉。

主通道QUIC UDP 8788

节点与中继之间的长连接。UDP 被安全组挡住时自动回退 WebSocket。

节点HTTP 8765

你的机器。拉起内核、内嵌界面、代理接口,同一个端口全都给了。

内核stdio JSON-RPC

以标准输入输出跑的 Agent 进程,按 ACP 协议交换会话事件、工具调用与权限请求。

只在一台机器上用?不必起中继,直接跑节点即可。

0组件
0端口起步
0位配对码
0分钟有效
0命令在中继执行

快速开始

五分钟跑起来

本机:一条命令
chmod +x ./capri-host
./capri-host
# 浏览器打开 http://localhost:8765
从 Releases 下载对应平台的二进制即可。
从源码跑
go run ./cmd/capri-host
需要 Go 1.26 以上。
起中继
FE_TOKEN=$(openssl rand -hex 24) go run ./cmd/capri-hub
启动日志里有六位配对码。生产务必设门禁密钥。
把节点接进来
HUB_URL=http://your-relay:8787 \
HUB_PAIR_CODE=XXXXXX \
HOST_ID=macbook HOST_NAME="办公室 Mac" \
  ./capri-host
每台机器给一个不同的标识。