Hugging Face 推出開源工具 funes,為編碼智能體提供可檢索的持久記憶
Give Your Coding Agents a Memory You Own
Hugging Face 推出開源工具 funes,讓 Claude Code、Codex、pi 和 Hermes 共用可檢索的持久記憶。funes 預設在本機索引、嵌入及重排工作記錄,檢索時返回原文並標示智能體、時間戳、工作階段和回合;記憶亦可發布至預設私有的 Hugging Face 資料集,供其他機器使用。
funes 將不同編碼智能體的工作記錄轉為本機可檢索記憶,並保留原始片段及來源脈絡,展示跨會話延續決策依據的實作方式。
我會在多部電腦上工作,並按不同任務切換編碼代理程式。 每個代理程式初次接觸我的項目時都像陌生人。工作階段結束後, 「上星期二」的推理便消失。每個新代理程式在每部新主機上都要從零開始。
今年較早時,軟件會遺忘:代理程式軌跡就是記憶一文指出,編碼代理程式其實已在產生我們不斷失去的紀錄。它們搜尋程式碼庫、嘗試不同方法、遇到錯誤、閲讀文件和改變方向時,會留下詳盡記錄,不只説明改了甚麼,也記錄為何而改。
這個診斷是正確的,但軌跡只是潛在記憶。代理程式的工作階段日誌仍然只是檔案庫。你無法靠 grep 從一萬個回合中找出「我們為甚麼不用串流解析器?」。代理程式要在工作時使用這些軌跡,就必須為它們建立索引、檢索和排序,並提供精確來源。
funes 正是為此而設。它是 Claude Code、Codex、pi 和 Hermes 等代理程式的持久記憶層,利用你電腦上已有的工作階段建立。它在本機運作,只需一條指令便可融入代理程式的日常工作流程。你亦可選擇將記憶同步至自己擁有的 Hugging Face 數據集,預設為私人。
為你正在使用的代理程式加入記憶
funes 是單一執行檔。預設推論後端毋須依賴機器學習執行環境,嵌入和重新排序都會在你的電腦上執行。安裝方法:
curl -fsSL https://huggingface.co/buckets/huggingface/funes/resolve/install.sh | sh
然後將它加入代理程式:
funes add claude # or: codex, pi, hermes
這條 add 指令會建立第一個索引,為代理程式提供 recall 和 get 工具,並安裝自動化程序,為每個已完成的回合建立索引。索引採用增量方式,新執行只會加入新回合,不會重新嵌入整段歷史記錄。較舊和更深層的內容亦可分批迴填。
之後照常工作即可。任務涉及過往決策、原因或發現時,代理程式可以自行呼叫 recall。你毋須記起舊工作階段,或把當時的上下文貼到新工作階段。
加入 funes 後,對話中便可直接檢索記憶。代理程式會自行查找,並指出答案來自哪個工作階段。
recall 會傳回原文而非摘要,並準確指出內容來源(代理程式、時間戳記、工作階段和回合)。每項結果亦會附上 get 指令,開啟該完整回合及其上下文。
底層採用確定性流程,將每種支援的軌跡解析成相同的回合和區塊結構,然後分塊、使用固定版本的本機模型嵌入,並寫入本機 Lance 數據集。查詢會結合向量搜尋和 BM25 搜尋、合併排序結果、使用交叉編碼器重新排序候選內容,再按近期程度重新加權,並附上相鄰區塊。
這個設計為 funes 帶來三項重要特性:
- 不同代理程式共用同一份記憶:Claude Code、Codex、pi 和 Hermes 都會寫入相同結構。
recall可搜尋它們的所有歷史記錄,每項結果也會標明由哪個代理程式產生。 - 保留原始證據:寫入時不會把任何內容提煉成事實。每項結果都能追溯至產生它的回合。
recall預設在本機執行:毋須帳戶或 Hub 儲存庫。索引期間不會由託管模型處理你的工作階段;嵌入和重新排序會在你的電腦執行,推理則由編碼代理程式負責。
「代理程式把你當陌生人」的問題,在單一電腦上已經解決。但下一個代理程式若在別處運作,記憶就更有用。
記憶是數據集,不是服務
若要讓記憶跟隨你的工作,只需在把 funes 加入代理程式時綁定一份記憶:
funes add codex acme/funes-memory
綁定時會把目前的記憶發布到該處。之後 funes 會在本機為每個回合建立索引,並在工作階段結束時發布,持續更新記憶;代理程式在整個過程中都能檢索。只要在另一部電腦執行相同指令,記憶便會跟你過去。
底層的本機記憶是 Lance 數據集,共享記憶則是你擁有的 Hugging Face 數據集,預設為私人。
內容上載至 Hub 之前,索引階段已先刪除認證資料。發布時會再掃描每個區塊,並阻止任何仍看似機密資料的內容上載。其背後的掃描器詳見 SECURITY.md,包括它的功能和限制。
代理程式讀取遠端記憶時,funes 會先把數據集檔案快取至本機,因此之後的查詢可回復本機速度。Hub 提供數據集一貫的擁有權、存取控制、版本管理和分發能力。你的記憶不會變成另一項記憶服務的帳戶,也毋須透過 API 租回來。
先詢問,再接入
recall 是為代理程式而設。若你想親自向記憶提問,請使用 ask。它預設會讀取本機記憶:
funes ask claude "what did we decide about the streaming parser"
你亦可指定共享記憶。我們公開了一份記錄 funes 開發過程的記憶,讓你不用建立自己的記憶,也能詢問 funes 為何以目前方式運作:
funes ask claude "why is funes append-only" --memory huggingface/funes-memory
funes ask是funes add的唯讀版本,一次只回答一個問題。它會檢索相關段落、交給編碼代理程式處理,再提供有根據並列明來源的答案。它不會安裝整合,也不會更改代理程式的持久設定。
若檢索不到相關內容,不會掩飾這個缺漏。段落不足以支持答案時,代理程式會如實説明。你可以改寫問題,或把 funes 加入代理程式,讓它在日常工作中反覆搜尋記憶。
切換代理程式,延續工作脈絡
共享記憶不會綁定建立它的代理程式或模型。你可以先在 Claude Code 開始任務,下星期用 Codex 繼續,第二個代理程式便能檢索第一個代理程式的推理過程。你也可以透過本機模型或 Hugging Face router 提供的模型使用 pi,然後再回到 Claude。
Claude 作出決策;hook 為決策建立索引;Codex 在另一個工作階段中檢索。示範中較舊的結果,是同一實驗早前留下的紀錄:只能新增的記憶,連排練過程也記得。
這對不同範圍的工作都很有用:
- 跨電腦:把每個代理程式綁定至同一份記憶,便能從正在使用的任何主機檢索歷史記錄。
- 跨團隊:新隊友的代理程式在第一天便能檢索數月來的決策,包括走不通的方法,以及從未寫進 pull request 的理由。
- 配合開源項目:維護者可以在發布版本時,一併發布背後的工作階段並為其命名。你可以把它想成可搜尋的
CLAUDE.md,用來保存項目演變至今的原因,而非一份必須不斷重寫的文件。任何人都可透過--memory讀取公開記憶。
已發布的記憶附有數據集卡片和 funes 標籤,因此易於辨認,亦可在 Hub 上搜尋發現。Hub 本來就託管開放權重和數據集;funes 則加入開放工作記憶,保存項目背後的決策、失敗方法和理由,供其他代理程式查詢,並追溯至產生這些記錄的工作階段。
結束長工作階段最省錢的方法
長時間調查會令工作階段愈來愈臃腫,之後每個回合用來攜帶上下文的成本甚至高於實際工作。常見做法是讓代理程式壓縮上下文後繼續,或撰寫交接摘要再重新開始。檢索是第三種做法;我們以交接與檢索基準測試比較三者:測試包含兩項任務,若沒有工作階段的先前知識,就無法重建答案。
壓縮是大多數代理程式的預設做法,也是三種方式中唯一結果不一致的方法:一項任務成功,另一項則完全失敗。失敗時,摘要把重要發現過度簡化。檢索會傳回原始段落,因此發現不必靠摘要保留下來。
兩項任務中,檢索都是三種方式裏最便宜的:一項比書面交接便宜 8 倍,另一項便宜 4 倍。
每個橫條中顏色較淡的部分,是準備檢索渠道、交接或壓縮所需的一次性費用,在提出第一個問題前支付並只計算一次。叉號表示該渠道未能完成,因此沒有每次成功的成本。
別再從零開始
「思想就是遺忘差異、概括事物、建立抽象。」 — Jorge Luis Borges,Funes the Memorious
你的代理程式早已寫下這些紀錄。funes 位於 github.com/huggingface/funes,只需一條指令,就能把紀錄轉化為下一個代理程式可讀取的記憶,無論你當時使用哪部電腦。
建基於開源技術
funes 沒有重新發明多少東西。它採用足以在本機執行的開源嵌入模型、Lance 只能新增的數據集(支援低成本增量寫入),以及 Hub 為數據集提供的快取和內容去重功能。真正的工作,是把這些技術組合成代理程式實際可用的記憶。
funes 本身亦是開源軟件。無論是安裝遇到阻礙、檢索遺漏,還是希望支援其他代理程式,都歡迎在 提出問題。
來源:Hugging Face Blog · huggingface.co



