从写作到发布：这套博客系统的特性与使用指南
一套博客系统真正被使用起来之后，最重要的通常不再是技术栈，而是每天打开它时是否顺手：能不能迅速进入写作，预览是否可信，发布之后是否容易找到旧文章，过几个月回来修改时又会不会担心覆盖或丢失。
这套博客围绕这样的日常问题设计。公开站点、写作后台和内容存储彼此分开，功能不追求无限扩张，而是覆盖一个人长期写作最常见的路径。下面先介绍它能做什么，再从第一次打开后台开始，走一遍完整的使用流程。
公开站点：把阅读需要的东西准备好
博客前台采用响应式纸张风格，支持浅色、深色和跟随系统主题。首页之外，还提供归档、标签、系列、搜索和上一篇/下一篇导航，让文章既能按时间回看，也能通过主题彼此连接。
面向订阅和搜索引擎的基础能力也已经内置：RSS、Sitemap、Canonical URL、阅读时长、文章目录和基础 SEO 元数据都由服务端生成。搜索在浏览器中使用公开文章索引，不需要把管理接口暴露给读者。
如果需要一张独立的“关于”页面，只要把文章 Slug 设置为 about。它会发布到固定地址，但不会出现在首页、归档、标签、搜索、RSS 或系列中。
写作后台：围绕一篇文章的完整生命周期
文章有三种状态：
- 草稿：只在后台和限时预览中可见；
- 已发布：由公开博客读取并展示；
- 已归档：保留在后台，但从公开站点撤下。
编辑器提供书写、实时预览和专注模式。草稿会自动保存，标题、正文、Slug、摘要、封面、标签和分组都集中在同一个编辑流程里。首次发布前，系统会检查标题、正文以及 Markdown 图片是否填写替代文本。
已发布文章不会因为后台正在输入就立刻变化。修改完成后需要显式点击“更新”，公开内容才会切换到新版本；写入前还会留下版本快照。版本号同时承担并发控制，如果另一个页面或 MCP 客户端已经修改文章，旧页面会收到冲突提示，而不是悄悄覆盖新内容。
第一次使用：先完成站点设置
进入后台后，建议先打开“设置”，完成以下信息：
- 填写站点名称、描述、作者和作者简介；
- 选择语言、时区、默认主题与强调色；
- 决定是否显示文章目录和阅读时长；
- 从媒体库选择网站图标，按需填写默认分享图；
- 配置公开导航和社交链接，每行使用“名称|地址”的格式；
- 点击“保存设置”，再到公开站点确认结果。
这一步只需要在首次上线或站点定位变化时处理。设置完成后，日常使用基本都发生在“文章”和“媒体”两个入口中。
写一篇文章并发布
一条可靠的发布流程可以保持得很短：
- 在概览或文章列表中点击“新建文章”；
- 填写标题和 Markdown 正文，等待自动保存完成；
- 打开“属性”，检查 Slug、摘要、标签和封面；
- 切换到“预览”检查标题层级、列表、链接和代码块；
- 若需要在真实博客布局中确认效果，生成十分钟有效的草稿预览链接；
- 确认所有正文图片都有清楚的替代文本；
- 点击“发布”，稍等边缘缓存更新后检查公开地址。
公开页面的边缘缓存通常会在约一分钟内更新。刚发布后短暂看到旧内容并不代表保存失败；后台状态和版本号才是更直接的判断依据。
修改已经发布的文章时，建议先保存一次版本快照，再完成编辑并点击“更新”。如果只是暂时不想公开，可以转为草稿；如果内容不再适合展示但仍值得保留，则优先归档，而不是永久删除。
使用媒体库插入图片和视频
图片支持 JPEG、PNG、WebP 和 AVIF，单张最大 10 MB。原文件进入 R2，文件名、尺寸、替代文本和对象标识记录在 D1。上传后可以复制 Markdown，也可以直接从编辑器的“素材”面板插入正文。
在线视频支持 YouTube、Bilibili、Vimeo，以及 HTTPS 的 MP4 和 WebM 直链。系统只保存经过规范化的外部链接，不会把视频下载到 R2。无法识别的地址会安全降级，而不是直接透传任意播放器代码。
删除素材前要先检查引用关系。正在作为网站图标、文章封面或正文资源使用的图片不能直接删除；先从对应位置移除并保存，再回到媒体库处理。
用分组组织系列文章
当多篇文章围绕同一个主题展开时，可以在“分组”中创建系列。分组支持名称、说明、顺序和组内文章排序，公开站点会据此生成系列页面和文章内导航。
只有已发布文章可以加入分组，一篇文章也不会同时属于多个系列。这项限制让公开导航保持明确：草稿不会提前占位，系列顺序也始终对应读者真正能够访问的内容。
通过 MCP 与 Codex 管理文章
CMS 还提供受 Cloudflare Access 保护的 MCP 接口。配置专用 Service Token 后，Codex 可以搜索文章、读取完整 Markdown、创建草稿、更新文章、改变状态和确认删除。
推荐的自动化流程与网页后台相同：先搜索或读取，再修改，最后明确发布。已有文章的写操作必须携带最近读取到的版本号；遇到版本冲突时重新读取并确认差异，不要反复提交旧版本。
MCP 当前只管理文章。媒体、系列排序、站点设置和历史版本恢复仍然留在网页后台完成，这样自动化边界更容易理解，破坏性操作也更集中。
一条适合长期坚持的日常流程
如果不想记住所有功能，可以只保留下面这条路径：
- 想法出现时先建立草稿；
- 写作过程中依赖自动保存，不急着整理全部属性；
- 完稿后补摘要、标签、封面和图片替代文本；
- 用预览检查阅读体验；
- 发布后等待缓存更新，再检查公开页面；
- 大幅修改前保存快照，不再公开时优先归档；
- 文章形成主题后，再把它们整理成系列。
这套系统的目标不是让写博客显得更复杂，而是把容易遗忘的安全检查和维护细节交给工具。流程足够稳定之后，后台就会逐渐退到文字之后：需要时可靠地出现，完成之后不再占据注意力。