Agent 消息路由网关vb2250158/RabiRoute

RabiRoute

RabiRoute 吉祥物展示消息入口、基于规则的路由、Agent 处理和受控回复

让 Agent 连接我们周围的一切。

将聊天、语音、定时和设备消息发送给正确的 Agent，同时让上下文、权限和投递凭证保持明确。

RabiRoute 是一个 Agent 中立的消网关、投递策略路由器和操作闸门。它接收 QQ、webhook、定时、语音、桌面和设备消息，然后使用消息 Route 将每条消息投递给选定的 Agent 或程序。

Agent 负责回答、编写代码、调用工具并执行任务。RabiRoute 决定消息来自哪里、由谁接收、哪些近期消息随之传递、是否允许外部回复，以及结果和凭证存储在哪里。

快速开始 · 当前能力 · 近期变更 · 工作原理 · 文档

你可以构建什么

- 将聊天路由到 Agent。 QQ 群、私聊、persona 面板和其他输入可以通过一个 Route 进入固定的项目和 Desktop 任务。
- 运行定时 Agent 工作。 Persona 规则可以按间隔、时间窗口、每日时间或一次性计划触发 Agent，或运行明确允许的本地脚本。
- 携带连续上下文。 每个 persona 拥有自己的消息历史以及对计划、记忆和技能的引用；每个 Route 都可以限制投递中包含的近期消息。
- 控制外部发送。 Agent 通过一个发送 API 回复 QQ、RabiLink 和其他渠道。目标、引用消息、发送者身份和凭证都会被验证并记录。
- 发送 Windows 文本和图像。 RabiRoute Desktop 支持选中文本操作、系统截图、标注、复制、固定，以及投递到活跃 persona。
- 连接语音与移动设备。 RabiSpeech、RabiLink 手机和眼镜客户端、可穿戴输入以及远程 Relay 均作为实验性集成实现。

快速开始

Windows 安装程序

从 GitHub Releases 下载 RabiRoute--windows-x64-setup.exe。该软件包包含 RabiRoute Host、Desktop 界面、本地 Manager、RibiWebGUI、Node.js 以及生产依赖项。在 Windows 上，Host 是唯一的应用程序生命周期所有者：它创建一个应用程序代际，并将 Manager 和 Desktop 保持在同一代际中。

同时还会发布便携式 ZIP 和 SHA256SUMS.txt。该 ZIP 使用 RabiRouteHost.exe + current.json + versions/ 布局，并且只能解压到一个新的空目录中；对于所有现有安装，请使用 Setup。Setup 内嵌该确切的 ZIP，将其暂存到安装卷上，验证每个清单哈希和大小，以及私有路径、重解析点和 Host 自检门禁，然后发出一个代际隔离的退出。只有有效的候选版本才能原子替换 current.json 和引导程序；失败时会恢复先前的指针和引导程序。被确切识别的已退役生命周期条目会移入安装程序拥有的、不可执行的隔离名称中，名称以 .retired 结尾；回滚或断电恢复会将它们原位恢复，而外来文件和类似后缀的文件永远不会被移动。卸载不会覆盖或删除 data/、logs/ 和外来文件。Windows 软件包目前未签名，因此在接受 SmartScreen 未知发布者警告之前，请验证校验和。

从源代码运行

需要 Node.js 20 或更高版本以及 npm。

git clone https://github.com/vb2250158/RabiRoute.git
cd RabiRoute
npm install
npm run build
npm run start:manager

Manager 在启动后会打印其实际的环回 URL；操作系统会分配一个未使用的端口。源代码模式用户打开打印出的 URL。打包版 Windows 用户启动 RabiRoute Host，并让 Host 状态或托盘打开当前 URL；产品契约中不包含固定的 localhost 端口。当不存在本地运行时数据时，Manager 会根据 examples/data/ 创建一个经过清理的示例配置。

完成第一条 Route

