> ## Documentation Index
> Fetch the complete documentation index at: https://docs.2024921.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Qingyu'Blog

> 零框架 · 零构建 · 零依赖的个人博客开发文档

# Qingyu'Blog 开发文档

零框架 · 零构建 · 零依赖的个人博客：纯原生 JavaScript + Cloudflare Workers / Pages Functions / D1 / KV / R2（AI 可选），双击 `public/index.html` 即可离线写作，部署后即为完整云端博客。

**当前版本：v2.10.63（2026-10-04）**

## 从这里开始

* [快速开始](/quick-start) —— 30 秒跑起来，静态与云端两条路径
* [项目架构](/architecture) —— 目录结构、双通道架构、前后端分层
* [Cloudflare Workers 部署](/cloudflare-workers) —— Secrets、迁移、Cron、缓存与安全头
* [API 总览](/api-overview) —— 服务端接口分组、鉴权与错误码
* [数据库表结构](/schema) / [迁移脚本](/migrations) —— D1 模型到 0032
* [更新日志](/changelog) —— v2.10.63 与历史版本

## 主要能力

| 能力 | 说明 |
| - | - |
| 静态 + 云端双模式 | `mode: auto` 自动检测；无后端时退化为本地 localStorage |
| Markdown 编辑器 | 实时预览、自动保存 / 崩溃恢复、分类 / 标签 / 封面 / 作者 / SEO / 置顶 |
| 文章增强 | 客户端 AES-GCM 加密、HMAC 草稿预览链接、版本历史、多作者与作者页、打印 / 导出 PDF |
| 内容渲染 | Mermaid 图表 + KaTeX 公式本地化按需加载；表格、任务列表、代码高亮 |
| 评论与留言板 | D1 存储、服务端分页、最新 / 最热排序、嵌套回复、点赞 / 精选 / 置顶、敏感词、反机器人、批量审核 |
| 搜索与发现 | FTS5 trigram 全文搜索、标签 / 分类 / 系列、热门排行、相关文章、Webmention |
| 订阅与通知 | 双重确认订阅、订阅者分组、分组群发、新文章与评论邮件通知（Resend 可选） |
| 音乐与媒体 | R2 预签名直传、音乐播放器、媒体库搜索 / 分页 / 批量操作；Workers / Pages 双形态可用 |
| 后台与可观测 | 仪表盘趋势、来源 / 国家 / 设备 / 系统 / 品牌、站点健康检查、操作审计、前端错误日志 |
| 导出与分发 | RSS / Sitemap、一键导出静态站（先弹「另存为」选保存位置）、Webmention、文章级 SEO |
| 功能开关 | 后台可改：首页分页与**首页显示哪些标签**、阅读字号、划线高亮、收藏、广告、图表公式、错误上报等 13 项，保存即生效 |
| 5 语言界面 | 中文 / English / 日本語 / 한국어 / हिन्दी，自动识别浏览器语言 |
| Workers AI | 文章摘要、写作助手、评论汇总与垃圾检测；可用 `BLOG_AI_ENABLED` / `BLOG_AI_PUBLIC` 关闭 |

## 功能参考

* [功能开关](/feature-switches)
* [文章 SEO](/seo)
* [草稿预览链接](/preview-links)
* [静态站导出](/static-export)
* [Webmention](/webmention)
* [多作者与作者页](/authors)
* [可观测性](/observability)

## 主仓库文档

* [开发文档（中文）](https://github.com/kejiland/qingyu-blog/blob/main/docs/DEVELOPMENT.md)
* [开发文档（English）](https://github.com/kejiland/qingyu-blog/blob/main/docs/DEVELOPMENT_EN.md)
* [README（中文）](https://github.com/kejiland/qingyu-blog/blob/main/docs/README.md) · [README\_EN](https://github.com/kejiland/qingyu-blog/blob/main/docs/README_EN.md)
* [Cloudflare 新手教程](https://github.com/kejiland/qingyu-blog/blob/main/docs/CLOUDFLARE_SETUP_GUIDE.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.