用途:该技能面向静态架构,帮助使用 Gravito @gravito/freeze 生态构建高性能营销站、博客或文档站,目标是通过边缘网络实现亚秒级页面加载。
主要能力:一是构建时检测,通过 detector.isStaticSite() 在动态(水合)与静态(原生)行为间切换,静态构建中建议使用原生 <a> 标签导航以减少 JS 开销;二是本地化路由,要求静态站默认支持 i18n,使用 generateLocalizedRoutes 为所有支持语言构建路径树。
使用方式:先定义 FreezeConfig,包含域名、语言与基础 URL;再分析需要预渲染的动态片段(如 [slug]);在构建时获取全部所需数据,避免客户端请求;执行 freeze 构建流程生成 dist-static/ 目录;最后检查生成的 sitemap.xml 与 redirects.json,确认 SEO 与连通性。代码中可用 createDetector(config) 创建检测器,判断是否静态并返回带原生链接的纯 HTML;用 generateLocalizedRoutes({ baseRoutes: MyRoutes, locales: ['en', 'zh-TW'], defaultLocale: 'en' }) 生成路由。
适用场景:营销站点、博客、文档等以性能为优先的静态站点,适合部署到 Cloudflare Pages 或 GitHub Pages。
限制与建议:遵循边缘优先;采用 Islands 架构仅对需要交互的组件做懒水合;使用构建时 worker 优化图片并压缩 CSS。具体配置项、收费情况与完整 API 暂未提供。