raiyanyahya/recall

解決的問題

Recall 解決了 Claude Code 等 AI 編碼代理的「冷啟動」問題，即每次新會話開始時都缺乏對之前工作的記憶。它消除了每次會話開始時手動重新解釋專案目標、當前進度和待辦事項的需要，同時避免了將會話歷史發送至外部 LLM 進行摘要所帶來的高 token 成本和隱私風險。

工作原理

Recall 在 .recall/ 目錄中維護兩個本地 Markdown 檔案：

• history.md：一個僅追加的日誌，記錄會話期間發生的每個提示、回應、檔案變更和命令執行。
• context.md：專案當前狀態的精煉摘要，包括目標、涉及的檔案和下一步行動。

Recall 不使用 LLM，而是使用基於 TF-IDF 和 TextRank 的經典本地 Python 摘要演算法，從歷史記錄中提取最核心的句子並生成摘要。此過程完全在使用者機器上本地執行，無需 API 金鑰或網路呼叫。

適用對象

使用 Claude Code 或 OpenCode 的開發者，希望在多個會話之間以持久、隱私保護且成本低廉的方式維護專案記憶。

特點

• 零 token 成本：摘要由本地演算法完成，而非 LLM 調用，節省使用額度。
• 完全本地且私密：資料不會離開機器；轉錄和摘要均本地儲存，從不發送至外部 API。
• 零摩擦：無需複雜安裝或本地模型設定；摘要器已打包，使用標準 Python 套件。
• 與代理無關：雖然專為 Claude Code 構建，但也可整合到 OpenCode 等其他代理中，因為它將記憶儲存為普通 Markdown 檔案。