命令参考

全局选项

以下选项适用于所有命令。

选项	描述
`--telemetry`, `-t`	启用或禁用匿名使用遥测。
`--help`, `-h`	显示命令帮助。
`--version`, `-v`	显示 CLI 版本。`mint version` 的别名。

`mint dev`

启动文档的本地预览。

mint dev [flags]

选项	描述
`--port`	本地预览使用的端口。默认为 `3000`。
`--no-open`	不自动打开浏览器。
`--groups`	以逗号分隔的用户组列表，用于模拟预览。
`--disable-openapi`	跳过 OpenAPI 文件处理以提高性能。
`--local-schema`	允许通过 HTTP 提供的本地托管 OpenAPI 文件。

使用你的 Mintlify 账户进行身份验证。

mint login

打开浏览器窗口完成身份验证。如果浏览器未打开，CLI 会显示一个 URL 供你手动打开，并提示你粘贴授权代码。凭据保存在 ~/.config/mintlify/config.json 中。如果你有多个部署，CLI 会在登录后提示你选择一个默认项目。你可以稍后使用 mint config set subdomain <subdomain> 更改默认项目。

`mint logout`

移除已存储的凭据。

mint logout

`mint status`

显示当前会话的详细信息，包括 CLI 版本、账户邮箱、组织和已配置的子域名。

mint status

`mint automations`

从终端创建、列出和删除自动化。需要使用 mint login 进行身份验证。

mint automations <subcommand> [flags]

mint workflow 和 mint workflows 仍可作为 mint automations 的别名继续使用，因此现有脚本仍可正常运行。新脚本应使用 mint automations。

所有子命令都接受以下共享选项：

选项	描述
`--subdomain`	文档子域名。默认为通过 `mint config set subdomain` 设置的值，或你账户中的第一个项目。
`--format`	输出格式：`table`（默认，美化）或 `json`（原始、机器可读）。

当设置 --format json 时，错误会以 Error: <message> 的形式输出到 stderr，并且命令以非零状态退出，因此你可以将成功的输出通过管道传递给其他工具。

`mint automations create`

创建新自动化。你可以通过选项内联传递自动化定义，或者使用 --file 指向一个 JSON 或 YAML 文件。

mint automations create [flags]

选项	描述
`--name`	自动化名称。除非提供了 `--file`，否则为必填项。
`--prompt`	每次运行时附加到自动化基础提示的说明。
`--type`	自动化类型。可选值之一：`changelog`、`source-code-agent`、`translations`、`writing-style`、`typo-check`、`broken-link-detection`、`seo-metadata-audit`、`assistant-docs-updates` 或 `contextual-feedback-docs-updates`。省略表示自定义自动化。
`--cron`	用于计划触发的 cron 表达式。与 `--push-repo` 互斥。
`--push-repo`	用于推送触发的仓库（`owner/repo`）。可重复以监听多个仓库。与 `--cron` 互斥。
`--context-repo`	自动化运行时 agent 读取的附加上下文仓库（`owner/repo`）。可重复，总共最多 10 个。
`--automerge`	自动合并此自动化打开的 pull request。设置要求请参见配置 automerge。
`--file`	指向包含完整自动化主体的 JSON 或 YAML 文件路径。会覆盖内联选项。

请提供恰好一个触发器：传入 --cron 表示计划自动化，或传入一个或多个 --push-repo 选项表示推送触发的自动化。

示例

# 计划翻译自动化
mint automations create \
  --name "Translate content" \
  --type translations \
  --cron "0 6 * * *"

# 带额外上下文的推送触发自动化
mint automations create \
  --name "Sync API reference" \
  --type source-code-agent \
  --push-repo my-org/api \
  --context-repo my-org/shared-types \
  --automerge

# 从文件创建
mint automations create --file automation.yaml

自动化文件使用与内联选项相同的结构。on 字段保存触发器：

