技能介绍

解决的问题

静态站点和内容驱动型应用的内容更新，长期卡在一个尴尬的位置：内容本身是纯文本（Markdown、YAML front matter、JSON），完全可以用 git 管理，但让非技术同事直接往仓库里提交，既容易写错 front matter 结构，也绕不开 CI 重新构建这道门槛。Pages CMS 要解决的就是这件事——不改变 Git 作为内容存储的事实，只把编辑过程包装成一个人能用的界面，提交、分支、拉取请求的流程保持原样。

它如何工作

核心能力集中在三处：

仓库即数据库：内容不导出、不另建存储，直接读写 Git 仓库里的文件，因此 Jekyll、Hugo、Next.js、Astro 这类框架的源文件结构无需改造。
可视化编辑界面：提供 Web 端编辑入口，用户在浏览器里改 Markdown 正文和 front matter，不必理解分支模型，提交记录仍然留在 Git 历史中。
两种使用形态：可以直接用托管版本，也可以拉取仓库在本机跑自己的开发副本，方便在上线前核对内容变更。

使用流程大致是：准备好一个仓库作为内容源，通过 GitHub App 或相应的配置完成仓库授权，之后编辑、保存、触发重新构建，全程不离开这个界面。

适用边界与注意点

它面向的是仓库内容管理，不是通用的富文本后台。内容模型仍由仓库里的文件结构决定，复杂字段类型、多语言拆分这类需求要自己用 front matter 约定来表达。
编辑器对 Markdown 结构有基本约束，书写不规范的内容仍可能在构建阶段报错。
自托管不是零成本：需要自己维护应用进程和一个 PostgreSQL 数据库实例，数据库的连接信息在初始化时就要确定，后续修改不如托管版本省心。
构建仍依赖你原有的静态站点流水线，Pages CMS 负责内容写入和触发，不替代 CI 与部署环节。