TEngine6.2.1

TEngine 6.2.1

版本: v6.2.1
发布日期: 2026-04-27

---

功能增强

打包工具窗口

新增 BuildPipelineWindow 编辑器窗口（菜单入口：TEngine/Build/打包工具窗口），提供可视化的打包配置与执行界面：

• 5 个配置分区：基础设置、最小包、高级设置、热更DLL、打包Player
• 3 个操作按钮：构建AB、构建Player、一键构建
• 构建日志实时显示
• 所有配置 EditorPrefs 持久化

最小包模式

新增最小包模式构建支持：

• 构建后按 Tag 保留指定 bundle，删除其余 .bundle 文件
• 通过 BuildReport JSON 读取 bundle tag 信息
• 支持中英文逗号分隔保留 Tag

参数化构建

• 新增 BuildConfig 参数类，封装所有构建选项
• 改造 ReleaseTools 增加参数化构建入口 BuildWithConfig
• 原有 MenuItem 入口保持兼容

AI 开发工具链

• 新增 tengine-dev skill，替代原 wiki-query-agent，提供更精准的 TEngine 框架知识查询
• 新增 luban-dev skill，支持 Luban 配置表的增删改查与代码生成
• 新增 html-to-ugui skill，支持 HTML 原型转 Unity UGUI 界面的生成管线
• 新增 update-tengine.bat 更新脚本，简化 TEngine 版本升级流程
• 全面优化 skill references 文档，修复 P0~P2 知识库问题

---

Bug 修复

资源管理

• 修复资源加载取消或失败时 handle 未释放导致的资源泄漏（#253）
  • 在 cancel/failure 分支添加 handle.Dispose()，防止 handle 和资源泄漏
• 修复 AssetsReference 静态字典 _originalRefs 残留旧引用的问题
  • OnDestroy 时正确移除自身引用
  • Initialize 时使用 _originalRefs[gameObject] = this 替代 AddIfNotContains，确保引用始终更新

单例系统

• 修复 SingletonSystem.Release() 遍历集合时修改集合导致的异常（#248）
  • 释放 _gameObjects 和 _singletons 时先创建快照副本再遍历
  • 添加 null 检查，防止 Release 过程中的空引用异常
  • 补充清理 _updates、_fixedUpdates、_lateUpdates 等列表

打包工具

• 修复默认输出目录为 ./Builds/（原 ../Builds/），路径更直观
• 修复打包工具文件名风格 BundleName 的问题
• 打包成功日志添加输出路径信息

序列化

• 添加 JSON 设置参数，适配 Newtonsoft Json

---

文档更新

• 修正 API 用法与项目结构文档，补充 UI 前缀表和流程分支说明
• 全量对齐 references 规范，修正事件模块等文档错误
• 新增 FAQ 常见问题章节

---

贡献者

• @Alex-Rachel -- 打包工具窗口、资源泄漏修复、AI 工具链
• @tpxxn -- 打包工具文件名风格修复、输出路径日志
• @TheSakuraCherry -- 单例系统集合遍历修复（#248）
• @LSDust (Jun) -- AssetsReference 静态字典残留引用修复
• @daydayasobi (刻夜) -- Newtonsoft Json 适配

---

升级指南

1. 从 6.2.0 升级至 6.2.1 为兼容升级，无破坏性变更
2. 如使用 AssetsReference，升级后旧引用残留问题将自动修复
3. 打包工具默认输出目录从 ../Builds/ 变更为 ./Builds/，已有项目可在打包工具窗口中手动调整
4. 推荐使用新的 BuildPipelineWindow 替代原有 MenuItem 入口进行打包