用途:指导智能体按顺序完成将 Web 应用部署到 Cloudflare Workers & Pages 的准备工作,适用于智能体能读写仓库文件的场景。
主要能力与步骤:
- 发现阶段:确定部署目标、构建命令、输出路径、是否为 SPA、构建时环境变量以及 monorepo 根目录;存在多个应用或构建方式不明确时向用户询问。
- 本地验证:确认构建产物出现在预期输出目录,例如执行 <build-command> 后运行 ls <output-directory>。
- 生成或更新仓库文件:在项目根目录添加或更新 wrangler.toml 或 wrangler.jsonc;把 wrangler 加入 package.json 的 devDependencies 以固定版本;可选通过 package.json 的 engines 或 .nvmrc 提示 Node 版本。纯静态 SPA 配置示例:name = "<cloudflare-project-name>"、compatibility_date = "<YYYY-MM-DD>"、[assets] directory = "./<output-directory>"、not_found_handling = "single-page-application";name 必须与 Cloudflare 仪表盘中的 Worker 名称一致。
- 记录仪表盘设置:智能体负责仓库文件,用户在 Workers & Pages → Worker → Settings → Builds 中连接 Git,并提供填写好的配置表。
- 部署后验证:应用能在分配的 *.workers.dev 域名或自定义域名加载;SPA 的深层链接与刷新可用;构建时公开环境变量已进入产物。
决策要点:纯静态且客户端路由用 not_found_handling = "single-page-application";静态多页可省略该字段或使用 "404-page";静态加 API 同 Worker 时增加主 Worker 脚本与 assets;monorepo 需在仪表盘设置根目录为包路径,必要时从仓库根安装依赖。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;故障排查细节需参考 troubleshooting-deployment.md,本文未展开。