SAGE(全称 Sovereign Agent Governed Experience)是一个面向 AI 智能体的持久化项目记忆系统。其核心目标是解决“每次都要重新向 AI 解释项目”的问题:让智能体将项目决策、尝试失败的方案以及有用的经验教训记录下来,并在后续会话中回忆相关上下文。SAGE 支持 Claude Code、Codex、Cursor 以及其他具备 MCP(Model Context Protocol)能力的客户端,开发者还可以通过 Python SDK 或带签名的 REST API 进行集成。
主要能力包括:
- 记忆记录与回忆:智能体可以记录经验,并在后续会话中检索相关记忆。回忆效果取决于已记录的内容、配置以及智能体对工具的使用方式。
- 溯源与准入:智能体签名的写入会将其记录归因到相应的作者;记忆在进入正常回忆前需经过验证生命周期。
- 访问控制:通过注册、域权限和分类来决定哪些智能体可以使用某条记忆。
- 记忆维护:可以检查置信度和状态、应用衰减或废弃某条记忆,同时保留审计历史。
- CEREBRUM 仪表盘:一个基于浏览器的操作控制台,以 3D MRI 记忆大脑为中心,包含链健康、智能体、联邦、语义记忆、回忆调优、保险库恢复、任务、导入和更新等功能。
使用方式:
- 桌面端:下载最新版本,打开 SAGE 并在 CEREBRUM 中完成设置。选择记忆引擎,连接 AI 客户端并审查智能体访问权限。
- 从源码构建:需要 Go 1.26.9+。
- 容器镜像:ghcr.io/l33tdawg/sage:11.23.23。
- 连接 MCP 客户端后,调用 sage_inception 并遵循其返回的记忆模式。
- HTTP MCP 也可在 /v1/mcp/sse 和 /v1/mcp/streamable 使用,但两者都需要 bearer token 或 OAuth 认证。http://localhost:8080 是 REST 基础地址,不是未认证的 MCP 端点。
适用场景:
- 智能体需要持续参与同一项目的长期工作。
- 需要保留有价值的设计决策、失败方案或供下次会话使用的经验教训。
- 与 RAG 不同,SAGE 在检索之外还提供了围绕智能体经验的受治理记录。
限制与注意事项:
- 记忆默认存储在本地。可选的联邦、连接器和远程模型提供者可能将数据发送到配置的目的地。启用保险库可对记忆内容进行静态加密。
- 验证者检查治理的是哪些内容被提交,并不证明每条记忆的声明都是真实的,也不会改变模型的权重。
- 个人模式运行一个真实的 CometBFT 验证者,没有拜占庭冗余;注册更多智能体不会增加共识验证者。多验证者部署运行一条共享链;联邦在明确策略下连接不同的链。
- 智能体不是验证者,其请求和结果仍是不可信数据。
- 若从 v5.0 之前安装的版本升级,且 AI 未进行逐轮记忆更新,需在项目目录重新运行安装程序。
- 版本升级前应阅读相应指南,多管理链在应用 v23 激活前尤其需要。
- 部分功能(如本地裁判 memory gate)仍为实验性且默认关闭。
当前版本 v11.23.23 新增:通过 sage_message_close(message_id, reason) 在不回复的情况下关闭已审阅的通知,记录“已关闭但未回复”的结果,保留历史并清除待处理提醒。应用版本 v28 保持活跃,无需链迁移。