Web Artifacts 构建器

要构建功能强大的 claude.ai 前端 artifacts，请按以下步骤操作：

1. 使用 scripts/init-artifact.sh 初始化前端仓库
2. 通过编辑生成的代码开发您的 artifact
3. 使用 scripts/bundle-artifact.sh 将所有代码打包为单个 HTML 文件
4. 向用户展示 artifact
5. （可选）测试 artifact

技术栈：React 18 + TypeScript + Vite + Parcel（打包）+ Tailwind CSS + shadcn/ui

设计与样式规范

极其重要：为避免常被称为“AI slop”的问题，请勿过度使用居中布局、紫色渐变、统一的圆角样式以及 Inter 字体。

快速开始

步骤 1：初始化项目

运行初始化脚本以创建一个新的 React 项目：

bash scripts/init-artifact.sh 
cd 

该脚本将创建一个已完全配置的项目，包含以下内容：

• ✅ React + TypeScript（基于 Vite）
• ✅ Tailwind CSS 3.4.1 与 shadcn/ui 主题系统
• ✅ 已配置路径别名（@/）
• ✅ 预装 40+ 个 shadcn/ui 组件
• ✅ 包含全部 Radix UI 依赖项
• ✅ 已通过 .parcelrc 配置 Parcel 打包支持
• ✅ 支持 Node 18+（自动检测并锁定 Vite 版本）

步骤 2：开发您的 Artifact

构建 artifact 时，请编辑生成的文件。有关具体指引，请参阅下方的常见开发任务。

步骤 3：打包为单个 HTML 文件

将 React 应用打包为单个 HTML artifact：

bash scripts/bundle-artifact.sh

该命令将生成 bundle.html —— 一个自包含的 artifact，其中所有 JavaScript、CSS 及依赖均已内联。此文件可直接作为 artifact 分享至 Claude 对话中。

前提条件：您的项目根目录下必须存在 index.html 文件。

脚本执行内容：

• 安装打包所需依赖（parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline）
• 创建支持路径别名的 .parcelrc 配置文件
• 使用 Parcel 构建（不生成 source maps）
• 利用 html-inline 将所有资源内联至单个 HTML 文件中

步骤 4：向用户分享 Artifact

最后，在对话中将打包好的 HTML 文件分享给用户，使其可作为 artifact 查看。

步骤 5：测试 / 可视化 Artifact（可选）

注意：此为完全可选步骤，仅在必要或明确要求时执行。

如需测试或可视化 artifact，可使用现有工具（包括其他 Skills 或内置工具，例如 Playwright 或 Puppeteer）。通常应避免在初始阶段即进行 artifact 测试，因其会在请求发出后与最终 artifact 展示之间引入额外延迟。建议在 artifact 呈现之后再进行测试——仅当用户提出要求或出现异常情况时执行。

参考文档

• shadcn/ui 组件：https://ui.shadcn.com/docs/components