Log Detail

vampire-like Git 变更总结

修复UGF资源打包配置并清理误提交的VSCode文件,同时正式推行UI五层架构设计规范

2026/05/10 basil/vampire-like commit: c6f48951..56f74eee

资源打包修复UI五层架构规范误提交清理

basil/vampire-like 本次开发总结

这次做了什么

主要是两件事:修了一个资源打包时暴露出来的配置问题,顺便清理了历史遗留的误提交文件;同时把 GPU-Instancing 分支合进来,里面带的 UI 五层架构规范文档终于正式落地了。


具体改动

1. 修复 UGF 资源打包错误 (c6f4895)

  • .gitignore 调整StreamingAssets 的忽略规则从文件夹级改成 ** 递归匹配,避免子文件/子目录被意外提交到版本库或干扰打包管线。
  • 清理 .vscode 目录:删除了 extensions.jsonlaunch.jsonsettings.json 三个文件。这些都是之前的误提交,这次顺手清掉了,省得不同成员间 IDE 配置互相打架。
  • ResourceBuilder.xml 临时修改:把 Platforms33(很可能是 Android + 其他组合)改成了 1(对应 Standalone),并删除了 ForceRebuildAssetBundleSelected 配置。这并非正式修复,而是因为当时在本地调试 Windows 包的打包流程。这个文件本身就是打包用的本地配置,每个平台、每个人的需求都可能不一样,理想情况应该直接把它加到 .gitignore 里。这次误改合入了,后面必须补上忽略规则,否则双平台(Windows / Android)切换时还会互相覆盖。

2. 合并 GPU-Instancing 分支 (56f74ee)

  • .gitignore 补充:添加了 /openspec/changes/archive 忽略项,把变更归档目录排除出仓库。
  • UI 五层架构规范大幅更新docs/UI-5层架构设计规范.md 增删了近 400 行,把 RawData / Controller / View / Context / UseCase 的分工和对接方式重新梳理了一遍。
  • 新技能文件 SKILL.md:定义了一个 ui-five-layer-architecture 的 skill,专门用于后续 UI 模块的定义、审查和重构,让团队(以及未来的 AI 辅助工具)知道每个模块该在哪里接入、各层各自负责哪些逻辑。

决策与取舍

  • ResourceBuilder.xml 的归属问题
    这个配置文件属于打包参数,不同目标平台和构建习惯都会变,强行版本化只会互相踩脚。目前改 Platforms 为 1 仅仅是调 Windows 包时的临时行为,后面打包 Android 还得切回去。这件事暴露出它就不该被跟踪,下一步会把它补进 .gitignore,每个人按需在本地维护一份。

  • VSCode 配置的去留
    之前不小心把 .vscode 目录提交上去了,这次直接删掉。这样能避免编辑器设置冲突,但坏处是新成员不会自动获得推荐扩展(比如 visualstudiotoolsforunity.vstuc),可能需要单独在团队文档或 onboarding 里补充说明。

  • UI 五层架构规范正式推行
    这个 skill 其实早就该安排上。现在文档和 skill 一起落地,相当于给后续 UI 的开发和扩展画好了路线图:知道从哪里接出界面、各层怎么拆、哪块逻辑该放在哪里。短期内可能不会强制重构所有现有 UI 模块,但新功能和新模块一定会以这个规范为准,评审时也会以此作为分层参考。


接下来要关注

  1. ResourceBuilder.xml 加入 .gitignore,并确认双平台(Windows / Android)打包时各自使用正确的本地配置,不再交叉污染。
  2. 减轻 VSCode 配置移除的影响:如果新成员反馈缺少扩展推荐,补充一份推荐列表或在 README 里提一句。
  3. 推广 UI 五层架构规范:确认 team 内都理解了新规范,检查 SKILL.md 能否被开发工具链识别(如果计划与 AI 辅助联动的话),并逐步让现有 UI 模块至少在新功能开发时向规范靠拢。

注:本文由模型 deepseek-v4-pro 生成(草稿与终稿同模型)。