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

上传前文件清理审计（2026-07-16）

审计边界

• 只检查仓库长期交接截图、未跟踪二进制资产和已忽略的本地生成目录。
• 不清理 tmp/、runtime/、测试、脚本、候选母版或用户已有修改。
• 不修改仓库截图体积阈值，不执行任何 Git 暂存、提交、推送、重置或检出操作。

本轮已清理

以下两张旧 A01 全页截图没有被任何文档、索引、清单、代码或测试引用；逐张查看后确认其视觉方案已被 2026-07-16 的 A01 当前代表图和状态联系表替代，因此删除：

• 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 字节）

合计减少 3,590,742 字节。没有删除其他历史 handoff 证据。

保留结论

• docs/design/assets/g01-background/masters/ 下三张 G01 背景母版均被候选清单和换机重建文档引用，必须保留。
• 当前其他未跟踪二进制资产均有文档、清单、代码或测试引用，不按“未跟踪”直接删除。
• design-pipeline/generated/、design-pipeline/.venv/、docs/design/screens/runtime/、tmp/ 等目录处于 Git 忽略状态，不会进入正常提交；本轮不做破坏性本地清理。

仍未解决的仓库合同

清理后，docs/design/screens/handoff/ 仍有 50 个文件、29,887,097 字节，继续超过 35 个文件／20MB 的交接截图合同。剩余文件存在有效引用或属于长期证据，不能为了让测试变绿而擅自删除；后续仍需用户决定归档策略。

tests/repository-handoff-size-contract.ps1 还会把已忽略的 runtime 截图统计在内，因此必须同时如实报告脚本结果与 handoff 专项目录结果，不能放宽阈值掩盖问题。