makepad-2.0-splash

makepad-2.0-splash 技能概览

makepad-2.0-splash 的作用

makepad-2.0-splash 技能用于处理 Makepad 2.0 Splash，也就是 script_mod!{} 内使用的运行时 UI 脚本语言。它可以帮助你生成或改写 Splash 代码，用于交互式 UI、有状态组件、热重载流程和 Canvas 驱动应用，而不用从零散示例里自己猜语法。

适合谁使用

如果你正在用 Rust 构建 Makepad UI，并且需要可靠的 Splash 语法、状态管理、事件绑定或渲染/更新模式，那么就适合使用 makepad-2.0-splash 技能。它尤其适合涉及实时 UI 行为、标签页切换、计时器、文本更新，或要求脚本第一次就能通过的应用壳层等前端开发任务。

它的不同之处

和一个泛泛的 Makepad 提示词不同，这个技能是基于真实的 Splash 规则来工作的：空白分隔语法、use mod.prelude.widgets.*、script_mod!{}、mod.state，以及 on_render/fn tick() 这类交互模式。也正因为如此，当你的卡点不是设计，而是脚本结构和运行时模型是否正确时，makepad-2.0-splash 会更有用。

如何使用 makepad-2.0-splash 技能

按正确顺序安装并阅读

要安装 makepad-2.0-splash，先走仓库里的 skill 安装流程，然后从 skills/makepad-2.0-splash/SKILL.md 开始读。接着再看 references/splash-language-reference.md 了解语法规则，读 references/splash-scripting-patterns.md 了解可工作的应用模式；如果你的应用是通过 Canvas 或 POST /splash 工作流驱动的，再看 references/canvas-splash-patterns.md。按这个顺序走，能让你更快从安装过渡到真正可用的 makepad-2.0-splash usage。

把模糊目标转成高质量提示词

makepad-2.0-splash 安装后的最佳效果，来自提供一个具体的 UI 任务，而不是一句笼统的“做个 Splash app”。高质量输入会明确 widget 树、状态和交互模型，例如：“构建一个带计数器状态、标签页切换和启动时渲染的双标签 Splash UI。” 低质量输入则会遗漏约束，迫使模型去猜 widget 结构、更新路径，以及代码应该使用 script_eval!、on_render 还是 fn tick()。

用仓库里的模式，而不是只看标题

在 makepad-2.0-splash usage 里，真正影响正确性的，是那些具体模式：先定义 let 绑定再使用，保持状态局部且显式，并遵循交互发生在 Splash 内部、而不是反复重新提交代码的运行时模型。如果你在生成 Canvas 代码，canvas-splash-patterns.md 是最重要的决策指南，因为它解释了什么时候只需要 POST 一次、如何刷新数据，以及为什么循环 POST 会破坏 widget 状态。

提升输出质量的实用工作流

一个更稳的 makepad-2.0-splash guide 工作流是：先描述 UI 目标，再识别持久状态，接着选择事件来源，最后要求生成符合仓库语法的代码。如果你希望结果能直接粘到 Rust 里，就要明确输出只要 Splash 代码块，还是需要完整的 script_mod!{} 包装。你还应该说明是否需要兼容热重载、兼容 Canvas，或者只是一个最小示例，因为这些约束会直接改变生成脚本的结构。

makepad-2.0-splash 技能常见问题

makepad-2.0-splash 只适用于 Makepad 2.0 吗？

是的。这个技能主要面向 Makepad 2.0 Splash，不是旧的 live_design! 工作流，也不是通用 UI 脚本。如果你的代码库仍然依赖编译期 UI 宏，它或许能帮助你理解迁移思路，但不能替代专门的迁移方案。

安装前需要先懂 Splash 吗？

不需要，但你必须知道自己想要的应用结果。这个技能对结构化 UI 任务很友好，因为它会暴露语法和可工作的模式；不过它默认你能把 widget 树、状态变化或事件流描述得足够清楚，这样 makepad-2.0-splash 才能生成有用的代码。

什么情况下不适合用它？

如果你只是需要通用 Rust 帮助、类似 CSS 的样式建议，或者只是想问一个没有 Makepad 背景的“前端开发”问题，就不要用 makepad-2.0-splash。当任务主要是架构设计，而不是 Splash 语法、运行时状态或 Canvas 执行规则时，它也不是一个好的选择。

它和普通提示词相比有什么区别？

普通提示词也能给出看起来合理的答案，但更容易漏掉 Splash 的专有约束，比如空白语法、widget 作用域或运行时更新模型。对 makepad-2.0-splash skill 来说，正确性比头脑风暴更重要，尤其是当你要马上运行这段代码时，它会更有价值。

如何改进 makepad-2.0-splash 技能

补上缺失的状态模型

提升质量最明显的一步，就是把状态明确写出来。不要只说“做一个仪表盘”，而要给出像 selected_tab、elapsed、items、connected 这样的字段，以及每个字段如何变化。这样 makepad-2.0-splash 生成的代码会更容易渲染、更新和调试。

明确交互边界

告诉技能在启动时、点击时、tick 时，或者数据刷新时应该发生什么。很多失败都来自事件归属不清，最终生成的代码只能渲染一次，却不能正确更新。对于 makepad-2.0-splash 来说，你在一开始把事件循环定义得越清楚，后面第一次输出后要做的修补就越少。

要求合适的完整度

如果你只需要片段，就直接说明。如果你需要可直接粘贴的完整代码块，就要求完整的 script_mod!{} 结构，并说明是否要包含 Rust 样板代码。这样可以避免输出只在局部看起来正确、却无法放进你项目里的半成品。

先修语法，再调行为

如果第一版已经接近目标但还不合法，先修语法问题，再提新功能。然后再细调布局、状态和事件流。对于 makepad-2.0-splash 来说，最常见的改进循环就是：先修正 widget 作用域，再确认渲染/更新模式，最后根据你的真实应用优化 UI 结构。