# Statewave Statewave 是面向 AI 智能体的开源、自托管记忆运行时:持久化存储事件,编译带来源信息的结构化记忆,并为需要跨会话连续性的应用返回排序后的上下文集合。 - Findings24: - 网站: - 价格: Freemium - 分类: AI 智能体基础设施 ## 什么是 Statewave? Statewave 是面向 AI 智能体的开源记忆运行时。它在 LLM 应用与应用长期接触的用户、项目、决策和事件之间提供持久化层。应用将原始事件作为不可变事件记录发送,并限定在用户、账户、智能体、代码仓库或项目等主体范围内;Statewave 会将这些事件记录编译为类型化记忆,并为后续请求组装相关上下文。 该运行时将情景记录与语义记忆分开。事件记录保留发生过的事情,而编译后的记忆则表示用户档案、偏好、操作流程和过往问题摘要等事实。记忆可以包含置信度分数、有效期以及指向源事件记录的链接。检索会结合时效性、相似度、类型优先级和时间有效性等信号,对相关记忆和事件记录进行排序,然后返回受令牌数量限制的上下文集合,供 LLM 提示使用。 Statewave 基于 Postgres 和 pgvector 自托管,并提供 REST、Python 和 TypeScript 接口。其 MCP 服务器支持兼容客户端;可选连接器则会将开发、通信、文档、支持和工作流工具中的事件规范化为通用事件记录格式。 ## Statewave 能做什么? ### 事件记录与记忆分离 将原始事件以仅追加方式存储为事件记录,并将其编译为类型化语义记忆,同时保留事件时间线和持久事实。 ### 排序且受令牌数量限制的上下文 将相关记忆和事件记录组合为排序后的上下文集合,并受应用选定的令牌预算限制。 ### 来源信息与状态组装回执 将编译后的记忆链接到源事件记录,并使用不可变、可通过 ULID 定位的回执和完整性哈希记录每次上下文调用。 ### 治理控制 支持敏感性标签、提升前的运营人员审核、声明式 YAML 策略、拒绝或编辑行为,以及面向审计的 log\_only 模式。 ### 自托管集成接口 使用 Python 和 Postgres 运行,提供 REST 和 SDK 接口,并提供 MCP 服务器及模块化源连接器。 ## 使用场景 ### 具备会话感知能力的支持智能体 保留客户对话、解决历史和重复问题上下文,使支持工作流能够在交接或处理新工单时组装相关历史记录。 ### 编码与代码仓库智能体 摄取问题、拉取请求、评审、发布和架构说明,使智能体能够跨编码会话构建项目知识。 ### 内部副驾驶 为内部工具保留用户工作流、过往决策和组织背景,无需在每次提示中重放完整的交互历史。 ### 长期运行的基于主体的智能体 为长期运行的智能体提供持久记忆层,并围绕用户、账户、社区、联系人或项目等主体进行组织。 ## 常见问题 ### Statewave 会向应用返回什么? 它会返回排序后的、受令牌数量限制的上下文集合,其中包含相关情景记录和语义记忆。应用可以将这些集合放入系统提示、工具结果或检索增强工作流中。 ### Statewave 与向量数据库有何不同? 它底层使用 pgvector,但增加了类型化记忆、仅追加事件记录、确定性的排序信号、幂等编译、时间有效性、冲突解决、来源信息和上下文组装能力。 ### Statewave 可以自托管吗? 可以。Statewave 专为使用 Postgres 和 pgvector 进行自托管而设计。Docker Compose 可在本地运行整个技术栈,部署也可以使用 Fly.io 或 Railway 等容器平台。该网站说明目前没有托管式 Statewave 云服务。 ### 它可以与哪些模型和框架协同工作? Statewave 与框架无关。编译使用 LiteLLM,支持众多托管和本地提供商;检索和上下文组装则与提供商无关。REST、Python 和 TypeScript 接口支持自定义智能体和框架。 ### Statewave 是否开源并可用于商业用途? 该项目采用 Apache License 2.0 发布,允许使用、修改、分发、自托管以及用于商业产品。可选的企业支持以服务合同形式提供。 ## 快速信息 - **类别**: AI 基础设施 / 开发者工具 - **部署方式**: 使用 Postgres 和 pgvector 的自托管 Python 服务 - **许可证**: Apache License 2.0 - **接口**: REST API、Python SDK、TypeScript SDK 和 MCP 服务器 - **核心工作流**: 记录事件 → 编译记忆 → 检索上下文集合 - **源域名**: statewave.ai