用途:为 Magento 2 中的 Hyvä 主题编译 Tailwind CSS,适用于用户需要构建样式、生成 CSS 或运行 Tailwind 的场景,涵盖生产构建与开发监听模式。
主要能力与用法:
- 检测环境并确定命令包装方式,使用 hyva-exec-shell-cmd 技能;文中 npm 命令均为核心命令,需按检测到的环境包装。
- 识别主题:未提供主题路径时,调用 hyva-theme-list 技能发现可用主题,默认只保留 app/design/frontend/ 下的主题;vendor/hyva-themes/ 下的主题需用户明确要求。若未找到,提示用户在 app/design/frontend/ 中未发现带 Tailwind 配置的 Hyvä 主题,询问是否检查 vendor/hyva-themes/ 或先用 hyva-child-theme 技能创建子主题。
- 安装依赖并构建:默认生产构建,仅当用户明确要求 watch、watch mode 或 live reload 时才用监听模式。node_modules 缺失时先安装: if [ ! -d "<theme-path>/web/tailwind/node_modules" ]; then cd <theme-path>/web/tailwind && npm ci fi 生产构建:cd <theme-path>/web/tailwind && npm run build 监听模式:cd <theme-path>/web/tailwind && npm run watch
- 验证输出:编译后的 CSS 位于 <theme-path>/web/css/styles.css,通过检查修改时间确认文件已更新。
常见问题:缺少 node_modules 时运行 npm ci;样式未更新时清除浏览器缓存,生产模式下运行 bin/magento setup:static-content:deploy。
限制:主题发现默认限定在 app/design/frontend/;vendor 目录主题和子主题创建需额外技能或用户明确请求。其他收费、平台与版本信息暂未提供。