syncable-dev/memtrace-public
Structural memory for AI coding agents. Bi-temporal graph, MCP-native, zero LLM calls. Cursor · Claude Code · Codex · Hermes · VS Code · Windsurf.
它解決了什麼問題
Memtrace 為 AI 程式編寫代理提供「結構化記憶」,防止它們在處理大型程式碼庫時失去上下文或破壞相依性。它消除了代理必須不斷重新閱讀檔案的需求,並解決了「盲目重構」的問題——即代理在未了解其修改全域影響範圍的情況下進行變更。
它如何運作
Memtrace 將程式碼庫轉換為即時、雙時間軸的情節式結構知識圖譜。與使用 LLM 推斷關係的一般記憶系統不同,Memtrace 使用 Rust 與 Tree‑sitter AST 解析器,在本地以確定性的方式解析符號(函式、類別、介面)及其關係(呼叫、匯入、實作)。
它在標準 AST 圖上加入了兩個關鍵維度:
- 時間記憶:追蹤每個符號的完整版本歷史,讓代理能查詢「什麼變更了、什麼是意外的、或根據六種不同的評分演算法會導致什麼破壞」。
- 跨服務 API 拓撲:映射不同儲存庫之間的 HTTP 呼叫圖,以偵測服務對服務的相依性。
目標使用者
使用 AI 程式編寫代理(如 Claude Code、Cursor、Windsurf 或 VS Code Copilot)的開發者,需讓其代理對複雜的多語言儲存庫擁有深度且持久的理解。
重點特色
- 高效能:在不到 2 秒的時間內索引 1,500 個檔案,且無 API 成本,遠快於基於 LLM 的記憶系統。
- MCP 原生:透過 Model Context Protocol 暴露超過 25 個工具,用於搜尋、關係分析、影響分析與圖演算法。
- 廣泛語言支援:支援 20+ 程式語言,並提供針對後端 HTTP(Express、FastAPI、Django 等)、CI/CD(GitHub Actions)與資料庫(PostgreSQL RLS)的框架感知掃描器。
- 隱私優先:完全在本機執行;原始碼永不離開環境。
- 代理技能:內建 17 個預建技能/指導提示,教導代理如何串接工具完成如事件調查與重構指南等任務。