用途:把体积较大、不适合放 GitHub 的静态 HTML 文件(图表、仪表盘、报告)发布为公开 workers.dev 网址,凭据通过 1Password 管理。
主要能力:用 1Password 存取 CLOUDFLARE_ACCOUNT_ID 与 CLOUDFLARE_API_TOKEN,经 npx wrangler deploy 部署;部署根目录含 wrangler.toml 与自动生成的 index.html 目录列表;脚本分三阶段执行;提供新建站点、追加文件、新建 Worker、轮换 token、部署排障等任务模板。
必要用法:需 1Password CLI(brew install 1password-cli)与 Node.js(npx wrangler)。先建 Cloudflare API token(Account > Workers Scripts > Edit),在 1Password Claude Automation 保险库中手动预建条目(服务账号只能读取,不能创建);wrangler.toml 仅保留 name、compatibility_date 与 [assets];在含 wrangler.toml 的目录中执行部署。首次使用需在 Cloudflare 控制台启用 workers.dev 子域,实际网址用 npx wrangler whoami 获取,并在浏览器而非 curl 验证。
适用场景:发布 Bokeh 图表、仪表盘或报告;新建 Workers 静态站点;追加文件;轮换 API token;排查部署失败。
限制:仅静态部署,不支持动态 Workers、Cloudflare Pages(2025 年 4 月已弃用)、R2 对象存储与自定义域名;单文件上限 25 MiB,超出需改用 R2、GitHub Release 或自建主机;大型 HTML 用 Git LFS 跟踪,部署前需 git lfs pull,否则会上传 LFS 指针而非真实文件。