wrangler 是 Cloudflare Workers 及其 KV、R2、D1、Vectorize、Queues、AI 和部署能力的 CLI。你要本地开发、生成类型、查看日志、管理 secret 或发布 Worker 时，先用它的当前命令和项目配置，不要照搬旧版参数。
新项目可以用 `wrangler init`，配置优先使用 `wrangler.jsonc`，并设置近期的 `compatibility_date`。绑定默认走本地模拟；确实需要线上资源时，明确写 `remote: true`。修改配置后运行 `wrangler types`，开发阶段用 `wrangler dev`，上线前先用 `wrangler deploy --dry-run` 检查。
secret 不要写进命令行、日志或仓库，用交互式 `wrangler secret put` 或文件输入。生产环境与 staging 分开配置，必要时用 `wrangler check startup` 看启动成本。它负责 CLI 路径和配置护栏，具体 API 仍以 Cloudflare 文档为准。