用途:整理 Astro 项目的设计、实现与评审,核心思想是 HTML 为中心(文档优先),仅在必要处使用 JS(Islands)。适合内容站点、性能敏感页面及多框架集成的客户端 JS 削减评估。
主要能力与判断规则:优先完成 HTML;把客户端 JS 视为成本,只发送能说明必要性的部分;Islands 作为动态 UI 的“特区”,要小而职责单一,避免整页或整个列表变成岛;性能上优先“不发送的优化”(客户端 JS、图片、字体、第三方);渲染策略以 SSG 为第一候选,仅对更新频繁的部分考虑 SSR/按需渲染。
输出与使用方式:按固定顺序给出推奨方针(1-3 行)、理由(Web 约束/性能/可维护性)、设计方案(渲染策略、Islands 粒度、数据获取、打包与资产、缓存)、实现前检查清单、应避免的陷阱、以及从小处着手的下一步行动。检查清单包括:岛是否只用在真正必要处、岛是否过大、图片/字体/第三方是否拖慢速度、是否以 SSG 为首选、能否解释 JS 发送量的必要性。
限制与常见陷阱:把 React 等“顺手”全部发到客户端会削弱 Astro 优势;岛间状态共享增多会回到 SPA 级复杂度;分析、广告等第三方可能恶化 INP/LCP。具体命令、配置与代码示例资料未提供。