网络工件构建器

其他 社区
  • 作者仓库星标 0
  • 许可证 Complete terms in LICENSE.txt
  • 作者更新于 2026年8月21日 17:10

技能解读

web-artifacts-builder 是给 claude.ai artifact 造单文件 HTML React app 的脚手架:React 18 + TypeScript + Vite + Parcel 打包 + Tailwind CSS + shadcn/ui,最终通过 bundle-artifact.sh 把所有 JS / CSS / 依赖内联到一个 bundle.html 里,可以直接当 artifact 分享。

设计思路

作者的目标:让你「写 React 代码 + 一键导出单 HTML」,省去 Claude artifact 单文件、不能引外部 CDN 的纠结。脚手架默认装好 40+ shadcn/ui 组件、Radix UI 全套依赖、@/ path alias、Vite + Parcel + html-inline 全链路,Node 18+ 自动检测并 pin Vite 版本。

设计与样式守则(重要)

作者特别点出反「AI slop」:少用过度居中布局、紫色渐变、统一圆角、Inter 字体——这些是一眼能认出 AI 模板的视觉特征,要刻意避开。

工作流

Step 1 Initialize:bash scripts/init-artifact.sh <project-name> 建仓 → cd <project-name>;自动装好 React + TS(via Vite)/ Tailwind 3.4.1 + shadcn/ui theme / @/ alias / 40+ shadcn 组件 / 全套 Radix UI / Parcel + .parcelrc / Node 18+ pin。Step 2 Develop:编辑生成的代码,对照 "Common Development Tasks"。Step 3 Bundle:bash scripts/bundle-artifact.sh 跑出 bundle.html——单文件 self-contained。要求项目根有 index.html。脚本内做的事:装 parcel / @parcel/config-default / parcel-resolver-tspaths / html-inline;写 .parcelrc 含 alias;Parcel 构建无 source map;用 html-inline 把 asset 全内联。Step 4 Share 把 bundle.html 当 artifact 给用户。Step 5 Test/Visualize(可选):用 Playwright / Puppeteer / 其他 skill 跑一下。

适合的场景

  • 在 claude.ai 里做交互式 artifact,想用 React + shadcn/ui 而不是裸 HTML
  • 需要把 demo 一文件分享,避免外部 CDN
  • 已有 Tailwind + shadcn/ui 习惯的开发者

不适合

  • 静态展示足够:直接写 HTML / CSS 比走整个脚手架更快
  • 需要后端 / 持久化:单 HTML artifact 跑不了 server

配套

theme-factory(统一视觉主题)、prototype(更通用的 prototype 脚手架)、webapp-testing(Playwright 跑通 artifact 验证)、pdf / make-pdf(同样面向「成品 artifact」的另一类)。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@anthropics · Complete terms in LICENSE.txt
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:初始化项目

运行初始化脚本来创建一个新的 React 项目:这将创建一个完全配置的项目,其中包含: ✅ React + TypeScript(通过 Vite) ✅ 带 shadcn/ui 主题系统的 Tailwind CSS 3.4.1 ✅ 配置了路径别名 (`@/`)

02
第 2 步:开发您的工件

要构建工件,请编辑生成的文件。请参阅下面的常见开发任务以获取指导。

03
第 3 步:捆绑到单个 HTML 文件

将 React 应用程序捆绑到单个 HTML 工件中:这将创建 `bundle.html` - 一个内联所有 JavaScript、CSS 和依赖项的独立工件。该文件可以作为工件直接在 Claude 对话中共享。要求:您的项目根目录中必须有一个`index.html`。脚本的作用:安装捆绑依赖项(parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline)

04
第 4 步:与用户共享工件

最后,在与用户的对话中共享捆绑的 HTML 文件,以便他们可以将其视为工件。

05
第 5 步:测试/可视化工件(可选)

注意:这是一个完全可选的步骤。仅在必要或要求时执行。要测试/可视化工件,请使用可用的工具(包括其他技能或内置工具,例如 Playwright 或 Puppeteer)。一般来说,避免预先测试工件,因为它会增加请求和可以看到完成的工件之间的延迟。如果有要求或出现问题,请在展示工件后稍后进行测试。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。