目录

Quiet Archive

文件系统驱动的个人档案馆基座。不依赖数据库,用 Git 管理内容,让 AI 生成你的专属前端。你正在阅读的这个网站,就是用这个项目构建的。

这个项目的设计,围绕三个核心理念展开。

一、一切从简。

市面上的博客方案,要么需要数据库(WordPress、Notion),要么依赖云服务,要么需要一套复杂的 CI/CD 配置。而且部署到服务器之后还有一堆后续问题——服务器到期了得迁移数据,没有后台的话更新文章也很麻烦,数据备份还得额外操心。所以我参考了 VitePress 的思路,以本地文件结构组织内容,Git 仓库作为备份和发布机制。不用担心服务器出问题导致数据丢失,内容更新就是改文件然后 push,跨端同步和历史版本记录也是 Git 天然就有的能力。

文件夹即分类,README.md 即目录页,git push 触发服务器 hook 自动重新构建上线。没有控制台,没有后台,没有额外的账号系统。整个系统只要能 SSH 进去,就能运维。

二、主题是你自己的。

用过很多博客主题,总感觉有细节不顺眼。想用 AI 去魔改别人的项目?如果遇到前后端耦合紧密、文档不全的情况,AI 改起来也很吃力,而且骨架终究还是别人的。

与其修修补补,不如让 AI 从头生成一套。但完全从零生成也有门槛:AI 很容易会给你搞出一套前后端加数据库的庞大体系,这对普通用户来说太超纲了。

这就是本项目的核心设计:把博客拆成「稳定的底层基座」和「可替换的前端展示层」。我们提供了一套现成可用的底层架构,并将前端开发流程和 API 上下文打包成了一个内置的 AI Skill(blog-frontend-bootstrap)。AI 不需要造后端的轮子,只需要读取 Skill,就能直接根据你的审美描述,一次性生成一整套完全属于你的前端主题。上面两张截图就是这样来的——同一个基座,两种不同的视觉。

毕竟,谁不想要一套完全属于自己的主题呢?

三、内容即知识库。

这个能力更多是锦上添花——如果你只是想搭一个好看的博客,前面两点就已经足够了。但如果你对个人知识管理有更多想法,这一层会让你的内容变得更有价值。

随着内容积累,这里的每一篇文章都有稳定的 URI、结构化的 frontmatter、和可被检索的全文索引。项目内置了静态 JSON API(/api/entries.json/api/tree.json/api/tags.json 等),可以直接被 Agent 或 MCP 消费。

你写一次,内容既给读者看,也能直接喂给你的 AI Assistant——未来还可以通过 MCP 给别人的 Agent 用。


技术栈

  • Astro + Preact — 静态生成 + 岛屿式交互
  • MDX — 支持组件的 Markdown
  • Python + jieba — 构建时索引 + 中文分词全文搜索
  • Vanilla CSS — 无框架,全量 CSS Variables 设计系统
  • Git SSH Hook — 自动部署

开源地址:github.com/lin037/quiet-archive

内容