SuperAPI AI 工具集

hyva-tailwind-include-exclude

前端与建站

查看项目

更新于 10-15 22:15

技能介绍

用途:该技能向主题的 hyva.config.json(位于 <theme-path>/web/tailwind/hyva.config.json)中 tailwind.include 或 tailwind.exclude 数组添加 { "src": "<PATH>" } 条目,用于在 Tailwind CSS 编译中包含或排除某个模块路径。这是 Hyvä 1.4+ / Tailwind v4 的机制,更早的版本需要另行处理。

主要能力:先确认目标是包含还是排除;通过 hyva-theme-list 技能查找主题;检查主题所用 tailwindcss 主版本;解析模块路径;更新目标配置文件并报告结果;最后可提供重新编译 Tailwind CSS 的选项,使改动生效。

使用方式:依赖 hyva-theme-list 与 hyva-compile-tailwind-css 两个技能。配置文件路径为 <theme-path>/web/tailwind/hyva.config.json。排除时路径必须与 app/etc/hyva-themes.json 中登记的一致,并以该处登记的源路径为准;未登记的模块无法排除。包含时可使用相对项目根的目录、Vendor_Module 名称或目录名,技能会据此在 app/code/ 或 vendor/ 下解析。若已有条目会跳过;若出现在相反列表会提示是否移除。

适用场景:需要让某个模块的 Tailwind 样式参与编译或排除在编译之外,且使用 Hyvä 1.4+ / Tailwind v4。若主题 tailwindcss 主版本为 3,则不应创建或编辑该文件,而应改用 postcss.config.js 的 excludeDirs 或 tailwind.config.js 的 content 数组。

限制:改动在重新编译前不产生可见效果;vendor/ 下的主题改动会在 composer update 后丢失,需确认;hyva.config.json 不存在时按 { "tailwind": { "<target>": [] } } 创建,若文件存在但 JSON 无效则停止且不覆盖。价格与其他平台信息资料未提供。