SuperAPI AI 工具集

web-artifacts-builder

前端与建站

查看项目

更新于 10-15 08:33

技能介绍

用途

web-artifacts-builder 是一套用于创建 claude.ai HTML artifact 的工具。它面向希望构建结构较为复杂、由多个组件组成的前端界面的场景,通过现代前端 Web 技术栈来实现,并最终产出单个可直接在 Claude 对话中分享的 HTML 文件。

技术栈

该工具套件使用的栈包括:React 18、TypeScript、Vite、Parcel(用于打包)、Tailwind CSS 以及 shadcn/ui。

主要能力

  • 通过 scripts/init-artifact.sh 初始化前端仓库,生成一个已完整配置的 React 项目。
  • 生成的项目包含:React + TypeScript(经由 Vite)、Tailwind CSS 3.4.1 及 shadcn/ui 主题系统、配置好的路径别名(@/)、预装的 40 多个 shadcn/ui 组件、全部 Radix UI 依赖、通过 .parcelrc 配置的 Parcel 打包支持,以及 Node 18+ 兼容性(自动检测并固定 Vite 版本)。
  • 通过 scripts/bundle-artifact.sh 将 React 应用打包为单个 HTML artifact。该脚本会安装打包相关依赖(parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline),创建带路径别名支持的 .parcelrc 配置,使用 Parcel 构建(不生成 source map),再通过 html-inline 将所有资源内联为单个 HTML。产物为 bundle.html,是一个所有 JavaScript、CSS 和依赖均已内联的自包含 artifact。

使用方式

  1. 初始化项目:运行 bash scripts/init-artifact.sh <project-name>,然后 cd <project-name>。
  2. 开发 artifact:编辑生成的文件进行开发。
  3. 打包为单个 HTML 文件:运行 bash scripts/bundle-artifact.sh。注意:项目根目录必须存在 index.html。
  4. 与用户分享 artifact:将打包后的 HTML 文件在对话中分享给用户,使其作为 artifact 查看。
  5. 测试/可视化 artifact(可选):此步骤完全可选,仅在必要时或被要求时执行。可使用可用工具(包括其他 Skills 或 Playwright、Puppeteer 等内置工具)进行测试。一般来说,应避免提前测试 artifact,因为这会增加请求与最终成品可见之间的延迟;可在呈现 artifact 之后、被要求或出现问题时再进行测试。

设计与风格指南

非常重要:为避免通常所说的“AI slop”,应避免使用过多的居中布局、紫色渐变、统一的圆角和 Inter 字体。

参考

shadcn/ui 组件文档:https://ui.shadcn.com/docs/components

限制

资料未提供该工具的收费、价格、平台支持范围等更多信息,暂未提供。