用途:在 Vendure 前端与主题开发中正确应用和审查 @vendure-io/design-tokens,让组件代码保持语义化,并根据当前宿主选择正确的令牌所有权模式。
主要能力:先做所有权分类,检查 git 远程和本地代码;若 origin 或 upstream 的 GitHub 属主恰为 vendurehq(不区分大小写)则视为 Vendure 自有仓库;若代码从 @vendure/dashboard 导入或调用 defineDashboardExtension,或 VendurePlugin 声明了 dashboard 入口,则视为 Dashboard 扩展。三种模式:Vendure 自有仓库直接消费已发布令牌值,不重定义;Dashboard 扩展继承宿主仪表盘主题,不重定义令牌值;独立外部应用保留语义契约,但允许有意重映射槽值并使用本地命名空间的语义槽。证据不足时按独立外部应用处理。
使用方式:组件与页面代码使用语义颜色槽,禁止在组件标记中直接使用通用调色板档位或字面颜色;brand、success、warning、destructive、info 等已发布语义色阶仅在需要固定强度时使用,常规状态优先用角色槽;通用色阶或字面值只允许出现在定义或重映射主题时。领域状态通过状态字典和六个共享色调映射。阅读 token-decisions.md 中与任务相关的语义颜色、表面与强度、排版、动效、主题所有权章节,并查看已安装包的 CSS 与导出以确认令牌名,勿臆造已存在的槽。Tailwind v4 应用优先使用 @vendure-io/design-tokens/css/theme,需自托管字体时单独导入 css/fonts,采用 CSS-first 配置,不要为 Vendure 主题创建 tailwind.config.js,暗色差异保留在令牌值中。
适用场景:主题搭建、前端样式、暗色模式、覆盖与外部品牌定制,以及颜色、表面层级、排版、动效的审查。
限制:Vendure 自有仓库中预期由 @vendure-io/design-lint 强制机械颜色规则;审查时报告缺失配置,未要求不要安装或重配工具。独立外部应用可建议使用 lint 包但保持可选。审查请求默认只读,需区分允许原始值的主题定义代码与不允许的组件代码,并报告证据与语义替换方案。资料未提供具体版本、价格与支持平台等信息。