dsh-plugin-beyond-simulator 2.0.8 → 2.0.10

package/dsh-plugin/lib/play.html

@@ -24,7 +24,7 @@
     <header class="bar">
       <div class="brand"><span class="icon">UI</span><strong>模拟器</strong><select id="deviceSel" class="devsel hidden" aria-label="切换设备画布" title="切换设备画布：以新画布重建运行时，GetUICanvasSize 与预设像素一致"></select><select id="playerCountSel" class="playersel hidden" aria-label="试玩人数" title="试玩人数：最多 8 人，每人一份独立客户端"></select><select id="playerViewSel" class="viewsel hidden" aria-label="当前玩家视角" title="切换当前玩家视角：输入、画面和 PlayerSelf 都跟随该玩家"></select><span class="device">设备 <b id="resolution">准备中…</b></span></div>
       <div class="view-tabs" role="tablist" aria-label="试玩页面"><button class="active" data-view="play" role="tab">试玩</button><button data-view="log" role="tab">日志</button></div>
-      <div class="actions"><button id="pause">Ⅱ 暂停运行</button><button id="step" disabled title="暂停后可单帧调试">▷ 单帧调试</button><button class="stop" id="stop">■ 结束试玩</button><button class="primary hidden" id="restart">↻ 重新开始</button><button id="theme" title="切换亮暗主题">◐</button><button id="close">返回编辑</button></div>
+      <div class="actions"><button id="audio" data-audio-toggle title="点击解锁浏览器音效">开启声音</button><button id="pause">Ⅱ 暂停运行</button><button id="step" disabled title="暂停后可单帧调试">▷ 单帧调试</button><button class="stop" id="stop">■ 结束试玩</button><button class="primary hidden" id="restart">↻ 重新开始</button><button id="theme" title="切换亮暗主题">◐</button><button id="close">返回编辑</button></div>
     </header>
     <div class="views">
       <main class="workspace play-view" id="workspace"><div class="stage-shell veiled" id="shell"><div class="stage-label" id="stageLabel"></div><div class="stage" id="stage"><canvas id="cv" class="stage-canvas"></canvas></div></div><div class="loading" id="loading"><span class="spin"></span>正在准备试玩…</div><div class="fatal hidden" id="fatal"></div></main>
@@ -248,9 +248,14 @@
         onSnapshot: renderChrome,
         onStatus: applyStatus,
         onError: showError,
+        onAudioStatus: status => {
+          $('audio').textContent = !status.unlocked ? '开启声音' : status.muted ? '声音已关闭' : '声音已开启'
+          $('audio').title = status.error || (!status.unlocked ? '点击或在画布内操作以解锁音效' : '切换静音')
+        },
         isActive: () => !closing,
       })
       play.bindInput(stage, { keysOn: window })
+      $('audio').addEventListener('click', () => play.audio?.toggle())
 
       $('step').addEventListener('click', () => void play.act('step', { dt: 1 / 30 }))
       $('pause').addEventListener('click', () => void play.act(play.snapshot?.paused ? 'resume' : 'pause'))

package/dsh-plugin/presets/wonderland-lua-builder/skills/qxqy-game-studio/references/04-art-assets.md

@@ -10,7 +10,7 @@
 
 有真正视觉分歧时，在同一布局和玩法状态下提供少量可比较方向，请用户选择；没有分歧则采用推荐方向。按当前工作区和会话实际可用能力，使用像素画、图元拟合、UI 制作或帧动画 Skill。
 
-官方原神/千星素材可以使用。模拟器只预览 `100001–100006` 六种基础图元；其他官方图片显示缺失框，这是预览限制，记录真实目标 ID 并留待真机核验。高成本拼图或帧动画先准备关键样本，批量制作随步骤 5 的实现需要推进。
+官方原神/千星素材可以使用。模拟器对 `100001–100006` 使用基础图元代理，另支持固定白名单静态图片的按需下载与本地缓存；白名单外或加载失败仍显示缺失框，截图可通过 `assetWarnings` 区分下载失败。记录真实目标 ID，九宫格/动效及实际视觉仍留待真机核验。高成本拼图或帧动画先准备关键样本，批量制作随步骤 5 的实现需要推进。
 
 ### UI 还原规格
 

package/dsh-plugin/skill.md

@@ -181,7 +181,7 @@ play 动作：`start`（重建运行时；可带 `canvasId` 指定设备画布
 - 画布 5 个：`pc-16-9`(1600×900)、`pc-21-9`(2100×900)、`mobile-16-9`(1280×720)、`mobile-19.5-9`(1560×720)、`mobile-4-3`(1280×960)；原点左下，锚点相对父矩形 0–1。
 - **2D 游戏布局基准是手机 16:9（`mobile-16-9` / 1280×720）。** 整屏构图必须在该画布完整可见。PC 可用 1600×900 设计像素，但应把舞台放进固定设计尺寸的板，再按 `min(canvas/design)` 等比缩放（不足处留边），禁止按 PC 铺满后再在手机上裁切。缩放容器不要再加全屏不透明兄弟节点（试玩页同级先出现的子节点会盖住后面的舞台）。P0 至少覆盖 `mobile-16-9` 与 `pc-16-9`。
 - 多设备试玩：试玩 `device` 动作或 `start {canvasId}` 在五个预设间切换；切换只改画布宽高并选用对应平台的 RectTransform 槽位（PC→KEYBOARD/KeyboardAndMouse，手机→TOUCHSCREEN/Mobile），锚点在新父矩形下重新解算。
-- `imageId` 100001–100006 画占位图元，其他显示缺失框——不伪造官方素材。
+- `imageId` 100001–100006 使用图元代理；固定白名单静态图片按需从素材源下载，编辑器/试玩/截图共用缓存。未列入或加载失败显示缺失框，截图失败明细见 `assetWarnings`；不要把缺图直接判定为 Lua 错误。图片属性面板可重新下载素材；九宫格、动效及真机视觉一致性不在此预览承诺内。
 - 旋转进入运行时，但点击命中按旋转前轴对齐矩形计算。
 
 ## 排障（运行时）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-beyond-simulator",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "千星奇域客户端 UI 编辑与试玩模拟器 for DeepSeek Harness",
   "type": "module",
   "packageManager": "pnpm@10.15.0",