给 Claude Code 装上自我进化与长期记忆系统｜AI笔记

Fri, 12 Jun 2026 00:12:55 +0800

本文是一份技术设计文档,记录如何为 Claude Code 构建一套跨会话的自我进化 + 长期记忆系统:用 Hook 确定性地观测行为,会话结束后自动提炼行为规律与项目知识,下一次对话通过向量召回主动注入,使其逐步演化为更贴合个人习惯的编程伙伴。

文中所有路径、依赖均为示例,可按自己环境替换。系统面向单用户、纯本地场景。

一、背景与动机

每次新开一个 Claude Code 会话,它都是一张白纸:昨天解释过的项目架构、反复纠正的代码风格、约定好的开发规范,全部归零。每个新会话都要花若干轮对话、约十分钟把模型"带入状态"。

我们想要的不只是被动记忆,而是主动学习:观测自己的真实行为,提炼出规律与项目知识,下次自动应用。本文介绍的系统就是为此设计的。

整个系统是一个自学习闭环,由三个子系统构成:

行为观测层(Observation) —— Hook 100% 捕获工具调用,落盘为观测流。
模式提炼层(Instinct) —— 会话结束时分析观测流,提炼为带动态置信度的原子规则。
记忆注入层(Memory) —— 把知识性记忆向量化,会话开始时按相关性召回并注入上下文。

二、系统总览

会话进行中
  └─ 每次工具调用 ─→ observe ─→ observations.jsonl

会话结束(Stop hook)
  └─ stop_runner
       ├─ 非阻塞锁(拿不到就跳过,不拖会话)
       ├─ rotate(归档,防膨胀)
       └─ 后台 detached 拉起 analyze
            ├─ 路径 A:统计检测器 ─→ instincts/*.md
            ├─ 路径 B:语义分析(LLM,带闸门)─→ instincts + 候选记忆
            └─ evolve ─→ 去重 + 聚合 ─→ rules/auto-evolved.md(覆盖重写)

下次会话开始(SessionStart hook)
  └─ inject_memory_context
       ├─ 构造查询(项目名 + 最近 commit)
       ├─ 双层召回(全局偏好 + 当前项目记忆)→ Top-K
       └─ stdout 注入(规则 + 记忆)→ 进入 Claude 上下文

两条互补的记忆维度:

Claude Code on MekeyPan

给 Claude Code 装上自我进化与长期记忆系统｜AI笔记

一、背景与动机

二、系统总览