basil/vampire-like 开发日志
仓库别名:vampire-like
本次整理了仓库2026年5月10日至2026年6月2日期间的5个提交,累计代码变动量为 +1152 / -229,改动涵盖3项代码调整、2项文档更新、1项配置修改。
UGF 资源打包问题修复
(对应提交 sha:c6f48951d32ad0345b0790e41e87ff7e1413816e)
这次修了之前踩的一个打包坑:之前误把整个 StreamingAssets 目录加到了 .gitignore 里,导致UGF打包时找不到对应文件夹直接报错。所以调整了 .gitignore 的匹配规则,从直接忽略整个目录改成忽略目录下的所有内容,保证空目录可以正常入库占位。
另外同步调整了 Assets/GameMain/Configs/ResourceBuilder.xml 的构建配置:把平台配置从33改成1,移除了 ForceRebuildAssetBundleSelected 配置项。这里没做特别的权衡——因为 ResourceBuilder 本身每次打包都会自动修改,只是把配置修正到符合当前打包需求的状态。
这次还清理了仓库里内置的 .vscode 个性化配置文件(extensions.json、launch.json、settings.json),以后IDE相关的本地配置不再入库,统一团队配置管理方式,避免不同成员的本地配置冲突。
⚠️ 风险路径提醒:
Assets/GameMain/Configs/ResourceBuilder.xml、Assets/GameMain/Configs/ResourceCollection.xml涉及资源打包核心逻辑,后续修改需重点验证。
UI 架构标准化沉淀
(对应提交 sha:56f74eee9a577150022e897fd329dc62d0a055cd、34c0784190be76a335db21d2a0295fbbd4dc2a44)
这段时间重点在推进UI架构的标准化和插件化落地:
- 首先大幅修订了根目录下的
docs/UI-5层架构设计规范.md,还把这套架构标准沉淀成了跨项目可复用的技能文档skills/ui-five-layer-architecture/SKILL.md,方便后续其他项目直接复用这套规范。 - 为了把五层架构做成可插拔的通用组件,整理了基于UGF的可选UI插件
UIModule,输出了两份配套文档:Assets/Plugins/UIModule/docs/UI-5层架构设计规范.md:特意说明这是通用的抽象规范,不是对当前项目现状的总结,避免和项目内的落地实现混淆。Assets/Plugins/UIModule/docs/UIModule-使用说明.md:明确了插件通过.asmref接入现有项目SepCore.Base、SepCore.Runtime程序集的方式。
目前这个项目的UI已经实现了初版的五层架构,等核心程序集拆分完成后,就会把现有UI模块调整到最新版的规范要求,完成全量落地。
核心代码分层重构
(对应提交 sha:affa44e4d080cf4a085db7c75e89b88d7cef755d、6b8a6a87892d65079f2775981cfbe00a2d99c0dd)
之前专门研究过 UnityGameFramework 的程序集拆分方案,正好借这个项目落地实践,整体重构目标是梳理各模块的依赖边界、规范代码结构、缩短增量编译时间。
目前已经完成的动作:
- 命名空间统一:把原来散落在23个文件里的
CustomEvent命名空间全部收敛为SepCore.Event,同步调整了所有相关的引用。每次调整命名空间或程序集结构时,都会先解决完所有依赖冲突、编译报错后再提交,不会出现提交后主干编译失败的问题。 - 程序集拆分推进:正在创建
Procedure和Presentation两个独立程序集,目前已经完成了 DebugPanel 组件的路径迁移(重命名了对应的meta文件),还新增了325行的RuntimeDebugPanelComponent.cs实现,后续其他组件也会按分层规则逐步迁移到对应程序集。
后续跟进点
- 验证本次UGF资源打包修复的覆盖场景,确认所有打包环境都正常,后续修改资源配置风险路径时走专项验证。
- 跟进程序集拆分的整体进度,重点监控跨程序集的依赖方向,避免出现反向依赖、循环依赖的问题。
- 待核心程序集拆分完成后,启动现有UI模块向最新版五层架构的适配工作。
注:本文由模型
unknown生成(草稿与终稿同模型)。