用途：面向 Makepad 项目的诊断与参考资料，集中在构建失败、控件查找、重绘和布局问题上，需对照项目锁定的确切运行时修订版本使用。
适用时机：需要常见 Makepad 错误的速查资料、调试或 API 查询时；任务偏诊断或查阅，而非在单一子系统中编写功能；想先找一个总入口再进入更专门的 Makepad 技能。
导航主题：API 文档（官方文档索引与快速 API 参考）、Troubleshooting（常见错误与修复）、Code Quality（Makepad 感知的重构）、Adaptive Layout（桌面/移动响应式与跨平台布局）。
常见问题速查：no matching field: font 改用 text_style: <THEME_FONT_*>{};颜色解析错误需检查已安装的 live-design 解析器语法，改动合法十六进制颜色并非通用修复；set_text 缺参需把 cx 作为第一个参数；UI 不更新需在修改后调用 redraw(cx)；控件找不到需检查 ID 拼写并用 ids!() 表示路径。
调试技巧：MAKEPAD=lines cargo run 可带行号信息运行以获得更好错误信息，需使用项目固定的工具链并核实该修订版的诊断标志；可用 log!("Value: {:?}", my_value); 与 log!("State: {} / {}", self.counter, self.is_loading); 添加日志。
其他资源：Makepad 官方文档、Makepad 仓库、Robrix 与 Moly 生产参考。
限制：仅在任务明确匹配上述范围时使用；输出不能替代针对具体环境的验证、测试或专家评审；缺少必要输入、权限、安全边界或成功标准时应停下并请求澄清；导航表只是主题名称而非随附参考文件；修改代码前须核实确切 API 签名与项目工具链；日志中应保留私有值；需实际测试控件更新、输入与目标布局，而不是假设 redraw 调用能解决所有问题。