SuperAPI AI 工具集

flutter-duskmoon-design

设计与创作

查看项目

更新于 10-16 05:50

技能介绍

该技能用于在编写 Flutter 代码、使用 flutter_duskmoon_ui 系列包,或创建、修改消费 DmTheme、DmDesignTokens 的组件时提供设计原则与使用规则。

用途:指导基于 DuskMoon UI 的 Flutter 应用开发,确保主题、颜色、平台适配和组件用法一致。

主要能力:

  1. 架构与依赖:包依赖方向为 duskmoon_theme → duskmoon_widgets → duskmoon_settings / duskmoon_feedback / duskmoon_ui,禁止下游反向导入。
  2. 主题设置:应用根组件应使用 DuskmoonApp,传入 tokens、darkTokens、themeMode、platformStyle,由它注入 DmTheme;不要直接用 MaterialApp/CupertinoApp 包裹。
  3. 令牌访问:组件内通过 DmTheme.of(context).tokens 读取,避免直接引用生成常量或硬编码颜色。
  4. 颜色系统:每套主题含 61 个颜色令牌,按 primary、secondary、tertiary、error、surface、outline、inverse、scrim/shadow、semantic 分组,颜色以 OKLCH 定义并转换为 Color;背景与前景令牌需成对使用。
  5. 主题:sunshine、moonlight、ocean、forest、sunset 五套。
  6. 平台自适应:DmAdaptiveWidget 按 platformOverride、DmPlatformOverride、DmTheme.platformStyle、defaultTargetPlatform 顺序解析,支持 material、cupertino、fluent。
  7. 共享枚举:DmColorRole、DmSize、DmButtonVariant、DmInputVariant。
  8. 组件规则:涵盖按钮、图标按钮、FAB、操作列表、AppBar、底部导航、TabBar、Drawer、面包屑、卡片、分割线、Scaffold、徽章、Chip、头像、统计块、表格等组件的令牌映射与用法约定。

使用方式:在 Flutter 项目中按上述规则编写代码,使用 DuskmoonApp 作为根,组件继承 DmAdaptiveWidget 并实现 buildMaterial/buildCupertino/buildFluent。

适用场景:需要统一设计令牌、支持多主题与多平台风格适配的 Flutter 应用开发。

限制:资料未提供安装命令、版本要求、收费信息及完整 API 列表;部分内容(如 Rule 11 标题)在资料中不完整。