文档导航
AI 参与说明（Agent：Codex）：本页由 Codex 根据站内已校验的 Cloudflare 技术文档维护阅读顺序和跨平台专题入口。产品状态、API、限额和部署方式会变化，请以对应专题页的一手来源和资料日期为准。
修订说明
导航补充（2026-10-23，Agent：Codex）：加入 Cloudflare Agents SDK 使用、场景与运行机制指南，并更新 AI 与 Agents 分类文章数。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得任务级运行记录。
关联阅读修订（2026-09-09，Agent：Codex）：同步 OpenCode Cloudflare SDK 文章的新标题与阅读重点。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
术语校对（2026-09-07，Agent：Codex）：统一关联阅读中的 Convex Workflow 名称。此次运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
导航补充（2026-09-08，Agent：Grok）：交叉主题加入 Convex 与 Durable Objects 的状态模型对比。模型
grok-4.6，提供方xAI，执行入口 Grok Build TUI。
导航补充（2026-09-09，Agent：Grok）：加入 AI Search 专题。模型
grok-4.6，reasoning effortxhigh，提供方xAI，执行入口 T3 Code。
导航补充（2026-09-09，Agent：Cursor）：交叉主题加入 OpenCode v2 的 workerd SDK。模型
grok-4.6，提供方xAI，执行入口 Cursor。reasoning effort 未取得运行记录。
导航补充（2026-09-10，Agent：Cursor）：加入 Email Service 专题。模型
grok-4.6，提供方xAI，执行入口 Cursor。reasoning effort 未取得运行记录。补齐本页date/categories/draft/tags；日期依据首次入库记录（2026-08-07）。
导航补充（2026-09-10，Agent：Cursor）：加入 Artifacts 专题。模型
grok-4.6，提供方xAI，执行入口 Cursor。reasoning effort 未取得运行记录。
导航补充（2026-09-11，Agent：Cursor）：加入 Cloudflare Wallets 专题。模型
grok-4.6，提供方xAI，执行入口 Cursor。reasoning effort 未取得运行记录。
修订说明折叠（2026-09-15，Agent：Cursor）：将导航补充与历次修订收入默认折叠的「修订说明」，首条 AI 参与说明与栏目导语保持可见。模型
grok-4.6，提供方 xAI，执行入口 Cursor Cloud。reasoning effort 未取得运行记录。
导航补充（2026-09-15，Agent：Codex）：加入 EmDash CMS 的技术原理与适用场景专题；补齐显式 slug，保留原有页面路径。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.154.0-alpha.6.2（不代表桌面 App 版本）。
导航补充（2026-09-16，Agent：Codex）：加入 Workers Builds 免费额度、超限处理与费用计算说明。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.154.0-alpha.6.2（不代表桌面 App 版本）。
导航补充（2026-09-16，Agent：Codex）：加入 Workers Builds 工作范围与 GitHub Actions 分工说明。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.154.0-alpha.6.2（不代表桌面 App 版本）。
导航补充（2026-09-28，Agent：Codex）：在 Durable Objects 基础资料之后加入 PartyKit / PartyServer 与 Workers、Durable Objects 集成专题。模型与 reasoning effort 未取得运行记录。
导航修订（2026-09-28，Agent：Codex）：PartyKit 专题先介绍产品能力和适用场景，再解释 Workers、Durable Objects 与 TanStack 的分工。模型与 reasoning effort 未取得运行记录。
导航补充（2026-09-28，Agent：Codex）：加入 Worker Previews 分支预览环境专题，并与 Workers Builds 工作流互相链接。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得运行记录。
导航修订（2026-10-08，Agent：Codex）：Cloudflare OS 专题按
4358072更新多 Gadget Workspace、Git VFS、Worktree、Blueprint release、Observer 与 Facet 生命周期解析，区分最新主仓库和 starter 固定版本。运行记录：模型gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.162.0-alpha.2（不代表桌面 App 版本）。
导航修订（2026-10-15，Agent：Codex）：Cloudflare OS 原文扩展为十一节源码深读，锁定
ef34d8e，补齐输入投影、step 持久化、OT/三方合并、Blueprint、Observer 和 Scheduler 的调用与失败边界，并加入正文 TextChange 交互及源码复跑实验。模型gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop；其他运行时版本未取得任务级记录。
导航修订（2026-10-08，Agent：Codex）：Worker Previews 专题补充 Service bindings 对独立 staging Worker 与具名 Preview 的调用边界、通用配置及 HTTP 联调方式。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.162.0-alpha.2（不代表桌面 App 版本）。
导航补充（2026-10-08，Agent：Codex）：加入 Eve 与 Cloudflare Think、Workflows、Sandboxes 的能力对照和最小示例。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai，运行记录中的 CLI 版本0.162.0-alpha.2（不代表桌面 App 版本）。
导航补充（2026-10-09，Agent：Grok）：加入 Domain Connect 专题，说明 SaaS 一键接入自有域名的协议原理、Cloudflare 实现限制与 Cloudflare for SaaS 配合方式。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
导航调整（2026-10-10，Agent：Grok）：open-compute 专题改放到 posts（一次性项目评测），本页交叉主题保留入口。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
导航补充（2026-10-12，Agent：Grok）：加入 Clef 家族专题（Clef、Clef-flash、Clef-omni），说明决策模型共用 API，并对照模态、上下文、定价与选用方式。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
分类修订（2026-10-20，Agent：Codex）：按 Cloudflare 产品线整理为 12 个子目录，重组产品分类与文章入口，补齐 Wrangler 导航，并保留历史文章 URL。执行入口 Codex；未取得任务级模型与 reasoning effort 运行记录。
导航补充（2026-10-21，Agent：Codex）：在 Workers 与开发工具中加入 Cap’n Web RPC，介绍远程对象、Promise pipelining、权限与会话边界，并提供可运行示例和固定源码入口。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得任务级运行记录。
导航修订（2026-10-21，Agent：Cursor）：Applications 栏目的侧栏与本页产品目录显示名改为「平台应用」，磁盘目录与
/docs/Cloudflare/applications/保持不变。模型grok-4.7-high-fast，执行入口 Cursor Cloud；reasoning effort 与提供方未取得独立运行记录。
这里集中维护 Cloudflare 产品与工程实践的长期技术资料。可先按产品查找文章；初次接触 Workers 体系时，可从下方的推荐阅读顺序开始。
产品分类
| 产品目录 | 涵盖主题 | 文章数 |
|---|---|---|
| Workers 与开发工具 | 运行时、RPC、开发工具与发布流程 | 8 |
| Durable Objects | 状态协调与实时应用 | 4 |
| Workflows | 持久编排、事件与恢复 | 4 |
| Queues | 异步消息、批处理与重试 | 1 |
| Containers、Sandbox 与 Computer | Linux 执行、工作区与远程桌面 | 4 |
| 存储：KV、R2 与 Artifacts | KV、R2 与 Git 存储 | 4 |
| AI 与 Agents | 搜索、决策模型与 Agent 开发 | 5 |
| Browser Run | 浏览器自动化与人工接管 | 1 |
| Email Service | 开发者收发信 | 1 |
| 域名与 SaaS 接入 | 自有域名接入与证书校验 | 1 |
| Wallets | Handle 预约与付款方案 | 1 |
| 平台应用 | 工作区平台与 CMS 架构 | 2 |
推荐阅读顺序
- Workers：运行时 API、Bindings 与执行模型：先分清运行时、事件入口与资源绑定。
- Cloudflare Workers KV：架构、一致性、API 与选型边界：理解全球读取与最终一致性。
- Durable Objects 使用方式与接口整理：再看有状态协调与对象私有存储。
- Queues：生产者、消费者、批量处理与重试实战：掌握消息确认、重试与幂等。
- Workflows 与 Dynamic Workflows：概念、使用方式与适用场景：最后区分持久化编排与动态代码执行。
按产品查找文章
Workers 与开发工具
- Workers：运行时 API、Bindings 与执行模型：先分清 handler、Runtime API、
envbinding、平台产品与控制面 API 的职责边界。 - Cap’n Web RPC：远程对象、Promise pipelining 与使用方式：用可运行示例理解一次 HTTP 往返中的依赖调用，并核对对象能力、双向回调、会话生命周期与核心源码。
- Cloudflare Workers Rate Limiting API：用法、业务维度与选型边界：区分 Cloudflare 控制面 API 配额、Worker 代码内业务限流、WAF 入口防护，以及严格计费应使用的状态模型。
- Dynamic Workers：Worker Loader、受控 Binding 与安全执行：从 Loader、WorkerCode、WorkerStub 到 capability 与 egress control，建立可落地的安全执行模型。
- Cloudflare Worker Previews：按分支管理预览环境：用独立配置和稳定地址测试分支，核对数据隔离、Service bindings 的跨环境边界、Preview 间 HTTP 联调与 Workers Builds 迁移。
- Cloudflare Workers Builds：免费额度、超限处理与费用计算：区分免费套餐的构建上限、付费套餐的包含额度与超额单价，避免混淆构建时间和线上运行费用。
- Workers Builds：能承担哪些工作，与 GitHub Actions 如何分工：按构建、测试、定时触发、运行环境与任务编排判断哪些工作可以迁移，并给出发布流程示例。
- Wrangler 安装方式：优先使用项目本地依赖，区分 npm scripts、npx 与全局安装的适用场景。
Durable Objects
- Durable Objects 使用方式与接口整理：先建立有状态协调、对象身份、私有 SQLite、Alarm 与 WebSocket 的基础认知。
- Durable Object Facets：概念、使用场景与 Durable Objects 对比：理解动态子代码如何在受控的 parent DO 下获得隔离 SQLite，并判断何时仍应直接使用普通 DO。
- PartyKit 与 PartyServer：能力、场景及 Cloudflare / TanStack 集成：先理解两个项目的能力与房间场景，再看 Workers、Durable Objects 和 TanStack 的接入方式。
- Convex 与 Cloudflare Durable Objects：状态模型、查询边界与选型：分清共享响应式数据库与单实例 Actor，避免把 Durable Objects 当成 Convex 的替代品。
Workflows
- Workflows 与 Dynamic Workflows：概念、使用方式与适用场景：理解持久化编排与运行时动态代码的职责边界。
- Workflows：实例、步骤、事件与恢复 API 实战：用订单、webhook、等待事件和补偿走完一个可恢复流程。
- Dynamic Workflows：多租户动态代码如何跨休眠恢复：了解如何将实例 metadata 路由回创建时的不可变租户代码版本。
- Convex Workflow、Cloudflare Workflows 与 Dynamic Workflows：区别、场景与使用方式：从流程代码所有权、持久化模型和动态代码能力选择合适的编排方式。
Queues
- Queues：生产者、消费者、批量处理与重试实战：从消息生产、消费确认到延迟重试、DLQ、幂等与监控，建立可靠异步处理模型。
Containers、Sandbox 与 Computer
- Dynamic Workers、Containers 与 Sandbox：关系、区别与使用方式：先分清动态 Worker、完整 Linux Container 和 Sandbox SDK 的选型边界。
- Sandbox SDK：命令、文件、进程与会话 API 实战：按命令、文件、session、解释器、进程和 Tunnel API 使用隔离 Linux 环境。
- Cloudflare Computer 技术解析：持久 Workspace、执行后端与 Agent 集成：在掌握 Durable Objects、Dynamic Workers 与 Sandbox 后，理解 Durable Workspace 如何组合文件状态和多种执行后端。
- Cloudflare Agent 电脑方案调研：远程桌面、Browser Run 与 Computer 工作区：比较网页 Agent、持久工作区、完整 Linux 桌面与已有 VNC 主机的接入路线，说明平台分工、恢复边界、成本及实施步骤。
存储：KV、R2 与 Artifacts
- Cloudflare Workers KV：架构、一致性、API 与选型边界：理解 central stores 与多层缓存、eventual consistency、读写 API、价格限额，以及何时应改用 Durable Objects、D1 或 R2。
- Cloudflare R2 Data Catalog：它是什么，以及旧图片 bucket 为什么会出现在其中：区分 R2 object storage、Apache Iceberg catalog 与查询引擎，并判断旧 bucket 是候选资源还是已启用 catalog。
- Cloudflare R2 图片上传到 Hugo 博客：安全、可验证的 AWS CLI 流程：用最小权限的 R2 API token、
YYYY/filename.ext键、显式 MIME/缓存元数据和 CDN HEAD 校验，完成可复现的图片上传。 - Cloudflare Artifacts：产品、概念、API 与最佳实践：把它看成账户拥有的可编程 Git 存储面，分清 Namespace、repo-scoped token、控制面与 Git 数据面，并按一任务一仓落地。
AI 与 Agents
- Cloudflare Agents SDK：使用方式、业务场景与运行机制：从具名 Agent 实例、持久状态和实时连接出发，理解调度、恢复及可选模型 SDK 的职责。
- Cloudflare AI Search：功能、使用方式与最佳实践：把它看成托管的搜索与 RAG 流水线，分清 Instance、Data source、
search()与chatCompletions()，并判断何时应改用 Vectorize。 - Clef 家族：Workers AI 上的决策模型（Clef、Clef-flash、Clef-omni）：先理解决策模型与 System One API，再对照三个模型的模态、上下文、定价与选用方式。
- Convex Agent Component 与 Cloudflare Agents SDK：关页后继续生成并恢复聊天：比较 durable ACK、断线续流、重启恢复与失败重试，并给出 Workers + TanStack Start 的落地架构。
- Eve 在 Cloudflare 上的对标方案：Think、Workflows 与 Sandboxes：从 Agent harness、Session、恢复和 Linux 执行层对照两套方案，并给出 Think 最小示例与选型依据。
Browser Run
- Cloudflare Browser Run 能力范围、运行原理与使用方式：从 Quick Actions 与 Browser Sessions 入门，核对 CDP、Workers Binding、Live View、人工接管、录制、会话与网络策略。
Email Service
- Cloudflare Email Service：介绍、使用方式与开发接入：分清开发者收发信与 Email security，核对 SMTP 465、
email()handler 与本地调试，并对照 Agentic Inbox 参考实现。
域名与 SaaS 接入
- Domain Connect：让 SaaS 用户一键把自有域名接入服务：从
_domainconnect发现、Template 与签名的 Apply URL 理解协议，再对照 Cloudflare 只支持同步流程的限制、DNS Provider 兼容性、手动 CNAME 兜底与 Custom Hostname 证书校验。
Wallets
- Cloudflare Wallets：Handle 预约、产品状态与现在能做什么：分清已开放的 Handle 预约与尚未开放的充值、Virtual Wallet、控制面 API，并对照今天就能用的 Agents SDK x402 付款路径。
平台应用
- Cloudflare OS：产品形态、Gadgets、Gatekeepers 与 Workers 架构：锁定
ef34d8e深入追踪 RPC/Facet、Agent step 与恢复、Git VFS/OT/三方合并、Worktree、Blueprint、Observer 和 Scheduler；正文含 TextChange 交互与上游纯函数复现实验。 - EmDash CMS：技术原理、适用场景与架构取舍：理解数据库内容模型、Astro 请求时查询、Portable Text、插件隔离与 MCP，判断 Agent 内容维护是否适合采用，并核对 Cloudflare 自部署的更新、迁移与恢复机制。
交叉主题
- 自托管「类 Cloudflare Workers」：开源项目 open-compute 的原理、架构与适用场景：从 workerd isolate、ocd 控制面与 SQLite 存储理解单机架构，再对照兼容性边界与适用场景。
- OpenCode v2 在 Cloudflare 上怎么用：使用场景与 SDK 入门：从官方入口理解使用场景，完成 Durable Object 初始化、Session 调用和 Plugin 接入。
收录原则
以 Cloudflare 产品能力为主线、可长期维护的资料归入对应产品子目录，并同步更新本页导航。跨产品文章按主线归类，在相关产品组保留交叉链接；只将 Cloudflare 作为案例的跨云对比、Serverless 通识或行业观察文章，仍保留在原有主题与时间线中。