道术法记忆系统 · 内部 README

一句话概括

把记忆当文件系统管理 — 有写入、有提炼、有归档、有搜索、有自动化维护。不用数据库，不花钱，全透明可审查。

文件地图

workspace/
├── AGENTS.md          ← 操作规则（记忆流程、回调处理、任务规范）
├── SOUL.md            ← AI 人格（语气、价值观、边界）
├── USER.md            ← 用户画像（偏好、雷区、沟通风格）
├── IDENTITY.md        ← AI 身份和职责
├── TOOLS.md           ← 工具笔记（设备、API、脚本路径）
├── MEMORY.md          ← ⭐ 长期精华记忆（道、人物、决策、热区）
├── HEARTBEAT.md       ← 心跳任务清单
├── CHECKLIST.md       ← 高频踩坑速查卡
│
└── memory/
    ├── YYYY-MM-DD.md           ← 📅 每日原始记录
    ├── YYYY-MM-DD-slug.md      ← 💾 session-memory 自动保存
    ├── lessons-learned.md      ← 📕 术：踩坑经验
    ├── procedures.md           ← 📗 法：标准操作流程
    ├── 道.md                   ← 📙 道的完整版
    ├── 专题文件.md              ← 📘 活跃专题
    │
    └── archives/
        ├── monthly-YYYY-MM.md  ← 月度摘要
        └── daily/              ← 归档的旧 daily notes

分类口诀：人格→SOUL，规则→AGENTS，流程→procedures，踩坑→lessons-learned，工具→TOOLS，道详情→道.md，长期索引→MEMORY，当天→daily，活主题→专题，死记录→归档

架构总览

┌────────────── 每次会话自动注入 ──────────────┐
│                                              │
│  MEMORY.md    ← 精华记忆（道、人物、决策）     │
│  AGENTS.md    ← 操作规则                      │
│  SOUL.md      ← AI 人格                      │
│  USER.md      ← 用户画像                     │
│  TOOLS.md     ← 工具笔记                     │
│  IDENTITY.md  ← AI 身份                      │
│  CHECKLIST.md ← 速查卡                       │
│  HEARTBEAT.md ← 心跳任务                     │
│                                              │
└───────────────── ~14.5k tokens ──────────────┘
        ↑ 自动注入              ↑ 提炼（周记 cron）
        │                      │
┌───────┴──── 主动读取（启动清单）─┴────────────┐
│                                              │
│  memory/YYYY-MM-DD.md  ← 今天 + 昨天         │
│  memory/lessons-learned.md ← 术              │
│  memory/procedures.md     ← 法               │
│                                              │
└──────────────────────────────────────────────┘
                    │
                    ↓ 按需检索
┌───────────── QMD 向量搜索引擎 ────────────────┐
│                                               │
│  memory_search → 语义搜索所有 .md 文件          │
│  315 files · BM25 + 向量混合搜索               │
│                                               │
└───────────────────────────────────────────────┘

道术法三层认知架构

业界按"短期/长期"分层。我们按认知层级分。这是认知架构创新，不是技术创新。

🌌 道 — 方向层

从反复实践中提炼的普适原则。拿掉技术背景，对不懂代码的人依然成立。

存储：MEMORY.md + memory/道.md
写入权限：飞飞 + Maddox 讨论后
数量：~17 条，极少变动
例子："从需求出发，不从工具出发"

📕 术 — 战术层

踩坑 → 解决 → 沉淀的实战记录。现实驱动。

存储：memory/lessons-learned.md
写入权限：飞飞确认后才能写入
数量：~20+ 条，持续增长
例子："编辑索引消息前必须先读原文"

📗 法 — 流程层

从术中提炼的标准操作流程。

存储：memory/procedures.md
写入权限：Maddox 自主维护
数量：~270 行，随术增长
例子："cron 任务管理六步法"

信息流动：踩坑 → 产生术 → 从术中提炼法 → 从多条法中悟出道
核心原则：知道刚好 > 知道太多。每一层只给需要的人看需要的部分。

记忆生命周期

Phase 1：写入

事件发生 → 写 daily notes → 加标签前缀

"记一下"默认只记当前话题。"把今天的都记一下"才全面回顾。

Phase 2：提炼

周记 cron（每周日 23:30）→ 按标签分类 → 更新 MEMORY.md + 热区 + 关系表

Phase 3：归档

月归 cron（每月 1 号）→ 旧 daily notes → 月度摘要 → 移入 archives/

Phase 4：检索

memory_search（QMD 混合搜索）→ memory_get 精确读取 → 注入上下文

四道防线

对话中的信息不丢失的保障体系：

1

/new 时 — session-memory hook

自动保存最后 15 条消息。安全网，自动触发，不依赖人。

2

对话中 — Pre-Compaction 深度提取

compaction 前回扫整段对话，提取偏好/决策/人物/金句。主力防线。

3

随时 — "记一下"手动触发

飞飞说"记一下"写 daily notes。最精准但依赖人。

4

每天 22:00 — 晚间复盘扫 JSONL

兜底防线。扫原始对话记录，找 daily notes 里没有的遗漏。

标签系统

写 daily notes 时，给条目标题加标签前缀。周记扫标签即可分类提炼。

[决策] 飞飞做出的选择及理由
[人物] 新认识的人或关系变化
[偏好] 飞飞表达的喜好/雷区
[教训] 踩坑经验
[洞察] 值得沉淀的思考
[项目] 项目进展/里程碑
[待办] 需要后续跟进的事

### [决策] 订货系统用 SSH 直连而不是 API
### [洞察] 道是透镜不是锤子
### [项目] 记忆系统 v2.2 投入使用

自动化 Cron 体系

记忆相关 Cron

任务	时间	作用
🏆 战果提醒	每天 21:30	问飞飞完成了哪三件事
🏆 战果追问	每天 21:50	检查归档，未记录再催
🌙 晚间复盘	每天 22:00	核对任务 + 补捞遗漏记忆
📝 周记	每周日 23:30	提炼 daily notes → MEMORY.md
📦 月归	每月 1 号 10:00	归档旧文件 → 月度摘要