AI 参与说明（Agent：Codex）：本页由 Codex 根据站内已校验的 Convex 技术文档整理，用于说明阅读顺序与交叉主题归属。具体 API、版本与能力边界以各篇文档中列出的一手资料和项目实际版本为准。
修订说明
导航补充（2026-09-16，Agent：Codex）：加入公开 Roadmap 快照，区分开发中、计划中、Beta 与已完成能力；补齐页面元数据，日期依据首次提交记录，保留既有页面路径。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得运行记录。
术语校对（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）：交叉主题加入 Stripe 接入指南，以及 Convex 与 Durable Objects 的状态模型对比。模型
grok-4.6，提供方xAI，执行入口 Grok Build TUI。
修订说明折叠（2026-09-15，Agent：Cursor）：将导航补充与术语校对收入默认折叠的「修订说明」，栏目导语保持可见。模型
grok-4.6，提供方 xAI，执行入口 Cursor Cloud。reasoning effort 未取得运行记录。
这里集中维护 Convex 的架构、开源源码、Components 与工程实践。
产品进展
- Convex 公开 Roadmap：开发中、计划中与已落地能力：2026-09-16 的官方公开状态快照，包含 7 项 In Progress、8 项 Planned，以及 AI Gateway Beta、Streaming Export APIs 等交付边界。
推荐阅读顺序
- Convex 源码导读：开源仓库版图、核心架构与阅读路线：先建立官方仓库、核心后端与客户端生态的整体认知。
- 在阿里云中国大陆自托管 Convex：可行性评估与部署方案：评估 FSL 许可、Self-hosted 功能与 HA 边界，并给出以 ECS、ALB/WAF、RDS PostgreSQL、OSS、ACR 和 KMS 为底座的受控上线方案。
- ClawHub 源码分析：Convex 架构、缓存、数据流与 PostgreSQL 选型：从当前源码追踪 Query/Mutation/Action、派生读模型、发布与下载、统计、缓存分层和部署，并评估 Convex 与 Drizzle + PostgreSQL 的实际适配度。
- 以 ClawHub 为例：如何在真实流量下优化 Convex：以历史优化案例把观测、订阅选择、digest table、compound index、无效写入与 backfill 限速串成闭环。
- Convex Components：概念、隔离模型与使用方式：理解带私有状态的 backend module 边界、安装方式与调用语义。
- Convex Workflow：接口、事件与恢复 API 实战：从 Component 注册、持久化步骤到重试、事件和版本演进，完成可恢复工作流。
- Convex + TanStack Query：
useQuery与useSuspenseQuery的选择、原理与场景：理解实时订阅、Suspense、SSR 与条件查询在 Convex React 数据层中的边界。
交叉主题
- Stripe 接入指南：角色、对象、Checkout 与 Webhook：支付对象与 Webhook 履约；Convex 后端可评估
@convex-dev/stripe，但客户映射和 Event 语义仍按该文核对。 - Convex 与 Cloudflare Durable Objects：状态模型、查询边界与选型：分清共享响应式数据库与单实例 Actor；跨平台状态模型比较保留在 Cloudflare 专题。
- Convex Agent Component 与 Cloudflare Agents SDK：关页后继续生成并恢复聊天：比较消息事务确认、后台生成、stream deltas、断线恢复及 Workers + TanStack 的集成方式。
- Convex Workflow、Cloudflare Workflows 与 Dynamic Workflows：区别、场景与使用方式：跨平台编排比较保留在 Cloudflare 专题。