Synapse v1.5：给 Claude Code 的轻量化图记忆 Skill

CodeGraph 让 AI 更懂“代码在哪里”。Synapse 想解决另一个更日常的问题：AI 下次回来时，还记得这个项目做到哪了吗？

GitHub: LameGz/synapse-graph-skills

如果你长期用 Claude Code 写项目，应该会遇到一个很熟悉的时刻：

你隔了三天回到一个项目，问 AI：“支付这块做到哪了？”

AI 很认真地开始扫代码、读 README、翻提交、grep 关键词。十分钟后，它大概能拼出一个答案，但你心里知道：它不是“记得”，它是在现场考古。

这就是 Synapse 想解决的问题。

Synapse v1.5 是一套以 Claude Code Skills 形式发布的个人工程记忆工具。它不做服务器，不做 MCP，不做 Web UI，不引入向量数据库。它只做一件事：把一个项目的工程上下文整理成一张轻量图，让 AI 每次回来都能按图恢复状态。

---

痛点：AI 很会读代码，但不擅长记住工程状态

代码搜索工具解决的是“现在代码长什么样”。

但开发者经常问的不是这个。

我们真正会问的是：

• 这个功能做到什么程度了？
• 上次为什么选了这个方案？
• 改这个模块会影响哪些功能？
• 还有哪些 open issues 没处理？
• 前端按钮到数据库表之间的链路怎么走？
• 我三天没碰这个项目了，先从哪继续？

这些答案一部分在代码里，一部分在提交里，一部分在对话里，还有一部分只存在于你当时的脑子里。

问题是：Claude Code 的会话会结束，人的短期记忆会丢，代码本身也不会解释“为什么当时这样设计”。

所以我们需要的不是又一个“更强的 grep”，而是一层专门给 AI 读取的工程记忆。

---

和 CodeGraph 的关系：都是图，但不是同一张图

CodeGraph 是一个很优秀的代码图工具。它用代码符号、调用关系、文件结构来建立图谱，回答的是：

• 这个函数在哪里定义？
• 谁调用了这个方法？
• 这个类和哪些模块有关系？
• 我应该读哪些源码文件？

Synapse 也用图，但节点不是函数、类或符号，而是工程记忆单元。

比如：

• project：项目整体状态
• module：一个后端模块、SDK、服务边界
• feature：一个业务功能
• database_table：一张关键表
• api_endpoint_group：一组 API
• ui_page：一个页面或交互入口
• deployment：部署、环境、配置单元

CodeGraph 的图更接近“代码城市地图”：街道、楼房、门牌号都标得很清楚。

Synapse 的图更像“工程师的项目作战地图”：哪里还没修、哪里容易炸、哪个路口绕行、为什么当时没有走另一条路。

两者并不冲突。

CodeGraph 适合做代码级理解。Synapse 适合做项目级记忆恢复。

一句话区分：

CodeGraph 回答“代码怎么连”。Synapse 回答“项目怎么继续”。

---

Synapse 是什么？

Synapse v1.5 是一个 Claude Code 个人工程记忆 Skill 套件。

它的核心设计很克制：

• Markdown 是真相源。
• SQLite 只是可重建缓存。
• 不需要常驻服务。
• 不需要向量数据库。
• 不要求团队协作平台。
• 不把所有记忆一次性塞进 context。

项目里会有一个 meta/ 目录，每个 Markdown 文件是一个记忆节点。节点之间用 depends_on、auto_linked 和自动计算出的 blocks 形成图拓扑。

Claude Code 需要恢复上下文时，不再暴力读取所有记忆，而是走三层渐进加载：

1. 先读 MEMORY_MAP.md，用摘要、标签、关键词定位目标节点。
2. 再读目标节点，确认是否足够回答问题。
3. 只有在需要影响分析或链路追踪时，才做有限 BFS 展开依赖。

这让 AI 从“全仓库考古”变成“按地图导航”。

---

v1.5 新增了什么？

v1.5 的重点不是堆功能，而是把 Synapse 从“能跑的实验”收束成“可发布的产品形态”。

主要变化有五个：

• 四个独立 Skill 套件：synapse-graph-memory 是核心，synapse-init、synapse-daily-note、synapse-timeline 可以按需安装。
• 七类工程节点统一：正式使用 project、module、feature、database_table、api_endpoint_group、ui_page、deployment。
• Memory Inbox 产品化：低置信度自动记忆进入 .synapse/inbox.json，支持去重、查看、应用、清空。
• Project Resume：支持“继续这个项目 / 上次做到哪 / 恢复上下文”这类真实工作流。
• Release Hardening：发布检查覆盖 MAP、SQLite 可选路径、Inbox、Resume、fullstack fixture 和文档一致性。

