SuperAPI AI 工具集

web-artifacts-builder

前端与建站

查看项目

更新于 10-15 21:48

技能介绍

用途:帮助创建结构复杂、多组件的 claude.ai HTML 产物(artifact),使用现代前端技术栈。

技术栈:React 18 + TypeScript + Vite + Parcel(打包)+ Tailwind CSS + shadcn/ui。

使用方式:

  1. 初始化项目:运行 bash scripts/init-artifact.sh <project-name> 并进入目录。该脚本生成的配置包括 React + TypeScript(Vite)、Tailwind CSS 3.4.1 及 shadcn/ui 主题系统、路径别名(@/)、预装 40+ shadcn/ui 组件与全部 Radix UI 依赖、用于打包的 Parcel 配置(.parcelrc),并兼容 Node 18+(自动检测并固定 Vite 版本)。
  2. 开发产物:编辑生成的文件,参考文档中的常见开发任务说明。
  3. 打包为单 HTML 文件:运行 bash scripts/bundle-artifact.sh,生成 bundle.html,将全部 JavaScript、CSS 与依赖内联,可直接在 Claude 对话中作为产物分享。要求项目根目录存在 index.html。脚本会安装打包依赖(parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline),创建支持路径别名的 .parcelrc,使用 Parcel 构建(不含 source map),再用 html-inline 内联全部资源。
  4. 向用户分享该 HTML 文件。
  5. 测试/可视化(可选):仅在必要或被要求时进行,可使用 Playwright 或 Puppeteer 等工具;一般避免在展示前测试,以免增加延迟,可在呈现产物后按需或出现问题再测。

设计规范:为避免通常所说的“AI slop”,避免过度使用居中布局、紫色渐变、统一圆角与 Inter 字体。

参考:shadcn/ui 组件文档 https://ui.shadcn.com/docs/components。中文文档、注释与常见问题解答为资料所列的国内适配内容。其他细节暂未提供。