Decap CMS 静态站 Git 内容管理

静态站内容编辑的痛点

静态网站生成器（SSG）如 Hugo、Jekyll、Gatsby 等将内容以 Markdown 或 JSON 文件形式存储在仓库中。这种架构虽然保证了性能和安全性，却给内容维护带来挑战：直接编辑文件需要开发者手动操作，非技术人员无法参与；修改后缺乏版本控制，难以追踪变更历史；多人协作时容易出现文件冲突和版本混乱。传统 CMS 依赖数据库，无法直接应用于纯静态站点。

Git 驱动的内容工作流

这个技能将 Decap CMS（Netlify CMS 的继任者）封装为代理技能，通过可视化界面解决上述问题。其核心机制是：所有内容编辑操作都会生成对应的 Git 提交，用户在浏览器中完成内容修改后，系统自动创建 commit 并推送到仓库。触发静态站点构建器重新生成页面。

关键能力包括：

• 可视化编辑界面：提供所见即所得的编辑器，支持 Markdown、富文本和媒体管理
• Git 原生支持：每次编辑自动生成提交，完整记录变更历史
• 框架兼容性：支持 Hugo、Jekyll、Gatsby、Next.js 等主流 Jamstack 框架
• 两种部署方式：轻量级方案仅需 HTML 文件和配置文件，所有资源从 CDN 加载；高级方案通过 npm 包集成到构建流程

工作流程分为四个步骤：初始化配置后，用户在浏览器中编辑内容；保存时系统自动创建 Git 提交；推送到远程仓库触发 CI/CD；构建器重新生成静态页面并部署。

适用场景与边界

该技能适合需要让非技术人员参与内容更新的静态站点项目，特别是团队协作场景。它要求站点托管在支持 Git 的平台上，且构建流程能响应仓库变更。

需要注意：

• 依赖 Git 平台：需要配置 GitHub、GitLab 或 Bitbucket 作为后端
• 首次配置：需要在仓库中添加配置文件，指定媒体文件夹和构建命令
• 构建器要求：高级安装方式需要构建器支持 npm 包管理
• 权限管理：需要合理设置 Git 平台的访问权限，确保内容编辑者能创建提交

对于已有成熟 CMS 工作流或使用 headless CMS（如 Contentful、Strapi）的项目，此方案可能不是最优选择。