Document Git LFS space maintenance and remove obsolete image checksum

2026-10-04 14:32:07 +08:00
parent c2756ca4d6
commit a277da0f96
7 changed files with 402 additions and 3 deletions
@@ -0,0 +1,33 @@
+# Git LFS 历史本地缓存清理记录
+
+记录时间：2026-10-04T14:25:15+08:00。本次仅清理本地 Git LFS 缓存，无设备操作或软件功能变更。
+
+## 结果
+
+普通 Git 垃圾回收已由用户先行完成。本次 `.git` 从 10.471 GiB 降到 0.644 GiB，四个 LFS 缓存共回收 9.827 GiB；本地 LFS 对象由 133 个降为 129 个。三个旧 IMG 已在历史提交 `912ba43` 停止跟踪，当前无跟踪中的 IMG。远端副本通过现有 Git 登录进行验证，没有保存凭据或下载大文件。
+
+| 历史文件 | LFS OID（SHA-256） | 本地缓存 GiB |
+| --- | --- | ---: |
+| 项目镜像 1.0.3 | `a5676576fb63a913ed9e40a02ce206e5ef71f47b1005a98a8758479b51413e0b` | 3.080 |
+| 项目镜像 1.1.1 | `8356b75ef970891db951a08429f8e2d21a6c0c4933065001778e10d74022c19d` | 3.080 |
+| 官方 Debian 12 IMG | `04a27c5da2244eded7bbc3dfb967582957a9540c7d61ef51cfdbaebeaa70d789` | 3.080 |
+| 历史官方镜像 RAR | `78a54e0e04a28bb7247c68101a61defb9a40f666a3813138a22a35f97fb226cd` | 0.587 |
+
+## 执行与验收
+
+预演使用 `git lfs prune --dry-run --verbose --verify-remote --verify-unreachable`，确认四个候选的远端副本及 OID 集合一致后，执行 `git lfs prune --verify-remote --verify-unreachable`；结果为四个对象均验证通过并删除成功。
+
+清理前后核对：仅上述四个对象消失，其余 129 个缓存大小保持不变；HEAD、已有 Git 引用及暂存区原始字节不变，相关工作区 IMG/RAR 的存在状态、大小和修改时间不变。用户已有的 `发布更新相关/导出包/1111/11223344.img.sha256` 删除状态保持原样。本次仅新增维护说明及本归档，不提交或推送；不修改工作区镜像、远端数据、历史提交、Codex 检查点、OTA 或当前依赖。
+
+`git fsck --connectivity-only --no-dangling` 通过；该检查仅验证 Git 连接完整性，不宣称已做全部内容校验或完整历史恢复测试。纯缓存维护及说明修订不触发设备、Android 或业务回归。文档差异与仓库卫生检查结果见 `validation.json`。
+
+## 证据与可重复方法
+
+- `before.json`：提交、原有工作区状态、暂存区摘要、引用与本地 LFS 对象大小清单。
+- `remote-verification.json`：预演返回值及经远端验证的四个 OID，不保留原始认证或网络跟踪输出。
+- `after.json`：清理后对象清单、回收量和保留边界检查。
+- `validation.json`：最终文档、忽略规则、工作区状态与仓库卫生检查结果。
+
+经验已补入 [Git 仓库安全验收](../../测试相关资料/如何测试/核桃派点阵屏控制服务测试流程.md)：普通 `git gc` 不清理 LFS，停止跟踪也不自动删除历史缓存；非交互预演可能只输出最后一个候选详情，必须核对完整 OID 集合和候选数。仅保存提取后的验证结果，不保存可能包含认证信息的原始跟踪输出。
+
+远端与历史指针继续保留，恢复旧文件时可能重新下载对应 LFS 数据；这是正常行为。本归档记录一次性结果，不把以上四个历史对象作为以后固定清理目标。