博客 AI 增强检索分类方案调研
背景
Quartz 博客项目结构调整后，文章分布在多层目录下（performance/tools、performance/cases、AI/claudecode 等），纯文件夹树 + 关键词搜索（Pagefind）在分类聚焦方面体验不佳。调研 AI 增强方案，目标：更快定位内容、自动分类、语义检索。
一、Obsidian 侧 AI 插件方案（写作时增强）
1.1 Smart Connections
- 基于 embedding 做语义搜索，自动发现相关笔记
- 本地运行，支持 OpenAI / 本地模型
- 适合在写作时发现已有的相关内容
1.2 Copilot for Obsidian
- 接 OpenAI / Claude API，对话式检索笔记库
- 可以问 “binder 相关的性能文章有哪些” 直接得到答案
- 支持 RAG 模式，上下文感知
1.3 Auto Classifier
- 自动给笔记打 tag、归类
- 根据内容语义判断所属领域
- 写完笔记自动触发
1.4 Text Generator
- 生成摘要、自动补 frontmatter（tags / description）
- 可配合模板使用
工作流
写笔记 → AI 自动打 tag + 生成摘要 → git push → Quartz 构建发布
成本：OpenAI API 调用费用，单篇文章几分钱。
二、网页端 RAG 语义搜索方案
2.1 架构
文章 → 分块(chunk) → embedding → 向量数据库
用户提问 → 语义匹配 → 返回相关文章段落 + 链接
2.2 实现选项
| 方案 | 特点 | 成本 |
|---|---|---|
| Cloudflare Workers AI + Vectorize | 零服务器，边缘部署 | 免费额度够用 |
| Ollama 本地 embedding + ChromaDB | 完全自建，数据不出本地 | 硬件成本 |
| Vercel AI SDK + OpenAI embedding | 部署简单，生态好 | API 费用 |
| Markprompt (SaaS) | 给文档站加 AI 搜索对话框，开箱即用 | 免费版有限额 |
| Inkeep (SaaS) | 类似 Markprompt，支持多数据源 | 商业定价 |
2.3 效果
用户在博客页面输入自然语言（如 “内存泄漏排查工具”），返回语义最相关的文章，而非仅靠关键词匹配。
三、Claude Code 批处理方案（一次性整理）
3.1 自动打 tags
find content/myblog -name "*.md" | while read f; do
claude -p "读取这个文件内容，根据内容生成合适的 frontmatter tags 和 description，
直接输出修改后的完整 frontmatter 块" "$f"
done3.2 自动生成关联
让 Claude 分析所有文章，找出逻辑关联关系，自动插入 wiki-links [[相关文章]]。
3.3 自动生成分类索引页
为每个分类（performance、AI、framework 等）自动生成一个索引 markdown，包含：
- 该分类下所有文章的标题 + 一句话摘要
- 按主题/时间排序
- 交叉引用
优点
- 今天就能跑完，不需要部署服务
- 结果直接是 markdown，融入现有 Quartz 构建流程
- 后续新增文章偶尔跑一次即可
四、Quartz 原生能力配合
4.1 Tags 聚合页
Quartz 内置 Plugin.TagPage()，给文章加 tags 后自动生成 /tags/performance/ 聚合页。
4.2 Explorer 过滤配置
Component.Explorer({
filterFn: (node) => !node.name.startsWith("_"),
folderDefaultState: "open",
})4.3 Graph 视图
已有的 Component.Graph() 可视化文章间的链接关系，配合 wiki-links 效果更好。
五、推荐落地路径
第一步：Claude Code 批量整理（立即可做）
- 扫描所有文章，自动生成 tags + description frontmatter
- 生成各分类索引页
- 配置 Explorer 过滤无用目录
第二步：Obsidian 插件日常使用
- 安装 Smart Connections 或 Copilot for Obsidian
- 新写文章自动打标签、生成摘要
第三步：网页端 AI 搜索（可选）
- 文章量大了以后（50+ 篇），部署 RAG 搜索
- 推荐 Cloudflare Workers AI 方案，免费额度足够个人使用
六、方案对比总结
| 方案 | 成本 | 效果 | 维护负担 | 适用场景 |
|---|---|---|---|---|
| Obsidian AI 插件 | 低（API 费用） | 写作时自动分类 | 零 | 日常写作 |
| Claude Code 批处理 | 零 | 一次性整理好分类 | 偶尔跑一次 | 存量整理 |
| 网页 RAG 搜索 | 中 | 语义搜索体验最佳 | 需维护服务 | 文章量大 |
| Markprompt 等 SaaS | 低 | 开箱即用 AI 搜索 | 零 | 快速上线 |
| Quartz 原生 tags | 零 | 多维度聚合浏览 | 零 | 基础分类 |
参考链接
- Smart Connections: https://github.com/brianpetro/obsidian-smart-connections
- Copilot for Obsidian: https://github.com/logancyang/obsidian-copilot
- Markprompt: https://markprompt.com
- Cloudflare Workers AI: https://developers.cloudflare.com/workers-ai/
- Quartz Tags 文档: https://quartz.jzhao.xyz/features/tags