# 磁盘清理与遗留项处置建议（基于 2026-09-29 只读核查）

> 全部结论来自字节级/内容级核查（文件头、同名同大小清单、大文件 MD5 抽样、跨备份覆盖度）。
> **本轮只核查、只建议，未删除任何文件。** 删除/迁移请你逐项点头，我再执行；默认全部"送回收站（可还原）"或"移外置"，不做永久删除。
> 磁盘现状：**F盘 506.2GB，可用 49.5GB，占用 90.2%**；D盘 92.2%（紧）；E盘 200GB 可用 75.8GB（可作中转）；C盘 73.2%。

---

## 一、四项决策的明确建议（速览）

| # | 项目 | 大小 | 我的建议 | 把握 | 前提/联动 |
|---|---|---:|---|---|---|
| 1 | lib 6 张 PNG | 1.54MB | **可删**（建议先移入 `_archive`） | 高（前后端零引用、文件头确认为 PNG） | 无 |
| 2a | 缓存 `cleanup -Commit` | 0.23GB | **可立即清**（可再生，保留登录态） | 高（已 dry-run 零删除验证） | 无 |
| 2b | 隔离区 `-Quarantine` | 18.80GB | **可送回收站**；不急可等观察期满 10/11 | 中高（被更近黄金备份覆盖） | 送回收站后观察几天再清空 |
| 2c | 重复副本 `-ArchiveDup` | 8.50GB | **可送回收站** | 高（GOLDEN_20260921 100%覆盖） | **必须保留 GOLDEN_20260921** |
| 2d | 旧APK `-ApkOld` | 2.33GB | **留 1 个离线完整版，其余送回收站**（约回收1.66GB） | 中高（构建产物可再生） | 先复制保留"含视频PDF"版 |
| 3a | backup_20260910（普通） | 16.84GB | **可删/送回收站**（与 GOLDEN 版字节级重复） | 很高（37960/37964同大小+大文件hash全同） | 保留 GOLDEN_backup_20260910 |
| 3b | FULL_20260916 | 32.24GB | **移外置**（不建议直接删） | 中高（被9/21、9/27基线覆盖，但体量大） | 外置盘/E盘 |
| 3c | F盘根 旧整盘备份 20260904 | 56.24GB | **首选移外置**；视频已证另有副本 | 中高（45.87GB视频hash确证在"学习资料库"） | 保留 `F:\水利智学系统\学习资料库` |
| 4 | deprecated 分批 | — | **继续观察，最早 10/01 评估，本轮不标** | — | 连续3个自动夜晚 HIGH 才走白名单 |

---

## 二、逐项证据与建议

### 1. lib 的 6 个文件 —— 确认为零引用 PNG 截图，可删
- 文件头均为标准 PNG 签名 `89 50 4E 47`：combo4 339KB、expanded 340KB、newapi 339KB、ok 340KB、test 124KB、pure 55KB，合计约 **1.54MB**。
- 前端（全文件类型）、后端（*.py）按 `elixir_expanded/ok/newapi/combo4/test/pure` 检索：**0 引用**。
- 性质：思维导图各状态的视觉对比截图，不是 JS；思维导图运行时实际加载 `/static/lib/MindElixir.stable.js`。
- **建议**：可直接删；为稳妥可先移入 `_archive/lib_PNG截图_20260929/`。空间意义不大，主要是消除"疑似实验文件"的困惑。

### 2. cleanup_disk.ps1 各开关

**2a. `-Commit`（缓存，0.23GB）—— 现在就能做，零风险**
- 构成：`backend/temp` 228.1MB + 各处 `__pycache__` 约 6.7MB + 浏览器 ShaderCache 0.5MB。
- 均为可再生缓存；脚本保留浏览器登录态（不清 Cookie/Local Storage）。已 dry-run 验证零删除逻辑。

