# .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、域名、用户名），
没有任何凭据。