Log Detail

vampire-like Git 变更总结

本次修复UGF资源打包错误,完善UI五层架构规范,推进核心代码命名空间统一与程序集拆分重构。

2026/06/02 basil/vampire-like commit: c6f48951..6b8a6a87

资源打包修复UI架构规范代码重构

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.jsonlaunch.jsonsettings.json),以后IDE相关的本地配置不再入库,统一团队配置管理方式,避免不同成员的本地配置冲突。

⚠️ 风险路径提醒:Assets/GameMain/Configs/ResourceBuilder.xmlAssets/GameMain/Configs/ResourceCollection.xml 涉及资源打包核心逻辑,后续修改需重点验证。


UI 架构标准化沉淀

(对应提交 sha:56f74eee9a577150022e897fd329dc62d0a055cd34c0784190be76a335db21d2a0295fbbd4dc2a44

这段时间重点在推进UI架构的标准化和插件化落地:

  1. 首先大幅修订了根目录下的 docs/UI-5层架构设计规范.md,还把这套架构标准沉淀成了跨项目可复用的技能文档 skills/ui-five-layer-architecture/SKILL.md,方便后续其他项目直接复用这套规范。
  2. 为了把五层架构做成可插拔的通用组件,整理了基于UGF的可选UI插件 UIModule,输出了两份配套文档:
    • Assets/Plugins/UIModule/docs/UI-5层架构设计规范.md:特意说明这是通用的抽象规范,不是对当前项目现状的总结,避免和项目内的落地实现混淆。
    • Assets/Plugins/UIModule/docs/UIModule-使用说明.md:明确了插件通过 .asmref 接入现有项目 SepCore.BaseSepCore.Runtime 程序集的方式。

目前这个项目的UI已经实现了初版的五层架构,等核心程序集拆分完成后,就会把现有UI模块调整到最新版的规范要求,完成全量落地。


核心代码分层重构

(对应提交 sha:affa44e4d080cf4a085db7c75e89b88d7cef755d6b8a6a87892d65079f2775981cfbe00a2d99c0dd

之前专门研究过 UnityGameFramework 的程序集拆分方案,正好借这个项目落地实践,整体重构目标是梳理各模块的依赖边界、规范代码结构、缩短增量编译时间。

目前已经完成的动作:

  1. 命名空间统一:把原来散落在23个文件里的 CustomEvent 命名空间全部收敛为 SepCore.Event,同步调整了所有相关的引用。每次调整命名空间或程序集结构时,都会先解决完所有依赖冲突、编译报错后再提交,不会出现提交后主干编译失败的问题。
  2. 程序集拆分推进:正在创建 ProcedurePresentation 两个独立程序集,目前已经完成了 DebugPanel 组件的路径迁移(重命名了对应的meta文件),还新增了325行的 RuntimeDebugPanelComponent.cs 实现,后续其他组件也会按分层规则逐步迁移到对应程序集。

后续跟进点

  1. 验证本次UGF资源打包修复的覆盖场景,确认所有打包环境都正常,后续修改资源配置风险路径时走专项验证。
  2. 跟进程序集拆分的整体进度,重点监控跨程序集的依赖方向,避免出现反向依赖、循环依赖的问题。
  3. 待核心程序集拆分完成后,启动现有UI模块向最新版五层架构的适配工作。

注:本文由模型 unknown 生成(草稿与终稿同模型)。