Home

Monolith Wiki

运行在 Cloudflare 边缘网络的全栈博客系统 — React 19 + Hono + D1/R2

在线 Demo: monolith-client.pages.dev · 仓库: one-ea/Monolith

---

我是新人，从哪里开始？

角色	推荐路径
想本地跑起来	快速开始 → 部署指南
想了解架构	架构概览 → 存储适配器
想二次开发	前端指南 · 后端指南 → API 参考
想接入 AI 助手	MCP 集成
想贡献代码	分支策略 → 安全设计

---

文档目录

入门

• 快速开始 — 本地开发环境一站式搭建
• 部署指南 — 一键脚本 + 手动逐步两套方案

架构

• 架构概览 — 系统拓扑、模块划分、关键决策
• 存储适配器 — D1/Turso/PostgreSQL · R2/S3 切换矩阵

开发

• 前端指南 — Vite + React SPA 结构与扩展点
• 后端指南 — Hono Workers 路由与 Drizzle ORM
• API 参考 — 所有公开/管理端点详细签名

运维

• 安全设计 — 认证、防注入、密钥管理 14 项加固
• 分支策略 — Conventional Commits + Squash Merge

生态

• MCP 集成 — 自然语言驱动的 30+ 自动化工具

---

核心特性速览

• 零冷启动 — 全球 200+ PoP，平均响应 <50ms
• 无锁定 — 数据库/对象存储双层适配器，可整套迁移
• 批量导入 — WordPress / Ghost / Hexo / Hugo / Jekyll / Halo 6 平台无损迁入
• AI 友好 — 内置 MCP 服务器，支持 Cursor/Claude Desktop/Antigravity 自然语言管理
• 极致体积 — 客户端首屏 <100KB gzip · Worker bundle <500KB
• 安全合规 — JWT + 限流 + DOMPurify + SSRF 防护 + GDPR Cookie 同意

---

反馈与贡献

• Bug 报告: GitHub Issues
• 安全漏洞: SECURITY.md
• 代码贡献: 阅读 分支策略 后通过 PR 提交

法则: 文档以仓库 main 分支为唯一事实来源；当 wiki 与代码冲突，以代码为准。