进行中约 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 问答(独立子域部署)。