Funes

产品简介

Funes 是由全球最大开源 AI 平台 Hugging Face 于 2026 年 9 月 3 日正式开源的编码智能体本地优先持久记忆层工具。它以单一二进制文件形式分发，无需 ML 运行时依赖，不强制要求外部账户，真正实现本地优先部署。Funes 的核心使命是解决编码智能体"每新建一个会话都将项目视为陌生"的根本性痛点——在 Claude Code、Codex、pi、Hermes 等主流编码助手每次会话结束后，历史决策、错误尝试与技术权衡的原始上下文全部丢失，新会话只能从零开始。Funes 将这些会话轨迹自动结构化、索引化、可检索化，让智能体在新会话中直接召回历史上下文。

核心功能

1. 本地优先持久记忆：默认在本地机器运行，无云端依赖，不强制要求 Hugging Face 账户
2. 多智能体统一记忆：同时支持 Claude Code、Codex、pi、Hermes，所有智能体的会话写入统一格式，一次配置全平台生效
3. 增量索引：每次会话结束后自动增量索引新 turn，无需反复对全量历史做嵌入
4. 混合检索：结合向量检索（Vector Search）、BM25 关键词匹配与 Cross-Encoder 重排序，召回质量优于单一检索方式
5. 溯源检索（Recall）：返回原始文本而非摘要，精确标注来源的智能体、时间戳、会话 ID 与 turn 编号
6. 跨机器记忆同步（可选）：支持绑定 Hugging Face Hub 私有数据集，将记忆同步至其他机器，支持访问控制
7. 凭证自动脱敏：发布至 Hugging Face Hub 前自动清理敏感凭证
8. recall 与 get 工具：智能体可在对话内直接调用 recall 命令召回记忆，get 命令打开完整 turn 及上下文

技术原理

Funes 的技术实现包含以下关键环节。

会话轨迹解析：将各受支持智能体（Claude Code、Codex、pi、Hermes）的会话日志解析为统一的 turn-and-block 结构，确保跨智能体记忆格式一致。

嵌入与索引：在本地使用固定模型对每个 turn 进行嵌入，写入本地 Lance 数据集。嵌入在本地执行，敏感内容不出本机。

混合检索 pipeline：查询时同时执行向量检索与 BM25 关键词搜索，融合两种排序结果后通过 Cross-Encoder 做重排序，并结合时间衰减因子提升近期内容权重，同时附加相邻 chunk。

可选 Hugging Face Hub 同步：用户可选择将本地 Lance 数据集推送至 Hugging Face Hub 私有数据集，实现跨机器记忆同步。发布前自动执行凭证脱敏。

性能表现

在 Hugging Face 官方发布的 handoff-vs-recall 基准测试中，Funes 的召回成本比传统对话压缩方案低 8 倍，比人工撰写交接文档方案低 4 倍。这意味着团队在长程开发任务中可显著降低 Token 消耗与重复试错成本，同时保持可追溯的技术决策记录。

特色优势

1. 完全本地：无需任何云端服务，不强制注册账户即可使用
2. 多智能体统一：Claude Code、Codex、pi、Hermes 共用同一记忆层，一次索引全平台可用
3. 零额外模型调用：在本地完成嵌入和重排序，不依赖额外 API
4. 记忆即数据集：记忆以 Hugging Face Dataset 格式存储，可版本控制、可分享
5. 增量更新：新会话的增量索引成本远低于重新嵌入全量历史
6. 凭证安全：自动脱敏机制确保发布至云端前清理敏感信息

应用场景

1. 跨会话项目上下文召回：开发者在切换智能体或开启新会话时，可直接召回上一个会话中的技术决策与错误记录
2. 团队知识共享：通过 Hugging Face Hub 分享项目记忆，新成员加入后可快速了解历史上下文
3. 多智能体协同开发：不同智能体在不同任务中产生的经验可被统一召回
4. 代码审查与交接：项目交接时无需手动撰写文档，直接移交 Funes 数据集即可

适用人群

1. 个人开发者：使用 Claude Code、Codex 等工具进行日常编码，希望保持项目记忆连贯性
2. 开发团队：需要在多个开发者或多个智能体之间共享项目上下文
3. AI 研究者：关注编码智能体长期记忆与上下文管理的前沿技术
4. DevOps 工程师：管理大量自动化脚本和基础设施代码，需要跨项目召回技术决策

出品方

Hugging Face（联合创始人兼项目主导 David Corvoysier），开源 AI 平台，总部位于纽约，全球最大 AI 开发者社区，平台拥有超过 100 万个模型和数据集。

更新动态

2026 年 9 月 3 日正式发布首个版本，支持 Claude Code、Codex、pi、Hermes 四大编码智能体，提供单一二进制分发包，安装后一条命令即可接入目标智能体。

官网链接

项目官网：https://huggingface.co/blog/funes 安装命令：curl -fsSL https://huggingface.co/buckets/huggingface/funes/resolve/install.sh | sh GitHub：https://github.com/huggingface/funes