Bridge 远程控制

Bridge 远程控制

Bridge 是基于 FastAPI 的 REST + WebSocket 远程控制服务，支持从浏览器或其他客户端实时操控 AuraCode。

启动 Bridge

# 默认配置
python cli.py --bridge


自定义端口和最大会话数

python cli.py --bridge --bridge-port 9000 --bridge-max-sessions 10


指定认证 Token

python cli.py --bridge --bridge-token my-secret-token
参数说明默认值
--bridge启用 Bridge 模式false
--bridge-port服务端口8765
--bridge-host绑定地址127.0.0.1
--bridge-max-sessions最大并行会话数5
--bridge-token认证 Token自动生成

REST API

会话管理

方法路径说明
POST/sessions创建新会话
GET/sessions列出所有会话
GET/sessions/{id}获取会话详情
DELETE/sessions/{id}关闭会话

消息与命令

方法路径说明
POST/sessions/{id}/message发送消息
POST/sessions/{id}/command执行命令

系统

方法路径说明
GET/health健康检查
GET/status系统状态

WebSocket 实时事件

连接 ws://host:port/ws?token=xxx 即可接收实时事件推送：

事件类型

事件说明
session_created新会话创建
tool_useAI 调用工具
tool_result工具执行结果
assistant_messageAI 回复消息
token_usageToken 消耗统计
error错误通知
session_complete会话任务完成

事件示例

{
  "type": "tool_use",
  "data": {
    "session_id": "abc123",
    "tool": "read_file",
    "input": {"path": "src/main.py", "start_line": 1, "end_line": 50}
  }
}

Web UI

内置 Web 控制面板（bridge/test_bridge.html），可直接在浏览器中操作：

http://localhost:8765/static/test_bridge.html

功能包括：

  • 会话列表与管理
  • 实时消息显示
  • 事件面板（工具调用、Token 消耗、错误通知）
  • 命令执行

Token 认证

Bridge 使用 Bearer Token 进行认证：

# REST 请求
curl -H "Authorization: Bearer your-token" http://localhost:8765/sessions


WebSocket 连接

ws://localhost:8765/ws?token=your-token

多会话并行

Bridge 支持同时运行多个独立会话，每个会话有自己的上下文和状态：

> /bridge sessions


Bridge 会话 (3 个活跃 / 最大 5):
  #1  session_abc  运行中  迭代 5/20  Token: 12,400
  #2  session_def  等待中  迭代 0/20  Token: 0
  #3  session_ghi  运行中  迭代 8/20  Token: 23,100

相关命令

命令说明
/bridgeBridge 管理入口
/bridge sessions查看活跃会话
/bridge statusBridge 服务状态