AFTERGLOW 零代码个人博客

AFTERGLOW 是一套开箱即用的个人博客与内容管理平台。它把写文章、换主题、管理图片、建立专栏、处理评论和发送订阅邮件都放进了可视化后台。

除了第一次启动或部署，日常运营基本不需要接触代码。会使用普通网页表单，就可以维护一个完整的个人博客。

为什么适合不懂代码的用户

登录 /admin 后，大部分工作都可以通过点击、输入和拖拽完成：

想做的事情	后台操作	是否需要写代码
写文章、排版、插入代码/表格/按钮/分栏	块式文章编辑器	不需要
上传图片、视频、音频和 PDF	媒体库批量上传	不需要
更换网站配色、字体、布局和预设配图	设计编排	不需要
创建专栏、友链、项目和自定义页面	对应的可视化管理面板	不需要
发布、定时发布、私密预览或设置文章密码	文章发布选项	不需要
审核评论、回复读者、管理留言	互动订阅	不需要
管理订阅者和发送新文章邮件	互动订阅	不需要
查看访问量、热门文章和来源	数据看板	不需要
备份或迁移内容	导入与导出	不需要

第一次安装需要运行两条命令；如果不熟悉终端，也可以直接让 Codex 帮你启动或部署。启动完成后，博客的日常使用都在浏览器后台进行。

快速开始

需要 Node.js 22.13 或更高版本。

npm install
npm run dev

打开终端显示的网址，然后进入 /admin：

1. 第一次访问时创建管理密码；
2. 点击“写新文章”开始创作；
3. 在“站点设置”和“设计编排”中修改名称、作者资料与视觉方案；
4. 保存或发布后，前台会立即使用新的内容和样式。

完整操作说明见 零代码使用指南，上线方法见 部署指南。

功能概览

写作与内容

• 零代码块式编辑器：标题、段落、列表、引用、链接、代码、表格、按钮、双栏和图片画廊
• 正文区块拖动排序、自动保存、版本快照和历史恢复
• 草稿、发布、定时发布、置顶、精选和自定义排序
• 草稿私密预览、仅链接文章和密码文章
• 专栏与合集、分类、标签、年份归档和全文搜索
• Markdown、JSON 和本站备份文件一键导入

图片与多媒体

• 图片、视频、音频和 PDF，单文件最大 50MB
• 批量上传、图片自动压缩、正方形裁剪和原文件替换
• 封面复用、替代文字、图注和多图画廊
• R2 持久化存储，后台跨文章重复使用

页面与视觉

• 五套一键主题：余光橙、深夜信号、纸上花园、钴蓝几何、雾紫玻璃
• 三套页面布局、四套字体组合和三套组件风格
• 首页模块可开关和排序，导航菜单可视化编辑
• 关于、友链、项目和归档页面模板
• 结构化友链与项目卡片，无需手工排版
• 手机、平板和桌面响应式布局

读者互动

• 嵌套评论、作者回复、置顶、审核、隐藏和按文章关闭评论
• 点赞、收藏、阅读量、相关文章和一键生成分享海报
• 读者账户、跨设备收藏、阅读历史和订阅管理
• 联系表单、公开留言板和后台审核
• Resend 自动邮件：发布新文章和回复评论时通知读者，也支持手动群发

管理与数据

• 数据看板：累计访问、近 7 天趋势、热门文章、来源、评论和订阅数据
• 回收站、文章恢复、JSON 备份导入与导出
• D1 持久化文章、页面、用户和互动数据
• 首次打开后台时设置密码，无需手工编辑配置文件

自动邮件

邮件属于可选功能。进入后台“互动订阅”，填写 Resend API Key 和已经验证的发件人，打开“发布文章后自动发送”即可。密钥只保存在数据库中，不会返回给前台页面。

不配置邮件服务也不会影响写作、发布、评论和其他博客功能。

部署

项目已经包含 OpenAI Sites 使用的 D1 与 R2 配置。通过 Codex 发布时，可以直接说：

请把这个博客发布到 Sites，并保留 D1 数据库和 R2 媒体存储。

详细说明、部署后的首次设置和数据备份步骤见 部署指南。

项目结构

app/        页面、后台界面和 API
build/      Sites 部署打包辅助插件
db/         Drizzle 数据结构
drizzle/    数据库迁移
lib/        数据库、认证与邮件功能
public/     网站图标和主题预设图片
docs/       面向使用者的说明文档
worker/     Cloudflare Worker 入口

验证

项目结构检查：

node --test tests/rendered-html.test.mjs

完整生产构建与检查：

npm test

技术栈

Next.js 16、React 19、vinext、Cloudflare D1、Cloudflare R2、Drizzle ORM。