项目

xhalo-blog 项目说明

hexo-blog 是 ranbeis.com 当前线上博客的生产源码仓库。

它的职责是：

• 保持当前 Hexo / NexT / Cloudflare Pages 生产链路稳定。
• 承载真实文章、图片、视频、PDF 和主题配置。
• 验证未来可以抽离到 xhalo-blog 的通用能力。

xhalo-blog 则是未来独立的开源社区版。

它的目标不是做一个通用 AI 建站器，而是：

Cloudflare-native、Hexo-compatible、AI-assisted 的开源博客 / CMS 框架

Codex Sites 可以用于原型、预览和演示，但不是 ranbeis.com 的正式生产链路，也不是未来 xhalo-blog 的运行依赖。

目标定位

方向	说明
Cloudflare-native	优先基于 Pages、Workers、D1、R2、Queues、Turnstile、Access、WAF 扩展
Hexo-compatible	优先兼容 Hexo 内容结构、文章资源目录、Front Matter、permalink 和 NexT 迁移
AI-assisted	AI 用于辅助写作、SEO、摘要、评论回复、迁移分析和 PR 工作流
Self-hostable	用户应能用自己的 GitHub 和 Cloudflare 资产部署和长期运营

项目边界

hexo-blog

• ranbeis.com 的生产源码仓库
• 生产验证母体
• 私有内容与真实资源所在地

xhalo-blog

• 未来独立开源社区版
• 干净模板、示例内容、部署文档与平台骨架
• 面向社区用户 fork、自部署和长期扩展

长期路线

阶段	目标
Stage 1	冻结并验证 ranbeis.com 现有 Hexo / NexT / Cloudflare Pages 生产基线
Stage 2	完成开源前产品化准备：项目页、边界文档、主题规范、安全路线和后台 MVP 设计
Stage 2.5	从 hexo-blog 抽离 xhalo-blog 开源社区版最小骨架
Stage 3	在 xhalo-blog 上继续增强 Cloudflare 全平台、在线编辑、机器人和 AI 运营能力

计划能力

• Hexo 内容迁移与兼容
• 主题配置抽象
• 自有域名与一键部署文档
• Cloudflare Pages / Workers / D1 / R2 / Queues 路线
• 评论、防刷、安全与审计策略
• 基于 GitHub PR 的后台写入工作流

当前约束

• 不替换 Hexo
• 不替换 NexT
• 不修改 permalink
• 不删除现有文章与资源
• 不把 OpenAI Sites 作为正式生产依赖
• 不把私有生产内容直接复制到开源模板

相关文档

• docs/rb-blog/01-three-phase-alignment-plan.md
• docs/rb-blog/03-codex-sites-impact-and-next-step.md
• docs/rb-blog/04-codex-stage-2-productization-task.md
• docs/rb-blog/open-source-extraction-boundary.md
• docs/rb-blog/cloudflare-platform-roadmap.md
• docs/rb-blog/theme-config-spec.md
• docs/rb-blog/security-roadmap.md
• docs/rb-blog/admin-panel-mvp.md