Agent Skills
返回列表
💻

TinaCMS 支持可视化编辑的 Git 无头 CMS

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/tinacms-git-backed-headless-cms-visual-editing。

技能介绍

要解决的问题

基于静态站点生成器的项目（Next.js、Gatsby、Astro 等）里，内容通常以 Markdown、MDX、JSON、YAML 文件存放在仓库中。改一篇内容意味着改文件、提 PR、等 CI 构建，非技术成员基本无法直接参与。而引入传统 CMS 又要额外维护数据库、API 服务和鉴权体系，与「内容即代码」的 Git 工作流彻底割裂。

核心能力与工作方式

TinaCMS 的做法是把内容当作仓库里的结构化文件来管理：

  • Git 即数据库：所有内容变更都写入工作区文件，提交历史天然成为审计日志
  • Schema 驱动的内容类型：通过 schema 描述字段结构，覆盖 Markdown、MDX、JSON、YAML
  • 可视化编辑：在页面上直接编辑，结果是写入文件，而不是存进数据库
  • GraphQL 数据层：内容通过 GraphQL API 暴露，前端可以用常规的 graphql 请求拉取
  • 静态站点集成：与 SSG 和 Next.js 无缝衔接，编辑提交后重建即可看到效果

典型工作流是：定义内容 schema → 在页面上挂载可视化编辑器 → 编辑结果写回文件 → 提交并触发构建。

适用边界与注意点

  • 适合内容规模适中、不需要复杂关系型数据模型的项目
  • 适合需要团队协作编辑、同时希望保留完整 Git 历史的场景
  • 不适合需要富文本审核流、多角色权限管理的企业级需求
  • TinaCloud 提供托管方案，但核心能力可完全本地自托管运行

使用场景

  • 技术作者维护 Next.js 站点，运营同事需要直接在页面上修改文章正文，而不是提交 PR 等构建。
  • 团队把 MDX 文档放在 Git 仓库中，希望编辑结果写回文件并触发构建，同时保留完整提交历史。
  • 前端需要统一通过 GraphQL 查询站点的 Markdown 和 YAML 配置内容，不想手写解析与缓存逻辑。
  • 文档站点改版后需要让非技术编辑直接修改 MDX 内容，修改完成后自动生成提交，无需操作命令行。

适合人员

  • 维护 Next.js 或 Gatsby 静态站点的技术作者，想让非技术同事直接在页面上改内容，不再依赖提 PR。
  • 负责文档站点的团队工程师，需要把 MDX 内容存进 Git 仓库并保留修改历史，同时降低编辑门槛。
  • 中小团队的前端开发者，想用 GraphQL 统一获取 Markdown 和 JSON 内容，减少自建接口和缓存的维护成本。
  • 内容驱动型产品的非技术编辑人员，需要按 schema 直接修改结构化内容，不接触仓库和命令行。