Wiki and Blog SCG Template

发表于 更新于

知识库与博客结合的模板

Wiki and Blog SCG Template

知识库与博客的结合，关键在于处理好结构化知识沉淀与碎片化内容输出之间的关系。以下整理了三种主流的模板方案，可以根据自己对技术栈的偏好和功能需求来选择。

1️⃣ 文档驱动型：VitePress + 博客主题

适合：偏好纯文档风格，希望将技术笔记和博客文章统一管理，且追求极致性能的技术写作者。

这个方案基于 VitePress（Vue 驱动的静态站点生成器），通过 vitepress-theme-teek 这类主题，在原生文档站基础上注入博客功能。模板会按文件路径自动生成侧边栏，构建出结构化的知识库；博客功能则作为“碎片化知识”的补充，支持文章分类、标签和归档。

  • 技术栈：VitePress、Vue、Markdown。
  • 核心能力：自动生成侧边栏/目录页、全文搜索、暗黑模式、支持评论系统（Giscus/Twikoo）。
  • 快速体验：可直接克隆 chuiyu_Wiki 这类现成项目，或参照 Teek 主题文档初始化。

vitepress-theme-teek

chuiyu_Wiki

2️⃣ 博客优先型：Astro 主题（知识图谱 + 搜索）

适合：内容较为丰富、需要强大检索能力来盘活知识库的博主。

Astro 因为对内容站点的高性能支持，出现了一批优秀的“博客+知识库”主题。例如 astro-theme-iris，它实现了双链笔记（Wikilink）和知识图谱（Graph View），能直观看到文章间的关联。配合 FlexSearch 实现的实时全文检索，能极大提升查找历史笔记的效率。而 qiyuan-blog-template 则更进一步，在 Astro 基础上集成了 RAG（检索增强生成）AI 问答，让读者可以直接向你的知识库提问。

  • 技术栈：Astro、TypeScript、FlexSearch/D3.js。
  • 核心能力：双链预览、知识图谱可视化、高性能搜索、AI 问答（RAG）。
  • 快速体验：在 GitHub 搜索对应仓库，点击 "Use this template" 即可一键创建。

astro-theme-iris

qiyuan-blog-template

3️⃣ 全栈管理型：Next.js 全功能平台

适合：需要后台管理、富文本编辑，且希望拥有 AI 辅助写作能力的深度内容创作者。

如果觉得静态模板定制性有限，可以考虑 Next.js 打造的全栈平台。例如 Petrichor，它不仅是一个展示站点，更包含完整的 CMS（内容管理系统），支持富文本编辑、知识库目录树，甚至集成了 AI 续写、改写和周报生成功能。next-ai-blog-cms 则侧重技术实现，提供了完整的后台管理界面和基于向量检索（RAG）的站内问答，实现了从写作、存储到智能问答的闭环。

  • 技术栈：Next.js、Supabase/PostgreSQL、Prisma、TailwindCSS。
  • 核心能力：AI 写作助手、富文本编辑器、后台仪表盘、RAG 知识库问答。
  • 快速体验：项目通常支持一键部署到 Vercel，需准备好数据库（如 Supabase）和环境变量。

next-ai-blog-cms

📊 表格对比

模板方案 推荐场景 主要技术 核心特色
VitePress + Teek 主题 文档技术博客、笔记整理 VitePress, Vue 文档/博客双模式，自动生成结构化目录
Astro 主题 (Iris/Qiyuan) 知识图谱展示、AI 问答博客 Astro, D3.js, RAG 可视化知识图谱，站内 AI 助手（RAG）
Next.js 全栈平台 (Petrichor) 需后台管理、AI 辅助创作 Next.js, Supabase, Prisma 富文本编辑器，AI 写作与周报，后台 CMS

🌟 选型建议

  1. 如果追求简单和速度：方案一（VitePress）最轻量，维护成本低，适合以 Markdown 为主的笔记博主。
  2. 如果希望内容被“盘活”：方案二（Astro）的图谱和 AI 能力，能让你的旧文章通过关联和问答重新被发现。
  3. 如果需要深度管理内容：方案三（Next.js）提供了完整的后台和 AI 写作流，更适合系列化、长周期的内容创作。

以上方案均为开源项目，除自行部署外，也可参考 WorkBuddy + MaxKB 等方案，为现有静态博客快速接入知识库问答能力。