funes

产品简介

funes 是由 Hugging Face 开源发布的编程智能体本地记忆层工具，为 Claude Code、Codex、pi、Helmes 等主流编程智能体提供持久化、可检索的会话记忆能力。开发者过去每开启一个新会话，智能体便丢失所有上下文——上次尝试的方案、踩过的坑、放弃的理由，全部归零。funes 正是为解决这一痛点而设计。

核心功能

• 本地记忆索引：将智能体现有会话轨迹（turn-and-block 结构）自动解析并存储为本地 Lance 数据集，无需额外云端依赖
• 跨机器跨会话检索：结合向量检索（Vector Search）、BM25 关键词匹配与 Cross-Encoder 重排序，让智能体在新会话中直接调用历史决策上下文
• 零门槛一键接入：运行 funes add claude 即可为指定智能体构建索引、安装召回工具，并自动化为每个完成的回合建立索引
• 可选 Hugging Face Hub 同步：支持绑定私有数据集实现跨机器记忆同步，敏感令牌在发布前自动脱敏
• 无 ML 运行时依赖：以单一二进制分发，嵌入与重排序均在本地运行，不产生额外云端账单
• 多智能体支持：当前支持 Claude Code、Codex、pi、Helmes，架构设计支持后续扩展更多生态成员

特色优势

1. 数据主权归用户：所有数据默认存储在本地 Lance 数据集，用户完全掌控自己的记忆数据，可选同步至自有 Hugging Face 私有数据集，无第三方持有记录
2. 召回精度高：融合向量检索 + BM25 + Cross-Encoder + 时序权重的混合检索策略，返回原始文本而非摘要，保留完整溯源（智能体、时间戳、会话 ID、轮次）
3. 部署极简：单一二进制安装，不依赖额外 ML 运行时，真正即装即用
4. 开源可扩展：Apache 2.0 许可证，架构设计允许后续添加新智能体适配

应用场景

• 跨项目上下文复用：开发者在多个项目间切换时，新会话可直接召回之前项目的技术选型决策与错误尝试记录
• 多人协作知识传递：团队成员可通过私有 Hugging Face 数据集共享历史会话记忆，新成员无需重复踩坑
• 长期智能体训练复盘：研究团队可借助历史会话记录对智能体行为进行系统性复盘与优化
• 个人编程经验沉淀：将多年编程生涯中积累的方案思路、技术判断变为可检索的知识资产

适用人群

• 日常使用 Claude Code、Codex 等编程智能体的专业开发者
• 跨多机器、多项目并行工作的工程团队
• 需要长期维护复杂代码库、积累技术债务治理经验的团队
• 研究编程智能体行为与记忆机制的研究人员

出品方

Hugging Face（产品团队主导，项目负责人 David Corvoysier），Apache 2.0 开源许可证

更新动态

2026 年 9 月 3 日正式发布，当前版本支持 Rust + Node.js 环境，GitHub 最新更新于 2026 年 9 月 2 日，Stars 18，Forks 4

官网链接

https://github.com/huggingface/funes