RoBrain 是一个开源的记忆和判断层,适用于使用人工智能编码代理的团队。其独特的单元不是聊天记录或松散的“事实”,而是工程决策:团队选择了什么、为什么选择它、拒绝了哪些替代方案、哪些文件受到影响以及决策是否仍然有效。相同的 Postgres 支持的记录可以显示在 Claude 代码、Cursor、GitHub Copilot、Codex CLI 和 Hermes 中。
这一重点解决了一个狭窄但代价高昂的问题。编码代理可能会记住当前的约定,但仍然推荐团队之前拒绝的库、迁移或架构。普通规则文件通常保留获胜者,但忽略失败的选项及其原因。 RoBrain 使这些否决可查询,并可以在工作开始前发出警告。它并不能使存储的决策永远正确:捕获错误、过时的约束和组织分歧仍然需要人工治理。
决策记忆循环如何工作
开发人员 + 编码代理会议
|
v
被动捕捉
编辑 -> 分类 -> 提取
|
v
Postgres 决策分类账
选择/理由/拒绝[]/文件/状态
| |
伏
任务前回忆计划综合
否决+上下文冲突+漂移
| |
'---------+----------'
v
审查/取代/导出
|
git 结果信号
该图将捕获、存储、检索和判断分开,因为每个过程的失败方式不同。分类器可能会错过一个决定。提取可以发明一个理由。检索可以返回相关但不相关的否决权。 Synthesis 可以将合法的更改标记为矛盾。一个有用的飞行员会衡量每个阶段,而不是将“代理记住了某事”视为充分的证据。
RoBrain 与更简单的项目内存
| 方法 | 实力 | 典型故障 | 最适合 |
|---|---|---|---|
| CLAUDE.md、AGENTS.md 或编辑器规则 | 透明,可在git中审核,无服务 | 手动维护;被拒绝的选项和日期经常丢失 | 具有稳定约定的小型或年轻存储库 |
| 聊天或编辑器自动记忆 | 低设置和个人连续性 | 对于用户/工具来说是本地的;团队治理薄弱 | 无需跨工具共享的单独工作 |
| 通用向量存储器 | 灵活的语义回忆 | 块可以检索没有生命周期或否决语义的散文 | 超越决策的广泛知识回忆 |
| RoBrain | 结构化拒绝替代方案、生命周期、跨工具存储和综合 | 操作开销和持久内存污染的风险 | 多个开发人员、多个代理和反复出现的架构辩论 |
RoBrain 自己的指导非常具体:如果一个项目没有多个开发人员或工具,没有足够的历史来积累矛盾,或者重复拒绝提案,静态规则文件可能就足够了。这是一个有用的取消资格。内存基础设施应该通过减少返工来赢得一席之地,而不是通过添加另一个数据库,因为“代理需要内存”。
实际存储的是什么
| 领域 | 为什么这很重要 | 复习问题 |
|---|---|---|
| 决定 | 说明所选择的约束或方法 | 它是否足够具体,可以在不冻结不相关工作的情况下进行申请? |
| 基本原理 | 保留选择背后的条件 | 观察到的原因是证据、偏好还是猜测? |
被拒绝[] | 允许检索不应随意重新引入的目标选项 | 每次拒绝是否都包含一个过时的、可证伪的理由? |
| 文件和出处 | 将记忆与其来源和受影响的表面连接起来 | 审阅者可以将记录追溯到会话或更改吗? |
| 生命周期 | 区分有效、被取代和无效的指导 | 谁可以改变状态,替换者是否有联系? |
| 关系 | 连接冲突、扩展和相关决策 | 该图是有助于检索还是仅仅产生噪音? |
被拒绝的选项不应成为永久的禁令。 “不要使用 Redis”在成本冻结期间可能是正确的,但在工作负载发生变化后可能是错误的。持久记录应包括范围、日期、所有者、证据以及到期或审核触发器。 RoBrain 支持取代和失效,但团队必须定义谁行使这些控制权。
自托管架构和数据边界
免费的自托管路径启动 Postgres 以及 Docker 中的 Perception 服务,然后通过 MCP、插件或挂钩连接支持的编辑器。根据官方网站,决策保留在团队的 Postgres 中,并且不会摄取完整的文件内容;可以存储简短的会话摘录、文件路径和决策元数据。秘密在捕获和摄取时被清除。但是,默认的提取和嵌入路径仍然可以使用操作员的 API 键调用外部模型提供程序。
| 组件 | 它看到的数据 | 操作员控制 | 测试风险 |
|---|---|---|---|
| 编辑器挂钩或 MCP 集成 | 选择捕获的提示、座席轮流和项目上下文 | 按存储库安装 | 敏感会话意外捕获 |
| Perception | 候选人轮流并提取决策 | 自托管容器和 API 身份验证 | 错误分类、未修补的服务或暴露的端点 |
| Postgres/pgvector | 决策语料库、摘录、嵌入和元数据 | 团队基础架构、备份和保留 | 广泛的访问、过时的记录和备份泄漏 |
| 法学硕士/嵌入提供商 | 提取或矢量化所需的有效负载 | 提供商选择;支持本地模型 | 第三方保留、居住和合同限制 |
| Rory Plans 云 | 云层处理和团队数据 | 供应商帐户和计划 | 验证当前术语、区域、角色和删除路径 |
因此,“自托管”并不自动意味着“没有数据离开网络”。使用 Ollama、LM Studio 或 vLLM 的完全本地配置可以减少出站处理,但团队必须验证实际的网络跟踪和模型配置。还保护数据库备份、API 代币、生成的账本和可观察性日志;即使没有源代码,这些也可能会揭示架构选择或过去的漏洞。
检索、否决扫描和合成是不同的控制
自托管 Perception API 公开了确定性 POST /否决扫描 寻找主动拒绝选项的字面提及。这是可预测的且成本低廉,但可能会错过同义词和间接建议。支持的集成可以添加语义检索以实现更广泛的匹配。在会话开始时,始终在线的摘要提供高优先级上下文。预定的 罗宾合成器 工作扫描语料库中的矛盾、立场漂移和重复出现的实体;评审员检查结果 罗宾评论.
| 机制 | 当它运行时 | 擅长 | 盲点 |
|---|---|---|---|
| 永远在线的总结 | 会话开始 | 稳定的高层约束 | 上下文预算和陈旧排名 |
| 字面否决扫描 | 在支持的挂钩中的提示/操作之前 | 具有确定性行为的已知选项名称 | 别名、概念等同和模糊提示 |
| 语义搜索/注入 | 按需或通过集成 | 相关决定的表述不同 | 代理解释中的错误匹配和来源缺失 |
| Synthesis | 手动或预定批次 | 语料库范围内的漂移和矛盾 | 需要人工审核;不是实时策略引擎 |
| Git 结果反馈 | 观察到恢复后 | 降低与失败结果相关的决策 | 回复是决策质量的不完美代表 |
如何阅读 VetoBench 声明
RoBrain 发布 VetoBench,这是一个围绕一个有用问题设计的基准:当任务邀请团队之前拒绝的方法时,编码代理是否会再次提出该方法并引用之前的原因? 2026 年 7 月的官方结果报告称,在存档的测试运行中,零拒绝了 RoBrain 的重新提案,而无内存条件则反复出现被否决的方法。该存储库包括提示、检索到的上下文、响应和判决,这比无法检查的营销百分比更有力的证据。
它仍然是供应商创建的基准,具有综合场景、选定的模型和特定的摄取管道。它表明结构化否决权检索可以在这些条件下发挥作用;它并不能证明每个存储库的生产事故都减少了。使用您的模型、语言、规则、历史记录大小和集成重新运行代表性子集。包括对抗性案例:重命名的图书馆、已过期的否决权、两个具有冲突约束的团队以及其基本原理包含类似秘密字符串的决策。
为期两周的实用评估
- 选择一个存储库。 更喜欢六个月以上的代码库,至少有两名活跃的开发人员并记录了逆转。
- 打造一套黄金套装。 选择 20 项决策:10 项有效、5 项被取代、5 项被拒绝。记录每个问题的权威问题、ADR 或拉取请求。
- 小心热启动。 仅导入经过审核的决策。不要将整个聊天档案转入可信内存。
- 运行配对任务。 为具有或不具有 RoBrain 上下文的代理提供相同的 15 个实际任务。随机化顺序并保持模型/设置固定。
- 检查每一次捕获。 衡量精确度、缺少基本原理、错误的文件范围、秘密编辑和批准时间。
- 测试生命周期的变化。 取代三项决定并确认旧的否决权仍然是历史性的,而不阻止更换。
- 模拟失败。 停止 Perception,轮换令牌,恢复备份并确认编辑器挂钩安全失败,而不会丢失开发工作。
| 公制 | 如何计算 | 建议的先导门 |
|---|---|---|
| 捕捉精度 | 正确的持久决策/所有捕获的记录 | 审核规则稳定后至少90% |
| 捕捉回忆 | 正确捕捉黄金决策/做出的决定 | 至少80%;通过整合调查遗漏 |
| 否决命中精度 | 有用的警告/显示的所有警告 | 至少 80% 以避免警告疲劳 |
| 内存陈旧率 | 无效或被取代的记录作为活动/召回出现 | 低于5% |
| 重复拒绝率 | 重新提出已知否决权的任务/符合条件的任务 | 大幅低于基线 |
| 审查负担 | 每周审查每个开发人员所花费的分钟数 | 低于重复调查节省的时间 |
这些阈值只是起点,并非官方保证。业务决策应该利用节省的时间并避免返工。如果系统可以防止一种代价高昂的重新引入依赖性,但需要每周进行数小时的清理,那么其价值取决于这些故障的成本分配。
治理:内存是共享基础设施
| 角色 | 责任 | 所需控制 |
|---|---|---|
| 开发商 | 创建决策并标记不正确的捕获 | 出处可见且易于修正 |
| 技术主管 | 批准高影响力架构内存 | 按子系统查看队列和所有权 |
| 安全/隐私 | 定义排除的存储库和数据类 | 编辑测试、访问日志、保留和删除 |
| 平台拥有者 | 操作 Postgres、Perception 和集成 | 备份、升级、令牌轮换和监控 |
| 审计员 | 重构指南改变的原因 | 不可变的来源加上取代历史 |
不要让被动占领默默地制定政策。将记录标记为提议、审查或权威;保留对批准或高可信度记录的自动注入强否决权。对项目和团队进行细分,这样前端实验就不会成为全公司范围内的禁令。添加依赖项升级、事件、监管变更和经过时间的审核触发器。
自托管与 Rory Plans 云
Apache-2.0 自托管版本提供核心决策系统:捕获、结构化否决、生命周期、综合、跨工具检索、导出和本地操作。 RoBrain 的官方比较称 Rory Plans 云增加了更多自动任务边界注入、预提交冲突判决、团队管理、仪表板和更丰富的冲突处理。云访问与付费 Rory Plans 产品相关,而不是项目页面上显示的简单独立 RoBrain 价格。
购买之前,请验证当前的实时计划,包括使用情况、超额、组织隔离、支持、数据控制器、删除过程和导出行为。对于自托管,请对不太明显的成本进行定价:Postgres、备份、模型和嵌入调用、升级、事件响应和审核时间。
替代方案以及何时选择它们
| 选项 | 选择它时 | 与 RoBrain 的权衡 |
|---|---|---|
| ADR 文件加上 CLAUDE.md/AGENTS.md | 您希望以最少的基础设施做出 git 原生、人工编写的决策 | 加强刻意审查;较弱的被动捕获和跨工具主动召回 |
| Mem0 | 您需要跨应用程序的通用内存 API | 更广泛的内存原语;被拒绝的替代方案可能需要自定义架构/治理 |
| Zep/Graphiti | 时态知识图和实体关系是核心 | 更通用的图模型;创建编码决策工作流程需要做更多工作 |
| OpenViking 或面向文件的上下文系统 | 您需要可导航的项目知识和明确的检索 | 更广泛的组织背景; RoBrain 更专注于否决和生命周期 |
| 自定义 Postgres + MCP | 您拥有强大的平台能力和不寻常的政策需求 | 最大限度的控制;您拥有提取、评估、挂钩和维护 |
当被拒绝的替代方案与所选约定同样重要时,RoBrain 最为引人注目。如果实际问题是文档发现、代码搜索或个人笔记,则较小的工具可能具有较低的运营成本。
常见问题解答
RoBrain 是编码剂吗?
不。它是连接到现有编码代理的记忆和判断层。它存储和检索决策; Claude Code、Cursor、Copilot、Codex CLI 或 Hermes 仍然执行编码工作。
独立开发者可以受益吗?
是的,尤其是在一个长期存在的代码库上,旧的错误会在不同的工具中重复出现。但是,维护的规则文件或 ADR 文件夹可能就足够了。根据那个更简单的基线进行试点。
自托管是否将所有数据保留在本地?
数据库和 Perception 服务可以在本地运行,但提取和嵌入可能会调用配置的外部提供程序。如果需要完全本地化,请使用受支持的本地模型并验证网络流量。
否决权会阻止代理人采取行动吗?
不具有普遍性。文字扫描和集成警告提供上下文;行为取决于连接的工具和层。将它们视为决策支持,除非您单独测试了执行路径。
记忆错误该如何处理?
拒绝或编辑捕获,保留出处,并将过时记录标记为已取代或无效。将错误捕获作为操作指标进行跟踪,而不是悄悄删除管道错误的证据。
VetoBench 是独立证明吗?
不会。这是一个透明的、由供应商维护的基准,带有存档收据。它是有用的证据和可重复的模板,但生产采用应取决于特定于存储库的配对评估。
来源与验证
- 官方RoBrain产品页面、架构和比较
- 官方 Apache-2.0 源存储库
- 官方概念和内存模型
- 官方CLI和安装参考
- VetoBench 方法和存档证据
- 官方内存导出格式
- Product Hunt 发布和制造商说明
- 模型上下文协议安全指南
- PostgreSQL 客户端身份验证文档
上次审核日期为 2026 年 7 月 26 日。RoBrain 正在快速发展。在生产使用之前确认当前的集成、命令、云术语、数据处理和基准工件。




