Jamdesk 工作原理
从 Git 推送到文档上线不到 60 秒。了解 Jamdesk 如何构建、部署和优化文档站点，无需管理基础设施。
Jamdesk 从 GitHub 仓库中的 MDX 文件构建文档站点。你可以使用 React 组件编写 Markdown，推送到 GitHub，站点会在不到 60 秒内上线全球 CDN。内容以纯 MDX 文件的形式保留在你的仓库中，因此你可以随时将其迁移到其他工具。
架构概览
你的仓库是唯一可信来源。Jamdesk 连接仓库、构建站点，并将其部署到全球边缘网络。你无需管理任何基础设施。
构建流程
通常从开始到完成需要 30–60 秒。构建速度快，是因为 Jamdesk 不会预渲染页面。原始内容会发送到边缘网络，访客请求页面时才按需渲染。
你可以推送到已连接的 GitHub 分支，或在仪表板中点击 Rebuild。Jamdesk 会克隆你的仓库并查找文档目录。
系统会根据架构验证你的 docs.json 配置，并检查内部链接是否指向不存在的页面或错误的锚点。
内容会上传到 CDN，并传播到 300 多个边缘位置。只有发生更改的文件会被传输，因此重新部署速度很快。
每个站点内置的功能
每个站点默认都包含以下功能，无需额外配置。
什么会触发构建
向已连接的分支执行 git push、点击仪表板中的 Rebuild 按钮，或通过 CLI 运行 jamdesk deploy。如果你在短时间内推送多个提交，Jamdesk 会将它们合并为一次构建，避免浪费资源。
如需了解运行详情（状态监控、回滚、环境变量和分支部署），请参阅 构建与部署生命周期。
安全性与基础设施
你无需关注这些细节，但如果安全团队提出疑问：构建会在隔离容器中运行，并且你的 GitHub App 连接仅具有读取权限。
性能
文档能否被发现，部分取决于加载速度。Google 将 Core Web Vitals 作为排名信号，而 GPTBot 和 ClaudeBot 等 AI 爬虫每个页面只会给自己 1–5 秒的抓取时间。如果你的文档无法在这段时间内加载，就不会被引用。
每个 Jamdesk 站点都从边缘网络提供服务，首字节时间低于 50 毫秒。这一速度足以满足 Google 的排名阈值，也能让 AI 爬虫抓取并引用文档。
| 指标 | 典型值 |
|---|---|
| 构建时间 | 30–60 秒 |
| 部署传播时间 | < 30 秒 |
| 首字节时间（边缘） | < 50ms |
| 完整页面加载时间 | < 500ms |