funes：为编码智能体提供可自托管的持久记忆层

背景

编码智能体在运行中会留下大量会话记录，其中包含它如何搜索代码、尝试方案、遇到错误和改变方向的过程。但这些日志本质上是归档：会话结束后，推理过程就消失了，换一个智能体或一台机器又要从零开始。要在工作中使用这些记录，还需要索引、检索、排序和可追溯的来源。

funes 是什么

funes 是 Hugging Face 于 2026 年 9 月 3 日发布博客介绍的开源记忆层，支持 Claude Code、Codex、pi 和 Hermes。它由本机已有会话构建，以单个二进制形式提供，默认推理后端不依赖 ML 运行时，嵌入和重排都在本机完成。

用 funes add claude（或 codex、pi、hermes）接入后，它会建立首个索引，为智能体提供 recall 和 get 工具，并安装对每个已完成回合进行索引的自动化。索引是增量的：新运行只添加新回合，较旧内容可分步回填。

检索方式与数据形态

• recall 返回原文而非摘要，并标注来源：哪个智能体、时间戳、会话和回合；每条结果附带 get 命令可打开完整回合及上下文。
• 底层管线把各智能体的轨迹解析为统一的回合-块结构，分块后用固定本地模型嵌入，写入本地 Lance 数据集。
• 查询时结合向量与 BM25 搜索，融合排名，用 cross-encoder 重排，按时间远近加权，并附加相邻块。
• 写入时不蒸馏为“事实”，原始证据保持完整；多个智能体写入同一形态，recall 可跨其历史检索。

共享与隐私

funes add codex acme/funes-memory 可把记忆绑定到自有 Hugging Face 数据集（默认私有），本地逐回合索引、在会话边界发布，其他机器运行同一命令即可接续。发布前凭据已在索引阶段脱敏，发布时再扫描每个块并拦下疑似密钥，扫描器覆盖范围记录在 SECURITY.md 中。读取远程记忆时本地缓存数据集文件，Hub 提供所有权、访问控制、版本管理和分发能力。

ask 与评测

funes ask 是只读的单问题入口，默认读取本地记忆，也可用 --memory 指向共享记忆；它召回段落交给编码智能体，返回带来源的答案，不改变智能体持久配置。若段落不足以支撑答案，智能体会明确说明。

作者在 handoff-vs-recall 基准的两个任务上比较了压缩、手写交接与 recall：压缩在其中一项任务上给出结果、另一项未达成；recall 在两个任务上都比手写交接便宜，分别约为 8 倍和 4 倍。该结果来自作者自述，任务数量有限。

评论区有用户报告在约 1.9 万条会话上运行 funes 1.3.0 的实测数据，并指出默认 30 天近期性半衰期会压低较旧历史的首位命中，作者回应称 LongMemEval 类任务用 BM25 即可，funes 的价值在于信息确实难以查找的场景。这些均为用户自述，未经独立验证。