← 返回项目库

Plain Git 内容管理台

一个把 Git 仓库变成内容后台的中文静态站点管理台。

Plain 将 Markdown 内容、JSON 配置和主题文件保存在 Git 仓库中,用浏览器后台完成页面与文章编辑、草稿保存、发布、历史记录、媒体管理和主题预览,再通过构建生成可部署的静态站点与只读 JSON API。交付包包含一个不需要账号或外部服务的本地演示入口,便于直接验收核心编辑工作流。

真实界面

项目截图

共 8 张

控制台
页面
文章
编辑文章
历史记录
媒体库
外观主题
站点设置

Capabilities

核心功能

中文本地演示后台与站点控制台
页面和文章的 Markdown 编辑器
草稿保存、发布和构建状态反馈
编辑器内实时预览与主题预览
单条内容的历史记录和恢复入口
媒体库与站点设置管理
十五套本地主题和 starter 预览
构建静态站点与只读 JSON API

适用场景

快速搭建个人博客、文档站或作品集
用 Git 审核、协作和回滚网站内容
在没有数据库和后端服务的情况下交付小型内容站
学习浏览器 CMS、Markdown 构建和主题系统的实现

适合谁

需要低运维博客、文档站、作品集、活动页或小型内容站的开发者、独立创作者和技术团队。

商业化思路

适合作为自托管静态内容站基座、网站交付模板和社群学习项目;不承诺托管服务、云端账号或第三方 API 服务。

你会拿到什么

  • 固定提交版本的 Plain 源码包与 MIT LICENSE
  • 中文本地演示适配、主题预览支持和构建脚本
  • 自动化测试、构建结果、运行 smoke 与八张绑定界面截图

部署流程

  1. 1进入源码目录执行 npm ci 安装锁定依赖。
  2. 2执行 npm run build 生成 dist 静态站点;本地可用 python3 -m http.server 预览。
  3. 3将 dist 部署到静态 Web 服务,并按 README 配置站点仓库与 GitHub Pages 工作流。

真实验证结果

已通过 npm run build、npm test(112 项通过)、本地 HTTP runtime smoke,以及独立浏览器对控制台、页面、文章、编辑器、历史记录、媒体库、外观主题和站点设置的八张绑定证据。浏览器实际完成文章草稿保存、实时预览、发布、历史记录检查和本地主题预览;控制台错误、坏图、404、登录页和横向溢出均为 0。

部署前须知

本地 demo 使用浏览器内存中的演示仓库,刷新或离开 demo 后不会持久化;真实协作发布需要用户自己的 GitHub 仓库和令牌。AI 辅助需要用户自行配置 Anthropic API key。源码交付包为开发与自托管基座,不包含托管账号、数据库、云端编辑服务或模型服务。

部署难度

简单

最低配置

Node.js 运行时与 npm 用于安装和构建;构建后的静态 dist 目录可部署到 Nginx、CDN、GitHub Pages 或任意静态 Web 服务。

开源许可证

MIT License

最后验证

2026-09-05

技术栈

Node.js原生 JavaScriptMarkdown静态 HTML/CSSGitHub Contents API(登录模式)

授权说明

源码包保留仓库根目录 LICENSE;使用、修改和再分发须遵守 MIT 许可证及源码中各项版权声明。

Release notes

版本记录

1 个已发布版本

v1.18.0-cn.1 当前推荐

基于 Plain 1.18.0 固定提交增加中文本地演示后台、中文核心管理流程、无外部 registry 的本地主题预览、编辑器预览资源修正,并完成构建、测试和浏览器验收。

部署要求:Node.js 与 npm 用于安装和构建;现代浏览器用于后台;真实 GitHub 发布模式还需要用户自己的仓库和最小权限令牌。

已知问题:demo 数据保存在浏览器内存中,真实 GitHub、AI 和可选插件后端能力依赖用户配置的外部服务。

登录后领取