🔄 卡若AI 重建本地主仓 | 保留有效小文件

01_卡资（金）/金仓_存储备份/群晖NAS管理/参考资料/TimeMachine_排除与纳入清单.md

@@ -0,0 +1,60 @@
+# Time Machine · 排除与纳入清单
+
+> 更新：2026-06-04 | 金仓
+
+## 必须纳入备份（勿排除）
+
+| 路径 | 体量（约） | 状态 |
+|:---|:---|:---|
+| `~/Documents/个人`（含卡若AI） | 大 | **Included** |
+| `~/Documents/开发` | **~58GB**（源码进；`node_modules` 等不进） | **Included** |
+| `~/数据库`（配置/脚本等） | 部分 | **纳入** |
+| `~/数据库/mongodb/data` | **~71GB** | **Excluded**（运行中 · 防 TM 卡死） |
+| `~/数据库/mysql` | **~9.5GB** | **Excluded**（Docker MySQL 在写） |
+| Docker `Data/vms` / `Docker.raw` | **~27GB** | **Excluded**（VM 热盘） |
+| 微信 `com.tencent.xinWeChat` | ~77GB | **Included**（脚本永不排除） |
+| Docker `com.docker.docker` 等 | **~27GB** | **Included**（已取消排除） |
+
+> MongoDB 运行中备份可能不一致；重要库另有 NAS/腾讯云同步（G13a）。TM 作整机兜底。
+
+## 固定排除（`tm_lan_speed_boost.sh`）
+
+| 路径 | 原因 |
+|:---|:---|
+| ~~`~/Documents/开发`~~ | **目录已纳入**；其下 `node_modules`/`.git` 等仍单独排除 |
+| `~/Library/Mobile Documents` | iCloud 小文件极多 |
+| `~/Library/CloudStorage` | 云盘同步目录 |
+| `~/Library/Application Support/MobileSync` | iOS 备份 |
+| `~/Library/Caches` | 缓存可重建 |
+| `~/Library/pnpm` / `~/.npm` | 包缓存 |
+| `~/Library/Group Containers` | 容器缓存 |
+| `~/Library/Logs` | 日志 |
+| `~/Library/Application Support/Cursor` | IDE 缓存 |
+| ~~`~/Library/Containers/com.docker.docker`~~ | **已纳入备份** |
+| `~/Library/Developer/Xcode/DerivedData` | 编译产物 |
+| `~/Library/Developer/CoreSimulator` | 模拟器 |
+| `~/Downloads` | 下载目录 |
+| `~/.Trash` / `~/.local/share/Trash` | 废纸篓 |
+| `~/.gradle/caches` / `~/.m2/repository` / `~/.cache` | 构建缓存 |
+
+## 动态排除（find 扫描，最多 200 项）
+
+在 `~/Documents`、`~/Library` 下匹配且**已排除**的目录名：
+
+`node_modules` · `.git` · `__pycache__` · `.venv` / `venv` · `dist` / `build` · `.next` / `.nuxt` · `target` · `.turbo` · `.parcel-cache` · `.pytest_cache` · `.tox`
+
+（不含微信路径）
+
+## 可选排除
+
+| 环境变量 | 路径 |
+|:---|:---|
+| `TM_EXCLUDE_PHOTOS=1` | `~/Pictures/Photos Library.photoslibrary` |
+
+## 恢复纳入备份
+
+```bash
+sudo tmutil removeexclusion -p "/路径"
+# 若有 xattr：
+sudo xattr -d com.apple.metadata:com_apple_backup_excludeItem "/路径"
+```