博客迁移到 Quartz 4
背景
原博客使用 Hugo，用户希望迁移到 Quartz 4，以便更好地支持 Obsidian wikilinks 和知识图谱。
执行过程
1. 创建 Quartz 配置
- 创建
nanobot分支 - 添加 Quartz 4 配置文件（quartz.config.ts, quartz.layout.ts）
- 配置 GitHub Actions 自动部署
2. 分支重命名
用户要求 main 分支用于 Quartz 4：
| 原分支 | 新分支 | 说明 |
|---|---|---|
| main | hugo-backup | 保留旧 Hugo 配置 |
| nanobot | main | Quartz 4 版本 |
3. 修复构建问题
问题1：GitHub Actions 触发分支配置错误
- 原配置：
branches: [nanobot] - 修复为：
branches: [main]
问题2：Vercel 路由 404
- 症状：
/daily/2026-04-06返回 404，但/daily/2026-04-06.html正常 - 原因：Vercel 默认不会自动重写 clean URLs
- 解决：在
vercel.json添加"cleanUrls": true
4. 内容迁移
删除旧文章，只保留知识库内容：
- 删除
content/posts/（5篇旧文章） - 删除
content/tools.md - 添加
content/daily/、content/projects/、content/learning/
最终结果
- 博客地址：https://blog.ysdmh.com/
- GitHub 仓库：https://github.com/ysdxz207/ysdmh
- 分支结构：main (Quartz 4) + hugo-backup (旧版备份)
遇到的问题与反思
- 遇到障碍没有明确告知用户：访问 Vercel 被安全守卫阻止后，我只报告了问题但没有继续推进，也没有明确说”我在等你的输入”
- 进度监控没有使用：长任务应该用
exec_with_progress.py发送飞书通知
关联笔记
- 知识库自动记录方案：说明知识库如何沉淀内容并同步到博客
- 知识库时间戳改进：说明知识库记录为何补充 created / updated / time 字段
- 运行环境约束与进度监控：说明 N1 盒子环境下执行构建、同步时的资源与反馈要求
- AI新闻汇总：一个已经落地到“自动生成 → 写入知识库 → 同步博客”的最新案例
相关文件
/data/ysdmh-new/- 本地仓库/data/knowledge-base/- 知识库（同步到博客 content 目录）