docs(memory): 记录全局记忆补 dev-cache-layout 规范约定 + 纠正两处不准确说法

This commit is contained in:
admin committed 2026-11-04 09:41:02 +08:00
1 parent 1086495361
commit 5c0935e874
1 file changed
+35
+35
View File
@@ -56,3 +56,38 @@ CannotCache(incremental): ["--crate-name", "probe", ..., "-C", "incremental=..."
- 技能里引用的 8 个路径全部真实存在;4 条诊断命令(`Cache location` / `Cache hits` /
`du -sh -H` / `ls -la` 看箭头)全部实测跑通。
- 三端软链确认指向真源。
## 全局记忆(用户级 MEMORY.md)补「编译配置必须遵循 dev-cache-layout 规范」
文件:`~/.workbuddy/user-8561188d-ef2b-478d-aabf-d774fe15713c-personal/MEMORY.md`
(**同时是 `~/.claude/CLAUDE.md` 的软链 ⇒ 改一次两端生效**;7582B → 8866B)
### 加了什么
- 🔴 §2 顶部新增**硬约定**:「各种编译配置必须遵循 `dev-cache-layout` 技能规范」——
涉及构建缓存布局 / 编译产物放哪 / 缓存软链 / 中间产物能不能清 / sccache 接线 /
沙箱缓存挂载,**先读技能再动手**;技能里的实测数据优先于记忆与旧文档。
- §2 补 Rust 硬约定:项目根 `Cargo.toml` 须设 `[profile.dev] incremental = false`;
判 sccache 好坏只看 `Cache hits`。
- §2 补清理纪律:`cargo clean`(禁 `rm -rf target/`)+ 清前 `pgrep`。
### 🔴 顺带纠正了记忆里两处**不准确**的说法
1. **「唯一回收入口 `xstudio/scripts/reclaim-space.sh`(幂等 + pgrep 闸门),周度自动化周日 03:00」**
—— 「周度自动化」**根本不存在**:脚本内无 launchd agent、系统无 crontab 条目、
`~/Library/LaunchAgents/` 只有 `com.xstudio.dev` / `com.xstudio.kernel.ccc`(都无关)。
且该脚本 `cd` 到自己目录后按**相对路径**清(`source/rust/target`、`plugins/*/rust`、
`plugins/*/.build`)⇒ **只覆盖 xstudio,不含其它项目**(ssw-platform 不在其内)。
已改成如实描述(标明作用域 + 明写「别信周度自动化那句」)。
2. **「唯一回收入口」的说法本身** —— 删掉「唯一」二字:清 `target/` 的正常入口是
`cargo clean`,reclaim 脚本只是 xstudio 工作区的额外手段。
### 依据的核实(不是凭印象改)
| 核实项 | 方法 | 结果 |
|---|---|---|
| reclaim 脚本作用域 | 读 `XSTUDIO_DIR` + `cd` + 相对路径 | 只管 xstudio |
| 周度自动化是否存在 | `ls ~/Library/LaunchAgents/` + `crontab -l` | **不存在** |
| 技能表述是否一致 | grep 技能里 `reclaim` | 技能写「xstudio 工作区还有…」,未说「唯一」⇒ 一致,无需改技能 |
| 软链是否完好 | `readlink ~/.claude/CLAUDE.md` | ✅ 指向 MEMORY.md |