1OneBlog 需求全景
 2├── 🔵 核心理念
 3│   ├── 大道至简：简约、清爽、唯美、丝滑
 4│   ├── 博客 + 知识库二合一（vdoing 思想）
 5│   ├── 0 服务器成本（无 VPS/数据库）
 6│   └── 本地 MD 维护 + 在线编辑 + 实时更新
 7│
 8├── 🟢 性能要求
 9│   ├── 快如闪电：首页打开 0.2~0.4s，切换无白屏
10│   ├── 身轻如燕：低性能电脑不卡顿
11│   ├── 百万级 MD 文档丝滑支撑
12│   └── 零构建、实时动态更新
13│
14├── 🟡 视觉体验
15│   ├── 壁纸轮播（打字机/大波浪/缩放/箭头/粒子）
16│   ├── 4 种站点风格（完整博客/简约博客/文档风/产品官网）
17│   ├── 小火箭、彩色滚动条、顶部进度条、数字时钟
18│   ├── 3 栏自适应布局（侧边栏/正文/文章目录）
19│   └── 代码块暗黑风格/折叠/语言图标
20│
21├── 🟠 功能模块
22│   ├── 内置功能（全文模糊搜索/评论/统计/点赞/纠错）
23│   ├── 侧边栏卡片（14 个模块：简介/公告/天气/日历/评论/精选...）
24│   ├── 扩展模块（相册/音乐/电影/图床/加密/付费阅读）
25│   ├── 菜单映射 + formatter 工具
26│   └── 移动端适配 + 暗黑模式 + 多主题色
27│
28└── 🔴 博客后台（核心差异化需求）
29    ├── 图形化配置中心（点点点完成所有配置）
30    ├── 在线编辑 MD（移动端友好）
31    ├── 站点配置/个人资料/主题/菜单/赞助/导航/关于
32    ├── 壁纸管理/封面管理/文章管理/评论管理/友链管理
33    ├── 图床管理/统计分析/一键 WEB 升级/备份恢复
34    ├── 通过 /admin 域名直接登录（强加密）
35    └── 后端用 EO 边缘函数（挂掉也不影响站点访问）

 1┌─────────────────────────────────────────────────────────┐
 2│                    用户浏览器                              │
 3└───────────────┬─────────────────────────────────────────┘
 4                │ HTTPS
 5                ▼
 6┌─────────────────────────────────────────────────────────┐
 7│              EO 边缘函数 (Edge Function)                   │
 8│  ┌──────────┐  ┌──────────┐  ┌──────────┐               │
 9│  │ 路由分发  │  │ 权限校验  │  │ SSR 渲染  │               │