**2b. `-Quarantine`（隔离区，实测 18.80GB）—— 可清，建议尊重观察期**
- 隔离区 README 规则：9/9 建立、观察期 30 天、计划 10/9 删除。
- 其中大头是 3 个 **9/11 治理快照**（README 清单未列）：after 7.58GB、final 7.41GB、before 3.75GB，合计 18.74GB；其余为 0.06GB 的小目录/.bak。
- 9/11 治理已稳定运行 18 天，且其后有 **9/15、9/21、9/27 三个黄金/基线备份**覆盖回滚需求。
- **建议**：不急于这 12 天的话，等 **10/11 观察期满**再清最规范；若 F 盘吃紧，现在送回收站也可（回收站=额外一层可恢复垫），送后观察 3–7 天无异常再清空回收站。

**2c. `-ArchiveDup`（重复副本_20260924，8.50GB）—— 可清，但有硬前提**
- 该目录是 9/24 从 `backend/uploads` 复制的 64 个精讲视频(8.30GB)+172 个讲义PDF(0.19GB)+3MB资料。
- **当前 `backend/uploads/videos`、`lectures` 已是空目录**，所以它现在是这些文件在项目内的唯一副本——不能只看目录名就删。
- 跨备份覆盖度核查：**GOLDEN_backup_20260921 对 64 视频、172 讲义 100% 同名同大小覆盖（缺 0）**。
- **建议**：可送回收站回收 8.50GB；**硬前提：GOLDEN_backup_20260921 必须保留**（它是唯一全覆盖备份）。

