用途:为部署到 Cloudflare 的 Astro 项目提供开发指导,覆盖 TypeScript、Tailwind 与 Astro 框架,帮助构建可扩展的 Web 应用。
主要能力与原则:强调简洁、技术性的回答与准确的 Astro 示例;优先静态生成与服务器端岛屿,尽量减少 JavaScript;使用描述性变量名并遵循 Astro 命名约定;未经用户明确确认不得更改站点输出,问题更可能出在配置、环境变量或构建流程;使用 Astro 基于文件的路由组织文件;优先使用原生 HTML 元素(如 dialog、form)与 Web Components,仅在框架特性有明确价值时使用框架。
项目架构:部署目标为 Cloudflare Workers,采用 output: 'static' 与组件服务器岛屿实现服务端渲染;服务器岛屿使用 server:defer 指令优化性能;Cloudflare 适配器配置 platformProxy 以支持表单/服务器操作;始终使用尾斜杠(trailingSlash: 'always')以匹配 Cloudflare Workers 行为。项目结构包含 src/components(core、forms、modals、animations)、layouts、pages、actions、utils、styles。
组件开发:所有组件创建为 .astro 文件,这是默认且首选方式;可复用组件放在 components/core/;交互优先使用自定义 Web Components 而非 React 岛屿;尽可能使用原生 HTML 元素。
包管理:使用 pnpm,Node 版本 24.x,pnpm 版本 >=10。
参考文档:references/components.md(组件模式与 Starwind UI)、routing.md(路由与页面)、forms.md(表单与服务器操作)、styling.md(Tailwind CSS 模式)、seo.md(SEO 指南)、testing.md(测试模式)、deployment.md(构建与部署)。
限制:资料未提供具体安装命令、收费信息或平台支持范围等细节。