Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs: add v0.6.2 changelog

esengine97fa6caeef69
diff --git a/docs/astro/src/content/docs/changelog-v062.mdx b/docs/astro/src/content/docs/changelog-v062.mdx
new file mode 100644
index 000000000..eb76a5c98
--- /dev/null
+++ b/docs/astro/src/content/docs/changelog-v062.mdx
@@ -0,0 +1,44 @@
+---
+title: v0.6.2
+description: ESEngine v0.6.2 release notes
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">
+v0.6.2 improves WeChat MiniGame support, fixes asset loading and browser compatibility issues, and resolves several editor stability problems.
+</Aside>
+
+## WeChat MiniGame
+
+- Add keyboard input support via `wx.onKeyDown` / `wx.onKeyUp` (PC platform, base library 2.10.1+)
+- Add dedicated WeChat runtime entry point with streamlined initialization
+- Improve file system error messages with actionable hints (e.g. missing `packOptions.include` for custom extensions)
+- Fix Emscripten wxgame build: use `-sENVIRONMENT=web` with minimal polyfill for `document` / `window` globals
+- Extract component defaults to a dedicated module for cleaner WeChat bundle
+
+## Asset Pipeline
+
+- Asset collector now recursively gathers dependencies for always-exported folders
+- Auto-create missing `asset-export.json` config file
+- Browser preview now resolves UUID asset references
+- Fix `asset:` protocol blocked by CSP `default-src`, preventing `fetch()` calls to load prefabs during play mode on Windows
+
+## Bug Fixes
+
+### Editor
+
+- Fix absolute path stripping in `resolveFilePath` — leading `/` is no longer removed, fixing virtual-fs plugin failures when reading user scripts
+- Fix event listener leaks on HMR: `onCloseRequested` and `contextmenu` handlers are now properly cleaned up in `Editor.dispose()` and `DockLayoutManager.dispose()`
+- Fix text vertical clipping: clamp `startY` to >= 0 when text block exceeds container height
+
+### SDK
+
+- Fix browser compatibility: replace Node.js `Buffer` with standard base64 encoding
+- Simplify builder templates and consolidate runtime config generation
+
+## Internal
+
+- Add playable emitter and atlas rewrite test coverage
+- Add desktop build utility scripts (`copy-esbuild-wasm.js`, `kill-port.js`)
+- Fix cross-package import in path tests causing CI type-check failure
diff --git a/docs/astro/src/content/docs/zh/changelog-v062.mdx b/docs/astro/src/content/docs/zh/changelog-v062.mdx
new file mode 100644
index 000000000..c1084352c
--- /dev/null
+++ b/docs/astro/src/content/docs/zh/changelog-v062.mdx
@@ -0,0 +1,44 @@
+---
+title: v0.6.2
+description: ESEngine v0.6.2 更新日志
+---
+
+import { Aside } from '@astrojs/starlight/components';
+
+<Aside type="tip">
+v0.6.2 改进微信小游戏支持,修复资产加载和浏览器兼容性问题,解决多个编辑器稳定性问题。
+</Aside>
+
+## 微信小游戏
+
+- 添加键盘输入支持,通过 `wx.onKeyDown` / `wx.onKeyUp`(PC 平台,基础库 2.10.1+)
+- 新增专用微信运行时入口,简化初始化流程
+- 改进文件系统错误提示,提供可操作的修复建议(如缺少 `packOptions.include` 配置的自定义扩展名)
+- 修复 Emscripten wxgame 构建:使用 `-sENVIRONMENT=web` 并添加最小化的 `document` / `window` 全局变量 polyfill
+- 将组件默认值提取到独立模块,优化微信包体积
+
+## 资产管线
+
+- 资产收集器现在递归收集始终导出文件夹的依赖项
+- 自动创建缺失的 `asset-export.json` 配置文件
+- 浏览器预览现在可解析 UUID 资产引用
+- 修复 `asset:` 协议被 CSP `default-src` 阻止的问题,导致 Windows 上播放模式无法通过 `fetch()` 加载预制体
+
+## Bug 修复
+
+### 编辑器
+
+- 修复 `resolveFilePath` 错误去除绝对路径前导 `/`,导致 virtual-fs 插件无法读取用户脚本
+- 修复 HMR 时事件监听器泄漏:`onCloseRequested` 和 `contextmenu` 处理器在 `Editor.dispose()` 和 `DockLayoutManager.dispose()` 中正确清理
+- 修复文本垂直裁剪:当文本块超出容器高度时,将 `startY` 限制为 >= 0
+
+### SDK
+
+- 修复浏览器兼容性:使用标准 base64 编码替换 Node.js `Buffer`
+- 简化构建模板,统一运行时配置生成
+
+## 内部改动
+
+- 添加 Playable 发射器和图集重写测试覆盖
+- 添加桌面端构建工具脚本(`copy-esbuild-wasm.js`、`kill-port.js`)
+- 修复路径测试中的跨包导入导致 CI 类型检查失败