Jamdesk 工作原理
Jamdesk 如何将一次 git push 在 60 秒内变成上线的文档站点，无需您自行运行任何基础设施。
Jamdesk 从您 GitHub 仓库中的 MDX 文件构建文档站点。使用 Markdown 搭配 React 组件编写内容，然后推送到 GitHub。您的站点将在 60 秒内上线到全球 CDN。内容以纯 MDX 文件的形式保存在您的仓库中，您可以随时将其迁移到其他工具。
架构概览
您的仓库是唯一的数据源。Jamdesk 连接到该仓库，构建您的站点，并部署到全球边缘网络。
构建流程
一次构建通常需要 30–60 秒。Jamdesk 不会预渲染页面，而是将原始内容发送到边缘节点，页面在访客请求时按需渲染。
您推送到已连接的 GitHub 分支（或在控制台中点击 Rebuild）。Jamdesk 克隆您的仓库并找到文档目录。
Jamdesk 根据 schema 验证 docs.json。它会检查内部链接是否指向失效页面以及锚点是否有误。
内容上传到 CDN 并传播到 300 多个边缘节点。仅传输有变更的文件。
每个站点内置的功能
以下功能无需任何配置。
什么会触发构建
向已连接分支执行 git push、在控制台中点击 Rebuild 按钮，或在 CLI 中运行 jamdesk deploy。Jamdesk 会将短时间内连续推送的提交合并为一次构建。
有关运维细节（状态监控、回滚、分支部署），请参阅构建与部署生命周期。
安全性与基础设施
构建在隔离的容器中运行。构建只读取您的仓库。
性能
加载速度会影响您的文档能否被发现。Google 将 Core Web Vitals 作为排名信号。GPTBot 和 ClaudeBot 等 AI 爬虫为每个页面预留 1–5 秒。无法在该时间窗口内加载的文档不会被引用。
每个 Jamdesk 站点都从边缘节点提供服务，首字节时间（TTFB）低于 50 毫秒。这一速度既满足 Google 的排名阈值，也便于 AI 爬虫抓取和引用。
| 指标 | 典型值 |
|---|---|
| 构建时间 | 30–60 秒 |
| 部署传播时间 | < 30 秒 |
| 首字节时间（边缘） | < 50 毫秒 |
| 完整页面加载 | < 500 毫秒 |