dsh-plugin-beyond-simulator

使用指南

1. 准备工程

一个存档集中管理三类资产：服务端 UI、客户端 UI 模板和 Lua 脚本。它们共同组成试玩所需的界面与逻辑。

• 从零开始：在编辑器中添加控件、创建客户端模板，再编写 Lua 脚本。
• 继续已有工程：从顶栏“工作区存档”选择已保存的项目，或点击“导入”打开本地文件。
• 迁入现有资产：导入支持的 UI JSON、GIA 或 Lua，再检查布局和脚本挂载关系。

编写 Lua 时，请让 AI 同时参考工作区中的千星 2D/Lua API 文档；模拟器安装包不包含官方知识库。需要从参考图制作美术时，也可以配合工作区已有的像素画、图元拟合、UI 制作或帧动画 Skill。

2. 编辑并试玩

1. 在“UI 编辑”页添加控件，调整属性，并切换 PC / 手机画布检查适配。
2. 在“Lua 脚本”页创建或导入脚本，将入口脚本挂载到客户端控件或客户端模板；模板脚本在模板实例化时运行。
3. 如果玩法需要服务端响应，在“服务端逻辑”页配置监听信号、设置变量和向玩家发送信号。
4. 点击“试玩 ↗”，在独立窗口中操作游戏。遇到问题时暂停、单步推进，并查看“日志”页中的脚本输出与运行状态。
5. 返回编辑器修改，再次试玩；需要检查多人交互时，调整试玩人数并切换玩家视角。

3. 让 AI 帮你测试

通过 Harness 插件或 MCP 接入后，可以直接描述要检查的行为，例如：

打开我的游戏存档，在手机 16:9 画布上试玩。点击开始按钮，检查得分是否变化，截取操作后的画面，并告诉我日志里有没有报错。

也可以把操作整理成可重复执行的测试：

把“开始游戏 → 点击目标 → 得分增加”记录成测试用例。修改脚本后重新回放，检查得分和界面状态是否符合预期。

AI 可以直接获取工程状态、发送输入、读取日志和截图，无需你手动切换到试玩窗口。涉及玩法规则时，请提供预期结果，例如“每次点击加 1 分”“玩家 1 的操作不应改变玩家 2 的分数”。

4. 保存与导出

继续开发时，优先保存完整存档；需要与外部编辑链路交换资产时，再选择相应导出格式。

目的	推荐方式
保存进度、备份或交给 AI 继续修改	导出“资产包 JSON（三类合一）”，保留 UI、脚本和挂载关系。
保存到 Web 服务的工作区	点击“保存存档”，填写工作区内的相对路径，例如 my-game.save.json。
与官方编辑器交换已支持的资产	导出对应的 GIA，并检查导出提示及导入后的实际效果。
单独交换 UI 或脚本	导出当前界面 Authoring JSON、脚本包或单个 Lua 脚本。

编辑和试玩不会自动把完整存档写入磁盘。Web 用户请显式保存，Harness 用户可导出 JSON，MCP 用户可让 AI 调用保存工具；关闭服务前先保存未完成的工作。