Zhiyuan Research
← 返回项目
进行中约 1 分钟

个人研究与知识网站(本站)

基于 Astro 的可长期积累的个人知识空间:Markdown 为唯一内容源,Git 管理版本,静态部署。

目录
  • Astro
  • TypeScript
  • Tailwind CSS
  • Keystatic
  • Pagefind

项目背景

需要一个能同时承载长文、碎片想法、阅读记录和项目的个人站点,并且十年后内容仍然可迁移。

问题定义

  • 内容必须脱离任何具体 CMS 存活;
  • 发布流程对”写作状态”零干扰:编辑器里保存即完成;
  • 为未来的知识图谱和 AI 问答预留架构,但不提前实现。

我的判断

静态生成 + Git 内容源仍是长期主义的最优解。复杂度应该花在内容结构上,而不是视觉层。

系统架构

Markdown / MDX (GitHub 唯一内容源)


Astro Content Collections (Schema 校验)


静态构建 (Astro) ── Pagefind 索引


GitHub Actions ── rsync ── 阿里云 ECS / Nginx

关键取舍

  • 选 Keystatic 而非功能更全的 Headless CMS:内容必须留在 Git 里;
  • 选 Pagefind 而非 Algolia:零外部依赖、构建期生成索引;
  • React 仅用于交互孤岛,文章无 JS 可读。

当前结果

第一阶段已完成:内容系统、Keystatic 后台、全文搜索、自动部署流水线。

下一步计划

  • 视频内容与字幕工作流;
  • 基于 Topics 的关系网络可视化;
  • 内容级 RAG 问答(独立子域部署)。

相关内容