80 lines
4.4 KiB
Markdown
80 lines
4.4 KiB
Markdown
# 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 逐路径引用，**移出会破坏可追溯性**。因此：
|
||
**本轮不做任何归档/移动**。若未来要压缩仓库体积，正确做法是先把引用改为
|
||
哈希清单（改引用 = 产品/证据变更，需单独计划），而不是直接搬走目录。
|
||
|
||
<details><summary>原 B 类清单（仅存档记录）</summary>
|
||
|
||
| 目录 | 大小 | 原因与建议 |
|
||
| --- | --- | --- |
|
||
| `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` 与哈希清单，保证"可追溯、不占仓"。
|
||
|
||
</details>
|
||
|
||
## 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 范围内自行处理。
|