跳到主要内容

cf 公开测试版现已发布,完整映射整个 Cloudflare API。

阅读发布公告

整个 Cloudflare API,
一个 cf

内置智能体命令搜索、默认 JSON 输出、TypeScript 配置与 Vite 构建,一次覆盖 3,000+ 操作。

终端

$ cf cli search "create D1 database" [ { "command": "cf d1 create", "summary": "Create D1 Database" }, { "command": "cf d1 update", "summary": "Update D1 Database" } ] 搜索在本地运行,不需要登录,最多返回五条最匹配的命令。

执行中
3,000+

可操作的 API

280

Wrangler 原有命令

48%

上周智能体执行占比

18 个月

Wrangler 维护支持

扩展,而不是把 280 条命令推到 3,000 条

Wrangler 由各产品团队手工构建,即使只有约 280 条命令路径,术语与模式也难以统一。同一件事在不同产品里有三种写法。

cf 换了一条路:命令直接从支撑 API 文档与 SDK 的 OpenAPI 模式生成。产品只需为模式补充少量注解,新增能力即可自动出现在 CLI 中。

同一件事,三种命名

  • D1d1 info
  • Hyperdrivehyperdrive get
  • Workflowsworkflows describe

在 cf 中,命名与参数由同一份模式决定,命令之间不再各说各话。

为智能体构建,人类同样顺手

每一个设计取舍都指向同一件事:让智能体少花上下文,让你少花时间。

智能体自己找到命令

用自然语言描述目标,cf cli search 会依据 API 描述与参数返回可用命令,不必先记住命令名。

cf cli search "create D1 database"
cf d1 create找到命令
cf schema d1 create查看参数
cf d1 create --dry-run预演请求

JSON 才是默认输出

对人类美化排版,对智能体压缩成单行,省下的是上下文。

"name": "my-worker",
"routes": 3
人类可读12 行智能体1 行

覆盖整个 API

从 Workers 到 DNS、WAF、Access 与域名注册,一个工具触达全部产品。

WorkersD1R2KVDNSWAFAccessPagesQueuesWorkflowsHyperdriveRegistrar

Vite 成为默认构建

具备 HMR 的开发服务器、基于 Rolldown 的构建,以及可直接复用的 Vite 插件生态。

HMRRolldownVitestVite 插件

配置也能被
类型检查

cloudflare.config.ts 让人类与编辑器都读得懂配置。使用 LSP 的智能体可以直接在上下文中解读它,给出更准确的建议。

TOML 没有可访问的模式,JSONC 虽有模式却很少被智能体使用;TypeScript 两者兼得。

查看配置指南
cloudflare.config.tsTypeScript
import { bindings, defineConfig } from "cf/config";
import * as entrypoint from "./index.js" with { type: "cf-worker" };

export default defineConfig(({ mode }) => ({
  worker: {
    name: "example-worker",
    entrypoint,
    compatibilityDate: "2026-09-27",
    env: {
      Environment: bindings.text(`This is ${mode} environment`),
    },
  },
}));

一个文件描述整个 Worker

从 Wrangler 迁移,
只要一条命令

迁移指南
  1. 01

    跑一条命令

    cf migrate 读取 Wrangler 配置,生成 cloudflare.config.ts 并接管依赖。

  2. 02

    处理待办

    无法自动转换的条目会列成清单,例如 Durable Object 绑定需要迁移后复核。

  3. 03

    继续用 Wrangler

    esbuild 的 JavaScript Worker 与 Rust、Python Worker 仍由 Wrangler 开发部署。

全局安装,
随时运行

cf 目前处于公开测试阶段,命令、配置与构建输出在稳定版发布前仍可能变化。

$npm i -g cf