Memora 是 AstrBot 的长期记忆插件，为对话提供记忆提取、混合检索、安全注入、稳定身份、关系演化与可视化管理能力。
完整中文文档：https://inside-734.github.io/astrbot_plugin_memora/
- 以 SQLite canonical memory 作为唯一权威数据，全文、向量、图和 Projection 均可重建。
- 组合 BM25、FAISS、图检索、关系扩展与重排序，并按会话、身份和隐私边界过滤。
- 通过请求级策略路由安全注入相关记忆，不把动态记忆写入 System Prompt。
- 支持稳定身份、来源可追溯的自动/人工用户画像、知识库、笔记、好感度、社交关系和群聊黑话。
- 自动知识只从达到质量门槛的 canonical memory 生成带来源证据的 derived proposal，并通过 Agent 工具、Page API 或 Dashboard 显式读取，不进入默认被动召回。
- 自动笔记由达到配置长度门槛的 canonical memory 生成；模型预算不可用时使用确定性来源摘要， source revision 变化或删除后自动失效，人工笔记与版本历史保持独立。
- 可选语义压缩把同 scope、privacy、role 的旧 canonical memory 聚合为带完整来源 revision 的
semantic_summaryProjection；原记忆不会被删除或替换，关闭功能后派生摘要不进入召回。 - 可选对话连续性只从通过质量门并成功写入 canonical 的 topics 维护同 session 待续话题， 重启可恢复未过期状态；召回时仅作为受预算和保护的临时请求上下文，不写 System Prompt。
- 可选异常检测按 UTC 日聚合 canonical 创建量，3-sigma 告警写入脱敏诊断事件并在健康页显示。
- 可选记忆再巩固只在召回时生成 pending 候选，人工确认后按来源 revision CAS 应用并可回滚，默认关闭、不自动改写 canonical。
- 可选自主学习从统一可信反馈生成 shadow 参数候选并等待人工 CAS 发布，默认关闭、不自动修改生产检索权重。
- 提供 Dashboard、管理命令、Agent 工具与 Page API。
- 自动与手动总结统一进入可恢复的 SQLite 窗口任务；
/memora summarize立即返回排队、重复和并发计数，最终 canonical、quarantine、discard 与 mark_write 累计通过诊断查看。 - 提供诊断、评测、备份恢复、索引重建和校验后的在线更新。
通过 /memora webui 打开 Dashboard，集中查看记忆、知识图谱与系统运行状态。
- Python
>=3.12,<3.13 - AstrBot
>=4.24.2 - 可用的 Embedding Provider
- 可用的 LLM Provider
Node.js 仅在开发 Dashboard 或文档站时需要，普通插件安装不需要 Node.js。
在 AstrBot 管理面板中打开“插件市场”，搜索 Memora 并安装。
- 打开 最新 Release。
- 下载
astrbot_plugin_memora-<version>-runtime.zip。 - 在 AstrBot 插件管理页面上传 ZIP；安装前无需解压。
安装后配置 Embedding Provider 与 LLM Provider，重启 AstrBot，然后以管理员身份检查状态：
/memora status
打开管理面板：
/memora webui
Provider 尚未就绪时，Memora 会在后台等待并重试，不会阻塞 AstrBot 的聊天主链路。
配置字段和默认值以仓库中的 _conf_schema.json 为准，架构不变量见 DESIGN.md，发布记录见 CHANGELOG.md。
本项目基于 GNU Affero General Public License v3.0 开源。