新手引导：在真实界面上的导览

玩家看到什么

• 任意界面上被高亮的元素，其余部分变暗；布局变化时高亮会跟随元素。
• 提示气泡：玩家自己关闭的步骤上有“下一步”，流程允许时有“跳过”。
• 等待真实操作的步骤：提示会一直保留，直到玩家在游戏中完成该操作。
• 流程结束时的奖励，以及用来重玩允许的流程的“新手引导”列表。

如何运作

• 每一步通过锚点指向元素：任意模块任意元素上的 data-tutorial-anchor。
• 游戏设置允许时，流程可以自动开始，例如在首次访问时。
• 每个展示过的步骤都会上报，从而在后台分析中形成新手引导漏斗。

开发者须知

新手引导通过 @idosgames/core 中的 client.tutorial 工作；遮罩层通过锚点找到元素。

// 任意模块的任意元素都可以作为引导锚点
<button data-tutorial-anchor="play:start">Play</button>
// 大厅标签页是 tab:{featureID}，个人资料按钮是 lobby:profile，
// 游戏的“开始”按钮是 play:{modeID}

• 为流程指向的元素加上标记；没有对应元素的锚点会一直等待它出现。
• 步骤通过 reportStepShown 上报、通过 completeStep 完成：遮罩层会替你处理。

每个字段都在技能 tutorial-system 中有说明，由 SDK 的 MCP 服务器提供。