Astro · 知识库

Astro 是 Maplen 的核心底座构建框架。

在设计之初，我对 Maplen 的技术底色设定了一条死命令：文字的阅读必须是零 JavaScript 的极速静态体验，而交互必须是按需唤醒的孤岛。 Astro 的设计理念与这一初衷完全契合。

为什么选择 Astro

默认零客户端 JS（Zero-JS by Default）：在一般的单页应用（SPA）框架中，即使是一篇纯文本随笔，浏览器也必须下载数百 KB 的 JavaScript 运行时并进行水合（Hydration）。在 Astro 中，所有的 Markdown (.md) 与大部分页面框架都在构建期直接预编译为最干净的纯语义 HTML，没有任何首屏脚本负担。
孤岛架构（Component Islands）：当我们需要在阻尼振子与电路仿真或 8 位微处理器微架构中呈现复杂的实时交互时，Astro 允许我们在 MDX (.mdx) 中按需引入局部组件：
```
<ComputerSim client:visible />
```
通过 client:visible，只有当读者滚动视窗至仿真器区域时，交互运行时的脚本才会被浏览器懒加载执行，绝不干扰正文文字的沉浸阅读。
强类型内容层（Content Layer & Collections）： Maplen 的所有手记、专栏和 Wiki 词条均被纳入 Astro 的 Content Layer 进行强类型 Schema 约束。构建期自动校验 Frontmatter 字段、标签完整性与双向链接关系，杜绝死链与格式损坏。
出版级构建输出流水线：同一套受 Git 追踪的源文件，通过 Astro 的编译管道被同时分流为人类阅读的静态网页、纯文本 llms.txt、裸 Markdown 镜像以及多级 RSS 订阅流。

关于 Astro 在整站静态架构中的流水线细节，可参考技术选型与静态管道与设计系统宣言。