需求迭代：v1.3 Gitea Webhook 触发 notes 实时构建
时间参考：2026-04-29（文档）· 运维排错延伸至 04-30
1. 需求背景：目标与痛点
目标：缩短「Obsidian push」到 「notes 网站可见」的最坏等待时间。
痛点：仅用 cron 定时 pull && mkdocs build 时，与客户端 最长约 10 分钟推送间隔叠加后，端到端最坏约 二十分钟量级。
2. 产品形态
- 推送至 Gitea 后 秒级触发宿主机
/opt/rebuild-notes.sh（git pull+mkdocs build）。 - cron 改为 低频兜底（可选），以防 Webhook 偶发失败。
3. 技术实现（引用）
完整方案见：技术实现/2026-04/v1.3-Gitea-Webhook实时构建.md
相关运维：维护手册细则.md（Webhook 一节） · 上线记录.md
环境与 Git 相关问题工单：问题总览 序号 014、015