# Astro

> 现代静态优先、内容驱动的 Web 框架，Maplen 的基座构建引擎与孤岛架构运行时

- HTML: /wiki/astro/
- Markdown: /wiki/astro.md
- Aliases: Astro, 孤岛架构, Islands
- Updated: 2026.11.09

---

Astro 是 [Maplen](/wiki/maplen.md) 的核心底座构建框架。

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

## 为什么选择 Astro

1. **默认零客户端 JS（Zero-JS by Default）**：
   在一般的单页应用（SPA）框架中，即使是一篇纯文本随笔，浏览器也必须下载数百 KB 的 JavaScript 运行时并进行水合（Hydration）。在 Astro 中，所有的 [Markdown (.md)](/wiki/md.md) 与大部分页面框架都在构建期直接预编译为最干净的纯语义 HTML，没有任何首屏脚本负担。

2. **孤岛架构（Component Islands）**：
   当我们需要在 [阻尼振子与电路仿真](/nodes/oscillator-showcase.md) 或 [8 位微处理器微架构](/nodes/computer-showcase.md) 中呈现复杂的实时交互时，Astro 允许我们在 [MDX (.mdx)](/wiki/mdx.md) 中按需引入局部组件：
   ```astro
   <ComputerSim client:visible />
   ```
   通过 `client:visible`，只有当读者滚动视窗至仿真器区域时，交互运行时的脚本才会被浏览器懒加载执行，绝不干扰正文文字的沉浸阅读。

3. **强类型内容层（Content Layer & Collections）**：
   Maplen 的所有手记、专栏和 Wiki 词条均被纳入 Astro 的 Content Layer 进行强类型 Schema 约束。构建期自动校验 Frontmatter 字段、标签完整性与双向链接关系，杜绝死链与格式损坏。

4. **出版级构建输出流水线**：
   同一套受 Git 追踪的源文件，通过 Astro 的编译管道被同时分流为人类阅读的静态网页、纯文本 `llms.txt`、裸 Markdown 镜像以及多级 RSS 订阅流。

关于 Astro 在整站静态架构中的流水线细节，可参考 [技术选型与静态管道](/nodes/architecture-showcase.md) 与 [设计系统宣言](/nodes/design-system.md)。

## 官方网站与参考链接

- **官方网站**：[Astro 官方主页 (astro.build)](https://astro.build/)
- **官方文档**：[Astro 中文技术文档 (docs.astro.build/zh-cn/)](https://docs.astro.build/zh-cn/)
- **开源仓库**：[GitHub - withastro/astro](https://github.com/withastro/astro)