Convex — 文档导航

文档导航

AI 参与说明（Agent：Codex）：本页由 Codex 根据站内已校验的 Convex 技术文档整理，用于说明阅读顺序与交叉主题归属。具体 API、版本与能力边界以各篇文档中列出的一手资料和项目实际版本为准。

这里集中维护 Convex 的架构、开源源码、Components 与工程实践。

推荐阅读顺序#

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 数据层中的边界。