name: Translate content
type: translations
on:
  cron: "0 6 * * *"
prompt: Prefer formal tone in French translations.
automerge: false
context:
  - repo: my-org/shared-content

`mint automations list`

列出当前部署的自动化。

mint automations list [flags]

默认的表格输出显示每个自动化的 ID、名称、类型、触发器和状态。使用 --format json 可获取完整的自动化对象。

`mint automations delete`

通过 ID 删除自动化。使用 mint automations list 获取 ID。

mint automations delete <id> [flags]

参数	描述
`id`	要删除的自动化架构 ID。

`mint config`

管理 CLI 命令的持久默认值。配置保存在 ~/.config/mintlify/config.json 中。

mint config <subcommand> <key> [value]

子命令	描述
`set <key> <value>`	设置配置值。
`get <key>`	显示配置值。
`clear <key>`	移除配置值。

配置键

键	描述	使用者
`subdomain`	默认文档子域名。	`mint automations`

`mint broken-links`

检查文档中的内部断链。

mint broken-links [flags]

该命令会排除匹配 .mintignore 模式的文件。指向被忽略文件的链接会被报告为断链。

选项	描述
`--check-anchors`	同时验证锚链接（例如 `/page#section`）是否与标题 slug 匹配。
`--check-external`	同时检查外部 URL 是否有断链。
`--check-redirects`	同时检查 `docs.json` 中的重定向目标是否解析为有效路径。
`--check-snippets`	同时检查 `<Snippet>` 组件内的链接。

检查文档中的无障碍性问题。

mint a11y [flags]

检查颜色对比度和图片、视频上缺失的替代文本。

选项	描述
`--skip-contrast`	跳过颜色对比度检查。
`--skip-alt-text`	跳过缺失替代文本检查。

`mint validate`

以严格模式验证文档构建。如果存在警告或错误则以错误退出。包括对 docs.json 中引用的 OpenAPI 规范的自动验证。

mint validate [flags]

选项	描述
`--groups`	以逗号分隔的用户组列表，用于模拟验证。
`--disable-openapi`	跳过 OpenAPI 文件处理和验证。
`--local-schema`	允许验证通过 HTTP 提供的本地托管 OpenAPI 文件。生产环境仅支持 HTTPS。

请改用 mint validate，而不是已弃用的独立 mint openapi-check 命令。

`mint export`

将文档导出为独立的 zip 存档，用于离线查看和分发。

mint export [flags]

选项	描述
`--output`	输出文件名。默认为 `export.zip`。
`--groups`	以逗号分隔的用户组列表，用于包含受限页面。
`--disable-openapi`	跳过 OpenAPI 处理。

有关详细信息，请参阅离线导出。

`mint score`

对公共文档站点运行代理就绪性检查。需要使用 mint login 进行身份验证。

mint score [url] [flags]

参数	描述
`url`	可选。要检查的文档站点的 URL。如果省略，该命令将对你配置的子域名进行评分（来自 `mint config`，或与你登录账户关联的子域名）。

选项	描述
`--format`	输出格式：`table`（默认，带颜色）、`plain`（可管道传输的 TSV）或 `json`。

该命令显示总体就绪性评分以及各项检查的通过/未通过指标。

示例

# 评分你的默认子域名
mint score

# 评分特定站点
mint score docs.example.com

检查项

评分评估以下方面：

