beyond-simulator-web 0.5.1 → 0.5.2

package/README.md

@@ -2,11 +2,13 @@
 
 单用户自托管 Web 编辑器和磁盘存档预览，无需 Harness。复用共享 Studio、Lua Runtime、固定步长试玩 Worker、Pixi 渲染器及 `editor-ui` 编辑界面。
 
-## 0.5.1 更新
+## 0.5.2 更新
 
-- 支持基础富文本，改进文本框高度不足时的整行显示。
-- 编辑画布与截图支持图片矩形遮罩和羽化预览。
-- 完善索引范围校验，保留旧存档编号、历史映射和脚本挂载，避免静默重编号。
+- 支持界面／全屏动效素材搜索、编辑画布预览及 Lua 试玩播放，资源加载失败仅影响对应动效。
+- 支持单个客户端控件和勾选组合的 GIA 导出，导出前可预览并检查依赖。
+- 改进快速点击、拖拽和输入事件顺序；AI 启动试玩默认静音，可手动开启声音。
+
+完整公告见 [DSH 2.2.2 / Web 0.5.2 / MCP 0.5.2](../dsh-plugin/CHANGELOG.md#222--2026-10-30)。
 
 更新或修改字体后，重启 Web 服务并刷新页面。
 
@@ -78,6 +80,8 @@ Web/MCP 0.3.0、共享宿主所在 DSH 2.0.3：修复空工作区启动后跳过
 
 Lua `game.PlayAudio2D(id)` 触发白名单 MP3 按需缓存与播放，同源路由为 `/qxqy-audio/`，缓存目录可用 `QXQY_AUDIO_CACHE_DIR` 指定。首次自动播放被浏览器阻止时点击「开启声音」；支持停止、试玩暂停/继续和静音。参见 [音频说明](../studio/docs/audio-assets.md)。
 
+界面动效和全屏动效通过 `/qxqy-vfx/ct-v1/` 按需缓存 C/T WebM、图标和声音。`/editor` 支持静音动态预览，两个试玩入口都支持 Lua 驱动的动效播放；`/` 编辑模式仍为静态 PNG。资源失败不停止编辑/试玩。参见 [动效播放、缓存与截图边界](../studio/docs/ui-vfx-playback.md)。
+
 ## 部署与访问控制
 
 绑定非回环地址前，设置 `QXQY_WEB_PASSWORD`，登录用户名固定为 `simulator`。设置口令后，即使回环访问也要求认证。业务静态文件、API、SSE 与截图均受保护；写请求只接受 JSON 并校验浏览器 Origin。路径只能落在配置工作区内。

package/dist/public/app.js

@@ -33,6 +33,7 @@ const elements = {
   stageShell: byId('stage-shell'),
   stageImage: byId('stage-image'),
   stageCanvas: byId('stage-canvas'),
+  stagePlay: byId('stage-play'),
   stageEmpty: byId('stage-empty'),
   stageLoading: byId('stage-loading'),
   activePath: byId('active-path'),
@@ -218,6 +219,8 @@ function renderStage() {
   const showPlay = hasArchive && mode === 'play' && Boolean(model?.play?.running)
   elements.stageImage.hidden = !showEditor
   elements.stageCanvas.hidden = !showPlay
+  elements.stagePlay.hidden = !showPlay
+  resizePlayStage()
   elements.stageEmpty.hidden = showEditor || showPlay
   elements.stageShell.classList.toggle('playing', mode === 'play' && Boolean(model?.play?.running))
   if (!hasArchive) {
@@ -243,6 +246,17 @@ function renderStage() {
     : t('编辑器静态预览 · 磁盘自动刷新')
 }
 
+// The video planes and transparent Pixi canvas share this exact viewport, not
+// the padded workspace around it. Keep letterboxing and clipping in one place.
+function resizePlayStage() {
+  const width = model?.play?.width || 1600, height = model?.play?.height || 900
+  const scale = Math.max(0.01, Math.min((elements.stageShell.clientWidth - 70) / width, (elements.stageShell.clientHeight - 80) / height))
+  elements.stagePlay.style.width = `${width * scale}px`
+  elements.stagePlay.style.height = `${height * scale}px`
+}
+const stageResize = new ResizeObserver(resizePlayStage)
+stageResize.observe(elements.stageShell)
+
 function refreshEditorImage() {
   if (!model?.activePath) return
   if (editorImageRefreshing) {
@@ -308,6 +322,7 @@ function syncPlayPolling() {
 
 async function onPlaySnapshot(next) {
   applyPlayStatus(next)
+  resizePlayStage()
   updatePlayChrome()
 }
 
@@ -391,8 +406,8 @@ const play = createPlaySession({
   onStatus: (next) => { applyPlayStatus(next); updatePlayChrome() },
   onError: (error) => notify(error.message, true),
   onAudioStatus: status => {
-    elements.playAudio.textContent = !status.unlocked ? t('开启声音') : status.muted ? t('声音已关闭') : t('声音已开启')
-    elements.playAudio.title = status.error || (!status.unlocked ? t('点击或在画布内操作以解锁音效') : t('切换静音'))
+    elements.playAudio.textContent = status.muted ? t('声音已关闭') : !status.unlocked ? t('开启声音') : t('声音已开启')
+    elements.playAudio.title = status.error || (status.muted || status.unlocked ? t('切换静音') : t('点击或在画布内操作以解锁音效'))
   },
   isActive: () => mode === 'play',
 })
@@ -499,5 +514,5 @@ events.addEventListener('state', (event) => {
 })
 
 setInterval(() => { void refreshState({ quiet: true }) }, 5000)
-addEventListener('pagehide', () => play.destroy())
+addEventListener('pagehide', () => { stageResize.disconnect(); play.destroy() })
 void refreshState()