# 工程清理与文件用途说明

<!-- CURRENT_PROJECT_VERSION_START -->
当前项目版本：MVP0.5.5 / v0.5.5。[当前开发总结](../Development/DevelopmentSummary.md)为统一现状入口。本页旧版本、日期和验收数值保留为历史记录，不能作为本次重复验收。
<!-- CURRENT_PROJECT_VERSION_END -->

本目录提供MVP0.5.2 / v0.5.2的当前文件列表、分类搜索和维护入口。下方清理过程、删除数量、哈希与验收数值为2026年10月9日MVP0.3时期的历史记录；保留原件和当时结果，不代表本次重新清理或重新验收。

[当前逐文件一览](FileInventory.md) · [当前搜索筛选页面](FileInventory.html) · [当前结构化一览](FileInventory.json) · [历史删除记录](CleanupReport.json) · [历史清理验收](CleanupValidation.json)

## 历史清理（2026-10-09）

删除1,423个旧文件/对应meta及空目录元数据，原件共153,298,203字节（约146.2MiB）；另清理738个可再生成测试缓存，共42,715,534字节（约40.7MiB），合计约186.9MiB。文件数包含Unity元数据，不等于删除1,423项游戏功能。

| 内容 | 判断依据与处理 |
| --- | --- |
| 651张StreamingAssets/Portraits旧JPG | 当前主公只使用正式Portraits中的7张PNG；卡面由CardArtIndex对应187插画。核对源码与序列化GUID后删除旧图及meta。 |
| 44份旧美术 | 未被CardArtIndex、姓名/数字索引、固定加载器或Unity序列化引用使用的旧边框、单个数字、试稿、张飞原型素材及废弃背景。保留293项正式PNG/JSON源素材。 |
| CardNameXingkai.ttf | 运行代码使用NotoSansSC、STHeitiMedium和CardNameKaiti，不再加载行楷字体。 |
| 旧V2卡库与导入/初始化脚本 | 当前云端校验只针对V3；移除失效旧回退，删除bootstrap.sh、tools/build_cards.py和过时run_unity.sh。 |
| BuildAndCapture.cs | 早期脚本会直接覆盖Main场景和塞测试手牌，已被隔离验收工具替代，删除该入口。 |
| battle_mockup.html/png、layout_diag.txt | 一次性旧布局草稿与诊断输出，当前运行/文档不引用。 |
| bin/obj、Python缓存 | 仅清理公开测试/后台工程的可再生成产物；不进入Backend/.local或运行中的构建目录。 |

删除前，所有受控原件均确认与Git HEAD一致、没有本地改动，记录逐文件SHA-256并核对GUID无外部序列化引用；需要原件时可从Git历史精确恢复。没有按“搜不到名称”直接删除动态加载资源，也没有清空工程缓存来假称完成资源清理。

## 历史清理时保留的内容

- 187张正式卡面、7张主公头像、金/银基础边框、6类徽章与青玉光沿、0—99数字图集、姓名书法切片、HUD和3种实际使用字体。
- 前后台源码、Main/BattleScene场景、Unity Packages/manifest.json及锁文件、平台设置、所有已应用数据库迁移。BillingMode.json由Unity IAP包读取/自动维护，虽然目前未开放支付，也保留原件和meta。
- 规则/AI/接口/发布/编辑器验收工具，以及Docs历史截图、Word原件、复现记录。历史测试不是当前重新执行；原日期保留。
- LocalSaveStore.cs仍被历史存档迁移和旧夹具引用，保留测试兼容用途。实际登录、卡组、收藏和历史由云端保存，不恢复旧本机存档流程。
- Backend/.local中的账号资料相关配置、密码、备份及GitHub Runner服务全部保留，不输出私有文件名或内容。当前Unity的Library、Temp、Logs、UserSettings和Git历史也保留。
- 清理前已存在的新人福利、珍宝阁、CI改动和用户UnityConnectSettings设置保留，不做分支切换、重置或混合提交。

## 历史清理验收（2026-10-09）

结构与哈希检查已确认293项正式美术都存在，当前卡库SHA-256仍为49d5b9afeeb1d2810a513e1fedd4df05c30797f6791c8436ab13af6fc301bb68。清理前已存在的业务文件均与清理基线一致；保留资源的meta齐全，718个被删除资源/目录GUID均无残留序列化引用。

| 本次检查 | 结果 |
| --- | --- |
| 共享规则 | 12,811项断言通过，含100场完整模拟 |
| 后台Release编译 | 通过，0警告、0错误 |
| 发布工具 | 29项通过 |
| 隔离Unity素材与卡库 | 226项通过；187张卡面全部解码/运行映射正常，数字、姓名、头像、边框、字体及HUD齐全 |
| 隔离Unity交互 | 188项通过；查看了出牌落场和卡组编辑截图，素材显示正常 |
| 文件一览 | 文件搜索、分类筛选和组合搜索均通过，没有仅写“配套文件”的用途条目 |

交互批处理启动时，Unity6.6编辑器QuickSearch自动索引出现一次ArgumentOutOfRangeException，堆栈在UnityEditor.Search内部。交互断言仍全部通过，最后资源检查也通过；没有将其描述为游戏报错，也未修改用户的编辑器缓存。共享规则测试联网读取NuGet漏洞信息有NU1900提示，测试完成；详细边界见CleanupValidation.json。

本次不是重新执行五万场AI模拟，也不等于四个平台导出后的目标设备试玩。没有登录test1/test2、清理账号或更改数据库。

## 文件一览如何维护

工程根目录执行 `python3 tools/docs/build_file_inventory.py`，同时更新Markdown、HTML与JSON。一览逐文件说明源码、资源、配置、测试和文档；Unity `.meta` 明确标注对应资源或目录。私有部署与机器缓存仅按目录说明用途，避免把凭证或账号相关路径写进公开文档。