验收完成40%

docs/design/上传前文件清理审计_2026-07-16.md

@@ -1,28 +1,34 @@
-# 上传前文件清理审计（2026-07-16）
+# 上传前文件清理审计（2026-07-17 更新）
 
 ## 审计边界
 
-- 只检查仓库长期交接截图、未跟踪二进制资产和已忽略的本地生成目录。
-- 不清理 `tmp/`、`runtime/`、测试、脚本、候选母版或用户已有修改。
-- 不修改仓库截图体积阈值，不执行任何 Git 暂存、提交、推送、重置或检出操作。
+- 生成资产所需的母版、清单、脚本、测试、`requirements.txt` 和 APP 正在引用的运行图一律保留。
+- 只删除可再生成的本机缓存，以及已经被新版长期代表证据或正式母版替代的旧截图。
+- 不修改仓库体积阈值，不执行 Git 暂存、提交、推送、重置或检出。
+- `unpackage/` 中已有的 tracked 缓存修改不覆盖、不删除，上传时单独排除。
 
-## 本轮已清理
+## 已清理的本机缓存
 
-以下两张旧 A01 全页截图没有被任何文档、索引、清单、代码或测试引用；逐张查看后确认其视觉方案已被 2026-07-16 的 A01 当前代表图和状态联系表替代，因此删除：
+- `design-pipeline/.venv/`、`design-pipeline/generated/` 和 Python `__pycache__/`。
+- `.superpowers/`、`tmp/` 与 `tmp-g01-icon-audit.png`。
+- `docs/design/screens/runtime/`：113 个文件，共 40,858,831 字节。该目录受 Git 忽略，只是本机运行截图缓存。
 
-- `docs/design/screens/handoff/2026-07-15/A01-selected-password-brand-seal-841x1870.png`（1,805,168 字节）
-- `docs/design/screens/handoff/2026-07-15/A01-selected-sms-brand-seal-841x1870.png`（1,785,574 字节）
+删除 `.venv` 和 `generated` 不影响换机恢复；新电脑按 `requirements.txt` 重建环境后，由正式母版、清单和脚本重新生成输出。
 
-合计减少 3,590,742 字节。没有删除其他历史 handoff 证据。
+## 已清理的长期截图
 
-## 保留结论
+用户于 2026-07-17 确认删除 20 张已被新版联系表、当前代表图或 A01 正式 PSD 母版替代的旧 handoff 截图，共 12,987,496 字节。长期索引已迁移到：
 
-- `docs/design/assets/g01-background/masters/` 下三张 G01 背景母版均被候选清单和换机重建文档引用，必须保留。
-- 当前其他未跟踪二进制资产均有文档、清单、代码或测试引用，不按“未跟踪”直接删除。
-- `design-pipeline/generated/`、`design-pipeline/.venv/`、`docs/design/screens/runtime/`、`tmp/` 等目录处于 Git 忽略状态，不会进入正常提交；本轮不做破坏性本地清理。
+- `docs/design/screens/handoff/2026-07-16/` 中 A01、A04、A05、A06、G01、G03、G05、G08–G12、T01、T04 的当前联系表或代表图。
+- `docs/design/assets/a01-vnext/source/A01-layered-source-v1.psd` 与 `a01-psd-manifest.json`。
 
-## 仍未解决的仓库合同
+此前 2026-07-16 已删除的两张无引用 A01 旧全页图继续保持删除状态。
 
-清理后，`docs/design/screens/handoff/` 仍有 50 个文件、29,887,097 字节，继续超过 35 个文件／20MB 的交接截图合同。剩余文件存在有效引用或属于长期证据，不能为了让测试变绿而擅自删除；后续仍需用户决定归档策略。
+仓库体积合同还会统计 `docs/design/screens/` 根目录。为满足同一合同，另删除 7 张早期整页设计稿：A01 v1–v3 已由正式分层 PSD 和保留的四档栅格证据替代，G01 v1–v4 已由仍保留的 v5 安全区稿和 2026-07-16 当前联系表替代。相关长期文档引用已迁移。
 
-`tests/repository-handoff-size-contract.ps1` 还会把已忽略的 runtime 截图统计在内，因此必须同时如实报告脚本结果与 handoff 专项目录结果，不能放宽阈值掩盖问题。
+## 清理结果
+
+- `docs/design/screens/handoff/`：30 个文件，16,899,601 字节，低于 35 个文件／20MB 合同。
+- `docs/design/screens/` 全目录：35 个文件，低于 20MB，满足仓库截图体积合同。
+- 正式 G01 与 T/F/R/N/M 生成输入、运行资产和恢复脚本均保留。
+- `design-pipeline/generated/`、`.venv/`、runtime 与 tmp 不属于长期交接材料，换机后按需重建。