产品简介
statewave Statewave 是一款开源的AI记忆运行时。它解决了AI应用每次对话都从头开始、无法跨会话保留记忆的核心痛点，通过“编译-使用”模式生成确定性的、带来源标记的上下文包，取代了不稳定的查询时检索。适合需要为AI应用（如客服机器人、编码助手）构建可靠记忆功能的开发者。
核心功能
- 编译式上下文包，确保相同查询在同一时间点产生完全相同的输出，避免采样噪声
- 内置来源追溯，每一小段记忆都能追溯到其原始的输入事件
- 支持可插拔的启发式或LLM编译器，灵活处理记忆生成
- 基于主体（如用户、账户）组织记忆，提供结构化数据生命周期
- 支持通过声明式策略引擎管理数据敏感性与多租户隔离
- 自托管于 PostgreSQL + pgvector，避免厂商锁定
快速开始
- 通过 `pip install statewave` 安装 Python SDK
- 启动 Postgres + pgvector 数据库并运行 Statewave 服务
- 使用 SDK 客户端连接服务，为特定主体（如用户ID）创建“事件”（episodes）
- 调用 `compile_memories` 编译记忆，然后用 `get_context` 获取带来源、按相关性排序的上下文包
界面预览
与其他方案对比
| 对比项 | statewave | 同类方案 |
|---|---|---|
| 上下文生成方式 | 先将原始事件编译成结构化记忆，再按需组装。结果确定、可重现。 | 查询时实时从原始日志或向量库中检索。结果受采样和排序影响，不稳定。 |
| 可重现性 | 相同查询条件总是返回完全相同的上下文字节。 | 每次检索可能因底层数据微变或算法不确定性而产生微小差异。 |
| 数据所有权与部署 | 开源，数据完全存储在用户自建的Postgres中，无厂商锁定。 | 部分方案为托管服务，用户数据需托管于第三方。 |
适合谁用
- 需要为客服机器人构建跨会话用户记忆的开发者
- 开发需要持久化项目决策和技术偏好的长期编码代理的开发者
- 希望在自己的基础设施上为AI应用构建私有化记忆层的企业技术团队
下载与版本
当前最新版本为 v1.4.0，发布于 2026-07-14。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/smaramwbc/statewave