交付模型

这个项目的目标是 快速迭代，同时把 runtime 体积压低。

Build 路径

bun install
bun run check
bun run build

CI workflow 会运行同样的步骤，然后 deploy workflow 用 Wrangler 把产物推到 Cloudflare runtime。

让本地命令与 CI 命令保持一致，可以显著减少 configuration drift，也更容易复现失败。

Runtime 选择

• Astro 负责 HTML-first shell。
• client:only="react" 把 hooks 较重的交互 islands 隔离在 dev 和 production 之外层。
• GSAP 只用于 Hero 和时间线 reveal。
• Motion 只用于交互 demo surface。
• Lottie 只存在于一个小窗口里，不会变成全局依赖。

交付检查清单

• Canonical URL 与 sitemap 由配置里的 site 自动生成。
• robots.txt 由 Astro route 输出。
• 主题切换只靠一个很小的 inline boot script 和 CSS variables。
• Docs 会先经过 Content Collections 校验，再进入 production。

如果你想继续看 docs authoring model，请打开 文档系统。