003 · Quartz 构建 CustomOgImages 外网失败

问题现象

使用 Quartz 生成 notes 静态站时，构建报错涉及 CustomOgImages / fetch failed，与字体或外网抓取相关。

排查过程

• 阅读构建日志定位失败插件与请求的 URL。
• 在服务器测试外网连通性差异（或根据经验归因国内链路）。

根因

构建阶段依赖外网资源（如 Google Fonts/OG），国内环境不稳定触发失败。

改进计划

• 短期：关闭或注释 Plugin.CustomOgImages()，以稳定构建为先。
• 中期：将只读渲染层迁至 MkDocs Material（v1.1），减少 Node 与外网钩子（见同名需求/技术文档）。

经验教训

选型静态站生成器时，必须把 构建期网络依赖清单列入门槛；在云主机上默认不信任任意外网。