**2d. `-ApkOld`（apk_versions，2.33GB）—— 留 1 个，清其余**
- 14 个 APK：3 个 0.67GB"完整版"（响应式优化/响应式适配/含视频PDF）+ v2.1.0~v3 等 11 个小包。
- 属构建产物、可再生；但"含视频PDF"离线完整版重新打包成本高。
- **建议**：把 `水利智学系统_完整版_含视频PDF.apk`(0.67GB) 复制到 `F:\APK构建\` 留存，其余 13 个（约 1.66GB）送回收站。

### 3. backups 老旧/重复 与 F盘 56GB 旧备份

**3a. backup_20260910_145325（16.84GB）—— 字节级重复，建议删普通版、留 GOLDEN 版**
- 与 `GOLDEN_backup_20260910_144713_golden` 同为 37964 文件、同名路径 37964、同名同大小 37960（仅 4 个备份元数据文件不同）。
- 抽 5 个最大文件（CUDA 库、教材PDF、精讲视频）做 MD5 抽样：**全部相同**。两者相差 6 分钟、同源。
- **建议**：删除/回收普通的 `backup_20260910_145325`，保留 GOLDEN 版，省 16.84GB。

**3b. FULL_20260916_221857（32.24GB）—— 建议移外置，不直接删**
- 内部 backend 29.79GB（含整套 ollama 程序/模型，属每个完整备份都重复带的第三方二进制）+ _archive 2.33GB。
- 其代码/数据状态已被更近的 GOLDEN_20260921、pre_techdebt_20260927 覆盖；体量大、含完整运行时。
- **建议**：移到移动硬盘（或 E 盘，若 E 是独立物理盘），从 F 盘移除，省 32.24GB。

**3c. F盘根 `水利智学系统_代码备份_20260904_234626`（56.24GB）—— 首选移外置**
- 构成：backend/uploads 48.86GB（其中 videos 47.20GB）+ ollama 程序/模型 5.96GB + 旧 data 1.39GB + 旧前端 0.02GB。
- 与 GOLDEN_20260921 比对：**356 个文件/45.88GB 为该旧备份独有**（330 个精讲视频，9/4 后被清出项目）。
- 全盘排查这些独有视频的去向：在 **`F:\水利智学系统\学习资料库\一造培训资料`** 中按 66 种大小全部找到，**MD5 抽样 66/66 内容完全相同** → 视频并非真唯一，已被你整理进学习资料库。
- 其余：ollama 程序可重装（当前项目内有更新版 16.47GB 模型）；旧 data 有更新数据库与多个 .db 快照。
- **建议**：**最稳妥是整包移移动硬盘**（一次性省 56.24GB、零风险）。若不打算留外置，视频部分已有确证副本，可在我再核对剩余约 1.5GB 资料（lectures/split_output 等）后送回收站；不建议直接永久删除。

**3d. 必须保留 / 建议保留**
- **必留**：`pre_techdebt_20260927_201024`(30.17GB，最近、技术债治理前、本轮改动回滚基线)、`GOLDEN_backup_20260921`(16.82GB，唯一全覆盖视频/讲义)、`GOLDEN_backup_20260910`(16.84GB)。
- **建议留或外置**：`架构迁移前_黄金基线_20260906`(18.78GB，里程碑)。
- **全部保留**：backups 根下各 `shuili_exam_before_*.db` 单文件快照（合计约 1.5GB，数据回滚点，体积小）。
- **绝不删**：`backend/ollama_models`(16.47GB)、`backend/data`(9.56GB)、当前 `backend/uploads`、`F:\水利智学系统\学习资料库`。
- 可不动：backups 里大量 0GB 级 .bak/小快照（合计 <0.1GB，细粒度回滚点，留着无妨）。

### 4. deprecated 分批 —— 机制已跑通，继续观察，最早 10/01 落地第 1 个
- 夜间任务 `ShuiLi_OvernightFullRun` 今晨 **00:00 自动执行成功（结果码 0）**，deprecated_watch 于 00:06 产出第二晚快照。
- 两晚结果一致：24 对重复，**HIGH=1（仅 `POST /generate-mnemonic`）**、MEDIUM=11、LOW=12。
- 注意：第 1 条是 9/28 23:16 手动、第 2 条是 9/29 00:06 自动，间隔仅 50 分钟，**不算两个独立夜晚**。
- **建议时间线**：以 **9/29、9/30、10/01 三个自动夜晚**为准，最早 **10/01 上午**评估；若该路由三晚连续 HIGH，再由豆包核实新旧 handler 同源（业务逻辑/返回结构一致）→ 写入 `whitelist.txt` → `apply_deprecated.py` 先 dry-run 给你确认 → `--commit`（仅写 OpenAPI deprecated 文档标记，零运行时变化）→ main.py 统一应用钩子另行拍板。MEDIUM/LOW 近期一律不动。

---

## 三、空间腾挪测算（F盘 506.2GB，当前可用 49.5GB / 占用 90.2%）

| 方案 | 动作 | 释放 | 清理后可用 | 占用率 |
|---|---|---:|---:|---:|
| 第0步 | 缓存0.23 + PNG（约0.24GB） | ~0.24GB | ~49.7GB | 90.2% |
| 第1步（高把握，送回收站并清空） | 重复backup 16.84 + 重复副本 8.50 + 隔离区 18.80 + APK余 1.66 | **45.8GB** | **~95.3GB** | **~81.2%** |
| 第2步（再移外置） | FULL_20260916 32.24 + F盘旧备份 56.24 | **88.5GB** | **~183.8GB** | **~63.6%** |

> 重要操作提示：
> - "送回收站"在同盘内进行，**不会立即释放空间，清空回收站后才真正释放**；因 F 盘仅剩 49.5GB，建议**分批送、分批清空**（先处理字节级重复的 backup_20260910，清空释放后再下一批），避免一次性占用与误删风险。
> - 移外置优先于删除；外置盘或独立物理 E 盘最安全（E盘当前可用 75.8GB，可中转但 88GB 一次装不下，需移动硬盘或分两次）。

## 四、建议执行顺序（待你点头，我来操作并逐项验证）
1. 第0步：`cleanup_disk.ps1 -Commit`；6 张 PNG 移入 `_archive`。
2. 第1步（每步都送回收站、可还原，全部完成后你观察几天再清空）：
   1. 删重复 `backup_20260910_145325`（留 GOLDEN 版）；
   2. 重复副本_20260924 送回收站（确认 GOLDEN_20260921 在）；
   3. APK 留"含视频PDF"版，其余送回收站；
   4. 隔离区（急则现在，不急等 10/11）。
3. 第2步：FULL_20260916、F盘 56GB 旧整盘备份移外置（移动硬盘优先）。
4. deprecated：10/01 按夜间台账再决策，本轮不动。

> 你只需告诉我：**"按第0步做" / "第1步全做" / "第1步只做某几项" / "FULL和56GB我准备了移动硬盘，帮我移"**，我会在每步执行前后做大小与存在性核验，并保留操作日志。
