SuperAPI AI 工具集

hyva-ui-component

前端与建站

查看项目

更新于 10-15 22:15

技能介绍

用途:将 Hyva UI 中基于模板(非 CMS)的组件安装到指定的 Hyvä 主题,把组件源文件复制到主题目录 app/design/frontend/{Vendor}/{Theme}/。

主要能力:

  • 校验 Hyva UI 是否安装,路径变量 {hyva_ui_path} 默认为 vendor/hyva-themes/hyva-ui,也可由用户自定义。未找到时可提供自定义解压路径、或执行 composer require --dev hyva-themes/hyva-ui、或从官方下载。安装后可用 <skill_path>/scripts/refresh_catalog.sh {hyva_ui_path} <skill_path>/references/components.md 刷新组件目录。
  • 通过 hyva-theme-list 技能查找 app/design/frontend/ 下已有主题,或先经 hyva-child-theme 技能创建新子主题。
  • 只列出“Non-CMS Components (Template-Based)”部分,不展示 CMS 组件与 plugins。
  • 展示变体(A=Basic、B=Enhanced、C=Advanced、D=Specialized)并阅读组件 README,说明依赖与配置项。
  • 复制前对比目标文件,标注 created 或 updated;对已存在的 layout XML 采用合并而非覆盖。
  • 若 README 含 XML 配置,将其 <var> 项(含默认值与注释)写入或创建 {theme_path}/etc/view.xml,保留原有内容与注释。
  • 自动处理依赖:plugin 依赖、组件依赖、外部包(如 composer require hyva-themes/magento2-hyva-payment-icons)。
  • 仅在用户确认后重编译 Tailwind(配合 hyva-compile-tailwind-css 技能),不自动构建。
  • 输出修改文件清单与 XML 配置表格,含 Option、Value、Description。

用法:需在开发环境执行 bin/magento 等命令时,通过 hyva-exec-shell-cmd 技能探测环境并确定命令包装方式。复制命令为 cp -r {hyva_ui_path}/components/{component}/{variant}/src/* {theme_path}/。

限制:仅适用于非 CMS、基于模板的 Hyva UI 组件;CMS 组件与 plugins 不在此技能直接安装范围内,因其依赖 CMS Tailwind JIT 编译器或属内部依赖。资料未提供具体组件数量、版本兼容范围与效果说明。