Claude Code 总忘项目上下文?这个 Git 原生记忆层让 AI 真正记住你的代码规范

每次打开 Claude Code,都要重新跟它讲一遍项目规范?

这不是你的错觉——AI 编程代理天然「失忆」,每次新会话都是从零开始。你花了 10 分钟解释的架构约定,下次它就忘了。

Knowledge Graph 就是来解决这个问题的。它把你的文件操作和 Git 历史变成一个轻量级的记忆层,直接跑在你项目仓库里,跨会话持久化,零额外依赖。


它是怎么工作的?

装好之后,它会在你项目里做几件事:

  • 自动生成 CLAUDE.md:每个模块一份 ≤20 行的知识节点,记录规范、禁忌、修改时机
  • 钩子追踪文件操作:Read/Write 全记录,第一次访问新模块时自动推断共变依赖
  • 会话快照注入:每次启动或 /clear 后,自动把上次的上下文塞回去,不用你重新介绍
  • 错误预判:基于真实共变历史,提前告诉你哪些模块改的时候要注意哪些坑

核心逻辑用纯 bash + jq 在会话边界跑,几乎不消耗 Token,不像那些每次查询都要调用 Embedding 接口的方案。


为什么值得装?

最直接的理由:装完之后,AI 真的开始「懂」你的项目了。

开发者自己测的反馈:目标达成率和「这真是我想要的」比例直接跳了 10 倍,他说「10 倍是地板,不是天花板」。

相比其他方案,它的优势在于:

Knowledge Graph Neo4j 类 Vector DB 类
存储 项目里的纯文本文件 Neo4j + Docker ChromaDB + Python
依赖 只需 jq Neo4j + Node.js Python + ChromaDB
Token 消耗 几乎为零 每次查询都花钱 Embedding 费用
跨团队共享 Git push 即可 需要手动导出 需要手动导出
多代理支持 ✅ MCP

而且支持 Claude Code / Codex / Cursor / Windsurf 所有主流 AI 编程工具——团队里有人用 Codex,有人用 Claude Code,装一份知识图谱,大家读的是同一套上下文,不再出现「Claude Code 知道这个坑,Codex 不知道」的情况。


怎么安装?

macOS / Linux:

bash <(curl -fsSL https://raw.githubusercontent.com/hilyfux/knowledge-graph/main/standalone/install.sh) /path/to/your-project

Windows(PowerShell):

git clone https://github.com/hilyfux/knowledge-graph.git
cd knowledge-graph
.standaloneinstall.ps1 C:pathtoyour-project

装完重启 Claude Code,然后运行 /knowledge-graph init 初始化即可。之后每次对话,钩子自动在后台跑,你感受不到它的存在,但它一直在帮你记。


说真的,AI 编程工具越来越强,但「失忆」这个问题一直没人正面解决。Knowledge Graph 找到了一个优雅的切入点——不靠大模型硬记,不靠外部服务,就在你的 Git 历史里找答案。

对于经常被 Claude Code「重新认识项目」这件事搞烦了的开发者,这个工具值得一试。

🔗 GitHub:https://github.com/hilyfux/knowledge-graph


GitHub: https://github.com/hilyfux/knowledge-graph

评论区

0 条评论

登录后可评论。

林小秋 15 阅读