SuperAPI AI 工具集

design-system-structure

设计与创作

查看项目

更新于 10-15 23:57

技能介绍

用途:为 Flutter 项目建立可维护的设计系统结构,规定 token、主题、组件与形状如何组织与消费,不涉及具体选色或圆角取值。

主要能力:两级 token——第一级原始值按测量值命名(如 neutral12),第二级语义槽按角色命名(surface、onSurface、hairline、accent),组件只读语义槽;通过 ThemeExtension 与断言式 of(context) 读取,不用静态常量类或 InheritedWidget 旁路;手写 ColorScheme 而非 ColorScheme.fromSeed,保留 M3 角色名;分层为 tokens→theme→modifiers/components→shapes,明暗主题各自手写并独立通过 AA;lerp 需诚实插值或有意跳变,copyWith 必填;颜色作为派生 token 最后计算,不作为状态的唯一通道;减少动态效果时折叠为 Duration.zero;首帧前恢复持久化主题;字体打包并用 LicenseRegistry 注册,不用 google_fonts 运行时拉取;CustomPainter 在组件层快照 token,paint() 不读 BuildContext。

使用方式:按任务阅读 references 下的 token-tiers-and-themeextension、motion-and-reduced-motion、typography-and-fonts、contrast-and-redundant-encoding;提交 PR 前运行 scripts/check_raw_values.sh 与 scripts/check_font_bundling.sh。

适用场景:需要统一主题、支持明暗模式与无障碍、避免散落硬编码美学值的 Flutter 应用。

限制:不负责具体颜色与圆角选择;不覆盖无障碍状态读取、画布手势、性能、状态管理等,需配合相关技能;小型单包应用不建议引入 DTCG/Style Dictionary 等 token 流水线。具体安装与版本信息暂未提供。