1. 打开 Quick setup 并选择 Scheduled trigger。
2. 选择 Codex Agent，然后绑定一个项目目录和一个现有的 Codex/ChatGPT Desktop 任务。
3. 保存该 Route，并从 Log diagnostics 运行一次手动触发。
4. 确认触发成功，并且同一个 Desktop 任务收到一条 RabiRoute 消息。

手动触发会执行真实投递。完整流程和故障检查请参见 完成第一条 Route。

当前能力
仓库版本为 0.2.3。下表列出了由当前代码、配置界面和测试所支撑的行为。需要账户、外部服务或物理设备的功能仍须在其目标环境中完成验收。

| 领域 | 状态 | 提供的能力 |
| --- | --- | --- |
| 路由核心 | 已验证 | 接收消息、持久化事件、匹配规则、构建 Agent 上下文、交付给处理器，并记录回复。 |
| NapCat / OneBot | 已验证 | 为每个 Route 绑定一个 NapCat，在 Route 卡片内管理快速/密码/二维码登录及安全确认，接收 QQ 群/私聊消息，保留媒体证据，并通过 OneBot HTTP 发送回复。 |
| 计划任务与人格自动化 | 已验证 | 通过消息或时间规则触发 Agent；仅在单独启用权限后运行人格本地脚本。 |
| Codex Desktop | 已验证 | 按完整任务 ID 和工作区交付；仅当目标 rollout 记录到 deliveryId 后才报告成功。已删除或已归档的绑定可在受控规则下替换。 |
| RibiWebGUI | 已验证 | 管理 Route、人格、消息输入、Agent、计划、记忆、日志、诊断、主题和桌面设置。 |
| 计划、记忆与消息处理 | 已验证 | 分页浏览计划和记忆，提交计划反馈，分配消息处理工作，并保留状态和回执。 |
| Windows 桌面 | 核心路径已实现 | Host 拥有一个包含 Manager 和托盘/任务窗口界面的应用代际；使用选中文本操作、截图和标注。部分系统交互仍需 Windows 设备验收。 |
| DSH | 实验性 | 将显式 API 地址、工作区和会话绑定为主处理器或辅助处理器。 |
| RabiSpeech / RabiLink / 移动端与可穿戴设备 | 实验性 | 连接语音、手机、眼镜、Relay 和健康数据路径，并针对每台设备和网络环境单独验收。 |
| 局域网 Rabi Agent | 实验性 | 在另一台计算机上运行无头 worker，并将 Manager 任务交付给该机器上配置的 Codex Desktop 所有者。真实多计算机验收仍待完成。 |

完整状态、限制和事实来源参见当前能力与成熟度。

近期变更

0.2.3：持久化 Manager 状态与客户端恢复

- 计划、记忆、反馈和路由目录的变更现在使用修订检查、稳定的幂等键、代际围栏、worker 所有权和可恢复回执，而非直接由父进程写入。
- 计划启动恢复会在退役旧文件之前发布完整的规范包。存储租约和持久交付所有权在长时间工作期间保持有效，并在所有权变更时故障关闭。
- RibiWebGUI、Windows 托盘、Android SDK、RabiLink AIUI 和小米家庭设置现在保留显式修订，并能从 Manager 代际或端点变更中恢复，而不会静默重放变更。
- 角色同步将清单和包检查移出 Manager 请求路径，保留规范的计划包身份，并拒绝过期或冲突的证据。
- Windows 开发者候选、事务性安装/应用脚本、Host 隔离和发布清单现在共享相同的本地运行时所有权规则；源代码与已安装状态保持分离。

0.2.2：单一 Windows 生命周期与插件运行时 v2

- RabiRoute Host 成为唯一的 Windows 应用程序所有者。Manager 和托盘作为同代子进程运行在操作系统分配的端口上，并通过经过身份验证的 Host 状态以及 /meta 身份进行发现。
- Manager 插件迁移到 schema/profile v2，具有显式执行模式、就绪依赖、代际替换、进程租约和不可变 Web Bundle 修订。
- Codex Desktop 交付获得了记录的 deliveryId 确认、受控任务替换和侧边栏索引显示名称；RibiWebGUI 获得了有界首屏读取和可恢复的目录加载。
- 桌面宠物、YeYu Gamer、可穿戴设备、小米家庭、移动语音和局域网 Agent 集成被移至显式的插件、设备和验收边界之后。

