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 图上添加了两个关键维度：

  1. 时间记忆：跟踪每个符号的完整版本历史，允许代理查询“什么改变了、什么是意外的、或基于六种不同评分算法会导致什么破坏”。
  2. 跨服务 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 个预构建技能/指导提示，教会代理如何链式使用工具完成如事件调查和重构指南等任务。