SuperAPI AI 工具集

stitch-nextjs-components

前端与建站

查看项目

更新于 10-15 21:49

技能介绍

用途:把 HTML 来源(Stitch 界面、本地 HTML 文件或 URL)转换为符合 Next.js 13+ App Router 规范的生产级组件,而非 Pages Router 或 Vite SPA。

主要能力:按组件判断服务端/客户端(含 onClick、useState 等用 'use client',纯渲染用服务端组件,表单配 Server Action);用 CSS 变量配合 next-themes 实现深色模式;响应式适配 sm/md/lg/xl;内置语义化 HTML、alt、aria-label、focus-visible 等无障碍基线。

使用方式:先把来源统一落到 temp/source.html。Stitch 界面需 MCP 访问,用 bash scripts/fetch-stitch.sh "[htmlCode.downloadUrl]" "temp/source.html" 下载;本地文件用 mkdir -p temp && cp "path/to/design.html" temp/source.html;URL 同样用该脚本下载。随后按模板建组件、在 src/data/mockData.ts 放静态数据、在 app/globals.css 定义 :root 与 .dark 变量、在 app/layout.tsx 用 ThemeProvider 包裹,最后 npm run dev 验证明暗模式。

适用场景:目标项目使用 app/ 目录、提到 server components 或 next-themes 时。

限制:仅 Stitch 路线需要 API key,本地文件与 URL 无需 Google 账号;URL 路线只下载单个 HTML 响应,外链样式可能缺失;截图无上传通道;无法解析颜色令牌时应说明而非臆造;复杂交互可配合 stitch-a11y,动画交给 stitch-animate。