用途
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。
使用方式
- 初始化项目:运行
bash scripts/init-artifact.sh <project-name>,然后cd <project-name>。 - 开发 artifact:编辑生成的文件进行开发。
- 打包为单个 HTML 文件:运行
bash scripts/bundle-artifact.sh。注意:项目根目录必须存在 index.html。 - 与用户分享 artifact:将打包后的 HTML 文件在对话中分享给用户,使其作为 artifact 查看。
- 测试/可视化 artifact(可选):此步骤完全可选,仅在必要时或被要求时执行。可使用可用工具(包括其他 Skills 或 Playwright、Puppeteer 等内置工具)进行测试。一般来说,应避免提前测试 artifact,因为这会增加请求与最终成品可见之间的延迟;可在呈现 artifact 之后、被要求或出现问题时再进行测试。
设计与风格指南
非常重要:为避免通常所说的“AI slop”,应避免使用过多的居中布局、紫色渐变、统一的圆角和 Inter 字体。
参考
shadcn/ui 组件文档:https://ui.shadcn.com/docs/components
限制
资料未提供该工具的收费、价格、平台支持范围等更多信息,暂未提供。