makepad-2.0-events

makepad-2.0-events 技能概览

makepad-2.0-events 是做什么的

makepad-2.0-events 技能用于处理 Makepad 2.0 的事件与 action 流转，避免你在 callback 形态、状态流转或渲染时机上靠猜。它最适合两类场景：一是把 Splash 里的 UI 交互接到 Rust 侧逻辑上，二是排查为什么某个事件没有触发、没有冒泡，或者没有更新视图。

适合谁使用

如果你在构建或维护 Makepad 前端 UI，尤其是依赖 on_click、on_render、on_return、on_startup、MatchEvent 或 script_eval! 的组件化应用，就适合使用 makepad-2.0-events 技能。它非常适合 Frontend Development 这类工作：难点不只是语法，而是要判断逻辑应该放在 Splash、Rust，还是两者之间的桥接层。

为什么它不一样

这个技能围绕的是 Makepad 的双层模型：一层是用于局部 UI 行为的内联 Splash handler，另一层是用于更广泛应用逻辑、异步任务和外部状态的 Rust event matching。这个分层本身就是是否采用它的关键判断点。如果你只需要一个泛泛的提示来“处理事件”，很容易漏掉 Makepad 特有的规则；而这个技能能帮你选对层，并正确接线。

如何使用 makepad-2.0-events 技能

安装后先读哪些文件

先用目录里常规的 skill 命令安装 makepad-2.0-events 技能，然后先打开 SKILL.md，再看 references/event-patterns.md。对这个仓库来说，这两个文件是最快进入可用 makepad-2.0-events usage 的路径，因为参考文件里有可直接套用、而不是从零重写的事件模式。

把模糊目标变成可用提示词

想要效果最好，描述清楚三件事：widget 或事件来源、你期望的状态变化、以及更新应该发生在哪里。一个弱请求是“让按钮能用”。更强的提示是：“用 makepad-2.0-events 把 Splash 里的 Button click 连接到 state.counter 的更新，然后通过 script_eval! 和 .render() 刷新 label。”这样技能才有足够结构去判断该用内联 handler、Rust matching，还是运行时 patching。

仓库里应该重点看什么

先看 references/event-patterns.md，里面有完整流程示例，比如按钮点击、启动时渲染、以及由状态驱动的 UI 刷新。然后再看 SKILL.md 里的事件章节，重点关注 handler 名称、桥接宏和作用域边界。如果你要把模式迁移到自己的应用里，先搜最接近的现有事件路径，再决定要不要发明一条新的。

实战使用技巧

尽量采用最小但完整的事件链：事件源、handler、状态修改、重新渲染。在 Makepad 2.0 里，使用上的问题通常不是出在语法，而是把逻辑放错层，或者状态变更后忘了触发 render。使用 makepad-2.0-events 技能做 Frontend Development 时，要在提示词里明确说明：回答应当留在 Splash、迁移到 Rust，还是通过 script_eval! 或 script_apply_eval! 跨桥处理。

makepad-2.0-events 技能常见问题

这只适用于 Makepad 2.0 的 UI 事件吗？

是的。makepad-2.0-events 技能专门面向 Makepad 2.0 的事件与 action 处理，不是通用前端事件系统。如果你用的是 React、Vue 或其他框架，思路可能有参考价值，但代码不能直接照搬。

使用前需要先懂 Makepad 吗？

有基本 Makepad 认知会更顺手，但即使你还在学习框架，这个技能也依然有价值，因为它提供的是一份可安装的事件流指南。尤其当你已经知道 UI 想做什么，但不确定该写 on_click、MatchEvent 还是桥接宏时，它会很有帮助。

什么情况下不该用这个技能？

如果你的任务主要是布局、样式，或者与应用架构本身无关，就不必优先用 makepad-2.0-events。另外，如果问题本身不是事件驱动的，也可以跳过它，因为这个技能优化的重点是交互处理、callback 行为和状态更新。

它为什么比通用提示词更好？

通用提示词可能只会抽象地解释事件，但 makepad-2.0-events 技能是按 Makepad 的实际控制流、命名方式和代码形态来调校的。只要你需要的是一条能跑通的事件路径，而不只是概念解释，这一点就很关键。

如何改进 makepad-2.0-events 技能

把完整交互路径说清楚

最好的 makepad-2.0-events usage 来自于明确事件来源、预期输出和状态归属方。比如：“当 TextInput 变化时，在 Splash 里更新 state.query，只在 Rust 侧做 debounce，然后重新渲染过滤后的列表。”这比简单说“处理输入变化”更有效，因为它告诉技能逻辑该放在哪里，以及什么行为才算成功。

写明你遇到的失败现象

如果你是在排错，请直接说出症状：callback 没触发、状态变了但 UI 没刷新、或者 action 已经到了 Rust 但没有影响 widget tree。这些细节能帮助 makepad-2.0-events 技能区分是 handler 绑定问题、bridge 使用问题，还是 render 时机问题。

基于可工作的模式逐步迭代

先拿参考示例做底，再一次只改一个变量：widget 类型、事件类型，或者状态更新路径。这样能减少猜测，也更容易判断问题到底是语法、作用域，还是生命周期。对于 makepad-2.0-events 来说，这通常是提升输出质量最快的方法。

直接要求你真正需要的层

如果你只需要本地 UI 行为，就明确要求 Splash-only 方案。如果你需要业务逻辑、异步工作或外部集成，就要求 Rust 侧的 MatchEvent 流程。清晰地选层是这个技能最重要的质量杠杆，也能避免把多个关注点混在一起，导致回答过度复杂。