SuperAPI AI 工具集

design-system

设计与创作

查看项目

更新于 10-15 19:54

技能介绍

用途:design-system 是 markdown-html 插件的共享品牌所有者,运行一次引导后,md-document、md-review、md-slides 等转换器通过 config_loader.py 读取配置,套用同一组 12 个 CSS 自定义属性;不运行则输出为无品牌的占位默认样式。

主要能力:包含三个仅用标准库、无 LLM 调用的 Python 工具。onboard.py 为交互式向导,也支持 --defaults、--set、--show、--reset、--scope 等参数;config_loader.py 按项目 > 全局 > 默认的优先级加载配置,可用 MARKDOWN_HTML_NO_CONFIG=1 绕过;brand_palette_validator.py 做 WCAG-AA 对比度校验并派生 HSL 调色板。

使用方式:首次转换前运行 python3 markdown-html/skills/design-system/scripts/onboard.py;CI 或临时环境用 --defaults;单字段修改如 python3 .../onboard.py --set brand.primary=#FF6B35;按仓库覆盖用 --scope project;重置用 --reset。配置存于 ~/.config/markdown-html/design-system.json 或项目内 ./.markdown-html/design-system.json。

限制:正文对比度须达 4.5:1,否则拒绝保存(退出码 4);输出目录须可写(退出码 3)。仅支持 Google Fonts,不托管本地字体;只含 12 个令牌,非完整设计令牌系统;不做无障碍审计,仅强制对比度;不转换已有 CSS。

适用场景:需要让 Markdown 转 HTML 输出保持统一品牌风格的工程文档、评审与幻灯片生成流程。