博客搭建记录（第一篇测试）

2026-10-11T07:30:00.000Z

为什么选 Hexo

这一节解释引擎选择。

与 Hugo 的对比

Hugo 构建更快，但改主题要会 Go template。Hexo 的主题是 EJS，改起来更直白。

为什么必须买域名

裸的 pages.dev 子域在国内打不开。

# 验证域名是否已指向 Cloudflare
Resolve-DnsName 612537.xyz -Type A
Resolve-DnsName 612537.xyz -Type NS

下面是行内代码 post_asset_folder: true 的样式测试。

表格测试

项目	免费额度	说明
静态请求	无限制	不花钱
构建次数	500/月	够用

踩到的坑

site.posts 没有 group 方法

Hexo 的 Query 原型上没有 group()，归档页按年分组必须手动实现。

中文搜索测试

这一段包含关键词：分布式锁、一致性哈希、零拷贝，用来验证站内搜索能否命中中文。

内容流水线设计方案

2026-10-12T02:00:00.000Z

问题

开发日志与设计方案经常附带 Word 和 PowerPoint 素材，但纯 Markdown 博客无法承载这些内容：

搜索引擎读不到 .docx / .pptx 里的文字
读者不想为了看一眼 PPT 就下载整个文件
把文件塞进正文图片会让文章变得很长

结论

采用三层处理：

层	处理方式	目的
正文	手写 Markdown	可被搜索引擎索引
PPT	逐页导出 PNG，渲染成画廊	不依赖外部查看器即可阅读
原文件	下载卡片，元数据构建时读取	需要源文件的人能拿到

代价

PPT 转图需要本机有 PowerPoint 或 LibreOffice，换机器要重新确认
单文件超过 25 MiB 无法部署，必须改走 R2 或网盘
每页幻灯片占一个文件，50 页 PPT 就是 50 个文件，计入站点 20000 文件上限

状态

有效。已验证 PPT 逐页导出可用（1600×900 PNG）。

幻灯片

下面是随文附带的演示稿，逐页导出为图片后在这里直接翻阅：

架构评审 v3

1 / 3

附件

DOCX设计方案-v2.docxWord 文档 · 37 KB · 更新于 2026-10-11 · 完整设计方案，含三层处理的取舍说明下载

变更记录

v1.2 · 2026-10-15 · 取消正文顶部素材栏 · 与文末下载卡片重复
v1.1 · 2026-10-13 · 下载卡片改为构建时读取真实文件体积 · 避免手写数字过期
v1.0 · 2026-10-12 · 初版

6号航站楼