这意味着 Synapse 已经不只是几个脚本，而是一套围绕 Claude Code 工作流闭环的个人工程记忆产品。

---

Synapse 的优势

1. 轻量

Synapse 不需要你起服务，不需要维护数据库实例，也不需要理解 MCP 配置。

它本质上是一组 Skill + Hook + Markdown 文件。最坏情况下，即使脚本都坏了，你仍然可以打开 meta/*.md 手改记忆。

这对个人开发者很重要。

一个人的工具不能像团队平台一样重。它必须能随手装、随手迁移、随手修。

2. 可解释

向量检索经常能“找得差不多”，但很难解释为什么加载了这些内容。

Synapse 的路径是显式的：

MEMORY_MAP -> feat_payment -> depends_on: api_payment -> blocks: ui_checkout

AI 为什么读这个节点，为什么继续读下一个节点，都能从图上解释。

这对工程记忆尤其关键，因为“差不多相关”不够。改支付状态字段时，你要知道到底会影响哪些页面和接口。

3. 面向工程状态，而不是通用聊天记忆

很多 memory 产品关注“AI 记住用户偏好”：你喜欢 TypeScript、你偏好函数式风格、你住在哪。

Synapse 关注的是：

• 哪个功能还没做完？
• 哪个接口已经接好？
• 哪个数据库表会影响哪些页面？
• 哪个决策是上周定下来的？
• 哪个节点已经 stale？

这不是用户画像记忆，而是工程状态记忆。

4. 和 Claude Code 工作流贴合

Synapse 不是独立知识库，而是直接嵌进 Claude Code 的读写节奏：

• 初始化项目时生成节点骨架。
• 开发中可以用一句自然语言记录变更。
• session-end 自动观察代码和对话。
• 高置信度记忆自动写入。
• 低置信度记忆进入 Inbox 待审。
• 下次回来用 Resume 恢复项目状态。

这让记忆不是“另一个你要维护的系统”，而是开发过程的一部分。

---

产品定位

Synapse 的定位不是“替代 CodeGraph”，也不是“做一个通用第二大脑”。

更准确的定位是：

Synapse 是 Claude Code 的个人工程记忆层。

适合的人群：

• 一个开发者同时维护多个项目。
• 项目经常中断，几天后再回来继续。
• Claude Code 是主要开发搭档。
• 不想维护重型服务或知识库。
• 希望 AI 能记住项目进度、设计决策、模块影响和待办。

不适合的场景：

• 你需要跨语言 AST 级调用图分析。
• 你要做团队级知识平台。
• 你需要多人权限、审计、Web UI、云同步。
• 你只想知道某个函数在哪里被调用。

如果你只需要代码级图谱，CodeGraph 更适合。

如果你的痛点是“AI 总是不知道项目做到哪了”，Synapse 才是正对的问题。

---

未来：Synapse 应该成为 CodeGraph 的上层记忆

长期看，Synapse 和 CodeGraph 最好的关系不是竞争，而是分层。

CodeGraph 负责底层代码事实：

• 符号
• 调用
• 引用
• 文件结构
• 代码级影响

Synapse 负责上层工程记忆：

• 进度
• 决策
• open issues
• 模块契约
• 产品语义
• 项目恢复

未来理想链路是：

CodeGraph: 这个函数被哪些地方调用？
Synapse: 这些调用分别属于哪些功能、页面和业务链路？改它会影响哪几个未完成任务？

也就是说，CodeGraph 可以成为 Synapse 的代码事实输入源，而 Synapse 负责把这些事实组织成 AI 能直接用于继续工作的工程记忆。

---

结语

AI 编程工具越来越强，但“记住项目”这件事还远远不够自然。

代码可以被重新扫描，依赖可以被重新分析，但工程上下文不应该每次都从零恢复。

Synapse v1.5 的目标很小，也很明确：

让 Claude Code 下次回来时，不是重新认识你的项目，而是继续你的项目。

这就是图记忆的价值。

不是为了炫技，而是为了少一点考古，多一点继续。

---

项目地址：https://github.com/LameGz/synapse-graph-skills