Files
aetherbound-guild/docs/runtime/W4_CLEANUP_INVENTORY.md
T

4.4 KiB
Raw Blame History

W4 无用物清理清单(2026-09-13 执行完毕)

Goal: ABG MVP 质量达标,工作包 W4。Owner 于 2026-09-13 签字:删 b ok —— 按"先删零引用、再谈归档"执行。执行前做了二次复核(文件名 + 目录名 + 测试/清单引用),修正了首轮浅层审计的错误判断,结果见下。

0. 修正说明(重要)

首轮审计只按"文件名"搜索,得出"10 个文件零引用"。复核发现:

  • runtime/assets/ui_m51/*@2x.png 被 runtime/tests/foundation/ m51_ui_asset_scaling_test.gd 引用 → 保留(删除会破坏该测试);
  • docs/prototype/generation/phase6_motion_proof_03(312 MB)被 runtime/assets/animations/asset-manifest.json、 prototype/site/assets/game/asset-provenance.json 与 docs/runtime/p9_1/visual_slice/evidence/verification.json 引用 → 保留在原处,不归档(移出会破坏出处引用链);
  • m52_q_company 目录本身被 initial_company_art.gd 与两个组件测试引用, 但其中 mage_idle/mage_wave/shield_idle/shield_wave 四个文件零引用 → 可删;真正使用的是 q_pf_b01..b12.png。

A. 已删除(6 个文件,7.44 MB,二次复核零引用)

文件 大小 说明
runtime/assets/entry/boot/aetherbound-guild-icon.png(+ .import) 1.74 MB 早期 App 图标草案
runtime/assets/entry/recruit_stickers/m52_q_company/{mage,shield}_{idle,wave}.png(4 个,+ .import) 4.50 MB 未被采用的贴纸;实际使用的是同目录 q_pf_b01..b12.png
runtime/assets/ui_m52_market/v2/ledger_panel.png(+ .import) 1.20 MB 旧账本面板,已被 ABGMarketChrome 的 ledger_cost/账本壳取代

提交:见 docs/EVIDENCE_LEDGER.md W4 行。, .import` 一并删除(素材与导入 缓存必须同生共死,避免悬空缓存)。

B. 撤回归档建议(复核后保留)

原建议把 phase6_motion_proof_03(312 MB)等批次归档出仓;复核确认这些目录 仍被运行时动画清单与出处 JSON 逐路径引用,移出会破坏可追溯性。因此: 本轮不做任何归档/移动。若未来要压缩仓库体积,正确做法是先把引用改为 哈希清单(改引用 = 产品/证据变更,需单独计划),而不是直接搬走目录。

原 B 类清单(仅存档记录)
目录 大小 原因与建议
docs/prototype/generation/phase6_motion_proof_03 312 MB FG-2 时代动作证明;FG-2 已被判定 VISUAL_SUPERSEDED,建议打包归档(保留 manifest/hash)
docs/prototype/generation/phase6_battle_scale_04 108 MB 保留原处:BAT-001 视觉权威链的一部分,AGENTS.md 明确引用
docs/prototype/generation/phase6_ui_masters_02 等 phase6/phase9 批次 ~150 MB 被手绘方向取代的生成批次;逐批确认后归档
runtime/assets/ui_m50_raw、ui_m51_raw、ui_m52_market_raw 9.3 MB 生成原始表:现行规则要求保留"原始表 + 处理命令"作为出处
像素家族素材(历史候选) — 保留:AGENTS.md 要求保留出处,不得删除或当作现行权威

归档建议:tar.gz + 逐目录 manifest.sha256 放到仓库外(owner 指定位置), 仓内保留批次 REPORT.md 与哈希清单,保证"可追溯、不占仓"。

C. 保留(复现链/工具,不在本轮删除)

  • tools/process_fg*_media.py、verify_fg*_media.py、generate_fg*_audio.py: FG-2/3/4 已验收媒体的生成与验证路径;
  • tools/build_*_package.py / build_*_contact_sheet.py:RSK/SHP/BAT/HUB 验收包与接触表的构建脚本;
  • tools/run_dev*_candidate_suite.sh:里程碑候选套件记录(现由逐页 attempt 取代,但仍是历史复现路径);
  • tools/test_*.py:run_test_attempt 等基建的自测。

D. 不动(仓库规则)

  • 未跟踪的 .uid / .import 文件:按 AGENTS.md 与既有计划规则,不得顺手 删除或提交;
  • docs/design-authority/**(497 MB):现行设计权威与验收包;
  • docs/evidence 类保留证据与 attempt artifact。

结论

  • A 类已删(6 文件 / 7.44 MB),连带 .import;
  • B 类撤回(引用链完整,保留原处);
  • C/D 不动;
  • 若将来仍要压缩体积,需先改引用为哈希清单(单独计划 + owner 授权), 不在本 Goal 范围内自行处理。