> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 本地调试

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

使用此工作流在创建拉取请求之前预览并验证公开文档站点。

## 网站位于何处

Mintlify 站点从仓库根目录进行配置。这里没有嵌套的前端应用，也不需要 `package.json`。

关键文件：

* `docs.json` 控制 Mintlify 的导航和站点设置。
* `index.mdx` 是 Mintlify 主页。
* `*.mdx` 文件是已发布文档页面的单一来源。
* `.mintignore` 可将仅限本地的内容和原始源材料排除在已发布的文档站点之外。

## 启动预览

安装 Node.js 20.17.0 或更高版本。仓库包含 `.nvmrc` 和 `.node-version`，其中指定了支持的最低版本。

如果你使用 `nvm`，请运行：

```bash theme={null}
nvm install
nvm use
```

然后从仓库根目录运行：

```bash theme={null}
npx mint dev --port 3333
```

打开 `http://localhost:3333`。

## 在审查前验证

从仓库根目录运行相同的检查：

```bash theme={null}
npx mint validate
npx mint broken-links
```

`mint broken-links` 可能会从被忽略的原始参考材料中打印解析器警告。即便如此，该检查仍应完成，并且已发布站点不应存在损坏的链接。

## 在添加或移动页面时

1. 编辑或创建 `.mdx` 页面。
2. 在 `docs.json` 中添加或更新路由。
3. 在本地预览准确的路由。
4. 提交前运行 `npx mint validate`。

在 Mintlify 导航和卡片中使用不带扩展名的内部路由，例如
`/reading-paths/explorer`，而不是 `/reading-paths/explorer.mdx`。