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 — 自动部署