dmc-best-practices

用途：为使用 Dash Mantine Components（DMC）构建 Dash 应用提供权威最佳实践，适用于编写、审查或重构此类应用。规则按优先级与类别组织，每类带有前缀，如 arch-、callback-、style-、data-、perf-、form-、theme-、v2-、a11y-。\n\n主要能力：覆盖九类规则。架构（CRITICAL，4 条）、回调（CRITICAL/HIGH，6 条）、样式（HIGH/MEDIUM，5 条）、数据管理（HIGH，4 条）、性能（MEDIUM-HIGH，3 条）、表单与验证（MEDIUM，2 条）、主题（MEDIUM，3 条）、DMC v2.x 迁移（MEDIUM，2 条）、无障碍（MEDIUM，1 条）。\n\n关键规则示例：用 MantineProvider 包裹布局；不要在回调中修改全局变量；不应触发回调的值用 State 而非 Input；在 app.run() 之前定义回调；防止循环回调；返回 JSON 可序列化值；仅用静态 CSS 选择器，不要针对 .m_* 动态类；自定义颜色需恰好 10 个色阶；客户端数据用 dcc.Store 而非全局变量；对文本输入做防抖。\n\n使用方式：参考 AGENTS.md 获取含全部规则的完整编译参考。当 DMC 审查输出需要机器可读证据时，可组织为 ui_audit.v1：target.framework 为 dmc；id 形如 dmc.arch-mantine-provider；category 按规则族映射（architecture→layout、callbacks→state、styling→layout、data→state、performance→performance、forms→interaction、theming→visual、migration→migration、accessibility→accessibility）；severity 中 CRITICAL、HIGH 映射为 error，MEDIUM-HIGH、MEDIUM 映射为 warning，低风险为 info；locations 为仓库相对路径或组件；docs 为相关规则 markdown 路径及外部组件文档。不需要修复的清单事实（如检测到的 DMC 版本、主题配置、回调数量）放入 observations。\n\n适用场景：开发、代码审查、重构 Dash + DMC 应用，以及需要结构化 UI 审计结果的场景。\n\n限制：资料未提供具体安装命令、依赖版本、收费或价格信息，相关内容暂未提供。