索引校准与旋转显示 · DSH 2.1.1 / Web 0.4.1 / MCP 0.4.1

千星沙箱模拟器更新

版本：DSH 2.1.1 / Web 0.4.1 / MCP 0.4.1

主要更新

• 修复客户端 GIA 层序：解决部分模板导入后前后遮挡颠倒的问题，独立导出和整合包均已修复。
• 新增索引批量校准：填写任意模板或子控件的实际索引，可按原生导入顺序自动填写整批客户端索引，并预览数量和范围。适用于同批导入、结构未增删或重排的模板。
• 完善 Lua 索引同步：提供「全量替换脚本索引」和「复制提示词给 AI」两条路径，衔接保存存档、AI 处理后重新载入，以及实机脚本更新。全量替换写前自动备份，也会修改同值的非索引内容，请检查结果。
• 支持 X/Y 旋转显示：属性面板可编辑 X/Y/Z，GIA 保留三轴旋转；编辑预览、试玩和截图支持压缩、侧立与背面镜像。
• 优化编辑体验：大批量索引详情可折叠，剪贴板不可用时支持手动复制，修正窄屏属性面板遮挡。

更新后重启模拟器服务或 Harness，并刷新网页。遇到旧版 GIA 层序问题时，使用原始完整存档重新导出。索引校准后请继续完成 Lua 同步并保存存档，再更新游戏脚本。

X/Y 单轴图片行为已有 PC 真机依据；混合轴和嵌套倾转仍采用模拟器策略，最终效果请在千星沙箱中试玩核对。

下载与安装

附件包含三个安装包及 SHA256SUMS。下载后可执行：

dsh plugin --profile web add ./dsh-plugin-beyond-simulator-2.1.1.tgz
npm install -g ./beyond-simulator-web-0.4.1.tgz
npm install -g ./beyond-simulator-mcp-0.4.1.tgz

npm 三包已成功暂存，等待维护者在 npm 的 Staged Packages 页面审核上线；审核前可使用本 Release 附件安装。

验证

• 本地自动化测试：345 通过、8 项条件测试跳过、0 失败。
• 本次一次性浏览器功能验收：4/4 通过，验收后脚本已清理，核心回归保留。
• Git 源码安装、三包独立安装及 Harness 0.2 完整启动验收通过。
• 附件来自本 Release tag 对应源码的本地构建，已通过独立安装检查。

构建与暂存记录 · 完整改动

图片预览与编辑体验 · DSH 2.1.0 / Web 0.4.0 / MCP 0.4.0

图片预览与编辑体验更新

版本：DSH 2.1.0 / Web 0.4.0 / MCP 0.4.0

主要更新

• 新增 2,720 个元件图标预览，支持按需加载和缓存。
• 新增图片「基础／拉伸」选择，支持三切片和九切片，调整面板、按钮尺寸时保留边框形状。
• 试玩和 PNG 截图支持矩形遮罩、像素羽化，并优化带遮罩场景的截图速度。
• 颜色与透明度分开编辑，支持取色器、十六进制颜色和 0–100% 透明度调整。
• 修复部分 GIA 导入千星沙箱后属性面板空白的问题，兼容可识别的旧异常存档。
• 优化实机脚本同步说明，保留原有布局和「发现本机目录」，补充填写示例、复制路径和下一步提示。

旧项目可继续使用。遇到上述 GIA 问题时，请在新版中重新打开原存档或 GIA，再导出。更新后重启模拟器服务或 Harness，并刷新网页；最终效果仍需在千星沙箱内试玩核对。

下载与安装

附件包含三个安装包及 SHA256SUMS。下载后可执行：

dsh plugin --profile web add ./dsh-plugin-beyond-simulator-2.1.0.tgz
npm install -g ./beyond-simulator-web-0.4.0.tgz
npm install -g ./beyond-simulator-mcp-0.4.0.tgz

npm 三包已暂存，等待维护者审核上线；审核前可使用本 Release 附件安装。

验证

• CI 自动化测试：326 通过、8 项条件测试跳过、0 失败。
• Git 源码安装、三包独立安装和 Harness 0.2 完整启动验收通过。
• 本 Release 附件为同一 tag 的本地构建，已通过三包独立安装检查。

