# 项目记忆库

本目录保存城市生命线项目的持续上下文，作为跨对话协作时的事实来源。

## 文件职责

- `index.md`：项目当前状态、关键入口、已知风险和会话索引。
- `long-term.md`：稳定有效的架构事实、长期决策、用户偏好和协作约定。
- `sessions/YYYY-MM-DD.md`：按日期聚合的会话记录。
- `archive/`：仅在整理时存放不再活跃的历史记录，按需创建。

## 会话记录模板

```md
## 会话：YYYY-MM-DD

### 目标

### 结论与决策

### 文件变更

### 验证结果

### 风险与待办
```

## 更新流程

1. 新任务开始前读取 `index.md`、`long-term.md` 和相关近期会话。
2. 任务过程中只记录已经核实的事实；猜测和待确认事项留在当日会话记录。
3. 任务结束后更新当日会话文件，并同步索引或长期记忆中的稳定内容。
4. 每累计 5 次会话，或当天记录超过约 20 KB，整理一次长期记忆。

## 整理原则

- 长期记忆只保留仍然有效、可复用的内容。
- 冲突信息以最新经用户确认或代码验证的事实为准。
- 过期内容标记为“已废弃”或移动到 `archive/`，不要无声删除重要决策。

## 隐私边界

不得记录密码、Token、API 密钥、地图密钥、内部账号、个人隐私和完整敏感响应。配置说明只保留变量名、用途和配置状态。