检查项	验证内容
`llmsTxtExists`	代理可以访问站点根目录下的 llms.txt 文件。
`llmsTxtValid`	`llms.txt` 文件遵循预期格式，包含标题、引用摘要和 Markdown 链接。
`llmsTxtSize`	`llms.txt` 文件在大小阈值内，确保代理可以完整消费而不会被截断。
`llmsTxtLinksResolve`	`llms.txt` 中的链接指向有效页面。
`llmsTxtLinksMarkdown`	`llms.txt` 中的链接使用 Markdown 语法。
`llmsTxtDirective`	`llms.txt` 文件包含使用指令。
`llmsTxtFullExists`	提供了 llms-full.txt 文件，供需要完整内容的代理使用。独立于 `llmsTxtExists` 运行。
`llmsTxtFullSize`	`llms-full.txt` 文件大小合理，代理可以处理。
`llmsTxtFullValid`	`llms-full.txt` 文件包含带标题的有效内容。
`llmsTxtFullLinksResolve`	`llms-full.txt` 中的链接指向有效页面。
`skillMd`	代理可以访问 skill.md 文件以供代理工具使用。
`contentNegotiationMarkdown`	当代理通过内容协商请求时，站点返回 Markdown。
`contentNegotiationPlaintext`	当代理通过内容协商请求时，站点返回纯文本。
`mcpServerDiscoverable`	代理可以发现用于基于工具的代理的 MCP 服务器。
`mcpToolCount`	MCP 服务器至少公开一个工具。
`openApiSpec`	在标准路径下有可用的 OpenAPI 或 Swagger 规范。
`robotsTxtAllowsAI`	`robots.txt` 文件没有阻止 AI 爬虫。
`sitemapExists`	有可用的站点地图供页面发现使用。
`structuredData`	主页包含 JSON-LD 结构化数据（`<script type="application/ld+json">`）。报告 JSON-LD 块的数量和发现的架构类型。
`responseLatency`	站点在代理可接受的时间内响应。

某些检查项仅在其依赖的检查项通过时才会运行。如果某个检查项失败，所有依赖它的检查项都不会运行，它们会自动失败。例如，llmsTxtValid 仅在 llmsTxtExists 先通过后才会通过。总分使用加权评分，因此影响更大的检查项对您的分数贡献更多。

`mint deslop`

检测文档页面中读起来像 AI 生成的文字，并给出人性化改写建议。需要使用 mint login 进行身份验证。

mint deslop [files..] [flags]

在没有参数的情况下，该命令会检查 git 中有变更的 .md 和 .mdx 页面（已暂存、未暂存和未跟踪的）。在包含 docs.json 的文档仓库中，变更文件会自动过滤为你的导航中引用的页面，因此会跳过 .mintignore 掉的页面以及未发布的页面。你也可以显式传入文件路径或通配符。每个页面会根据其读起来像 AI 撰写的文字所占比例进行评分。达到或超过 --threshold 的页面会失败，如果有任何页面被标记或出错，命令会以状态码 1 退出。完全由人类撰写的页面永远不会失败，即使在 --threshold 0 下也是如此。

参数	描述
`files`	可选。要检查的一个或多个文件路径或通配符。默认为 git 中有变更的页面。

选项	描述
`--subdomain`	文档子域名。默认为通过 `mint config set subdomain` 设置的值。
`--format`	输出格式：`table`（默认，带颜色）、`plain`（可管道传输）或 `json`（对代理友好）。
`--threshold`	当页面 AI 撰写文字的比例达到该值时判为失败。介于 `0` 和 `1` 之间的数字。默认为 `0.5`。
`--fix-whitespace`	在评分前规范化所检查文件中的正文空白。仅在本地重写文件，不调用服务器。

对于每个被标记的页面，输出会显示 AI 撰写的百分比、被标记的行范围、有问题的文字，以及可以应用的改写建议。

检查页面会消耗 AI 额度。--fix-whitespace 在本地运行，不会消耗额度。如果批处理遇到额度或可用性错误，剩余页面会被跳过而不会重试。

示例

# 检查 git 中有变更的页面
mint deslop

# 检查特定页面
mint deslop docs/guide.mdx

# 通过通配符检查页面，并使用对代理友好的输出
mint deslop "docs/**/*.mdx" --format json

# 仅对最确信为 AI 撰写的页面判为失败
mint deslop --threshold 0.8

# 一次性规范化正文空白并重新检查
mint deslop --fix-whitespace

修复空白

