Files
gjm 6c5770b754 chore: 新增 .ai-memory 记忆备份,换机器可恢复
CodeBuddy 的记忆原本只存在本机用户目录(不进版本控制),换机器即丢失。
把 5 个记忆文件备份进仓库,clone 后让助手「从 .ai-memory/ 导入记忆」即可恢复。

- README 说明用途、导入方法与维护约定
- CODEBUDDY.md 补充同步约定(改完记忆须同步本目录)
- 内容仅含基础设施信息(IP/域名/用户名),无任何密码或密钥
2026-09-27 20:27:45 +08:00

48 lines
1.8 KiB
Markdown

# .ai-memory —— AI 助手记忆备份
本目录是 CodeBuddy Code 在本项目的**持久记忆备份**。
## 它是什么
CodeBuddy 的记忆原本存放在**本机用户目录**,不进版本控制:
```
C:\Users\<用户名>\.codebuddy\projects\d-wx-scan-authorize\memory\
```
那里存的是「代码和 git 历史里看不出来」的东西:生产服务器实况、踩过的坑、
协作习惯、当前进度与待办。换一台机器这些就没了,所以在仓库里留一份副本。
## 怎么用
**换机器 / 新环境恢复:**
1. `git clone` 本仓库
2. 对 CodeBuddy 说:「从 `.ai-memory/` 导入记忆」
3. 助手会把本目录的文件写回本机记忆目录
> 注意:记忆目录名由**工作目录路径**派生(`d:\wx-scan-authorize` →
> `d-wx-scan-authorize`)。把仓库克隆到 `d:\wx-scan-authorize` 可保持目录名
> 一致;放在别的路径也能用,导入时告诉助手实际路径即可。
**日常维护:**
改完记忆后,把本机记忆目录的文件同步回本目录并提交。
CodeBuddy 每次修改记忆时都会顺手同步,不需要你提醒。
## 里面有什么
| 文件 | 内容 |
|---|---|
| `MEMORY.md` | 索引,助手每次对话自动加载 |
| `project_progress.md` | 三阶段进度、阻塞项、待办(新对话先读这个) |
| `project_server_deploy.md` | 生产服务器实况与反直觉的坑 |
| `project_cad_wxauth_integration.md` | CAD 插件集成进度与构建约束 |
| `user_shell_workflow.md` | 协作习惯(PuTTY 长命令折行、sudo 走脚本等) |
## 重要:不要在这里放密钥
本目录**会进 Git**。所有密码、token、私钥一律留在服务器的 `.env` 里,
不要写进这些记忆文件。当前文件里只有基础设施信息(IP、域名、用户名),
没有任何凭据。