makepad-2.0-app-structure

makepad-2.0-app-structure 技能概览

这个技能能做什么

makepad-2.0-app-structure 技能可以帮助你基于正确的 Rust + Splash 结构来构建或改造 Makepad 2.0 应用，而不是靠猜 boilerplate。它最适合在你需要一个可工作的应用外壳、事件路由、热重载配置，或者真正符合 Makepad 模式的 Rust 与 Splash 集成时使用。

适合谁使用

如果你正在新建一个 Makepad 应用、整理现有项目，或者想弄清楚 App::run、app_main!、MatchEvent、ScriptVm 和 from_script_mod 分别放在什么位置，就应该用 makepad-2.0-app-structure 技能。它特别适合 Makepad 里的前端式 UI 工作，尤其是在应用结构、脚本和运行时动作比通用 Rust 建议更重要的时候。

它最擅长什么

这个技能最擅长处理应用脚手架、模板选择，以及会直接影响落地的集成决策：Cargo 配置、最小可运行结构、hot reload / live reload，以及 Splash 脚本如何连接 Rust 逻辑。makepad-2.0-app-structure 技能在你需要解读仓库里的参考文档，而不是盲目照抄代码片段时，也很有用。

如何使用 makepad-2.0-app-structure 技能

正确安装并触发它

使用以下命令安装：
npx skills add ZhangHanDong/makepad-skills --skill makepad-2.0-app-structure

然后用一条明确说明你的目标、当前文件和目标运行环境的提示词来触发 makepad-2.0-app-structure 技能。好的触发方式会提到 makepad new project、Cargo.toml setup、--hot、wasm deploy，如果你的应用包含音频相关需求，也可以直接说明。

你的请求里该包含什么

这个技能在你提供应用类型、当前目录结构，以及你希望输出什么内容时效果最好：是一个 starter app、迁移方案、UI 外壳，还是 Rust/Splash 连接方式。如果你已经有代码，请把相关的 Cargo.toml、应用入口文件，以及现有的 widget 或 script module 名称一并贴上，这样技能就能按实际结构来分析，而不是凭空编造。

优先阅读哪些文件

先看 SKILL.md，再阅读 references/app-boilerplate.md 获取最小可运行模板，阅读 references/rust-splash-integration.md 了解通信模式。这两个文件正好回答了最常卡住安装决策的实际问题：应用如何启动、脚本放在哪里，以及 UI 回调如何回到 Rust 业务逻辑。

能产出更好结果的工作流

更有效的 makepad-2.0-app-structure usage 工作流是：1）描述目标应用，2）确认你要的是纯 Rust 逻辑、Splash 驱动的 UI，还是两者都要，3）要求给出精确的文件结构和启动顺序，4）在写代码前先要一份简短实现计划。比如：“我需要一个支持 hot reload 的 Makepad 2.0 桌面计数器应用，单窗口，有一个 Rust action handler；请给出文件布局和最小的 App::run 路径。”

makepad-2.0-app-structure 技能 FAQ

它只适用于 Makepad 2.0 吗？

是的。makepad-2.0-app-structure 技能面向的是 Makepad 2.0 的应用结构和 Rust 集成，不是通用 Rust UI 框架。如果你没有用到 Makepad 的应用生命周期、script modules 和 widget refs，普通提示词通常就够了。

我需要很专业才能用吗？

不需要。只要你能说明清楚目标，并提供部分文件树，它就很适合初学者。新手最常见的坑，是只说“做一个应用”，却没有说明你需要的是模板、迁移方案还是集成示例；当请求里明确起点时，技能表现会更好。

什么情况下不该用它？

如果你只需要孤立的 Rust 语法帮助、应用里没有 Splash scripting，或者你要的是与 Makepad 结构无关的设计建议，就不要用 makepad-2.0-app-structure。如果你需要的是超出应用启动和 UI 动作连线之外的深层产品架构，它也不太适合。

它和普通提示词有什么不同？

普通提示词可能也能给你一份看起来合理的 Makepad 代码，但这个技能是围绕仓库的真实结构、参考文档和集成模式调过的。当你希望 makepad-2.0-app-structure 指南能减少模板、事件处理和模块注册方面的猜测时，这一点就很重要。

如何改进 makepad-2.0-app-structure 技能

给技能加上正确的约束

提升结果最快的方法，是明确哪些内容绝不能变：edition、目标平台、对 hot reload 的预期、已有模块名，或者你是否在用带 ScriptVm 的 App::run。约束越精确，makepad-2.0-app-structure skill 越不容易给出一个“看起来对、其实不适合你项目”的结构。

提供更强的起始材料

不要只说“帮我做一个 Makepad 应用”，而是提供当前的 Cargo.toml、src/ 入口文件，以及一个有代表性的 UI module 或 action handler。如果你是在迁移，就说明哪些部分已经能跑、哪些地方坏了，比如：“窗口能渲染，但 handle_actions 从来收不到按钮点击。”

注意常见失败模式

最常见的失败，是把 Rust 侧逻辑和 Splash 侧 UI 职责混在一起，最后代码要么编译得不好，要么很难继续扩展。另一种失败，是没有说清应用应该是最小化、分模块，还是要适配 hot reload，结果技能走到了错误的模板路径。

从一个小的可运行切片开始迭代

可以先让技能给出一个最小可启动结构，等基础应用稳定后，再逐步扩展到多模块组合、脚本回调，或者音频 / 媒体集成。对于 makepad-2.0-app-structure usage 来说，这种分步骤的方式通常比一次性要求最终成品，产出的结果更干净。