用途：面向 Cloudflare Workers 的部署工作，尤其适合希望使用 Cloudflare 托管的 Git 构建流水线（Workers Builds）而非本地 wrangler deploy 的场景。
主要能力：区分本地部署（wrangler deploy 从当前机器发布）、Workers Builds（在 Cloudflare 内从 Git 运行构建/部署命令）以及 wrangler versions upload（上传非线上版本，但不会创建全新 Worker）。覆盖创建 Worker 项目、连接 GitHub、创建/更新构建触发器、触发构建、查看日志、验证部署、静态资源配置、自定义域名与路由、DNS 前置条件、用 Cloudflare Access 保护主机名，以及常见故障排查（pnpm 工作区/锁文件不匹配、pnpm deploy、空 Worker 项目、DNS 传播、缓存过期）。
使用方式：先确认意图（本地部署还是 Workers Builds、生产分支、主机名、预览分支、是否用 Access 保护）。检查本地仓库的 package.json、锁文件、wrangler.toml/wrangler.jsonc、构建输出目录、项目根目录与生产分支，从锁文件和 packageManager 推导包管理器。检查 Cloudflare 状态可使用 cf auth whoami、cf context show、cf workers scripts search --name <worker-name>、cf workers-builds triggers list --external-script-id <worker-tag>、cf workers deployments list --script-name <worker-name>、cf workers domains list --hostname <hostname> 等命令。配置 Workers Builds 时，缺失 Worker 项目可先创建无线上版本的 Worker 外壳再挂接 Git 构建触发器；交互式场景可交给用户仪表板深链，无头/脚本化场景走 cf CLI。验证分层进行：本地冻结安装、类型检查、构建、部署 dry-run；Cloudflare 侧检查构建状态、日志、Worker 版本、活动部署、自定义域名、DNS 与 HTTP 响应；Access 侧未认证请求应重定向到 Cloudflare Access。
限制与注意：控制平面变更前应查阅当前 Cloudflare 文档或 API schema；不要创建重复的 Worker、仓库连接、构建触发器、自定义域名、DNS 记录或 Access 应用；不要回显令牌、部署钩子 URL、原始构建日志或受保护响应体；Workers Builds REST 调用需使用带所需 Builds 权限的用户级 CF_API_TOKEN，不要读取本地 Cloudflare CLI OAuth 会话 JSON；Builds API 使用不可变的 Worker tag（external_script_id），Worker 名称不可互换；任何 POST/PATCH/PUT/DELETE 或手动触发构建前，先展示账户、Worker 名称/tag、仓库、分支、根目录、命令、主机名与策略摘要并取得明确确认。具体命令细节与文档入口见各参考文件，使用前应打开当前文档。