构建记录 · 完整改动

DSH 2.0.11 · 修复路由重复注册

DSH 插件更新公告

2.0.11 · 2026-10-07

本次为 dsh-plugin-beyond-simulator@2.0.11 稳定性修复，解决主组件启动或重载时报 webserver: duplicate prefix route "/qxqy-simulator/api" 的问题。

修复内容

• 修复组件卸载时 HTTP 路由未注销的问题。同一组件重新激活或依赖服务重载后，可正常注册 API、试玩页、渲染脚本、图片和音频路由。
• 完善初始化失败回滚，清理本次已经注册的路由。
• 组件卸载时等待试玩 Worker 退出，并阻止迟到请求重新创建已卸载的会话。
• 增加生命周期回归验证，确保重启后网页与 AI 工具操作同一份工程。

该问题在只安装一份插件时也可触发，报错本身不代表重复安装。修复补齐了路由的生命周期清理。

安装与更新

可直接下载本 Release 附带的 dsh-plugin-beyond-simulator-2.0.11.tgz，通过实际使用的 Harness profile 安装。以下以 web profile 为例：

dsh plugin --profile web add ./dsh-plugin-beyond-simulator-2.0.11.tgz

npm 版本审核上线后，也可执行：

dsh plugin --profile web add dsh-plugin-beyond-simulator@2.0.11

更新后请从托盘完整退出 Harness，再重新启动，以清除旧进程残留的路由。保留原版 cordis.patch.yml，无需注释主组件的 insert。

验证

• 全量自动化测试：309 通过、7 项条件测试跳过、0 失败。
• DSH Tools 0.1 / 0.2 两套基线的独立安装包验证通过。
• 真实 Harness 0.2.0-rc.2 完整启动、带活跃 Worker 的组件重复重启，以及 HTTP/工具状态一致性验证通过。

反馈者 Desktop 环境的原始触发链及修复包回验仍待确认。npm 使用暂存审核流程，工作流成功不等于版本已公开；公开状态以 npm registry 为准。

图片与音频预览 · DSH 2.0.10 / MCP 0.3.4 / Web 0.3.6

图片素材与 Lua 2D 音效预览

版本

• dsh-plugin-beyond-simulator@2.0.10
• beyond-simulator-mcp@0.3.4
• beyond-simulator-web@0.3.6

主要更新

• 支持 1,516 个白名单静态图片 ID 的按需加载；编辑器、Pixi 试玩和 AI PNG 截图共用磁盘缓存，恢复透明留白并支持 RGB/alpha 着色与水平/垂直填充。
• 图片属性面板新增重新下载素材，同源试玩页同步刷新；补齐失败占位、加载警告、请求合并和缓存恢复。
• 接通 game.PlayAudio2D、game.StopAudio、game.IsAudioAlive，支持 1,997 个白名单音频 ID、MP3 按需缓存、浏览器声音解锁/静音、独立实例停止及暂停/继续。
• 改善 Desktop 内嵌试玩启动：已知受限宿主直接内嵌，弹窗访问或导航失败时自动回退。
• 修复安装包验收临时目录的 npm 项目边界，避免依赖安装到父目录。
• 包含前一提交对 #4–#7 的证据核验记录和 GetChildren API 回归测试；未将计时或点击参数的候选改动作为修复发布。

素材渲染、音频时长和生命周期的模拟策略见仓库 studio/docs/image-assets.md、studio/docs/audio-assets.md；模拟器验证不代表千星真机一致性。

验证

• 冻结锁文件安装及全仓测试：300 通过、7 项环境可选测试跳过、0 失败。
• Edge 图片、音频和内嵌试玩专项：5/5 通过。
• Git 纯源码安装、三个 tarball 仓库外安装通过（DSH Tools 0.1 / 0.2 基线）。
• Harness 0.2.0-rc.2 实际启动、工具、截图及试玩验收通过。

安装

npm install -g beyond-simulator-web@0.3.6
npm install -g beyond-simulator-mcp@0.3.4
dsh plugin --profile web add dsh-plugin-beyond-simulator@2.0.10

npm 版本以 registry 实际可查询结果为准；Trusted Publishing 的暂存流程仍需维护者审核上线。