Agent 与自动化AI 资源
HyperMnesia:为 AI 编程代理提供自托管长期记忆
Recluse/HyperMnesia · Self-hosted long-term memory for AI coding agents: Postgres+pgvector doc-RAG (component/constraint map + hybrid RRF + cross-encoder rerank) and bi-temporal personal memory. MCP-native, local-model friendly.
ELI5:它是什么,解决什么问题
HyperMnesia 是一个基于 Postgres + pgvector 的自托管长期记忆存储,面向 Claude Code 等 MCP 客户端。它把仓库文档经过分块、嵌入和混合检索(向量 + 全文检索的 RRF 融合,可选交叉编码器重排)做成可搜索的 doc-RAG,并通过手写的组件-约束映射把文件路径解析为适用的 must 规则,在编辑前由 Claude Code hook 注入;同时维护双时态、按视角区分、带证据溯源的个人记忆,可从会话记录中提取事实,支持召回注入、定时整合和经人工审核的派生记忆。项目通过 MCP 工具和 Claude Code hooks 两条路径接入,提供 `hm` 命令行、诊断工具和 Docker Compose 部署方式。
核心能力与快速开始
★ 15 · Python
- 能做什么
- 文档 RAG:按标题切分 Markdown,使用 bge-m3 嵌入(Ollama 或 TEI),结合向量检索与全文检索做 RRF 融合,可选 bge-reranker-v2-m3 交叉编码器重排。组件-约束映射:根据文件路径确定所属组件,在编辑前注入 must 规则及一跳依赖中的约束。个人记忆:双时态记录、用取代而不是覆盖的方式更新、按视角区分、证据构成无环溯源图,支持带上下界的召回深度和基于证据的问答(无法溯源时弃答)。派生记忆经人工审核。MCP 服务器暴露项目地图、约束、文档搜索、记忆和状态等工具;Claude Code hooks 负责自动注入与会话捕获。提供 `hm` 命令行工具(init、migrate、ingest、doctor 等)及诊断检查。
- 适用场景
- 适合使用 Claude Code 或其他 MCP 客户端的开发者,在跨会话的编码任务中保留项目规则、架构约束、个人偏好和历史决策;在编辑文件前自动获得该文件适用的不变量,避免重复先说明背景再改代码;把仓库文档变成可检索知识库,按需召回而不是整份塞进上下文;与 LSP 符号工具(如 Serena)配合,分别回答代码结构问题和文档与记忆问题。
- 项目形态
- 可直接使用的工具
- 部署方式
- 自托管;提供单机 Docker Compose 与 Kubernetes 部署说明,依赖 Postgres + pgvector,可配 Ollama 或 TEI 本地模型;具体部署步骤与资源要求未在摘录中完整说明。
- 主要依赖
- Python 与 Rust 组件;Postgres + pgvector;嵌入与重排模型(bge-m3、bge-reranker-v2-m3 经 Ollama 或 TEI);MCP 客户端(如 Claude Code)。硬件规格、模型大小与运行成本未说明。
- 使用限制
- 不索引代码符号,代码结构问题需配合语言服务器;自动注入与会话捕获依赖 Claude Code hooks,其他 MCP 客户端只能按需调用工具;手工维护的组件映射会随代码变化而过期,项目提供新鲜度检查但不自动修复;文档语料对应用登录共享可写;重排效果的评测仅基于单个私有语料,非公开基准;派生记忆需人工审核;成本与限制未说明。
- 许可证
- MIT
- 最近推送
- 2026-10-31 06:51
资料检查:2026-10-31 07:00 · 卡片整理:2026-11-04 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。