用途:面向 Cloudflare Wrangler CLI 的日常操作,包括部署、tail 日志、KV/R2/D1/Queues/Workers 资源管理、secrets、bindings 与账号路由。
主要能力与用法:优先检索配置与参数,先查 wrangler --help、子命令 --help、本地 node_modules/wrangler/config-schema.json,再查 Cloudflare 文档。推荐使用仓库包装方式:npm exec --yes --package wrangler -- wrangler ...,除非仓库已有自己的脚本。账号敏感操作前先运行 wrangler whoami。常用命令示例:npm exec --yes --package wrangler -- wrangler deploy;npm exec --yes --package wrangler -- wrangler tail <worker> --format json --sampling-rate 0.999 --search '<term>';npm exec --yes --package wrangler -- wrangler kv key list --namespace-id <id> --prefix '<prefix>';npm exec --yes --package wrangler -- wrangler kv key get '<key>' --namespace-id <id>。执行前读取 wrangler.toml 或 wrangler.json(c);若配置账号与目标产品不一致,应停下询问。
注意事项与限制:不要凭记忆编造参数,Wrangler 4 已移除或改动部分旧参数,须用 --help 确认。wrangler kv key list 没有 --limit,可用 --prefix 再本地过滤。workerd 或本地存储启动时,KV 的 list/get/admin 读取应串行执行,并行可能触发 SQLite SQLITE_BUSY。wrangler tail --sampling-rate 须大于 0 且小于 1,接近全采样用 0.999 而非 1。自行启动的 tail 要负责停止;交互停止可用 PTY,否则精确 kill 对应 wrangler tail <worker> 进程。切勿打印 secrets,只按精确名称查询,不要导出环境变量。资料提到 ReleaseBar 生产账号与 OpenClaw 项目账号,具体账号 ID 见原文,不确定时应询问。