# ai.memory — AI 记忆目录

本目录是 **CodeBuddy CLI 的项目记忆**，随仓库一起提交，用于在**不同电脑/环境**之间保持上下文连续性。

## 使用方法（在新电脑上）

1. `git clone` 本仓库。
2. 让 CodeBuddy CLI 读取本目录：
   ```
   请阅读 ai.memory/ 目录下的所有文件，了解这个工程后再开始工作。
   ```
3. 工作结束后，把新的决策/进展写回本目录并提交，保证下一台机器能接续。

## 文件清单

| 文件 | 内容 |
| --- | --- |
| `00-overview.md` | 工程是什么、目录结构、技术栈 |
| `01-build.md` | 构建系统（CMake）与编译/发布方式 |
| `02-modules.md` | 业务模块划分 |
| `03-worklog.md` | 重要决策与变更记录（按时间倒序） |
| `04-conventions.md` | 约定、注意事项、常见坑 |

## 维护规则

- **有意义的决策必须记录**：构建方式变更、删除文件、目录重构、授权/发布方式调整等。
- **只记非显而易见的信息**：代码本身能看出来的（文件路径、函数名）不必重复记。
- 记录时带**日期**和**原因(Why)**，方便日后判断是否仍然有效。