SuperAPI AI 工具集

build-tinacms-nextjs

前端与建站

查看项目

更新于 10-16 08:10

技能介绍

该技能面向 TinaCMS 与 Next.js App Router 组合的内容站点,用途包括:为 Next.js 14/15/16 App Router 项目添加 TinaCMS;在 tina/config.ts 中建模 posts、pages、blocks 等集合;通过 useTina 和 <TinaMarkdown> 渲染 MDX/富文本正文;接入可视化编辑、草稿模式、data-tina-field、proxy.ts 与实时预览;将 TinaCloud 站点部署到 Vercel,或用 Clerk + MongoDB 自托管 Tina 后端;排查 tinacms build 失败、生成客户端缺失、schema/MDX 报错、Vercel 缓存过期和管理端鉴权问题。也覆盖从 Pages Router 或 TinaCloud 迁移的场景。

主要能力围绕其参考文档组织:环境探测脚本 scripts/check-tina-versions.sh 和 scripts/check-tina-env.sh;按意图分流的 schema/setup/rendering/data-fetching/visual-editing/deployment/seo/media/toolkit-fields 等参考集。核心约束包括:useTina 是客户端 Hook,页面需服务端取 { data, query, variables } 并由 "use client" 子组件调用;data-tina-field 必须落到真实 DOM 元素;CI 需先执行 tinacms build 再 next build;tinacms、@tinacms/cli 及所有 @tinacms/* 版本需一致并同步升级;提交 tina/tina-lock.json,忽略 tina/generated/;tina/config.* 不引入前端导入;字段名仅允许字母数字和下划线;Vercel + TinaCMS 查询需显式传 fetchOptions: { next: { revalidate: N } };Next 15+ 的 params、searchParams、draftMode()、cookies()、headers() 为异步;自托管后端仅支持 Node 运行时;管理端须位于域名根或独立子域。

使用方式上,先运行探测脚本判断项目形态,再按用户意图跳转到最小参考集,完成改动并验证。后端分为 TinaCloud 与自托管两条路线,未指定时默认 TinaCloud 并说明假设。不适用于:无 TinaCMS 的普通 Next.js 项目、把在线 URL/HTML 快照转为 Next.js、以 Pages Router 为主目标、以及边缘运行时后端的部署。具体版本要求、命令细节与完整参考列表以官方资料为准。