# 项目记忆库设计

## 目标

在仓库内建立可持续维护的项目记忆库，保存每次对话的上下文、技术决策、变更记录和待办事项，并定期将稳定信息整理为长期记忆。

## 目录结构

```text
AGENTS.md
memory/
├── README.md
├── index.md
├── long-term.md
└── sessions/
    └── YYYY-MM-DD.md
```

## 文件职责

- `AGENTS.md`：项目级协作规则。每次任务开始先读取 `memory/index.md` 与 `memory/long-term.md`；任务结束更新当日会话记录。
- `memory/README.md`：记忆库使用说明、记录模板、整理周期和隐私边界。
- `memory/index.md`：当前项目状态、关键入口和会话记录索引。
- `memory/long-term.md`：稳定有效的架构事实、用户偏好、已确认决策和长期约定。
- `memory/sessions/YYYY-MM-DD.md`：按日期聚合的会话记录，记录目标、结论、修改文件、验证结果、风险和后续行动。

## 更新规则

1. 每次对话结束时，追加或更新当天的会话文件。
2. 只记录可复用的项目上下文，不记录密码、Token、地图密钥或其他敏感值。
3. 用户明确确认的决策进入 `long-term.md`；临时猜测只放在当日会话文件。
4. 每累计 5 次会话，或当日会话文件超过约 20 KB，整理一次长期记忆并更新索引。
5. 过期内容不直接删除，改为标记为“已废弃”或移动到 `memory/archive/`（如确有需要）。

## 兼容性

该方案只增加 Markdown 文档和目录，不参与 Vite 构建，不改变运行时行为，不增加 npm 依赖。

## 验收标准

- 新会话可以通过 `AGENTS.md` 找到记忆库入口。
- 记忆库包含规则、索引、长期记忆和至少一个会话记录模板。
- 记录中不出现敏感配置值。
- 不影响现有 `npm run dev`、`npm run build:prod` 等项目脚本。