10│  │ / → 首页  │  │ 登录态   │  │ Astro     │               │
11│  │ /admin   │  │ 付费验证  │  │ MD→HTML   │               │
12│  │ /api/*   │  │ 强加密    │  │ 模板注入  │               │
13│  └──────────┘  └──────────┘  └──────────┘               │
14│                      │                                   │
15│          ┌───────────┴───────────┐                       │
16│          ▼                       ▼                       │
17│  ┌──────────────┐      ┌──────────────────┐              │
18│  │  CDN 缓存     │      │  KV 存储          │              │
19│  │  (全球加速)   │      │  (评论/统计/配置)  │              │
20│  └──────────────┘      └──────────────────┘              │
21└─────────────────────────────────────────────────────────┘
22                │
23                ▼
24┌─────────────────────────────────────────────────────────┐
25│              CNB 对象存储                                  │
26│  ┌──────────────────────────────────────────┐           │
27│  │  MD 文档仓库 (支持百万级)                   │           │
28│  │  壁纸/封面图/静态资源                       │           │
29│  │  Git 版本控制                              │           │
30│  └──────────────────────────────────────────┘           │
31└─────────────────────────────────────────────────────────┘

 1博客后台架构
 2┌────────────────────────────────────────┐
 3│          /admin (SPA)                   │
 4│  前端：React/Vue/Svelte 轻量 SPA        │
 5│  构建后部署到 CDN                        │
 6├────────────────────────────────────────┤
 7│       /api/admin/* (EO Edge Function)   │
 8│  路由：                                   │
 9│  POST   /api/admin/auth/login          │
10│  GET    /api/admin/config              │
11│  PUT    /api/admin/config              │
12│  POST   /api/admin/md/upload           │
13│  DELETE /api/admin/md/:id              │
14│  POST   /api/admin/backup              │
15│  POST   /api/admin/upgrade             │
16│  存储：EO KV (配置) + CNB (MD 文件)      │
17├────────────────────────────────────────┤
18│  中间件层                                 │
19│  - JWT 鉴权                              │
20│  - 微信扫码登录（公众号 OAuth）           │
21│  - 限流/防暴力破解                        │
22│  - 操作日志审计                           │
23└────────────────────────────────────────┘

 1百万文档架构策略
 2MD 文件存储 (CNB)               元数据索引 (EO KV)
 3┌──────────────────┐         ┌──────────────────────┐
 4│ /docs/             │         │ {                      │
 5│   linux/           │  ───▶   │   "posts": [...],     │
 6│     docker.md      │  构建   │   "tags": {...},      │
 7│     k8s.md         │  索引   │   "categories": {...},│
 8│   frontend/        │         │   "timestamps": {...} │
 9│     react.md       │         │ }                      │
10│     vue.md         │         └──────────────────────┘
11│   ... (100 万)     │                  │
12└──────────────────┘                  ▼
13                              首页/列表/归档 直接从索引渲染
14                              (毫秒级，无需扫描文件系统)

1目标：验证 Astro SSR + EO 边缘函数 + CNB 的技术可行性
2├── 搭建 Astro 6.x 最小项目
3├── 部署一个 EO 边缘函数 Hello World
4├── 验证边缘函数 → CNB 拉取 MD → SSR 渲染 → 返回 HTML 的完整链路
5├── 测试冷启动延迟、TTFB、CDN 缓存命中率
6└── 输出技术选型确认报告

 1目标：跑通博客核心流程，能用 MD 发布文章并在线浏览
 2├── Astro 项目完整搭建（路由/布局/组件体系）
 3├── 首页（壁纸轮播 + 打字机 + 文章列表）
 4├── 文章详情页（面包屑/元数据/目录/代码高亮）
 5├── 分类页、标签页、归档页
 6├── EO 边缘函数 SSR 渲染管线
 7├── CNB 存储集成（MD 拉取 + 图片服务）
 8├── 全文搜索
 9├── 评论系统
10├── 暗黑模式 + 基础主题色
11├── 移动端基础适配
12└── 部署上线 + 基础文档

 1目标：补齐所有博客功能，覆盖需求中 80% 的模块
 2├── 4 种站点风格切换
 3├── 知识库/文档站模式
 4├── 侧边栏卡片系统（全部 14 个模块）
 5├── 小火箭/滚动条/进度条/时钟/粒子特效
 6├── 站点统计
 7├── 壁纸管理
 8├── 相册/音乐/电影模块
 9├── RSS + sitemap + SEO
10├── 百万级文档架构优化
11└── 移动端深度适配

 1目标：实现博客后台这一核心差异化功能
 2├── /admin SPA 前端
 3├── 后台 API（EO 边缘函数）
 4├── 微信扫码登录 + JWT 鉴权
 5├── 图形化配置中心（站点/主题/菜单/侧边栏/壁纸...）
 6├── 在线 MD 编辑器（含移动端）
 7├── 文章管理/评论管理/友链管理
 8├── 图床管理
 9├── 统计分析面板
10├── 备份恢复
11├── 一键 WEB 升级
12└── 强加密 + 付费阅读

1目标：持续迭代优化，完善文档和社区
2├── 性能持续优化
3├── 更多主题/布局扩展
4├── 完整使用文档 + 视频教程
5├── 社区建设（GitHub/用户群）
6├── CI/CD 自动化
7└── 长期维护计划

 1// /edge-functions/entry.ts
 2import { Astro } from 'astro';
 3
 4export default async function handler(request: Request) {
 5  const url = new URL(request.url);
 6
 7  // 后台 API 路由
 8  if (url.pathname.startsWith('/api/admin/')) {
 9    return handleAdminAPI(request);
10  }
11
12  // 文章页面
13  if (url.pathname.startsWith('/posts/') || url.pathname.startsWith('/docs/')) {
14    const slug = extractSlug(url.pathname);
15    const mdContent = await fetchFromCNB(`/md/${slug}.md`);
16    if (!mdContent) return new Response('Not Found', { status: 404 });
17    const html = await renderAstroSSR(mdContent, url.pathname);
18    return new Response(html, {
19      headers: {
20        'Content-Type': 'text/html',
21        'Cache-Control': 'public, max-age=86400, s-maxage=86400',
22      },
23    });
24  }
25
26  // 首页
27  return renderAstroSSR(null, '/');
28}

 1// src/content/config.ts
 2import { defineCollection, z } from 'astro:content';
 3
 4// 实时从远程拉取的文档集合
 5const docs = defineCollection({
 6  loader: async () => {
 7    // 从 CNB 拉取文档索引（缓存在 KV）
 8    const index = await fetchFromKV('doc-index');
 9    return index.map((entry: any) => ({
10      id: entry.slug,
11      title: entry.title,
12      date: new Date(entry.date),
13      tags: entry.tags,
14      categories: entry.categories,
15      // MD 正文在 SSR 时实时拉取
16    }));
17  },
18  schema: z.object({
19    title: z.string(),
20    date: z.date(),
21    tags: z.array(z.string()).optional(),
22    categories: z.array(z.string()).optional(),
23    cover: z.string().optional(),
24  }),
25});
26
27export const collections = { docs };

1// 通过 CSS 变量 + 布局组件切换
2// astro.config.mjs 注入全局配置
3const SITE_STYLES = {
4  'full-blog':    { layout: 'blog',     sidebar: true,  toc: true  },
5  'minimal-blog': { layout: 'blog',     sidebar: false, toc: false },
6  'docs':         { layout: 'docs',     sidebar: true,  toc: true  },
7  'landing':      { layout: 'landing',  sidebar: false, toc: false },
8};