有关各项更改和迁移说明，请参阅版本更新日志。

工作原理

flowchart LR
A[Chat · schedules · voice · devices] --> B[Message input]
B --> C[Event record]
C --> D[Route rules]
D --> E[Context and attachments]
E --> F[Agent or program]
F --> G[Delivery policy and action gate]
G --> H[Reply · receipt · audit]

每个 Route 分别存储其消息输入、角色、处理器、工作区和发送规则。消息适配器不构建 Agent 指令，Agent 也不接收渠道凭据或路由状态的直接所有权。

Manager 通过一个 Plugin Kernel 加载 29 个独立的内置包。内置包和树外包共享 schema/profile v2、相同的 SDK、依赖图、权限检查、代际切换、执行模式边界和 Web 模块生命周期。请参阅插件包与热替换。

Agent 与安全边界

- 真实的 Codex 消息仅通过 Desktop IPC 传输到选定的 Codex/ChatGPT Desktop 任务所有者。
- 目标 Desktop 任务拥有其模型、工具、沙箱和审批。RabiRoute 不执行其推理。
- 项目固定的 codex app-server 可以创建或命名空任务，但它不执行 Route 消息。
- 当 Desktop 不可用、任务无法加载、工作区不同或所有者不明确时，交付会失败并记录证据。
- 平台账户、登录状态和凭据仍归其平台所有。
- 本地 data/、日志、录音、转录、令牌、Cookie 和私有路径不进入公共仓库。
RabiRoute 目前不提供通用操作队列、统一审批中心或无副作用的 Route 预览。面向手机、眼镜、可穿戴设备及多计算机 Agent 的生产级闭环仍处于实验阶段。

配置与数据

data/route//adapterConfig.json
data/roles//persona.md
data/roles//personaConfig.json

- adapterConfig.json 存储消息输入、处理器、工作区、Route 规则及人格绑定。
- persona.md 存储人格指引及面向处理器的工作要求。
- personaConfig.json 存储人格自动化、头像数据、语音关键词及最近消息限制。
- data/roles//conversation/ 存储该人格的消息历史。
- examples/data/ 包含经过脱敏、可复制的示例。

可构建的客户端位于 apps/ 下，共享 SDK 位于 packages/ 下，可复用的 Agent 指南位于 skills/ 下。

文档

首次使用

- 完成第一条 Route：完成一次真实的 Codex Desktop 投递。
- RibiWebGUI 用户指南：使用界面、人格、Route、Agent 及故障排查工具。
- 界面与运行时状态：判断 Manager、Route 及消息输入是否健康。
- 运维、日志与故障排查：根据可见症状定位故障。

安装与集成

- 配置：查看本地文件、目录及主要设置。
- 局域网 Rabi Agent：连接另一台计算机上的无头 Codex 工作节点。
- RabiSpeech：配置本地或远程 TTS 与 ASR。
- 客户端应用：构建 Android、Rokid AIUI、浏览器桥接及 Rabi Agent 客户端。

开发与维护

- 当前能力与成熟度：检查某项功能是否已验证。
- 文档索引：浏览当前、实验性、设计及历史资料。
- 架构：理解产品边界与数据流。
- 项目功能地图：定位功能归属、API 及代码入口。
- 版本更新日志：查看变更及迁移要求。

开发

npm run manager          # 从 TypeScript 运行 Manager
npm run webgui:dev       # 运行 Vue/Vuetify 前端
npm run test             # 运行后端与契约测试
npm run build            # 构建 Manager、独立插件包及 WebGUI
npm run check:config     # 校验公开及运行时 JSON 文本

发布变更前，请移除真实账号标识、聊天内容、令牌、Cookie、本地用户名、私有路径及运行时 data/。

许可证
RabiRoute 根据 MIT 许可证 授权。