---
title: 监控构建
description: "实时跟踪构建进度，了解各个构建阶段，查看结构化构建日志，并从 Jamdesk 仪表板的构建页面诊断失败原因。"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

每个构建都会从排队到上线经历多个阶段。你可以从 **Deployments** 标签页监控进度。

## 构建阶段

<Steps>
  <Step title="排队中">
    构建正在等待开始。大多数构建会在几秒内启动。
  </Step>
  <Step title="克隆中">
    正在从 GitHub 拉取你的仓库内容。
  </Step>
  <Step title="验证中">
    正在检查 `docs.json` 配置和 MDX 语法。
  </Step>
  <Step title="处理中">
    正在解析 MDX 文件并解析导入内容。
  </Step>
  <Step title="构建中">
    正在将 MDX 编译为 HTML，并应用语法高亮。
  </Step>
  <Step title="部署中">
    正在上传到 CDN 并清除缓存。
  </Step>
  <Step title="已上线">
    构建完成。你的文档已更新。
  </Step>
</Steps>

## 查看构建状态

### 仪表板概览

项目主页会显示：

- 当前构建状态
- 上次成功部署的时间
- 最近的构建历史记录

### 构建详情

点击任意构建即可查看：

- 开始和结束时间
- 持续时间
- 触发方式（推送、手动、CLI）
- 提交哈希和消息
- 完整构建日志

### 警告和建议

已完成的构建可能包含两级反馈：

- **Warnings**（橙色徽章）— 值得修复的问题，例如链接失效或资源缺失。这些问题不会导致构建失败。
- **Suggestions**（灯泡图标）— 针对网站品牌和 SEO 的可选优化，例如添加 [favicon、描述或徽标](/cn/customization/branding)。建议仅显示在最近一次已完成的构建中，不计入警告徽章，也不会通过电子邮件发送。

许多链接失效和描述缺失警告都可以自动修复。当最近一次构建包含可修复的问题时，使用 [Fix with AI](/cn/builds/fix-with-ai) 查看并应用更改，无需手动编辑 MDX。

## 构建日志

详细日志有助于调试问题：

```text
[12:34:56] Starting build...
[12:34:57] Cloning repository...
[12:34:59] Found docs.json at root
[12:35:00] Validating configuration...
[12:35:01] Processing 45 pages...
[12:35:15] Building search index...
[12:35:18] Deploying to CDN...
[12:35:22] Build complete!
```

## 构建通知

构建完成或失败时，Jamdesk 可以通过电子邮件或 Slack 向你发送提醒：

### 电子邮件

在 **Settings** → **Notifications** 中启用构建失败提醒。

### Slack

连接 Slack，即可在你的频道中接收构建通知。请参阅 [Slack 集成](/cn/integrations/slack)。

## 构建历史

在 **Deployments** 标签页中查看最近 30 个构建：

- 构建状态（成功、失败、已取消）
- 持续时间
- 触发类型
- 提交信息

## 取消构建

要取消正在运行的构建：

1. 转到 **Deployments** 标签页
2. 找到正在运行的构建
3. 点击 **Cancel**

上一次成功的构建会继续保持上线状态。

## 相关文章

<Columns cols={2}>
  <Card title="使用 AI 修复" icon="wand-magic-sparkles" href="/cn/builds/fix-with-ai">
    自动修复链接失效和描述缺失问题
  </Card>
  <Card title="触发构建" icon="play" href="/cn/builds/triggering">
    手动触发构建或在推送时触发
  </Card>
  <Card title="构建故障排除" icon="wrench" href="/cn/builds/troubleshooting">
    修复失败的构建
  </Card>
</Columns>