插件简介
RabiRoute 是一个 Agent 无关的消息网关与投递策略路由器,由 vb2250158 开发并开源。其核心定位是把聊天、语音、定时和设备消息统一接入,通过消息路由投递给正确的 Agent 或程序,同时保持上下文、权限与投递凭证的明确性。它支持 QQ 群聊/私聊、Webhook、定时任务、Windows 桌面、语音与移动端等多种消息入口。
GitHub 数据:当前 Stars 296,综合评分 63.2(GitHub 分 63.2),最近更新 2026-09-01,当前版本 0.2.3,开源协议 MIT,已提供中文文档。兼容性验证结果:需源码安装(npm 包 rabiroute 未发布到 npm、仓库 package.json 标记 private、缺少 main/exports/bin 入口声明),暂不能一键安装。
核心功能
消息路由
接收 QQ 群聊/私聊(通过 NapCat/OneBot)、Webhook、定时、语音、桌面与设备消息,按规则将每条消息投递给选定的 Agent 或程序。每个 Route 分别存储消息输入、人设、处理器、工作区与发送规则。
定时 Agent 工作
角色规则可按间隔、时间窗口、每日时间或一次性计划触发 Agent,或在单独启用权限后运行明确的本地脚本,适合定时巡检、日报生成等自动化场景。
连续上下文
每个角色拥有自己的消息历史以及对计划、记忆和技能的引用;每条路由可限制投递中包含的最近消息数量,避免上下文膨胀。
外部发送控制
Agent 通过统一的发送 API 回复 QQ、RabiLink 和其他渠道,目标、引用消息、发送者身份与回执均经过验证并记录。
Windows 桌面集成
RabiRoute Desktop 支持选中文本操作、系统截图、标注、复制、置顶以及投递到活动角色;通过桌面 IPC 将真实 Codex 消息传输至选定的 Codex/ChatGPT 桌面任务所有者。
RibiWebGUI 管理面板
管理 Routes、人格、消息输入、Agents、计划、记忆、日志、诊断、主题与桌面设置。
安装与配置
前置:需要 Node.js 20 或更高版本以及 npm,并先安装 DSH CLI 引擎(npm install -g @deepseek-ai/dsh)。
Windows 用户优先使用安装程序:
# 从 GitHub Releases 下载 RabiRoute--windows-x64-setup.exe,验证 SHA256SUMS 后安装
源码安装(Mac/Linux 或需要二次开发的用户):
git clone https://github.com/vb2250158/RabiRoute.git
cd RabiRoute
npm install
npm run build
npm run start:manager
Manager 启动后会打印其实际的回环 URL,操作系统会分配一个未使用的端口。源代码模式用户打开该 URL;打包的 Windows 用户通过 Host 状态或托盘打开。若尝试通过 DSH 插件方式安装:
dsh plugin add vb2250158/RabiRoute
因仓库未发布 npm,此命令需走 GitHub 源安装。
兼容性与避坑指南
未发布 npm,必须源码安装
npm 包 rabiroute 未发布到 npm registry,仓库 package.json 标记 private 且缺少 main/exports/bin 入口声明,无法通过 dsh plugin add 一键安装,需走 GitHub 源或手动 git clone 源码编译。
Node.js 版本要求
需要 Node.js 20 或更高版本,低版本会构建失败。
大量功能仍处实验阶段
当前版本 0.2.3,DSH 集成、RabiSpeech 语音、RabiLink 移动端/眼镜、可穿戴输入、局域网 Rabi Agent、多计算机交付等均标记为实验性,生产使用需谨慎。
Windows 安装包未签名
Windows 安装程序目前未签名,SmartScreen 会提示未知发布者,安装前务必校验 SHA256SUMS.txt 校验和。
无固定 localhost 端口
Manager 每次启动由操作系统分配随机端口,并打印实际 URL,不存在固定的 localhost 端口作为产品契约。
数据与隐私
配置存储在本地 data/ 目录;平台账户、登录状态与凭据归各平台所有。发布或二次分发前需移除真实账户标识、聊天内容、令牌、Cookie、本地用户名与私有路径。
适合人群
适合需要把 QQ 群聊、定时任务、桌面操作与 Agent 打通的自动化爱好者与开发者,尤其是 Windows 用户、使用 Codex Desktop 的人群。不适合需要一键安装、对稳定性要求高、或依赖 Mac/Linux 桌面完整功能的用户(桌面核心路径目前仅 Windows 完整实现,其余平台多为实验性)。
总结
RabiRoute 以"消息网关 + 路由 + 门控"的思路,把分散的聊天、定时与设备消息统一接到 Agent,是目前 DSH 生态中少见的连接型插件。查看插件详情页了解更多:查看插件详情页
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页