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

上传前文件清理审计（2026-07-17 更新）

审计边界

• 生成资产所需的母版、清单、脚本、测试、requirements.txt 和 APP 正在引用的运行图一律保留。
• 只删除可再生成的本机缓存，以及已经被新版长期代表证据或正式母版替代的旧截图。
• 不修改仓库体积阈值，不执行 Git 暂存、提交、推送、重置或检出。
• unpackage/ 中已有的 tracked 缓存修改不覆盖、不删除，上传时单独排除。

已清理的本机缓存

• design-pipeline/.venv/、design-pipeline/generated/ 和 Python __pycache__/。
• .superpowers/、tmp/ 与 tmp-g01-icon-audit.png。
• docs/design/screens/runtime/：113 个文件，共 40,858,831 字节。该目录受 Git 忽略，只是本机运行截图缓存。

删除 .venv 和 generated 不影响换机恢复；新电脑按 requirements.txt 重建环境后，由正式母版、清单和脚本重新生成输出。

已清理的长期截图

用户于 2026-07-17 确认删除 20 张已被新版联系表、当前代表图或 A01 正式 PSD 母版替代的旧 handoff 截图，共 12,987,496 字节。长期索引已迁移到：

• 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/ 根目录。为满足同一合同，另删除 7 张早期整页设计稿：A01 v1–v3 已由正式分层 PSD 和保留的四档栅格证据替代，G01 v1–v4 已由仍保留的 v5 安全区稿和 2026-07-16 当前联系表替代。相关长期文档引用已迁移。

清理结果

• 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 不属于长期交接材料，换机后按需重建。