Haiyue Engine 0.2.2

Haiyue Engine 0.2.2

共享二维布局、GUI 输入／主题／分隔面板／标签页／拖放、区域按需更新，以及 HYA 组合播放。四个 npm 包统一为 0.2.2；完整 CSS、任意来源动画完整保真及所有设备性能承诺不在本版范围。

Windows 全局门禁、580 次捕获、HYA 生产与真实 IME／手柄、无发布演练，以及具名 Mac／iPhone 输入、音频和 VoiceOver 验收均已完成。原失败、预算和证据边界保留。

发布提交：69ad05eacc25675ef6132c2d6da819c2b8d64573
运行时包构建提交：d58835a9d14c711f26374c5eed00851f4e4649c2
Native 宿主快照：1caaee0d1d24daac92b97a2f5e78fefcd8d17154（独立消费者；不属于四个 npm 包）。

附件包含四个原始 tarball、示例目录归档、校验和、SBOM、原始构建 provenance 与最终跨平台资格绑定。构建 provenance 保留真实构建提交，不改写为最终文档合并提交。

原生字体、短时音频时钟、VoiceOver 记录及资源清理范围见仓库 review/engine-0.2.2/g13-mac-iphone-20261030.md。区域接口仍按 experimental 标注使用。UI、Editor、Games、Native 与 App Store 独立发布。

Hosted CI investigation / publication basis

The original Ubuntu / SwiftShader tag run remains failed: https://github.com/HaiyueStudio/Engine/actions/runs/41068966208 . It reached the existing 300-second fixture deadline at render3d.planar-reflection.10000e.4m.8b.4v (warmup 3, samples 40), without recorded browser validation errors. Later hosted stages did not run.

The release owner explicitly approved only this named software-environment timeout as an investigation, continuing on the same candidate's complete Windows native global gate and no-publish rehearsal, plus the bound Mac / iPhone acceptance. Original logs, CI artifacts, samples, deadlines and all other budgets are retained; the failed hosted run is not represented as passed. The runtime package bytes are unchanged. See the attached ci-timeout-admission.json and tag-ci-timeout-assessment.json.

发布检查补充：合并后的 Linux Fast 测试入口修复（仅两份测试辅助文件，不改运行时或包）已通过完整检查：https://github.com/HaiyueStudio/Engine/actions/runs/41085972749 。签名标签及四个 npm 包保持冻结版本。master 的 SwiftShader 复核同样触及原四场景夹具共用的 300 秒总时限；它与标签运行的具名超时属于同一调查项，原失败记录保留，未放宽其他预算。

Haiyue 0.2.0

Haiyue 0.2.0

本次统一发布 @haiyue/engine、@haiyue/animation-spec、@haiyue/extensions、@haiyue/shader-language 四个 0.2.0 包。

新增能力

• 音频混音：OwnerSafeAudioMixer，按 owner 管理声音、混音和资源释放（experimental）。
• 多玩家输入：BrowserMultiplayerInput 与玩家输入快照（experimental）。
• 字体：GUI 字体配置及动画文本样式。
• 动画交互：InteractionRuntime、事件路由和动作契约。
• 虚拟摇杆：固定或浮动中心、死区、2D/3D 移动和输入清理。

渲染与发布改进

修复 AO 画面、灯光采样容量、反射视图可见性及 Volume 接线，统一 Live2D 示例资源。发布资格支持完整 Mac Chrome/Metal 或 Windows Chrome+Edge 原生 GPU 路径。示例站点通过 GitHub Actions 从 master 构建部署。

安装与兼容

npm install @haiyue/engine@0.2.0 @haiyue/animation-spec@0.2.0 @haiyue/extensions@0.2.0
npm install --save-dev @haiyue/shader-language@0.2.0

Engine、animation-spec 和 extensions 应一起升级，避免混装 0.1.x。Engine 默认入口保持 30 个稳定符号；HYA 数据格式与 Shader artifact 版本独立管理。本次不包含 Rive、UI、Editor、Games 或 CalendarPuzzle。

验证记录

冻结提交：4563e8d6b1f5204af37dc98d5630c62918d02a84。采用 macOS Chrome/Metal 原生 GPU 发布资格路径，源码保持干净，正式基线未变更。

• 正式灯光、渲染与像素检查、55 个全量自动示例、1800 帧 readback 长跑、四包确定性打包与真实安装/消费、入口体积预算通过。
• 完整 CPU 基准覆盖 93 项，资源指标违规为 0。本机未纳入固定时延基线，7 项时延告警保留为诊断信息。
• 首轮全局门禁在跨引擎比较处因 Three、Babylon、PlayCanvas 采样噪声退出。保持源码、场景、三轮采样配置和阈值不变，完整复测全部五引擎后通过；两轮原始记录均保留。
• 正式复测的 WebGPU P50：HaiYue 1.525 ms、Three 2.045 ms、Babylon 2.070 ms、PlayCanvas 3.105 ms。此结果仅代表该机器和比较场景；Galacean WebGL2 单列。
• 生产依赖审计覆盖 64 个组件，已知漏洞为 0，许可证和凭据扫描通过。
• 发布演练及独立制品校验通过；五项发布制品已按最终字节内容验证 SHA-256，附带 SBOM 和来源记录。

GitHub hosted Fast 和 Pages 构建部署成功。hosted Slow 的 SwiftShader 平面反射大场景超时记录保留；同版本原生 Mac 的四项平面反射工作负载和像素检查通过。

在线示例已由 master 的同一提交部署，共 91 个已发布条目。发布归档中的全量自动验收示例为 55 个；两者统计范围不同。

版本标签采用普通带注释标签（未签名），本次例外已获发布负责人明确批准。