用途
astro-ops 是一份围绕 Astro 框架开发的技能资料，主题覆盖岛屿架构、内容集合、渲染策略、视图过渡与多平台部署。其核心目标是为 Astro 项目在构建方式、交互水合、内容建模与上线位置等关键决策上提供可参照的模式与速查信息。
主要能力
资料以决策树和速查表的形式组织，主要包括：
- 渲染策略决策树：根据内容是否偏静态、是否需要个性化、是否需要实时交互、构建页数规模、是否需要边缘计算等条件，指导在 SSG（output: 'static'）、SSR（output: 'server'）、Hybrid（output: 'hybrid'）之间进行选择。
- 配置示例：给出 astro.config.mjs 中三种 output 模式的 defineConfig 写法，以及在 hybrid 模式下的 prerender = false、SSR 模式下的 prerender = true 的页面级开关说明。
- 岛屿架构客户端指令速查：列出 client:load、client:idle、client:visible、client:media、client:only 的水合时机、JS 加载行为与适用场景，并给出多框架组件（React、Svelte、Vue）的调用示例。
- 内容集合快速上手：展示使用 defineCollection、glob loader 与 Zod 定义博客、作者集合 schema 的方法，以及 getCollection、getEntry、引用解析、内容渲染的查询用法。
- 内容集合与外部 CMS 对比：从内容类型、使用者、校验方式、更新节奏、API 需求、工作流等维度列出两种方案差异，并给出「先用内容集合，非开发者需要无部署发布或内容确有关系型需求时再引入 CMS」的经验判断。
- 项目结构参考：给出包含 pages、layouts、components、content、content.config.ts、middleware.ts、styles、lib、public、.env 等的目录树，并标注文件路由与 API 端点映射。
- 视图过渡速查：包括 ViewTransitions 引入方式、transition:persist、transition:name、transition:animate 指令、astro:before-preparation 等生命周期事件，以及 prefetch 配置与逐链接预取控制。
- 部署决策树与适配器安装：按 Cloudflare Pages/Workers、Vercel、Netlify、Node.js、纯静态托管分别给出适用场景与对应适配器，并附 npx astro add 安装命令。
- 常见问题表：列举 hydration mismatch、客户端 import.meta.env 不可用、SSG 动态路由 404、图片未优化、SSR 缺少适配器、MDX 组件不渲染、内容集合 schema 变更未生效、在 Astro 组件上使用 client:*、document/window 未定义、样式泄漏、视图过渡导致脚本失效、生产环境变量缺失等问题及修复方向。
- 生产安全清单：涉及 CSP 头、远程图片白名单、Host 头校验、密钥管理、HTTPS、输入校验等。
- 参考文件说明：列出 content-collections.md、islands-rendering.md、deployment.md 三份参考文件的内容范围与大致行数。
使用方式
资料以「决策树 + 速查表 + 代码片段」的形式呈现，读者可先依据决策树确定渲染与部署方向，再对照速查表选用客户端指令、内容集合 schema 或过渡配置，并通过给出的安装命令添加所需适配器。文中同时给出「部署前应检查」的安全清单供上线前核对。
适用场景
适用于使用 Astro 构建博客、文档、营销站点，或采用混合渲染、部分交互岛屿的应用；也适用于需要在多种托管平台间选择、并在开发中排查常见 Astro 问题的开发者。
限制
本资料为模式与速查性质的参考，不包含对具体项目性能、成本或效果的承诺。文中提及的具体版本对应关系（如 Astro 5 / Astro 4 的 content config 路径差异）、命令与代码片段以其自身说明为准，实际使用需结合项目与官方文档核对。资料未提供收费、价格或平台选择建议等额外信息。