Hipocampo 是一个面向自主 AI 智能体的双记忆持久化架构，旨在跨会话保存技术知识和用户画像数据，使智能体能够学习、适应并高效扩展。它构建于 PostgreSQL 17 与 pgvector 之上，包含混合检索引擎 BIRE v3.7（结合语义嵌入、词法扩展、GIN trigram 搜索和动态评分融合），以及实验性的稀疏选择性缓存（SSC）管道。
用途与定位 Hipocampo 解决 AI 智能体缺乏长期记忆的问题，通过独立的存储层保存技术记录（memoria_vectorial）和用户画像（memory_items），并基于 1024 维嵌入实现跨系统语义搜索。它适用于需要上下文连续性、错误学习和知识复用的智能体场景。
主要能力
- 双记忆架构：分离技术记录与用户画像，均使用 1024 维嵌入。
- BIRE v3.7 混合搜索：默认检索引擎，融合本地嵌入（Ollama qwen3-embedding:0.6b）、查询扩展、GIN trigram 和复合评分，供所有 MCP 工具使用。
- SSC（实验性）：四阶段渐进管道：标签路由 → pgvector Top-K → GIN Trigram → ILIKE 回退。
- 对数检查点：基于时间衰减压缩历史记忆，将 24 小时细节合并为 90 天检查点。
- 自动标签引擎：基于正则的规则引擎，在持久化时自动分类和标记记录。
- 混合提示压缩（v4.0）：两阶段压缩，提取式（句子级）处理通用文本，LLM 摘要（通过配置的嵌入端点）处理技术/代码内容，减少 20-50% 令牌。
- 记忆图（v4.0）：记忆间语义关系的有向图，支持链接、BFS 树导航和最短路径查找。
- 记忆层级与触发器预防（v4.1）：三级记忆（情景 → 语义 → 自动），支持上下文触发器（如 trigger:php），自动规则永久保留。
- 代码免疫系统（v4.2）：防止智能体破坏正常代码，通过编辑前快照、编辑后验证、破坏时创建永久规则三步循环。
- 代码 RAG（v4.0）：索引项目源代码（PHP、JS、TS、Python、SQL）为语义嵌入，搜索返回真实代码片段。
- 指数时间衰减（v4.0）：final_score = relevance × exp(-λ × days)，λ=0.05 可配置，20% 下限。
- MMR 多样性反聚集（v4.3）：最大边际相关性重排序，防止密集嵌入簇垄断结果。
- 主动遗忘与归档（v5.0）：超过年龄阈值的情景记忆归档到冷存储，保护 automatica、semantica、critico 级别。
- 记忆疲劳提升（v5.0）：基于访问频率提升排名，模拟大脑强化神经通路。
- 记忆预算与分层（v5.0）：管理 HOT（嵌入完整）、WARM（无嵌入）、COLD（归档）三层，热层上限 5000 条。
- 矛盾检测（v5.0）：保存时用否定探针嵌入检测事实矛盾，记录警告并创建 contradicts 链接，不阻止保存。
- 文件监视器（v5.0）：监听目录变化并自动重新索引，由 systemd 定时器管理。
- 链接权重衰减（v4.3）：记忆图链接指数衰减（半衰期 90 天），低于 0.01 修剪。
- 潜在知识保存（v4.3）：四层自动保护 trade_knowledge，永不衰减，自动分类可复用性。
- 会话记忆与自动摘要：会话隔离保存/搜索，20 次保存后自动生成会话摘要。
- MCP 服务器：FastMCP 服务器提供 39 个工具，支持 Claude Desktop、OpenCode 等客户端。
- 可选 TypeSafe 集成：将语义判断委托给 TypeSafe 模型，返回校准概率，支持批量调用和优雅回退。
使用方式 提供一键安装脚本（Linux/macOS），自动安装 PostgreSQL + pgvector、嵌入、数据库、虚拟环境、MCP 客户端和 systemd 维护服务。Windows 需通过 WSL2 运行。也可连接 Hugging Face Spaces 上的免费 MCP 服务器进行测试（数据临时，重启丢失），或本地运行连接外部数据库（Neon、Supabase 等）。嵌入模型使用 sentence-transformers/all-MiniLM-L6-v2（384 维）通过 Hugging Face 推理 API。
适用场景 适合需要跨会话记忆、错误学习、代码回归保护、项目知识复用的自主 AI 智能体开发，尤其适合使用 MCP 协议的客户端集成。
限制 Hugging Face 免费层数据临时，仅用于测试。SSE 传输自 MCP 规范 2025-03-26 起弃用，推荐 Streamable HTTP。Windows 纯 CMD/PowerShell 无法运行安装脚本。TypeSafe 处于早期访问，需自带 API 密钥，启用后会发送记忆文本到其 API。部分功能（如 SSC）标记为实验性。