--fix-whitespace 会以确定性方式清理每个所检查文件中的正文空白：行尾空格、连续的空行、unicode 空格和零宽空格，以及内部的双空格。围栏代码块、行内代码和 frontmatter 不会被改动。因为它在本地运行，所以可以安全地纳入预提交钩子或 CI。

JSON 输出

--format json 会向 stdout 写入一个 JSON 对象，其中包含一个 results 数组（每个文件一个条目，以 path 为键）和一个 summary 块。错误会按文件分别报告，并计入 summary.errors。这种结构专为循环运行的代理设计：检查、改写被标记的段落，然后重新运行，直到该命令以 0 退出。该 CLI 调用的是与 Admin API 相同的检测服务。如果你需要在 CI 流水线或内部工具中运行这些检查而不调用 CLI，请使用检查页面中的 AI 风格文案端点。

`mint new`

通过选择主题或从 mintlify/templates 仓库克隆预定义模板来创建新的文档项目。

mint new [directory] [flags]

选项	描述
`--name`	项目名称。在交互模式下未提供时，CLI 会提示输入。
`--theme`	项目主题。在交互模式下未提供时，CLI 会提示选择。
`--template`	预定义模板。在交互模式下未提供时，CLI 会提示选择。
`--force`	无需确认即覆盖目录。

`mint update`

将 CLI 更新到最新版本。

mint update

`mint version`

显示当前 CLI 和客户端版本。

mint version

即将推出

这些命令可以运行但尚未正式启用。运行它们会通过 CLI 遥测记录你的兴趣，并帮助确定下一步开发的优先级。

命令	描述
`mint ai`	AI 驱动的文档工具。
`mint test`	文档测试。
`mint signup`	从 CLI 注册账户。
`mint mcp`	文档 MCP 服务器。

遥测

CLI 收集匿名使用遥测数据以帮助改进 Mintlify。遥测数据包括命令名称、CLI 版本、操作系统和架构。Mintlify 不会收集个人身份信息、项目内容或文件路径。默认情况下，CLI 会收集遥测数据。你可以随时使用 --telemetry 选项退出：

# 禁用遥测
mint --telemetry false

# 重新启用遥测
mint --telemetry true

你也可以通过设置以下环境变量来禁用遥测：

变量	值	描述
`MINTLIFY_TELEMETRY_DISABLED`	`1`	禁用 Mintlify CLI 遥测。
`DO_NOT_TRACK`	`1`	使用 Console Do Not Track 标准禁用遥测。

你的偏好保存在 ~/.config/mintlify/config.json 中，在 CLI 会话之间持久有效。

快速入门

组织

自定义

创建内容

编写 API 文档

部署

优化

全局选项

`mint dev`

`mint logout`

`mint status`

`mint automations`

`mint automations create`

示例

`mint automations list`

`mint automations delete`

`mint config`

配置键

`mint broken-links`

`mint validate`

`mint export`

`mint score`

示例

检查项

`mint deslop`

示例

修复空白

JSON 输出

`mint new`

`mint update`

`mint version`

即将推出

遥测

​全局选项

​mint dev

​mint login

​mint logout

​mint status

​mint automations

​mint automations create

​示例

​mint automations list

​mint automations delete

​mint config

​配置键

​mint broken-links

​mint a11y

​mint validate

​mint export

​mint score

​示例

​检查项

​mint deslop

​示例

​修复空白

​JSON 输出

​mint new

​mint update

​mint version

​即将推出

​遥测

全局选项

`mint dev`

`mint login`

`mint logout`

`mint status`

`mint automations`

`mint automations create`

示例

`mint automations list`

`mint automations delete`

`mint config`

配置键

`mint broken-links`

`mint a11y`

`mint validate`

`mint export`

`mint score`

示例

检查项

`mint deslop`

示例

修复空白

JSON 输出

`mint new`

`mint update`

`mint version`

即将推出

遥测