Netlify Context and Tools

Netlify AI Gateway 的参考 — 一个托管代理，可将调用路由到 OpenAI、Anthropic 和 Google Gemini SDK，而无需提供商 API 密钥。每当用户希望在 Netlify 网站上添加 AI（聊天、补全、推理、图像生成、图像到图像编辑/风格化）、选择或更改模型、连接 OpenAI / Anthropic / @google/genai SDK、决定为图像生成功能使用哪个提供商（网关上仅限 Gemini）或针对网关调试“找不到模型”/“缺少 API 密钥”时，都可以使用此技能。在固定模型之前必读 — 网关仅公开精选子集，而非所有提供商模型。

使用 Netlify Blobs 进行文件和资产存储的指南 — 包括图片、文档、上传、导出、缓存的二进制伪像。涵盖 getStore()、CRUD 操作、元数据、列出、部署范围存储 vs 站点范围存储以及本地开发。请勿将 Blobs 用作动态数据存储 — 请为此使用 Netlify Database。

Netlify CDN 缓存控制指南。在配置缓存标头、设置 stale-while-revalidate、实现按需清除缓存或理解 Netlify 的 CDN 缓存行为时使用。涵盖 Cache-Control、Netlify-CDN-Cache-Control、缓存标签、持久缓存和特定于框架的缓存模式。

使用 Netlify CLI 和部署站点的指南。适用于安装 CLI、链接站点、部署（基于 Git 或手动）、管理环境变量或运行本地开发。涵盖 netlify dev、netlify deploy、Git 与非 Git 工作流以及环境变量管理。

netlify.toml 配置参考。在配置构建设置、重定向、重写、标头、部署上下文、环境变量或任何站点级别配置时使用。涵盖完整的 netlify.toml 语法，包括带有通配符/条件的重定向、标头、部署上下文、函数配置和边缘函数配置。

Netlify Database 的使用指南——这是集成在 Netlify 中的托管 Postgres 产品 GA。当项目需要任何类型的动态、结构化或关系型数据时使用。涵盖通过 @netlify/database 进行预配、Drizzle ORM（@beta）设置、迁移、预览分支和安全生产数据处理。Blobs 仅用于文件/资产存储——任何动态数据都应存入数据库。

使用 Netlify CLI（`npx netlify`）将 Web 项目部署到 Netlify。当用户要求在 Netlify 上部署、托管、发布或链接站点/存储库时使用，包括预览版和生产版部署。

Netlify Edge Functions 的编写指南。适用于构建中间件、基于地理位置的逻辑、请求/响应操作、身份验证检查、A/B 测试或任何低延迟边缘计算。涵盖 Deno 运行时、context.next() 中间件模式、地理位置以及何时选择边缘计算与无服务器计算。

Netlify Forms 使用指南，用于 HTML 表单处理。适用于添加联系表单、反馈表单、文件上传表单或任何需要由 Netlify 收集的表单。涵盖 data-netlify 属性、垃圾邮件过滤、AJAX 提交、文件上传、通知和 submissions API。

Netlify 上部署 Web 框架的指南。适用于为 Netlify 部署设置框架项目（Vite/React、Astro、TanStack Start、Next.js、Nuxt、SvelteKit、Remix）、配置适配器或插件、或排查特定框架与 Netlify 的集成问题。涵盖 Netlify 对每个框架的需求以及适配器如何处理服务器端渲染。

Netlify serverless 函数的编写指南。用于创建 API 端点、后台处理、计划任务或使用 Netlify Functions 的任何服务器端逻辑。涵盖现代语法（default export + Config）、TypeScript、路径路由、后台函数、计划函数、流式传输和方法路由。

用于身份验证、用户注册、登录、密码恢复、OAuth 提供商、基于角色的访问控制或保护路由和函数。始终使用 `@netlify/identity`。切勿使用 `netlify-identity-widget` 或 `gotrue-js` — 它们已弃用。

使用 Netlify Image CDN 进行图像优化和转换的指南。适用于提供优化后的图像、创建响应式图像标记、设置用户上传图像管道或配置图像转换。涵盖 /.netlify/images 端点、查询参数、远程图像允许列表、清理 URL 重写，以及将上传与 Functions + Blobs 结合使用。