mintlify__docs/zh/changelog.mdx

---
title: "产品更新"
description: "及时了解最新的 Mintlify 产品更新、新功能、平台改进、错误修复和文档工具变更。"
rss: true
noindex: true
---

<Update label="2026年8月21日" tags={["新版本","改进","错误修复"]} rss={{ title:"Branches v2、Slack 触发的 automations 与可自定义的 SDK reference 页面" }}>

<div id="editor-and-collaboration">
  ## 编辑器与协作
</div>

  - **Branches v2 与版本历史：** 编辑器分支现在以草稿 pull request 为基础，并自动将更改保存到 Git。您可以重命名或删除分支、丢弃自动保存的更改，以及将待处理更改移动到新分支。分支菜单按最近活动排序、使用按用户区分的分支名称，并为自动生成的分支显示更简洁的 `Draft <date>` 名称。详情请参见 [Branching and publishing](/zh/editor/branching-and-publishing)。
  - **简化的编辑器导航：** 编辑器新增面包屑行，整合了页面和分享控件，增加了固定的侧边栏分区标题，以及用于设置和 **Ask agent** 的专用底栏。在小屏幕上，移动端导航现在使用简化的顶栏和面板式侧边栏。
  - **页面访问与评论：** 您可以直接在编辑器中请求对私密或受保护页面的编辑权限，并在审批弹窗中处理请求。评论卡片现在会显示头像，@提及也会链接到被提及的用户。
  - **实时预览改进：** 可同时运行多个本地预览。导航更改会同步到已打开的预览，Agent 面板停靠在左侧，并且预览会在 onboarding 后续步骤中保持可见。

<div id="automations-and-integrations">
  ## Automations 与集成
</div>

  - **Slack 消息触发器：** Enterprise 客户可以通过所选已连接 Slack 频道中的新顶层消息运行自定义 automations。Agent 会评估每条消息，并仅在确有必要时采取行动。详情请参见 [从集成触发 automation](/zh/automations/integrations#trigger-an-automation-from-an-integration)。

<div id="docs-and-delivery">
  ## 文档与交付
</div>

  - **自定义 SDK reference 页面：** 使用 `sdk` frontmatter 为单个 SDK 符号生成文档，并在生成的内容上方添加您自己的示例或说明。您还可以为导航组配置 SDK 生成功能。详情请参见 [自定义单个符号的页面](/zh/api-playground/sdk-reference-setup#customize-a-page-for-a-single-symbol)。
  - **`nocopy` 代码块：** 为围栏代码块添加 `nocopy` 标志即可隐藏复制按钮。对于 ASCII 图等纯文本内容，请使用仅含 `nocopy` 的围栏。详情请参见 [隐藏复制按钮](/zh/create/code#hide-copy-button)。
  - **结果片段：** 可选择在每个搜索结果下方显示一行内容预览，并高亮匹配的词语。请在 dashboard 搜索设置中启用 **Result snippets**；该设置默认关闭。详情请参见 [结果片段](/zh/optimize/search#result-snippets)。
  - **Assistant widget 访问权限：** Widget 设置现在需要 Assistant 访问权限。详情请参见 [Assistant widget](/zh/assistant/widget)。
  - **Assistant widget 分析：** 分析事件现在默认包含嵌入 widget 的页面当前路径，并会跟随客户端导航更新。将 `analytics.capturePathname` 设置为 `false` 可选择退出。详情请参见 [AssistantAnalyticsConfig](/zh/assistant/widget#assistantanalyticsconfig)。
  - **批量成员邀请：** Pro 和 Enterprise 客户可以通过上传 CSV 一次邀请最多 250 名队友，并在发送前审核名单和分配角色。详情请参见 [向组织添加成员](/zh/dashboard/roles#add-members-to-your-organization)。
  - **自托管部署中的分析：** Dashboard 分析选项卡现已在自托管部署上可用。
  - **Starter 计划：** Hobby 计划已更名为 Starter。[价格和权益](https://www.mintlify.com/pricing)保持不变。

<div id="bug-fixes">
  ## 错误修复
</div>

  - **API playground：** OpenAPI 3.1 示例和枚举值现在会出现在生成的响应示例中。
  - **搜索锚点：** 带有自定义 ID 的 JSX 标题现在会创建正确的搜索分区和锚点。
  - **编辑器组件：** 在 `Step` 内复制粘贴不再创建嵌套步骤，Tabs 在点击时不再跳动，并且设置侧边栏搜索已恢复。
  - **锚点图标：** 将鼠标悬停在深色背景上时，锚点链接图标会保持白色。
  - **Assistant widget 加载：** Widget 在加载时保持可交互。
  - **Discord 机器人：** Discord assistant 在遇到过期的交互时不再崩溃。

</Update>

<Update label="2026年8月14日" tags={["新版本","改进","错误修复"]} rss={{ title:"Bitbucket Cloud 支持、在文档中嵌入 GitHub 仓库等" }}>

<div id="bitbucket-cloud-support">
  ## Bitbucket Cloud 支持
</div>

  Enterprise 计划现已支持将 Bitbucket Cloud 作为 Git 提供商。详情请参见 [Bitbucket Cloud 支持](/zh/deploy/bitbucket)。

<div id="editor-and-collaboration">
  ## 编辑器与协作
</div>

  - **重新设计的版本历史：** 编辑器中的版本历史现在显示按日期分组的时间线。
  - **编辑器自动提交：** 在编辑器设置中开启自动提交，即可在输入时提交您的工作。
  - **编辑器分支创建：** 分支创建速度更快，创建分支时可以带上或暂存待处理的更改。您还可以在编辑器中编辑分支的 pull request 标题。
  - **私密页面：** 私密页面拥有自己的版本历史、agent 注释和通知邮件。将私密页面移至 workspace 文件夹即可发布到您的站点。
  - **Personal 与 Shared 分区：** 编辑器侧边栏设有 **Personal** 和 **Shared** 分区，让私密草稿与共享内容更易于区分。
  - **编辑器评论：** 过长的评论正文会被截断到六行并提供 **Show more** 控件，评论卡片的滚动、键盘快捷键和编辑输入也得到了打磨。
  - **批量成员邀请：** 从 dashboard 一次即可邀请多位队友加入您的组织。
  - **分支中的协作者：** 分支下拉列表会显示每个分支上的协作者，头像会在 Git 和编辑器身份之间去重，pull request 作者也会包含在贡献者列表中。对编辑器分支的外部推送会实时同步到编辑器中。

<div id="docs-and-delivery">
  ## 文档与交付
</div>

  - **GitHub 组件：** 在任意页面中嵌入一个公共 GitHub 仓库卡片，包含实时描述、star 数和 fork 数。用法与变体请参见 [GitHub](/zh/components/github)。
  - **语言偏好路由：** 将访问者从站点根路径重定向到与其浏览器 `Accept-Language` 头匹配的语言。请在 [Add-ons](https://app.mintlify.com/settings/deployment/addons) 页面启用 **Auto-route to preferred language**。详情请参见[导航](/zh/organize/navigation#route-visitors-to-their-preferred-language)。
  - **`lastUpdatedDate` frontmatter：** 最后修改页脚现在会优先使用页面 frontmatter 中的 `lastUpdatedDate` 值，而不是 Git 提交日期。
  - **搜索相关性：** 逐字匹配的标识符会在搜索结果中被提升排序，标识符 token 也会在分块拆分时得到保留。
  - **翻译可靠性：** 修复了整站翻译触发问题，并提高了翻译超时时间以适应更大的站点。
  - **API playground 端点菜单：** 优化了布局与间距，为 OPTIONS 提供正确的列宽，并修复了在端点搜索中输入的问题。

<div id="agent-integrations">
  ## Agent 集成
</div>

  - **Stripe 与扩展的 Notion 集成：** 将 [Stripe](/zh/automations/integrations) 作为只读集成连接，并在 Slack 和 automations 中使用更多 Notion 读取工具。
  - **Zendesk 集成：** 连接 [Zendesk](/zh/automations/integrations)，让 agent 能够使用您的支持工作区中的上下文。

<div id="bug-fixes">
  ## 错误修复
</div>

  - **Mermaid 图表：** 同一页面上的多个 Mermaid 图表在初始化时不再冲突。
  - **Assistant 历史：** 来自 assistant 的澄清性问题现在会在 dashboard 对话历史和分析导出中正确呈现。
  - **拒绝编辑器建议：** 建议的拒绝按钮现在会以内联方式显示。
  - **多仓库变量：** 变量现在在多仓库部署配置中能够正确解析。
  - **GitLab webhooks：** 来自 GitLab OAuth webhook 端点的 push 事件现在能被正确处理。
  - **Broken-links CLI：** `mint broken-links` 现在能够解析包含非 ASCII 字符的路径。
  - **代码片段校验：** 当代码片段对一个没有 default export 的文件使用 default import 时，`mint validate` 会发出警告。
  - **Markdown 任务列表：** Markdown 中的任务列表项样式已修正。
  - **焦点轮廓：** 交互元素的焦点轮廓现在在站点上保持一致对齐。
  - **下拉切换器：** 在下拉菜单之间切换现在会跳转到目标下拉菜单中匹配的页面，而不是下拉菜单的根页面。
  - **带基础路径的锚点：** 作者书写的锚点在使用自定义基础路径的部署中能够正确解析。
  - **编辑器导航栏：** 编辑器顶栏中过长的标题会被干净地截断，而不再溢出。
  - **GitHub 设置可见性：** 在连接到其他 Git 提供商的部署中，GitHub 应用设置会被隐藏。
  - **PDF 附件：** 上传的 PDF 附件不再在实时嵌入内部呈现。

</Update>

<Update label="2026年8月5日" tags={["新版本"]} rss={{ title:"Mintlify Index 正式发布" }}>

<div id="mintlify-index">
  ## Mintlify Index
</div>

  [Mintlify Index](/zh/search-index) 为编程代理提供统一的检索层，用于访问由发布者维护的技术文档和互联网内容。

  - **公共 MCP 服务器：** 无需 API key 即可[连接](/zh/search-index/connect)编程代理。`context` 工具会为实现任务返回带有来源引用的资料。
  - **访问受控的 REST API：** 搜索排名靠前的来源，在 token 预算内组装上下文，并通过单独的 API 端点检索选定内容。需要 Index API key。

</Update>

<Update label="July 31, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"私密页面、Assistant Widget 分析、展示次数分析等" }}>

<div id="new-features">
  ## 新功能
</div>

  - **私密页面：** 起草在正式站点上保持隐藏、直至您准备好发布的页面，无需单独的分支。可在[编辑器](/zh/editor)中管理可见性。
  - **展示次数分析：** [analytics](/zh/analytics) 中新增的 Impressions 部分通过图表和排序表展示 CTA 点击率，让您可以了解哪些行动号召能够带来互动。
  - **Assistant Widget 分析：** 在 analytics dashboard 中追踪来自 [Assistant Widget](/zh/assistant/widget) 的问题、转移次数和联系表单活动。
  - **Assistant Widget 的联系工具：** [Assistant Widget](/zh/assistant/widget) 现在可以呈现联系表单，并将对话转交给您的支持流程。
  - **面向自定义 JS 的 `window.mintlify.user`：** 已认证的用户信息现在通过 `window.mintlify.user` 暴露给[自定义脚本](/zh/customize/custom-scripts)，并在解析完成时派发 `mintlify:user` 事件。
  - **HTTP 语法高亮：** 使用 ```` ```http ```` 代码块编写请求/响应片段。请参阅[代码块](/zh/create/code)。
  - **通过 dashboard 设置自定义基础路径：** 通过用于自定义域名的同一流程配置[自定义基础路径](/zh/deploy/docs-subpath)。
  - **Top searches 中的搜索源选择器：** 在单个视图中按来源（包括 MCP 搜索）筛选 [Top searches](/zh/analytics/search)。

<div id="improvements">
  ## 改进
</div>

  - **编辑器性能：** 编辑器中的导航校验、页面查找和标签切换现在是线性复杂度而非平方复杂度，因此大型站点的打开和编辑速度显著提升。
  - **个性化功能移至 add-ons：** [个性化](/zh/create/personalization)设置现在位于 dashboard 的 add-ons 下，并可在使用自定义基础路径的 deployments 上进行配置。
  - **截断分页标题：** 上一篇/下一篇页脚链接中过长的标题会被截断，因此不再溢出。
  - **长文件名处理：** 上传的文件名超过 255 个字符时现在会被截断，而不是被拒绝。
  - **转移卡片中的紧凑数字：** 助手转移卡片中的大数字使用紧凑格式化，以提升可读性。
  - **会话录制在 dashboard 中显示真实输入：** Dashboard 中的会话回放不再对非敏感输入进行遮蔽，便于支持排障。密码字段和编辑器内容仍会被遮蔽。

<div id="bug-fixes">
  ## 错误修复
</div>

  - **API playground：** JSON 请求体现在会保留显式的 `null` 值，而不是将其剥离。
  - **预览中的隐藏页面：** 隐藏页面在预览部署的导航中会被正确排除。
  - **相对页面链接：** 指向 `.md` 和 `.mdx` 文件的链接（例如来自 Speakeasy 生成的 SDK 文档）现在会解析到正确的页面 URL，显式的 `index` 链接会折叠为父路径。
  - **多仓库站点中的 OpenAPI：** 由 `x-mint.href` 生成的页面现在位于声明它的规范的挂载路径下，因此 href 页面在多仓库部署中可正确解析。
  - **隐藏的 OpenAPI 端点：** 在 `docs.json` 中列出的显式隐藏端点页面现在解析到自身的 slug，而不是借用同级页面的 slug。
  - **预览部署中的搜索：** 预览部署会继承生产环境的搜索设置。
  - **搜索分析：** 搜索短语聚合现在不区分大小写，因此以不同大小写输入的相同查询会归为一组。
  - **访问量分析：** Markdown 访问请求现在计为代理流量而非人类流量，从而保持流量分类的准确性。
  - **编辑器：** Markdown 表格内的 JSX 表达式可以正确序列化，实时预览更新不会在部署查找期间丢失，实时预览导航在使用局部导航的页面上也能正确渲染。
  - **通知邮件：** `@mention` 和回复通知会链接到该评论对应的实际编辑器 URL。
  - **标签页：** 指向标签页的锚点链接现在会滚动到对应的标签部分。

</Update>

<Update label="July 24, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"GraphQL 与 SDK 参考、Analytics 流式传输、代理集成等" }}>

<div id="graphql-and-sdk-references">
  ## GraphQL 与 SDK 参考
</div>

  - **GraphQL API 参考页面：** 根据 GraphQL SDL schema 生成参考页面，包含类型链接以及示例查询、mutation 和响应。请参阅 [GraphQL 设置](/zh/api-playground/graphql-setup)。
  - **SDK 参考生成：** 直接根据 TypeDoc、DocFX、Javadoc、Sphinx 或 phpDocumentor 的输出构建 SDK 参考页面。请参阅 [SDK 参考设置](/zh/api-playground/sdk-reference-setup)。

<div id="editor-and-collaboration">
  ## 编辑器与协作
</div>

  - **评审流程：** 在草稿上发起评审、留下反馈，并在发布前批准或请求修改。评审现已支持非部署分支。
  - **更多协作方式：** 在整个页面上发起[评论线程](/zh/editor/comments)、提及自己以留下提醒，并使用键盘快捷键 <kbd>Option</kbd> + <kbd>C</kbd> 或 <kbd>Option</kbd> + <kbd>S</kbd> 对所选文本发表评论或提出修改建议。
  - **更快、更易用的编辑体验：** 编辑器无需等待 Git 文件树即可渲染，没有 GitHub 写入权限的用户也可以使用编辑器。

<div id="automations-integrations-and-slack">
  ## 自动化、集成与 Slack
</div>

  - **共享与个人集成：** 为 Slack 代理和自动化提供来自共享工具的只读上下文，或连接个人账号供代理在与您对话时使用。请参阅[集成](/zh/automations/integrations)。
  - **集成触发器：** Enterprise 计划可通过第三方事件（例如支持工单更新）触发自动化。
  - **Slack 代理读取 PR 活动：** [Slack 代理](/zh/agent/slack)现在会读取 PR 评论、评审和 CI 检查，并在根据反馈回滚变更后在会话中跟进说明。

<div id="analytics-and-data-streaming">
  ## Analytics 与数据流式传输
</div>

  - **Analytics 数据仓库流式传输：** Enterprise 计划可将 analytics 事件近实时传输到 Amazon S3，并控制要包含的事件类别和部署。请参阅 [Analytics 流式传输](/zh/analytics/streaming)。
  - **审计日志流式传输：** Enterprise 计划可将审计事件传输到 Amazon S3 或 Datadog，用于安全监控和长期保留。请参阅[审计日志](/zh/dashboard/audit-logs#stream-audit-logs)。
  - **自动化分析 dashboard：** 面向[自动化](/zh/automations)的全新分析视图，包含 pull request 和额度使用指标。

<div id="sites-deployments-and-performance">
  ## 站点、部署与性能
</div>

  - **更小的导航 payload：** 文档页面现在只加载所需的导航数据，对包含多个产品、版本或语言的大型站点提升尤为明显。
  - **更好的预览体验：** 预览部署现在提供搜索，GitHub PR 预览链接也会直接打开修改过的页面。
  - **部署设置：** 使用 `mint add-domain` 从 CLI 配置[自定义域名](/zh/customize/custom-domain)。
  - **`mint signup`：** 直接从终端创建 Mintlify 账号，也适用于由代理驱动的 CLI 工作流。请参阅 [CLI 命令](/zh/cli/commands#mint-signup)。
  - **发布控制：** 分享按特定标签筛选的 [changelog](/zh/changelog)，并在部署时默认忽略 `.mintlify`（`skills` 和 `specs` 除外）。
  - **更简洁的文件树：** 使用嵌套 Markdown 列表编写 [`FileTree`](/zh/components/tree) 组件，以更少的标记记录文件夹结构。

<div id="bug-fixes">
  ## 错误修复
</div>

  - **搜索可靠性：** 搜索会保留路径大小写，将模糊回退限制为接近拼写错误的匹配，恢复卡住的索引任务，重试瞬时上传失败，并正确标记出现在多个产品或版本中的页面。
  - **编辑器内容保真：** 编辑器会保留任务列表、表格转义、LaTeX、callout 类型、视频源、图片标题、包含竖线的内联代码，以及嵌套在 `Columns` 中的块级内容。
  - **身份验证站点：** 搜索会刷新过期的终端用户 JWT，缺失页面会返回真正的 404，未包含密码认证功能时相关设置会以只读方式显示。
  - **预览、链接、导出与域名：** 预览会清晰显示分支已删除，内部 `.md` 链接会遵循 `basePath`，PDF 导出以浅色模式渲染，子路径域名在 DNS 配置期间会保留待处理状态。
  - **主题与 dashboard 路由：** `luma` 和 `sequoia` 的居中页面模式正常工作，`maple` API 侧边面板保持在标签导航下方，重复页面名不再冲突，产品重定向也会保留身份验证路径。

</Update>

<Update label="July 16, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"页面改进、全新 Analytics dashboard 等" }}>

<div id="page-improvements">
  ## 页面改进
</div>

  - **相关页面：** 展示[相关页面](/zh/organize/related-pages)，帮助读者发现更多相关内容。
  - **按页面配置上下文菜单：** 在 frontmatter 中按页面配置[上下文菜单](/zh/ai/contextual-menu)，以覆盖站点级选项。
  - **Mermaid 全屏模式：** 读者可以将 [Mermaid 图表](/zh/components/mermaid-diagrams)展开为全屏视图，便于查看复杂图表。
  - **改进的滚动体验：** 代码块、API playground、表格、侧边栏导航和目录现在共享更流畅的跨平台滚动体验，并提供更大的触控区域。

<div id="editor-improvements">
  ## 编辑器改进
</div>

  - **草稿：** 无需创建分支或使用任何 Git 命令，即可处理未发布的更改。有关更多信息，请参阅[草稿](/zh/editor/branching-and-publishing)。
  - **锁定部署分支：** 如果检测到分支保护，编辑器现在会提示您锁定部署分支。
  - **更快的[编辑器代理](/zh/editor)与更完善的撤销/重做：** 代理更新现在会即时流式显示，导航速度更快，内容和导航树更改也可以干净地撤销和重做。
  - **可折叠标题状态按用户持久化：** 您展开和折叠章节的偏好会在多个编辑器会话之间保留。
  - **编辑器中的 Visibility 组件：** [可视化编辑器](/zh/editor)现已支持 [`Visibility`](/zh/components/visibility) 组件，让您无需离开编辑器即可为人类读者和 AI 代理编写各自的内容。
  - **隐藏页面提示：** 编辑器中新增横幅，提示从导航中隐藏的页面，便于识别和管理。

<div id="sites-and-dashboard">
  ## 站点与 dashboard
</div>

  - **更快的部署队列：** 预览部署现在可以同时运行更多构建任务，从而缩短队列等待时间。
  - **重新发送成员邀请：** 直接从 dashboard 向新的组织成员重新发送待处理的邀请。
  - **更清晰的注册反馈：** 注册流程现在会显示子域名是否可用，并在首选项已被占用时建议可用的子域名。
  - **已跳过部署的状态：** dashboard 现在会明确显示部署更新已被跳过，而不再让状态含糊不清。
  - **尾部斜杠 SEO 配置：** [`docs.json`](/zh/organize/settings-seo) 中新增的 `seo.trailingSlash` 选项可在整个站点强制统一带/不带尾部斜杠的 URL。

<div id="automations-and-slack-agent">
  ## 自动化与 Slack 代理
</div>

  - **代理配置移至 Automations：** 代理设置现位于 [Automations](/zh/automations) 页面。
  - **在 Slack 会话中继续自动化 PR：** Slack 代理可以直接从工作流通知会话中接管一个自动化 PR 的对话。
  - **遵循仓库约定：** 代理 PR 现在会遵循您仓库的 PR 模板和 `AGENTS.md` 文件。
  - **Slack 连接成功弹窗：** 连接 Slack 后，代理设置页面会显示确认弹窗。
  - **推送部署遵循 `.mintignore`：** 推送部署现在会遵循您的 `.mintignore` 文件，与预览和 CI 行为保持一致。

<div id="analytics">
  ## Analytics
</div>

  - **全新的 Analytics dashboard：** 重新设计的分析体验。合并了概览与流量板块，统一了 CSV 导出菜单，同步了日期范围选择器，并新增反馈板块。

<div id="bug-fixes">
  ## Bug 修复
</div>

  - 修复了预览部署上的 OAuth 重定向 URI，使已认证的文档登录可在 `.mintlify.site` 预览主机上正常工作。
  - 修复了 MDX 缓存问题，使后续编辑可以在解析失败后正常恢复。
  - MCP 服务器 "copy primary URL" 按钮现在会显示确认提示。
  - AsyncAPI playground 现在会正确地将基于标头的认证作为 `Sec-WebSocket-Protocol` 子协议发送。
  - Analytics 中的排名页面浏览量会汇总人类和代理流量，并且零结果差值颜色会反映正确的方向。
  - 减少了 Assistant 在响应流式传输过程中的错误。
  - 当响应以工具调用结束时，Assistant 聊天历史现在会保留响应文本。
  - Mermaid 图表操作现在会按预期在悬停时显示。
  - 版本切换器的范围限定为当前下拉菜单中可用的版本。
  - 导航级别的 `public: false` 设置现在会在身份验证元数据中得到正确应用。
  - 较长的聊天历史消息会被截断，而不是水平滚动。
  - 静态资源和 favicon 现在会发送 `X-Robots-Tag: noindex`，以避免出现在搜索结果中。
  - `BreadcrumbList` JSON-LD 不再输出空列表项。

</Update>

<Update label="July 10, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"自定义子路径托管、编辑器评论与建议、搜索筛选等" }}>

<div id="custom-domain-subdomain-and-subpath-hosting">
  ## 自定义域名、子域名和子路径托管
</div>

  - **改进的自定义域名、子域名和子路径托管设置：** 更新了 [Domain setup](https://app.mintlify.com/settings/deployment/custom-domain) 页面的界面和步骤。更多信息请参阅[自定义域名](/zh/customize/custom-domain)和[在子路径托管](/zh/deploy/docs-subpath)。

<div id="editor-comments-suggestions-and-performance">
  ## 编辑器评论、建议与性能
</div>

  - **评论与建议：** 在[编辑器](/zh/editor)中对任意文本发表带话题串的评论，可以回复、解决，并通过 @ 提及队友触发邮件通知。建议模式允许审阅者提出修改建议，由作者接受或拒绝。
  - **更快的编辑器：** 首次加载和导航更新方面的改进让编辑器更快、更流畅。
  - **可折叠标题：** 编辑时可折叠和展开标题下的章节，更轻松地浏览长页面。

<div id="search-filters-and-ranking">
  ## 搜索筛选与排名
</div>

  - **搜索筛选：** 为文档搜索[添加筛选器](/zh/optimize/search)，读者可以按产品、版本或其他类别缩小结果范围。
  - **搜索加权：** 在 frontmatter 中设置的每页 `boost` 值现在会应用到搜索排名，并且搜索不再通过标题匹配提升被降权的页面。

<div id="enterprise-security-and-access-control">
  ## 企业安全与访问控制
</div>

  - **强制 SSO 并保留应急访问：** 为整个组织强制启用 SSO 登录，并指定应急成员，在身份提供商不可用时仍可直接登录。请参阅 [SSO](/zh/dashboard/sso)。
  - **网络访问 IP 白名单：** 使用全新的[网络访问](/zh/dashboard/network-access)设置将 dashboard 访问限制在受信任的 IP 范围内，并可将 IP 白名单应用于外部 API 密钥，实现精细化管控。
  - **Dashboard 会话有效期与吊销：** 配置 dashboard 会话的有效时长，并可从成员页面吊销单个会话，与现有的 [SSO 控制](/zh/dashboard/sso)相辅相成。
  - **合并的 Identity & access 页面：** 在 dashboard 中的同一个 "Identity & access" 页面上管理 SSO、SCIM 和网络访问设置。

<div id="assistant-and-automations">
  ## 助手与自动化
</div>

  - **澄清性问题：** 当用户请求含糊不清时，[助手](/zh/assistant)现在可以提出澄清性问题，并在聊天中以可选选项卡片的形式呈现。
  - **Update from support feedback 自动化：** 全新的 [Update from support feedback 自动化](/zh/automations)会审查来自已连接第三方应用的已解决支持对话，并起草文档更新。
  - **可关闭联系表单：** 如果您不希望助手将对话移交给支持团队，可以在[偏转设置](/zh/assistant/configure)中关闭助手的聊天内联系表单。
  - **Slack 代理改进：** [Slack 代理](/zh/agent/slack)在选择审核流程时会遵循部署分支保护策略，对 Mintlify 托管的部署隐藏审核流程下拉菜单，在上传竞态时会重试文件抓取，并将反馈读取导向代码模式。
  - 重试助手响应现在会重新生成答案而不会追加重复的对话轮次；助手会显示流式错误而不是静默失败；不会在导航后仍显示过时内容；在达到工具调用上限时会基于已收集的上下文作答，而不是返回空消息。
  - 打开或关闭自动化不再出现 "workflow not found" 错误。

<div id="other-improvements">
  ## 其他改进
</div>

  - **文档页面的 Schema.org JSON-LD：** 页面现在会包含自动生成的 schema.org 结构化数据，帮助搜索引擎更好地理解您的内容。
  - **系统主题：** 通过新的 `system` 主题选项，站点现在可以跟随每位读者操作系统的浅色或深色模式偏好。
  - **细粒度 PDF 导出：** 可针对特定页面或语言[导出 PDF](/zh/optimize/pdf-exports)，而不必导出整个站点。
  - **活动日志深链接：** 用量活动日志中的行现在会链接到产生该笔消耗的自动化运行或助手对话。
  - **按比例费用预览：** 计费页面会在您更改额度层级前显示按比例计算的费用预览。
  - **新增本地化代码：** 新增对 `zh-CN`、`zh-TW` 和 `ja-JP` 语言代码的支持。
  - **MCP 自定义 OAuth 重定向 URI：** 在 dashboard 中为您的 [MCP 服务器](/zh/ai/model-context-protocol)注册自己允许的 OAuth 重定向 URI。
  - **API playground：** 将 JSON 请求体粘贴到 [playground](/zh/api-playground/overview) 中即可自动填充请求体字段。
  - **支持弹窗支持视频附件：** 可以在支持请求中附加 `.mp4` 录屏，为团队排查问题提供更多上下文。
  - **从更新日志复制锚点 URL：** 点击更新日志条目上的链接图标，现在会将锚点 URL 复制到剪贴板。
  - **通过 `window.mintlify.geo` 获取访客地理信息：** 客户端脚本现在可以从 `window.mintlify.geo` 读取访客所在的国家和地区，用于个性化展示。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 嵌套的 `llms.txt` 文件不再返回 404。
  - 终端用户认证的退出登录现在会执行整页跳转，以确保状态被可靠清除。
  - MCP 发现在启用认证的部署上会正确报告 OAuth 2.0 认证方式。
  - 计费页面现在会呈现当前部署对应的计划，而不是组织默认计划。
  - PDF 导出链接已规范化，某些部署上的目录不再渲染为空。
  - 修复了 `Card`、`Tabs` 和表格组件中的无障碍问题。
  - 使用 OneTrust cookie 同意管理的站点现在会在访客撤回同意后正确停止分析统计。

</Update>

<Update label="July 2, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"AI 预览编辑器、助手联系表单、automations webhook 触发器、SCIM 等" }}>

<div id="new-releases">
  ## 新版本发布
</div>

  - **AI 预览编辑器：** 从一条提示词启动新的文档站点，并在交互式预览中与 AI 代理一起迭代。代理现在可以提出澄清性问题、在断线重连后恢复流式响应，并可直接从入门流程中启动。
  - **助手联系表单：** [AI 助手](/zh/assistant)现在可以在聊天中呈现联系表单，当某个问题无法从您的文档中得到解答时，将其移交给支持或销售团队。
  - **助手分析中的主题化查询分组：** [助手分析](/zh/assistant)会将相关问题归入不同主题，并按分组显示点赞/点踩情感倾向，让您一眼就能看出助手在哪些地方有所帮助，或者在哪些地方回答得不够到位。
  - **Automations API webhook 触发器：** 除了 cron 计划之外，还可以通过外部 API webhook 按需触发预定的[自动化](/zh/automations)。
  - **Automation 单次运行更新：** [自动化](/zh/automations)运行会显示每次运行使用的额度，并在运行过程中发布单次运行的状态更新。
  - **会话 IP 白名单（Enterprise）：** 作为 [SSO 和会话安全策略](/zh/dashboard/sso)的一部分，将仪表盘会话限制在允许的 IP 范围内。
  - **SCIM 用户预配与解除预配：** 通过 SCIM 预配和解除预配用户，并在用户被停用时自动吊销会话、吊销机器凭证以及生成审计日志事件。
  - **文档和 `llms.txt` 的自定义基础路径：** 在自定义基础路径下提供文档、[`llms.txt` 和 `llms-full.txt`](/zh/ai/llmstxt)，导航和内容内链接会被重写以包含该前缀。
  - **`searchable` frontmatter 字段：** 在[页面](/zh/organize/pages)上设置 `searchable: false`，使其不出现在内部搜索结果中。

<div id="improvements">
  ## 改进
</div>

  - **管理员 MCP 授权 UI：** 重新设计的[管理员 MCP](/zh/ai/model-context-protocol) 授权界面新增了多选部署选择器、按部署范围的权限，以及新的 `list_deployments` 发现工具。授权、认证路径和代码模式 SDK 客户端现在都限定在所选组织和部署范围内。
  - **托管 MCP 管理员连接页面：** 仪表盘的 Settings 下新增了管理员连接页面和托管 MCP 认证设置。
  - **fork 分支上的 `@mintlify` PR 机器人：** 当 `@mintlify` GitHub 应用安装在 fork 上时，机器人现在会直接将评论编辑推送到 fork 分支，并支持针对文档仓库开启的 PR。
  - **编辑器中的发布并发安全：** [编辑器](/zh/editor)会在发布开始时进行广播，让其他客户端立即被阻塞，发布下拉菜单在加载期间也可以关闭。发布失败现在会附带摘要信息。
  - **可恢复的编辑器代理流：** [编辑器代理](/zh/editor)在断线后会重新连接到进行中的流，而不是从头开始重启。
  - **Mintlify 托管仓库的自动化：** Mintlify 托管仓库上的[自动化](/zh/automations)支持自动应用更新，并隐藏不适用的 GitHub 相关链接。
  - **Slack 代理的健壮性：** [Slack 代理](/zh/agent/slack)在消息被中断时可以干净地恢复，不会再让加载动画一直转；切换部署的流程也得到了强化。
  - **分区页面的 `.md` 路由：** 分区落地页和集合索引页现在可以在其 `.md` 路由上解析，方便 AI/LLM 工具使用。
  - **SSO 文案更新：** [SSO](/zh/dashboard/sso) 设置页面的分区更加清晰，并更新了 GitLab 配置说明。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 多仓库部署不再将挂载路径附加到 OpenAPI 端点条目前。
  - `llms.txt` 中的 OpenAPI 规范 URL 不再重复添加自定义基础路径。
  - 编辑器中的三方合并不再重复 `Step`、`iframe` 或静态 HTML 块。
  - SEO 审计不再覆盖页面的 `sidebarTitle`。
  - 在编辑器中编辑文档文件的标题不再将其重置为默认值。
  - 助手分组的出现次数计数现在会遵守所选的日期范围。
  - 从渲染页面中移除了无效的 `charset`、`canonical` 和 `og:*` 元标签。
  - 静态资源响应头会被转为小写，以避免出现重复的 `Content-Type`。
  - 对于使用量为零的产品，用量图表会隐藏图例和柱状条。
  - [自动化页面](/zh/automations)上的自动化运行行现在可点击进入其详情页，并移除了每周运行对比指示器。
  - 编辑器中超过 1 MB 的 `docs.json` 现在会回退到 blob API，以确保大型配置能可靠加载。
  - 编辑器同步过程中，对已连接 git 分支的强制推送现在会被优雅处理。
  - 自托管部署会正确地使用客户端 URL 作为预览基础地址，并且自托管 Lambda 会启动自托管客户端。

</Update>

<Update label="June 26, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Google Drive 代理集成、多源 git 设置、全新入门流程等" }}>

<div id="new-releases">
  ## 新版本发布
</div>

  - **Google Drive 代理集成：** 代理现在可以从 Google Drive 拉取上下文，与 Slack、Notion、Linear、Jira 等[代理集成](/zh/agent/integrations)并列。
  - **多源 git 设置：** 在仪表盘中为一个部署配置和重新排序多个 git 源，并可通过拖放设置源的优先级。请参阅[多仓库设置](/zh/deploy/multi-repo)。
  - **自助开通额外的 Starter 部署：** Starter 计划客户无需联系支持即可启动额外的[部署](/zh/deploy/deployments)。
  - **SCIM 预配 UI：** 可以直接在组织设置中设置和签发用于用户预配的 SCIM 令牌。请参阅 [SSO](/zh/dashboard/sso)。
  - **域名所有权验证：** 在配置[自定义域名](/zh/deploy/deployments)时，可通过 DNS TXT 记录证明验证自定义域名的所有权。
  - **全新入门流程：** 重新设计的入门 composer 视图，让新团队从注册到发布站点的速度更快。
  - **重新设计的身份验证设置：** 仪表盘中新增的方法下拉菜单让配置和切换[身份验证方法](/zh/deploy/authentication-setup)更加便捷。
  - **编辑器中的实时发布状态：** [编辑器](/zh/editor)现在会实时显示发布操作，让您可以准确看到变更何时上线。
  - **助手页面导航：** [AI 助手](/zh/assistant)可以作为回答的一部分，将用户直接导航到相关页面。
  - **markdown 页面的 HTML 备用链接：** 每个页面现在都会暴露一个指向其 [markdown 版本](/zh/ai/llmstxt)的 HTML `<link rel="alternate">`，让 AI 工具和爬虫更容易发现适合 LLM 的内容。
  - **`llms.txt` 和 markdown 中的自定义代理指令：** 自定义代理指令现在会包含在 [`llms.txt`、`llms-full.txt`](/zh/ai/llmstxt) 以及按页面生成的 markdown 中。
  - **Mintlify Slack 应用上架 Slack Marketplace：** [Mintlify Slack 应用](/zh/agent/slack)现已在 Slack Marketplace 中公开列出并可安装。

<div id="improvements">
  ## 改进
</div>

  - **"Workflow" 全面更名为 "automation"：** 仪表盘 UI 和 CLI 命令已统一更新为使用 [automations](/zh/automations)。在过渡期间，旧的 `workflow` CLI 命令仍可作为别名使用。
  - **切换组织位置变更：** **切换组织**操作现在位于个人资料下拉菜单中，而不是部署下拉菜单中。
  - **分析的 Cookie 同意拦截：** 第三方分析脚本（GA4、GTM 等）现在会在访客接受 cookie 之前被阻止加载，帮助您满足[隐私](/zh/integrations/privacy/overview)合规要求。
  - **将文档反馈转发到分析：** 通过 `analyticsForwarding` 设置，页面反馈事件现在可以转发到您已配置的[分析集成](/zh/integrations/analytics/overview)。
  - **前端的 SSO 强制执行：** 仪表盘现在会遵守[仅 SSO 组织](/zh/dashboard/sso)的后端 403 响应，并在登录时将已验证域名的用户路由到 SSO。
  - **自托管升级：** [自托管部署](/zh/advanced-support)现在支持自定义主机名处理和额外的 `<meta>` 标签。
  - **搜索为分区落地页建立索引：** 分区落地页现在会包含在文档搜索结果中，并且对于选择退出公开索引的站点，搜索索引也会继续构建。
  - **助手 CSV 导出分组：** 助手分析 CSV 现在包含 `Conversation ID` 列，并按对话对行进行分组。请参阅 [AI 助手分析](/zh/assistant/configure)。
  - **MCP 服务器标识与指令：** [Mintlify MCP 服务器](/zh/ai/mintlify-mcp)现在会在初始化时通告指令，帮助客户端更有效地使用它。
  - **更新日志自动化运行显示集成工具：** 生成更新日志条目的自动化运行现在会显示所使用的集成工具。
  - **多源 webhook：** 来自次级 git 源的推送 webhook 现在会触发更新，使多源部署保持同步。
  - **PDF 导出可靠性：** 大型 PDF 导出现在会分批进行，并在出现问题时生成更清晰的错误日志。
  - **Automation PR 合并：** 当[自动化](/zh/automations)运行提出新变更时，现在会先检查这些变更是否应追加到现有的已开放文档 PR 中，而不是创建新的 PR，从而减少重复 PR 和审查负担。适用于维护类和从代码变更更新类自动化。
  - **Automation 在 GitHub 中的 PR 审查体验：** 由[自动化](/zh/automations)创建的文档 PR 现在每次更新时都会发布一条评论，说明变更内容以及使用了哪些代码 PR 作为上下文。PR 标题标识了创建它的是哪个自动化，审查者会根据修改了相关代码的人员自动分配，后续运行会原地更新 PR 摘要。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 子路径部署现在可以正确解析 `.well-known` 链接。
  - 从编辑器发布在三路合并期间不再重复几乎相同的块。
  - 修复了已发布页面中的图标序列化问题。
  - 当 S3 对请求进行速率限制时，图片上传现在会重试。
  - MCP 响应现在会正确转发上游状态码，并为 MCP 客户端正确重建嵌套的 JSX。
  - 导航时活动的侧边栏项会滚动到可见区域。
  - 编辑器侧边栏不再渲染顶部渐变淡出，草稿行也不再显示陈旧的橙色状态点。
  - 标题中的加粗文本会以正确的字重渲染（限于正文内容）。
  - 产品选择器下拉菜单的列加宽，以便容纳较长的名称。
  - 在组织选择页面阻止了水平滚动溢出。
  - 在初始文档生成仍在运行时，域名链接会被禁用。
  - 从仪表盘中移除了 Auth 配置徽章。

</Update>

<Update label="June 19, 2026" tags={["New releases","Improvements","Bug fixes"]} rss={{ title:"Automations 更名、SSO 强制启用、自托管升级等" }}>

<div id="new-releases">
  ## 新版本发布
</div>

  - **Workflows 现已更名为 Automations：** 此前被称为 workflows 的功能在仪表盘和产品中现已统一更名为 [Automations](/automations)，为计划运行和触发运行采用统一名称。
  - **仪表盘中的 Atlas：** Atlas 生成现在会出现在活动日志、仪表盘横幅和编辑器中，并支持上传参考文件以及从指定分支生成。
  - **SSO 强制启用与紧急访问：** 组织所有者可以为成员强制启用[仅 SSO 登录](/zh/dashboard/sso)、配置已验证的域名，并在仪表盘中管理用于紧急访问的 breakglass 邮箱。
  - **已认证站点的完整 PDF 导出：** [已认证站点](/zh/deploy/authentication-setup)现在可以生成完整的 PDF 导出，并会解析认证 cookie，以便图片和资源正确加载。
  - **自托管改进：** 自托管部署现在可以提供公共文档域名、在静态导出期间将 `sitemap.xml` 写入 S3，并为静态导出使用边缘注入插槽。Webhook 现在也可以在自托管模式下工作。

<div id="improvements">
  ## 改进
</div>

  - **编辑器视图变化：** 可以从运行审查界面或 Slack 深度链接直接在[编辑器](/zh/editor)中打开自动化运行的变更页面。变更页面会被高亮显示，未列出的页面可以从分支差异中打开。
  - **草稿发布下拉菜单：** 编辑器的草稿发布下拉菜单现在会显示变更标签，并仅在草稿和主分支上出现。
  - **输入性能：** 修复了编辑器中长页面上的输入卡顿。
  - **Mintlify 机器人可靠性：** `@mintlify` GitHub 机器人在多评论迭代中更可靠，并会发布一个直接的"view changes"链接。
  - **预览部署：** 预览部署现在会在推送时重新构建，并通过新的 webhook 事件创建，从而加快预览速度。
  - **移动端菜单重新设计：** 文档顶栏的移动端菜单采用了焕新设计。
  - **产品下拉菜单：** 产品下拉菜单现在支持嵌套菜单和分组。
  - **Luma 宽屏模式：** `mode: "wide"` 现在会影响 Luma 主题中的内容定位。
  - **CLI 热重载：** CLI 中 `docs.json` 的热重载更快。已弃用的 `analytics` 命令已被移除。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 修复了在没有 workspace team 的 Slack Enterprise Grid 安装上仪表盘崩溃的问题。
  - 标题中的加粗文本现在会以正确的字重渲染。
  - 搜索模态框的主色调现在与配置的主题匹配。
  - "Contact sales" 按钮现在链接到 `/contact/sales`，而不是打开邮件客户端。
  - 已认证的 MCP 请求会将上游 429 响应传递给客户端，并提高了已认证 MCP 配置的速率限制。
  - 仪表盘中失败的 React 组件现在会渲染错误边界，而不是导致整个页面崩溃。
  - 在无用的命令行代码块中移除了复制按钮。
  - git 同步过程中重复的合并变更现在会被去重。
  - 当认证被禁用时，MCP OAuth 路由会被隐藏。
  - 更新了助手验证码的提示文案以提高清晰度。
</Update>

<Update label="June 12, 2026" tags={["New releases", "Improvements", "Bug fixes"]} rss={{ title: "编辑器草稿、重新设计的代理入门流程、Automations 正式发布等" }}>

<div id="editor-drafts">
  ## 编辑器草稿
</div>

  - **草稿与发布流程：** 在草稿中进行修改、申请审查并发布——全部在[网页编辑器](/zh/editor)中完成。草稿在您工作时自动提交，重命名或更新草稿会同步更新底层的 pull request。
  - **创建非 `.mdx` 文件：** 直接从编辑器文件树添加 JSON、YAML 等支持的文件类型。
  - **拖放上传媒体：** 将图片和其他媒体拖入文件树即可就地上传。

<div id="agent-onboarding">
  ## 代理入门
</div>

  - **重新设计的 3 步流程：** 新用户将体验到引导式的 3 步代理入门流程，包含欢迎屏、集成设置和最终审查步骤。
  - **在入门过程中连接集成：** 作为设置的一部分，添加第三方[代理集成](/agent/integrations)——包括 Confluence、Notion 和 Plain。
  - **快速回到设置：** 如果您中途离开，横幅会带您返回到正确的入门步骤。
  - **新的仪表盘检查清单：** 仪表盘上重新设计的检查清单会在入门完成后跟踪设置进度。

<div id="automations-ga">
  ## Automations 正式发布
</div>

  - **移除 Beta 标签：** [Automations](/zh/automations) 已退出 beta 阶段。
  - **陈旧运行清理器：** 长时间排队或停滞的自动化运行现在会在 25 小时后可靠超时。

<div id="sign-in-redesign">
  ## 登录页面重新设计
</div>

  - **默认使用邮箱和密码：** 登录屏幕现在默认使用邮箱和密码登录，并提供切换到魔法链接的选项。
  - **Starter 计划支持 Mintlify 身份验证：** [Mintlify 托管的身份验证](/zh/deploy/authentication-setup)现已在 Starter 计划中可用。

<div id="editor">
  ## 编辑器
</div>

  - **顶栏重新设计：** 更简洁的编辑器顶栏，控件已重新组织。
  - **更快的初始加载：** 编辑器首个文件和导航的加载速度显著提升，并对可见的导航树页面进行预取。
  - **新的链接交互：** 在所见即所得视图中重新设计的内联链接编辑器。
  - **折叠与粘性标题：** 长页面支持可折叠的标题，粘性标题可点击以跳回页面顶部。
  - **代理面板显示原因：** 编辑器的代理面板现在会显示其每个操作背后的原因。
  - **PR 审查轮询：** 编辑器会轮询 PR 审查状态，审查者的反馈无需刷新即可显示。

<div id="open-in-devin-desktop">
  ## 在 Devin Desktop 中打开
</div>

  - **重命名的上下文菜单操作：**[上下文菜单](/zh/ai/contextual-menu)中的"Open in Windsurf"现已更名为"Open in Devin Desktop"，并使用 `devin://` 深度链接。

<div id="search-and-ai">
  ## 搜索与 AI
</div>

  - **搜索结果支持 Markdown：** 通过 MCP、助手和代理进行的搜索现在会返回 markdown，为 AI 客户端提供更好的页面上下文。
  - **项目级 noindex：** 站点所有者可以从[文档界面](/zh/optimize/seo)将整个项目对搜索引擎隐藏。
  - **未版本化搜索：** 当设置了 `searchSettings.unversioned` 时，没有版本的页面也会包含在搜索结果中，面包屑会显示其版本上下文。
  - **Claude Code 识别：** 分析现在能识别 Claude Code 用户代理，并将 AI 代理的 HTML 页面浏览与 markdown 视图一起统计。

<div id="analytics">
  ## 分析
</div>

  - **CSV 导出：** 将仪表盘分析导出为 CSV，用于离线报表。
  - **代理反馈筛选：** 按用户反馈筛选代理分析数据。

<div id="billing">
  ## 账单
</div>

  - **更高的自助积分档位：** 自助积分档位现在最高可达 52,500。详情见[积分](/credits)。
  - **首次积分折扣：** 新客户在付费墙入口点会看到首次购买折扣。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 在编辑器中将文件在 `.mdx` 与其他扩展名之间重命名现在可以正常工作。
  - 在文件树重命名输入框中可点击重新定位光标。
  - 修复了在某些导航操作时编辑器出现白屏的问题。
  - 向 `docs.json` 添加文件不再需要重置。
  - 编辑器中的图片重命名现在可以正常工作。
  - 加载时会在导航树中显示当前页面节点。
  - 搜索结果锚定到页面顶部或标题匹配的章节，而不是任意子章节。
  - 错误的 frontmatter 不再导致页面构建崩溃。
  - Confluence 连接现在通过 Nango Connect 界面路由。
  - 自动化主页横幅在自定义自动化删除失败时会显示 toast 提示，并在运行失败时优先使用 `errorMessage` 而非摘要。
  - "x 之前运行"标签在轮询期间会持续更新。
  - 修复了积分滚存时使用概览中的重复计数问题。
  - 产品中各处的实时徽章现在使用一致的对勾图标。
  - Favicon 代理正确处理编码头。
  - 重复的导航分组名称不再发生渲染冲突。
  - 修复了 PDF 路由的身份验证元数据查找问题。
  - `@mintlify` 评论机器人现在仅在真正的提及时触发，不会因作用域包名而误触发。
</Update>

<Update label="June 5, 2026" tags={["New releases", "Improvements", "Bug fixes"]} rss={{ title: "陈旧审查提醒、搜索升级、Slack 代理改进等" }}>

<div id="automations">
  ## Automations
</div>

  - **陈旧审查提醒：** 打开 pull request 的 [automations](https://www.mintlify.com/docs/automations/reference) 现在会在审查停滞时发送 Slack 提醒，避免文档 PR 被遗忘。
  - **入门流程优化：** 自动化入门流程已端到端简化和重新设计，文案更清晰，集成图标更明显，连接体验更顺畅。

<div id="slack-agent">
  ## Slack 代理
</div>

  - **Enterprise Grid 支持：** [Slack 代理](/zh/agent/slack)现在可在 Slack Enterprise Grid 和组织范围的工作区上安装。
  - **原生计划卡片：** 代理在工作时现在会以更丰富的 Block Kit 计划卡片进行流式显示，方便您在 Slack 中跟进其工作进展。
  - **管理账单按钮：** 积分耗尽的回复现在包含一键式的**管理账单**按钮。

<div id="search">
  ## 搜索
</div>

  - **更优的排序：** 站内搜索现支持前缀匹配、标题匹配优先和 Unicode 分词，让部分关键词查询和标识符搜索更快定位到正确的页面。
  - **词前缀高亮：** 匹配的词前缀会在搜索结果中高亮显示。

<div id="dashboard">
  ## 仪表盘
</div>

  - **集成描述和标签：** 集成设置页面现在为每个集成显示描述和标签，并指明共享集成的启用者。
  - **实例级 SSO：** 自托管部署现在可以从仪表盘配置实例级 SSO (OIDC) 登录选项。

<div id="cli">
  ## CLI
</div>

  - **品牌欢迎屏：** 运行 [`mint`](/zh/cli/commands) 或 `mint --help` 现在会显示品牌欢迎屏。

<div id="bug-fixes">
  ## 错误修复
</div>

  - [网页编辑器](/zh/editor)的初始文件和导航加载速度显著提升。
  - 在编辑器中切换部署现在工作稳定。
  - 代理历史视图滚动正常。
  - 仪表盘链接现在指向正确的编辑器路径。
  - 自动化集成选择器的搜索过滤器现在按预期过滤结果。
  - 创建新文件后，编辑器文件树会按字母顺序排列。
  - 当您在同一页面导航到锚点时，折叠面板会自动展开。
  - 编辑器代理在您发送消息之前显示超额和积分状态。
  - Slack 积分耗尽通知可靠送达。
  - 当工作区已属于其他组织时，Slack 代理安装会被拒绝，避免跨组织冲突。
  - 仪表盘中的未来日期选择使用正确的样式。
</Update>

<Update label="May 22, 2026" tags={["New releases", "Improvements"]} rss={{ title: "网页编辑器增强、新自动化、搜索改进等更多更新" }}>

<div id="web-editor">
  ## 网页编辑器
</div>

  我们持续增强网页编辑器，带来多项功能与界面改进。

  - **更多可编辑文件类型：** 现在可以在网页编辑器中直接打开并编辑更多文件扩展名，同时出于安全考虑会阻止上传可执行文件。
  - **Agent 聊天面板重新布局：** Agent 聊天面板经过重新打磨，现位于文件资源管理器左侧，便于同时聊天与导航。
  - **编辑器设置：** 新的设置面板与重新设计的设置弹窗，让你可以在同一处管理编辑器偏好。详见 [网页编辑器](/zh/editor)。
  - **默认使用文件树导航：** 新入驻用户默认进入文件树视图，而非旧版列表视图。
  - **浏览器标签页标题：** 浏览器标签页名称现在会动态更新为当前文件，便于识别正在编辑的文件。

<div id="automations">
  ## 自动化
</div>

  - 新增 **Improve content from assistant conversations** 自动化，可分析用户提问趋势并建议文档更新以填补缺口。详见 [Automations](https://www.mintlify.com/docs/automations/reference#draft-improvements-from-assistant-conversations)。
  - 部分自动化现在可以直接配置 **Context repositories**，以便添加自动化运行时应引用的仓库。
  - 自动化设置现在在 **侧边面板** 中打开，而非弹窗，便于在查看 Automation Runs 时调整设置。

<div id="search-improvements">
  ## 搜索改进
</div>

  - **Maximum search results** 让你控制产品内搜索栏每次查询返回的结果数量。可与搜索加权一起调整，以适配读者的文档浏览方式。详见 [Search](https://www.mintlify.com/docs/optimize/search#maximum-search-results)。
  - **可搜索的隐藏标签页与分组：** 隐藏标签页与分组现支持 `searchable: true` 选项，将其子页面暴露给产品内搜索、站点地图与 AI 上下文。当你依赖隐藏标签页组织导航（例如按产品隔离侧边栏）但仍希望这些页面被索引时，可使用此选项。详见 [Hidden pages](/zh/organize/hidden-pages#include-pages-under-specific-hidden-tabs-or-groups)。

<div id="improvements">
  ## 改进
</div>

  - **Slack Agent**：[Slack agent](/zh/agent/slack) 现支持 **GitLab** 与 GitHub，用于基于仓库的工作流。
  - **侧边栏导航：** 页面切换时现在会保留侧边栏导航状态与滚动位置。
  - **无障碍：** 文档的多项无障碍改进，包括目录与移动端 agent 面板。
  - **AsyncAPI 架构：** 数组与组合（`oneOf` / `anyOf` / `allOf`）架构现在会在 API 参考中展开显示其子属性。
  - **API playground**：`any` 与 `undefined` 类型现在按 `oneOf` 架构处理，便于用户在发送请求时选择具体结构。

</Update>

<Update label="May 15, 2026" tags={["New releases", "Improvements"]} rss={{ title: "编辑器 AI 指令与发布控制" }}>

<div id="editor-settings-for-ai-and-publishing">
  ## 用于 AI 与发布的编辑器设置
</div>

  Web 编辑器现在提供独立的 **Settings** 菜单，包含两层配置：

  - **个人设置**绑定到你的账号，决定编辑器的 AI 在你编辑时如何提供协助。
  - **发布设置**由管理员按部署进行配置，决定提交和 pull request 的生成与合并方式。

  详见 [用于 AI 与发布的编辑器设置](/zh/editor/settings)。

<div id="new-features">
  ## 新功能
</div>

  - **AI 指令**：添加持续生效的指令，编辑器会在每次 **Edit with AI** 操作和 agent 会话中将其发送给 AI。可用于固定语气、术语、组件偏好或格式规则，避免在每个 prompt 中重复说明。
  - **提交信息指令**：在发布时引导 AI 生成提交信息——适合匹配 Conventional Commits、工单前缀或更严格的标题长度规范。
  - **Pull request 指令**：标准化编辑器在打开 pull request（包括 **Create pull request** 与 **Merge and publish** 流程）时由 AI 生成的标题和描述。

<div id="improvements">
  ## 改进
</div>

  - **默认以草稿形式创建 pull request**：管理员可以将编辑器配置为以草稿方式打开每个新建的 pull request，让审阅者在你将其标记为可审阅前看到清晰的"尚未就绪"信号。
  - **默认合并方式**：为 **Merge and publish** 选择默认使用 **Merge**、**Squash** 或 **Rebase**。请与你的 Git 提供商分支保护规则保持一致，避免从编辑器合并失败。

</Update>

<Update label="May 8, 2026" tags={["New releases", "Improvements"]} rss={{ title: "扩大 MCP 内容访问、助手积分套餐、AsyncAPI 嵌套分组等更多更新" }}>

<div id="expanded-mcp-content-access">
  ## 扩大 MCP 内容访问范围
</div>

  经过身份验证的 [MCP 服务器](/zh/ai/model-context-protocol)现在会向已授权用户返回更多内容。已登录用户可以搜索公开页面以及根据其用户组有权访问的任何页面，而不再仅限于公开页面。[客户端凭据](/zh/ai/model-context-protocol#client-credentials)可返回所有公开页面以及未限制为特定用户组的已认证页面。

  Mintlify MCP 的 `list_nodes` 工具现在支持按 `parentId` 筛选（可选 `recursive` 遍历）、多种节点类型，以及 `dropdown`、`anchor`、`product`、`item` 等更多划分范围。结果通过不透明游标分页。详见 [Mintlify MCP](https://www.mintlify.com/docs/ai/mintlify-mcp) 文档。

<div id="assistant-credit-packages">
  ## 助手积分套餐
</div>

  [助手](/zh/assistant)的计费体验已更新为所有套餐统一使用积分型套餐，仪表板与用量控制中的术语也已统一。现有积分余额与用量不受影响。

<div id="asyncapi-nested-groups">
  ## AsyncAPI 嵌套分组
</div>

  `asyncapi` 现支持[嵌套分组](/zh/api-playground/asyncapi-setup#examples-with-nested-groups)，因此你可以在更广泛的 API 分组的小节内生成频道页面，或在同一父级下合并多个 AsyncAPI 规范。

<div id="improvements">
  ## 改进
</div>

  - [Slack agent](/zh/agent/slack) 在执行发送邮件或创建工单等第三方操作前会请求权限。
  - [编辑器](/zh/editor) 现在支持将图片和视频从导航树直接拖到页面上，以行内嵌入已有媒体。
  - 编辑器中的 Mermaid 图表支持全屏模式，便于编辑复杂图表。
  - 自定义域名仪表板现在会同时显示两条验证用 `TXT` 记录（`_acme-challenge` 和 `_cf-custom-hostname`）及其实时验证状态，方便你在将 `CNAME` 指向 Mintlify 之前确认 DNS 配置正确。详见[自定义域名](/zh/customize/custom-domain)。
  - [自定义域名](/zh/customize/custom-domain#automatic-tls-provisioning)的 TLS 证书开通现由 Mintlify 直接处理。
  - 已连接 GitLab 的部署现在可以在 [Git 设置](https://app.mintlify.com/settings/deployment/git-settings)页面点击 **Active** 徽标重新验证 Git 源，在分支选项或配置显得陈旧时很有用。
  - [反馈仪表板](/zh/optimize/feedback)的详细反馈视图现在仅包含有文字评论的提交，更易浏览定性反馈。

</Update>

<Update label="May 1, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Agent 连接" }}>

<div id="agent-connections">
  ## Agent 连接
</div>

  在 [Slack](/zh/agent/slack) 中让 agent 设置它需要作为上下文使用的任何第三方集成。提示 agent 连接到你使用的服务，例如 GitHub、Jira、Notion、Google Drive、Confluence 或任何其他服务。

  Agent 使用 [Composio](https://docs.composio.dev/toolkits) 来支持广泛的第三方服务目录，包括问题跟踪器、知识库、CRM 和开发者工具。请参阅 [Composio toolkits 目录](https://docs.composio.dev/toolkits)以获取支持的服务的完整列表。

</Update>

<Update label="April 24, 2026" tags={["New releases", "Improvements"]} rss={{ title: "预览部署 API、Git 接入重新设计、网页编辑器改进等更多功能" }}>

<div id="preview-deployment-api">
  ## 预览部署 API
</div>

  用于生成预览部署的公共 API 现已推出。使用它从你自己的工具中触发预览，当你的 Git 工作流无法完全对应到标准的基于分支的预览触发时尤为有用。详见[触发预览部署](/zh/api/preview/trigger)。

<div id="git-onboarding-and-settings-redesign">
  ## Git 接入与设置重新设计
</div>

  Git 设置页面已进行重新设计，采用了新的布局。由 Mintlify 托管并迁移到自有 GitHub 或 GitLab 仓库的客户，现在可以获得一个贯穿整个迁移过程的分步流程。

<div id="web-editor-improvements">
  ## 网页编辑器改进
</div>

  网页编辑器现在可以显示当前分支的完整 Git diff，包括已经推送的更改。在发布或创建 pull request 之前，可以在一个位置查看所有修改内容。

  更改现在会在本地保留，因此离线时所做的编辑会被保留，并在连接恢复后自动同步。

  - **Emoji 选择器**：输入 <kbd>:</kbd> 即可打开 emoji 选择器并在行内插入 emoji。
  - **折叠面板重新排序**：通过拖放来重新排列[折叠面板组](/zh/components/accordions)中的折叠面板，无需编辑 MDX。
  - **可编辑的 color 组件**：直接在编辑器中更新 [color](/zh/components/color) 色块，无需编辑 MDX。
  - **SVG 文件上传**：在编辑器的配置视图中上传 SVG 文件。

<div id="redirect-destination-checks">
  ## 重定向目标检查
</div>

  [mint broken-links](/zh/cli/commands#mint-broken-links) 命令现在支持一个用于校验重定向目标的选项。在指向缺失页面的重定向进入生产环境之前将其捕获。

<div id="improvements">
  ## 改进
</div>

  - 页面暴露了一个 `data-current-path` HTML 属性，便于自定义脚本和分析定位。
  - 隐藏页面现在会遵循 `seo.indexing: all` 设置，因此你仍然可以索引被排除在导航之外的特定页面。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 修复了 Git 源隐私验证，使得保存 Git 设置后能正确识别私有仓库。
  - 修复了将单个 `$` 视为内联数学公式的解析问题。除非用数学定界符包裹，否则美元符号现在会作为纯文本渲染。
  - 修复了基于 OpenAPI 规范生成的 API 参考页面上 broken-links 的误报。
  - 修复了路径包含尾部斜杠时 OpenAPI 端点解析的问题。
  - 修复了通过 `npx` 运行时 `mint` CLI 版本解析不正确的问题。
  - 修复了在编辑器中对某个分支保存更改后，创建 PR 按钮未重新启用的问题。
  - 修复了存储在内容目录之外的 skill 文件的符号链接处理问题。
  - 修复了 Luma 集成的目录位置问题。
  - 修复了部署 URL 未包含页面 href 以生成直接链接的问题。

</Update>

<Update label="April 17, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Visibility 组件、MCP 文件系统访问、agent 反馈、Git 设置向导等更多功能" }}>

<div id="visibility-component">
  ## Visibility 组件
</div>

  新的 [`Visibility`](/zh/components/visibility) 组件允许你在同一页面上为人类读者和 AI agent 显示不同的内容。将内容包裹在 `<Visibility for="humans">` 中以仅在页面的网页版本上显示，或使用 `<Visibility for="agents">` 以仅将其包含在 AI 工具使用的 [Markdown 输出](/zh/ai/markdown-export)中。适用于为每种受众定制说明、示例或格式，而无需维护单独的页面。

<div id="agent-feedback">
  ## Agent 反馈
</div>

  在部署设置中启用 [agent 反馈](/zh/optimize/feedback#agent-feedback)，允许 agent 提交关于你文档的结构化反馈。启用后，页面的 Markdown 版本会包含反馈说明，以便 agent 知道如何报告他们在访问你的文档时遇到的任何问题。该功能作为 beta 功能在仪表板的部署附加组件中提供。

<div id="mcp-filesystem-access">
  ## MCP 文件系统访问
</div>

  [MCP 服务器](/zh/ai/model-context-protocol)现在包含一个查询文档文件系统工具，允许 agent 直接浏览和读取你文档的文件结构。Agent 可以导航目录、读取完整的页面内容，以及在单次调用中批量读取多个页面。此工具替代了 `get_page` 工具。

<div id="git-setup-wizard">
  ## Git 设置向导
</div>

  Git 设置页面上的新分步向导将指导你首次连接 GitHub 或 GitLab 仓库。可选择一键克隆或手动选择仓库，支持组织选择、分支配置和子目录设置。

<div id="gitlab-oauth-for-automations">
  ## 自动化的 GitLab OAuth
</div>

  [自动化](/zh/automations)现在通过 OAuth 身份验证支持 GitLab 仓库。从仪表板连接你的 GitLab 账户，以便在自动化中使用 GitLab 仓库作为文档源、触发仓库或上下文仓库。Agent 在 GitLab 上创建 merge request，就像在 GitHub 上创建 pull request 一样。

<div id="improvements">
  ## 改进
</div>

  - 在编辑器中粘贴有效的 MDX 组件现在会保留组件结构，而不是转换为纯文本。
  - 侧边栏中较长的导航标题现在会自动添加连字符以防止溢出。
  - 编辑器现在可以解析拆分配置文件中的 [`$ref` 引用](/zh/organize/settings#split-configuration-with-%24ref)。
  - [Slack agent](/zh/agent/slack) 的系统提示已改进，以提供更准确和有用的回复。
  - `llms.txt` 现在包含引用块摘要，以提供更好的页面描述。
  - 仓库中的自定义 `skill.md` 文件现在在部署期间可被正确检测到。

<div id="deprecations">
  ## 弃用
</div>

  - 基于文件的自动化已弃用。请改为从仪表板创建自动化。现有的基于文件的自动化将继续运行，但新自动化必须在仪表板中创建。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 修复了 `index.mdx` 文件中相对链接无法正确解析的问题。
  - 修复了助手回复中代码块的复制按钮。
  - 修复了页面内容更改后目录不更新的问题。
  - 修复了代码块标题无法正确显示的问题。
  - 修复了深色模式下的默认边框颜色。
  - 修复了 CLI 的 `mint analytics feedback` 命令发送错误反馈类型值的问题。
  - 修复了数字步进按钮上的阴影伪影。
  - 修复了相关链接的客户端导航问题。

</Update>

<Update label="April 10, 2026" tags={["New releases", "Improvements"]} rss={{ title: "CLI 分析、目录列表、多技能支持、Slack 机器人改进等更多功能" }}>

<div id="cli-analytics">
  ## CLI 分析
</div>

  `mint analytics` 命令可让你从终端查看流量、搜索查询、用户反馈和助手对话，以便更好地与 agent 集成。

  使用子命令探索特定数据：

  - `mint analytics stats` — 查看指定日期范围内的浏览量、访客数、搜索量、反馈和助手使用情况
  - `mint analytics search` — 搜索查询及其命中次数和点击率
  - `mint analytics feedback` — 用户提交的页面和代码片段反馈
  - `mint analytics conversation list` — 最近的助手对话

  所有子命令支持 `--from`、`--to` 和 `--format` 标志。输出格式包括 `plain`（默认）、`table`、`json` 和 `graph`。

<div id="directory-listings">
  ## 目录列表
</div>

  具有[根页面](/zh/organize/navigation#root-page)的导航组现在可以显示其子页面的[目录列表](/zh/organize/navigation#directory-listings)。将组、标签页或顶级 `navigation` 对象的 `directory` 属性设置为 `"accordion"` 或 `"card"`，即可自动生成该部分内容的概览。适用于帮助中心和其他用户需要快速浏览某个部分所有可用页面的站点。

<div id="multi-skill-support">
  ## 多技能支持
</div>

  从 `.mintlify/skills/` 目录提供多个[技能文件](/zh/ai/skillmd)。每个包含 `SKILL.md` 文件的子目录会被自动发现和提供服务，以便你按功能或领域组织技能。

<div id="slack-agent-improvements">
  ## Slack agent 改进
</div>

  - **多部署支持**：拥有多个文档站点的组织现在可以在所有站点上使用 [Slack agent](/zh/agent/slack)。Agent 会在首次使用时提示你选择一个部署，且你的偏好会按 Slack 账户保存。
  - **只读模式**：Slack agent 现在会对消息进行分类，对仅需信息检索的问题以只读模式响应，将写入权限保留给需要修改文档的请求。

<div id="client-credentials-for-authenticated-mcp">
  ## 经过身份验证的 MCP 的客户端凭据
</div>

  [客户端凭据](/zh/ai/model-context-protocol#client-credentials)现已可用于经过身份验证的 MCP 服务器。使用客户端凭据以编程方式连接，无需基于浏览器的登录——非常适合服务端集成、CI/CD 流水线和自动化工作流。从仪表板的 MCP 服务器页面创建和管理凭据。

<div id="improvements">
  ## 改进
</div>

  - [`mint new`](/zh/cli/commands#mint-new) 命令现在支持使用 `--template` 标志从预定义模板创建项目。
  - CLI 现在会自动刷新过期的访问令牌，因此你不再需要在会话过期后重新运行 `mint login`。
  - [助手](/zh/assistant/index)现已在 `mint dev` 本地预览中可用。
  - CLI 用户体验改进：登录 URL 显示为灰色以提高清晰度、标准化日志格式，以及 `mint status` 现在显示 CLI 版本。
  - 支持 OpenAPI `x-group` 扩展，用于将 API 端点组织到自定义分组中。
  - MDX 内容现在支持水平分割线（`<hr />`）。
  - [自动化](/zh/automations)现在会在仪表板收件箱中显示，便于跟踪。自动化列表还会显示 PR 名称以便快速识别。
  - `mint export` 命令现在包含从 OpenAPI 规范生成的 API 参考页面。
  - 编辑器中的斜杠命令菜单已重新设计，改进了组织和可发现性。
  - 改进了编辑器发布流程和页面创建界面的 UI。
  - 改进了助手的滥用防护。
  - 新增芬兰语作为支持的本地化语言。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 修复了自定义标题 ID 在 MDX 解析之前未被处理的问题，该问题可能导致某些页面上的锚点失效。
  - 修复了 SEO 和元数据审计自动化模板错误修改 API 端点页面的问题。
  - 修复了仪表板中已弃用标签文本换行的问题。
  - 修复了编辑器中内联格式（粗体、斜体、代码）在某些上下文中无法正确应用的问题。
  - 修复了目录文件夹图标颜色与配置主题不匹配的问题。
  - 修复了仪表板中 badge 插图渲染的问题。
  - 修复了切换分支可能导致编辑器处于不一致状态的问题。
  - 修复了某些 OpenAPI schema 类型的 API 响应示例生成失败的问题。
  - 修复了标记为隐藏的页面仍然出现在站点地图中的问题。

</Update>

<Update label="April 3, 2026" tags={["New releases", "Improvements"]} rss={{ title: "get_page MCP 工具、密码保护预览、SAML 组角色映射等更多功能" }}>

<div id="get_page-mcp-tool">
  ## get_page MCP 工具
</div>

  Mintlify 生成的 [MCP 服务器](/zh/ai/model-context-protocol)现在包含一个 `get_page` 工具，允许 AI agent 通过路径获取完整的页面内容。Agent 可以检索完整的文档页面，以获得超越搜索结果的更深层次上下文。

<div id="password-protected-preview-links">
  ## 密码保护预览链接
</div>

  [预览部署](/zh/deploy/preview-deployments)现在支持密码保护。分享预览链接而无需公开暴露内容。

<div id="saml-group-role-mappings">
  ## SAML 组角色映射
</div>

  使用 [SAML SSO](/zh/dashboard/sso) 的组织现在可以将 SAML 组映射到仪表板角色，以便在团队成员登录时自动分配角色。

<div id="improvements">
  ## 改进
</div>

  - 重新设计了编辑器配置设置页面，改进了布局并支持自动保存。
  - 从 OpenAPI 规范自动生成的页面现在以只读条目的形式显示在 Web 编辑器中。
  - [实时预览](/zh/editor/live-preview)中的视频支持。嵌入的 mp4、webm 和 mov 文件现在在本地开发期间可以正确渲染。
  - [自动化](/zh/automations)现在可以从仪表板禁用和重新启用。
  - 助手分析现在在仪表板中显示按来源（Web 与 API）分类的使用情况。
  - 经过身份验证的 MCP 搜索现在可以根据用户的身份验证组正确过滤结果。
  - Slack agent 响应现在显示工具调用摘要，而不是原始工具调用，以更清晰地展示 agent 正在执行的操作。
  - 前置数据中的 `title` 和 `sidebarTitle` 现在优先于侧边栏中的推断元数据。
  - 页面描述中的 MDX 内容现在在经过身份验证的部署上可以正确渲染。

<div id="bug-fixes">
  ## 错误修复
</div>

  - 修复了某些端点的 API playground 请求体构建问题。
  - 修复了编辑器中亮色和暗色模式图像解析的问题。
  - 修复了文本选择工具提示导致的布局偏移。
  - 修复了编辑器中 badge 和图标视觉差异检测的问题。
  - 修复了通过文件路径引用的页面的 OpenAPI 标题和描述无法解析的问题。
  - 修复了[自动化](/zh/automations)自动合并开关在设置为关闭时无法正确禁用的问题。
  - 修复了 API playground 在生成的请求体中包含带有必需子项的可选对象字段的问题。
  - 修复了反馈分析表选择复选框的键盘激活问题。

</Update>

<Update label="March 27, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Linear 和 Notion 集成、离线导出、内联 AI 编辑等更多功能" }}>

<div id="linear-integration">
  ## Linear 集成
</div>

从 agent 设置页面连接你的 Linear 工作区，授予 agent 访问你的 Linear issue 的权限。Agent 可以在生成文档更新时引用 issue 和评论作为上下文，你也可以直接在 Linear 工作区中将 issue 委托给 agent。

<div id="notion-integration">
  ## Notion 集成
</div>

从 agent 设置页面连接你的 Notion 工作区，授予 [agent](/zh/agent) 对你的 Notion 内容的读取权限。Agent 可以在生成文档更新时引用 Notion 页面作为上下文。

<div id="offline-export">
  ## 离线导出
</div>

使用 [`mint export`](/zh/deploy/export) CLI 命令将你的整个文档站点打包为一个自包含的 zip 压缩包。分享该 zip 文件，你的用户无需互联网连接或 Mintlify 账户即可在浏览器中查看你的文档。

<div id="inline-ai-editing">
  ## 内联 AI 编辑
</div>

使用内联 AI 编辑直接在可视化编辑器中生成、重写和重构内容。选择文本并从预设操作中选择，或输入自定义指令。更改以高亮 diff 的形式流式显示，方便你在应用前进行审查。

<div id="composable-docsjson">
  ## 可组合的 `docs.json`
</div>

使用 [`$ref` 引用](/zh/organize/settings#split-configuration-with-%24ref)将大型配置拆分为更小的文件。每个 `$ref` 指向一个单独的 JSON 文件，在构建时解析。

<div id="data-active-css-selectors">
  ## `data-active` CSS 选择器
</div>

侧边栏项目、目录条目和导航下拉菜单现在暴露了一个稳定的 [`data-active` 属性](/zh/customize/custom-scripts#css-selectors)，用于自定义 CSS 定位。使用 `.toc-item[data-active]` 或 `#sidebar-content li[data-active]` 等选择器来设置活动状态的样式，无需依赖内部类名。

<div id="agent-skills-discovery-endpoint">
  ## Agent-skills 发现端点
</div>

文档站点现在提供 `/.well-known/agent-skills/` 发现端点，遵循 [agent-skills 0.2.0 规范](https://schemas.agentskills.io/discovery/0.2.0/schema.json)。AI agent 可以通过编程方式发现并获取你的 [skill 文件](/zh/ai/skillmd#discovery)，并进行内容完整性验证。

<div id="api-playground-credentials">
  ## API playground 凭据
</div>

新的 [`api.playground.credentials`](/zh/api-playground/overview) 选项在代理禁用时，随 API playground 请求发送浏览器管理的凭据（如 cookies 和会话令牌）。适用于使用基于 cookie 的身份验证的 API。

<div id="improvements">
  ## 改进
</div>

- 现已支持[自定义标题 ID](/zh/create/text#custom-heading-ids)。搜索结果可深链接到使用自定义 ID 的章节。
- `docs.json` 中的导航条目现已支持锚点链接（`#` 链接）。
- Automation dashboard 重新设计，新增卡片视图、更清晰的运行历史、操作下拉菜单和改进的空状态。
- 编辑器导航现在与服务器同步，支持持久化更改和多用户冲突解决。
- MCP 搜索现在遵循身份验证权限，搜索结果仅包含用户有权访问的页面。
- [Heap analytics](/zh/integrations/analytics/heap) 现在可以正确转发页面浏览和自定义事件。

<div id="bug-fixes">
  ## 错误修复
</div>

- 修复了 Luma 主题主按钮颜色未从 `docs.json` 应用的问题。
- 修复了代码块工具提示使用错误工具提示基元的问题。
- 修复了编辑器中实时预览回退行为的问题。
- 修复了编辑器中静态 HTML 内容中的链接问题。
- 修复了已认证部署上图标路径的问题。
- 修复了已认证部署上导航根页面的问题。
- 修复了文本选择工具提示定位的问题。
- 修复了助手 CSV 导出缺少来源列的问题。
- 修复了嵌套代码块解析的问题。
- 修复了 tabs 内表格的内边距问题。
- 修复了 Frame 组件提示图标垂直对齐的问题。
- 修复了导航项徽章换行的问题。
- 修复了预填示例时 API 密钥被清除的问题。
- 修复了卡片中链接的代码片段无法点击的问题。

</Update>

<Update label="March 20, 2026" tags={["New releases", "Improvements"]} rss={{ title: "已认证的 MCP 路由、上下文菜单扩展、自托管 GitLab 界面等更多功能" }}>

<div id="authenticated-mcp-route">
  ## 已认证的 MCP 路由
</div>

[MCP](/zh/ai/model-context-protocol) 服务器现提供新的已认证路由，支持在启用身份验证的文档站点上进行安全搜索。

<div id="new-contextual-menu-options">
  ## 新的上下文菜单选项
</div>

[上下文菜单](/zh/ai/contextual-menu)现包含 **Google AI Studio**、**Devin** 和 **Windsurf** 选项。用户可以直接在这些工具中打开任何文档页面，页面内容将作为上下文预加载。

<div id="self-hosted-gitlab-configuration">
  ## 自托管 GitLab 配置
</div>

你现在可以直接从 dashboard 配置[自托管 GitLab](/zh/deploy/gitlab) 实例。GitLab API 请求通过服务器代理，无需使用浏览器对你的 GitLab 实例进行身份验证。

<div id="invite-multiple-members">
  ## 批量邀请成员
</div>

从 dashboard 一次性邀请多个团队成员加入你的组织，无需逐个发送邀请。

<div id="improvements">
  ## 改进
</div>

- 用户头像现在在整个 dashboard 中显示，提供更个性化的体验。
- Automation 模板已更新，包含改进的 prompt。
- Automation 运行历史现可从 dashboard 查看，支持监控状态和关闭 PR。
- Automation 的 Slack 通知现可从 dashboard 配置。
- 编辑器性能改进：修复了大型仓库中的输入延迟和持久化阻塞问题，对包含大量文件的仓库虚拟化了文件列表。
- 消除了页面初始加载时卡片的布局偏移。
- 改进了 dashboard 分析日期选择器的响应性。
- 搜索现使用统一端点，性能和一致性均有提升。

<div id="bug-fixes">
  ## 错误修复
</div>

- 修复了 Columns 组件布局回归问题
- 修复了 AsyncAPI 枚举参数显示为纯类型字符串的问题。
- 修复了 Aspen 和 Luma 主题的布局问题。
- 修复了 columns 组件布局在多个主题中出错的问题。
- 修复了 Luma 主题中与横幅相关的布局偏移。
- 修复了 API playground 预填示例在某些主题中不生效的问题。
- 修复了 API playground 中 Markdown 列表的渲染问题。
- 修复了基础路径未正确应用于内部链接的问题。
- 修复了基础路径错误地应用于协议相对链接的问题。
- 修复了列表内嵌套块级元素的问题。
- 修复了 Prompt 和 Mermaid 组件出现代码块工具提示的问题。
- 修复了隐藏页面的子页面未在装饰导航中显示的问题。

</Update>

<Update label="March 13, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Automation 模板和 CLI 命令、Agent API v2 等更多功能" }}>

<div id="automation-templates">
  ## Automation 模板
</div>

使用 [dashboard](https://app.mintlify.com/products/automations) 中的预置模板更快地创建 [automations](/zh/automations)。可选择的模板包括：changelog 生成、API 文档同步、功能文档草稿、断链检测、SEO 审计等。模板包含优化的 prompt 和触发器配置，帮助你快速上手。

<div id="automation-cli-command">
  ## Automation CLI 命令
</div>

使用 `mint automation` CLI 命令从命令行创建 [automations](/zh/automations) 文件。交互式提示将引导你完成名称、触发器、上下文和指令的配置。

<div id="agent-api-v2">
  ## Agent API v2
</div>

使用新的 `/v2/agent` [端点](/zh/api/agent/v2/create-agent-job)以编程方式触发 agent。提交一个包含 prompt 和可选上下文的任务，然后轮询完成状态和生成的 pull request 链接。适用于将 agent 驱动的文档更新集成到你自己的 CI/CD 流水线或内部工具中。

<div id="additional-language-support">
  ## 新增语言支持
</div>

新增匈牙利语（Magyar）和加泰罗尼亚语的本地化支持。

<div id="per-page-feedback-analytics">
  ## 按页面的反馈分析
</div>

在你的[分析](/zh/analytics) dashboard 中按单个页面查看反馈数据。

<div id="improvements">
  ## 改进
</div>

- 编辑器斜杠命令菜单中现提供 YouTube 和 Loom 嵌入功能
- 页脚和导航栏内容按语言本地化
- Slack 助手在处理时显示状态指示器
- Automations 现在可以发送包含自动合并状态的 Slack 通知
- 编辑器现在支持拼写检查
- 改进了移动端和响应式视图的 dashboard 布局

<div id="bug-fixes">
  ## 错误修复
</div>

- 修复了 HTTP 重定向状态码，现使用正确的 308 和 307 响应
- 修复了高级页脚配置下侧边栏闪烁的问题
- 修复了标签页内第一个元素的外边距间距问题
- 修复了编辑器刷新问题
- 修复了 PDF 导出样式问题
- 修复了 Mint、Maple、Willow 和 Linden 主题中自定义页面的页脚隐藏问题
- 修复了 `.md` 路由不能从 slug 生成标题的问题
- 修复了通过 dashboard 创建的 cron automation 不能自动触发的问题
- 修复了 automation 递归运行的问题
- 修复了 agent 在被要求进行后续更改时重新创建 PR 的问题
- 修复了多语言会话中 agent 会话错误的问题

</Update>

<Update label="March 6, 2026" tags={["New releases", "Improvements"]} rss={{ title: "从公开 GitHub 仓库自动生成文档、助手多模态功能，以及更多改进" }}>
  ## 从公开仓库自动生成文档

  从任何公开 GitHub 仓库[自动生成完整的文档站点](https://mintlify.com/explore)。将任意公开仓库 URL 中的 `github.com` 替换为 `mintlify.com`，即可立即预览生成的文档。如果你是该仓库的所有者，可以认领该文档站点，将其添加到你的 Mintlify 组织中并进行自定义。

  ## 助手改进

  [助手](/zh/assistant/index) 现在支持多模态输入。可向消息附加文件以提供更多上下文。你可以直接将图片、PDF 和代码文件拖放或粘贴到聊天中。

  助手现在还可以生成页面特定的[示例问题](/zh/assistant/configure#add-sample-questions)。

  助手现在还会根据用户当前所在页面构建上下文，并为整个 OpenAPI 规范建立索引。

  ## 默认 Vale 配置更新

  默认的[Vale 配置](/zh/deploy/ci#configuration)现在会将 MDX 按 MD 解析，以避免 JSX 导致的脆弱性。此前，Vale 会对 MDX 组件中的任何 JSX 返回误报。现在，Vale 会将 MDX 按 MD 解析，并通过针对应由 Vale 跳过的 MDX 和 JSX 元素使用 `tokenIgnores` 和 `blockIgnores`，来避免这些错误。

  ## 改进

  * Automations 现在支持每天最多运行 50 次，高于此前的 20 次。
  * 现在可在 API 操作台中支持[完整 base URL](/zh/organize/settings-api)，方法是在 `docs.json` 中配置 `api.url`。
  * 控制台布局已更新，改进了导航以及编辑器和设置页面的侧边栏访问体验。
  * 编辑器搜索栏已重新设计，优化了查找和跳转到文件的用户体验。
  * 编辑器中的列表现已支持嵌套拖放。
  * 代码块现已支持 Twoslash，可显示内联 TypeScript 类型信息。
  * 部署历史现在可区分排队中和进行中状态。

  ## 错误修复

  * 修复了已验证文档中的 OAuth 和 JWT 重定向问题。
  * 修复了在编辑器中粘贴文本时光标跳动的问题。
  * 修复了用于取消助手消息的键盘快捷键。
  * 修复了带下划线的分支名称在编辑器中无法使用的问题。
  * 修复了 callout 组件中的链接边框颜色问题。
  * 修复了输入字段在移动端的缩放行为。
</Update>

<Update label="February 27, 2026" tags={["New releases", "Improvements"]} rss={{ title: "使用自动化处理文档任务，并在编辑器中通过评论和建议协作" }}>
  ## Automations

  使用[automations](/zh/automations)自动化文档相关任务。你可以配置定时或事件触发的自动化流程，由 agent 运行以更新你的文档。

  Automations 目前处于测试阶段，所有套餐均可使用。

  ## 评论与建议

  在 Web 编辑器中通过评论和建议直接协作。选中文本即可留下反馈、提及队友或提出修改建议。

  ## Luma 主题

  全新的[Luma 主题](/zh/customize/themes)，提供简约、沉静的设计风格。

  ## 改进

  * 搜索筛选器现在支持按语言进行筛选。
  * 可以在编辑器的文件树中重命名文件。
  * API 操作台现已支持全局变量。
  * OpenAPI 和 AsyncAPI 规范现在会包含在 [llms.txt](/zh/ai/llmstxt) 中。
  * 新增 Adobe Analytics 集成支持。
  * Model Context Protocol (MCP) 现在可以与[部分已验证文档](/zh/ai/model-context-protocol)一起使用。

  ## 错误修复

  * 修复了 404 页面返回错误 HTTP 状态码的问题。
  * 修复了编辑器中的合并冲突解决问题。
  * 修复了 Mermaid 图表占位符渲染问题。
  * 修复了编辑器中的 frontmatter 解析问题。
  * 修复了表格工具提示的位置问题。
  * 修复了在没有 Frame 包裹时深色/浅色图片的渲染问题。
</Update>

<Update label="February 20, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Agent 配置文件与自定义前端" }}>
  ## `assistant.md` 和 `agent.md` 支持

  在你的存储库中使用 `.mintlify/Assistant.md` 和 `.mintlify/AGENTS.md` 文件来自定义 agent 和 AI 助手的行为。更多信息请参见 [Customize assistant behavior](/zh/assistant/customize) 和 [Customize agent behavior](/zh/agent/customize)。

  ## 自定义前端

  使用你自己的前端，并借助 Mintlify 内容引擎来发布文档并启用 AI 工具。更多信息请参见 [自定义前端指南](/zh/guides/custom-frontend)。

  ## 功能改进

  * Web 编辑器中的全新搜索功能，让你可以更轻松地在整个文档中查找并跳转到文件。
  * 在编辑器中通过拖拽即可添加表格行和列，加快表格的创建与修改。
  * API 操作台现在支持音频响应示例，更方便撰写与音频相关的 API 端点文档。

  ## 错误修复

  * 修复了 Sequoia 主题中的布局位移问题。
  * 修复了登出超时问题。
  * 修复了折叠面板 ID 去重逻辑，避免生成重复的锚点链接。
  * 改进了 SVG 清理机制以提升安全性。
</Update>

<Update label="February 13, 2026" tags={["New releases", "Improvements"]} rss={{ title: "Prompt 组件、Sequoia 主题、Tabler 图标以及编辑器改进" }}>
  ## Prompt 组件

  使用 [prompt](/zh/components/prompt) 组件用于展示可复制的提示词内容。专为分享 AI 提示词设计，并支持在 Cursor 中直接打开这些提示。

  ## Sequoia 主题

  [Sequoia 主题](/zh/customize/themes) 在侧边栏中提供了重新设计的目录，并集成了 [上下文菜单](/zh/ai/contextual-menu)。

  ## Tabler 图标支持

  现在你可以通过在 `docs.json` 的图标配置中设置 `"library": "tabler"`，在整个文档中使用 [Tabler icons](https://tabler.io/icons)。

  ## 在上下文菜单中添加 MCP

  [上下文菜单](/zh/ai/contextual-menu) 现在新增选项，可以添加一个可复制的命令，用于安装你的文档的 MCP 服务器。

  ## groups 中的 `root`

  导航 groups 现在支持 [`root`](/zh/organize/navigation#root-page) 属性，为分组设置着陆页。点击分组标题将跳转到 root 页面，而不是展开该分组。

  ## 编辑器改进

  * 改进了表格、折叠面板和卡片组件的编辑体验。
  * 全局块级选取，便于多块内容的批量编辑。
  * 提升了 branch 创建与拉取请求 (PR；亦称“合并请求”/Merge Request) 流程，并提供更清晰的状态指示。

  ## 反馈邮件收集

  [反馈](/zh/optimize/feedback) 表单现在包含一个可选的邮箱字段，使用户在提交反馈时可以提供联系方式。
</Update>

<Update label="February 6, 2026" tags={["New releases", "Improvements"]} rss={{ title: "自助式 SSO、查看者角色、人类/AI 流量切换，以及斜杠菜单重新设计" }}>
  ## 自助式 SSO 配置

  Enterprise 客户现在可以直接在控制台中配置 SAML SSO (Okta 或 Microsoft Entra) ，包括即时 (JIT) 预配、提供商切换和移除连接。

  ## Viewer 角色

  全新的 Viewer 角色，可对你的控制台进行只读访问。Viewer 可以查看编辑器中的内容，但无法编辑内容、邀请成员或修改配置。

  ## 人类/AI 流量切换

  Analytics 页面现在会分别显示人类流量和 AI 流量标签页。

  ## 斜杠菜单重新设计

  编辑器的斜杠菜单现已支持输入搜索、改进的键盘导航以及其他用户体验优化。

  ## 错误修复

  * 修复了控制台表格中单元格内容溢出的问题。
  * 现在通过编辑器中的配置面板重命名文件时，可以正确保存更改。
  * MDX 解析错误 (例如未闭合的 `<Card>` 标签) 现在会在你修复时动态更新，而不会在重新加载后错误地持续存在。
  * 编辑器中的拖放手柄现在能够与标题或段落等不同内容类型正确对齐，同时保持一致的尺寸并提供更大的可点击区域。
</Update>

<Update label="January 30, 2026" tags={["New releases", "Improvements"]} rss={{ title: "简化技能安装、焕新的 Analytics 页面、编辑器改进等" }}>
  ## 技能安装更简单

  只需使用一个文档 URL 即可安装 [skill.md 文件](/zh/ai/skillmd)，无需提供 `skill.md` 文件的具体路径。

  ```bash
  npx skills add mintlify.com/docs
  ```

  ## 焕新 Analytics 页面

  改进了 [Analytics](/zh/analytics) 标签之间的导航，提供更具可操作性的洞察和更出色的数据可视化效果。

  ## 编辑器改进

  * 可编辑的图标
  * Cards、Accordions 和 Steps 组件支持所见即所得的 title 与 description 编辑
  * 在导航中隐藏或取消隐藏页面
  * 实时预览中的本地图像支持
  * 使用 <code>```</code> 触发代码块
  * 更精确的拖拽手柄选取
  * 稳定性改进

  ## 更新后的 AI 助手页面

  在单一页面中管理所有 [AI 助手功能](/zh/assistant/index)，布局更简洁、用户体验更佳。

  ## MCP 筛选

  AI 助手现在可以按参数来[筛选](ai/model-context-protocol#search-filtering-parameters) MCP (Model Context Protocol) 搜索结果。

  ## 其他

  * 在[上下文菜单](/zh/ai/contextual-menu)中新增 "Open in Grok" 支持
  * 在[项目初始化流程](/zh/deploy/github#clone-to-your-own-repository)中支持上传 Zip 文件

  ## 错误修复

  * 修复了导致侧边栏在页面间导航时错误显示展开/折叠状态的缓存问题。
  * 解决了自定义页面上的滚动位置问题，确保内容正确显示。
  * 修复了同一页面包含多个 Mermaid 图表时产生的冲突问题。
  * 修复了可能导致 Tabs 组件产生性能问题的渲染循环。
  * 修复了密码重置按钮无法使用的问题。
  * 现在在打印页面时，AI 助手不再显示。
  * 修复了暗色模式下光标不可见的问题。
  * 修复了可能会移除 MDX 中样式属性的错误。
  * 修复了在全局配置变更期间，页面“最后修改”日期被错误更新的问题。
  * 修复了影响索引页正确渲染的认证问题。
  * 如果 GitHub 出现故障，在项目初始化流程中现在会正确显示 GitHub 状态。
</Update>

<Update label="January 23, 2026" tags={["New releases", "Improvements"]} rss={{ title: "skills.md、审计日志和 Markdown 导出" }}>
  ## `skill.md` 自动生成

  文档站点现在会根据你的 API 参考文档、指南和功能自动生成 `skill.md` 文件，为 AI 代理提供一份完整的技能文件，包含如何帮助用户使用你产品的上下文信息。`skill.md` 取代了 `install.md` 方案，提供更结构化的能力，并获得更广泛的采用。如果你在文档存储库根目录下有自定义的 `skills.md` 文件，它将替换自动生成的版本。更多信息，请参阅 [skill.md](/zh/ai/skillmd)。

  ## 认证事件的审计日志

  相关事件现在会记录到[审计日志](/zh/dashboard/audit-logs)中，以提升可见性并满足合规需求。

  ## 面向代理的 Markdown 导出

  现在，当发送 `Accept: text/markdown` 标头时，文档页面会返回原始 Markdown，从而让 AI 代理更好地使用这些内容。

  ## 改进

  * 将认证、部分认证和个性化整合为统一的认证体验。更多信息，请参阅[认证设置](/zh/deploy/authentication-setup)。
  * 隐藏页面现在会自动添加 `noindex` meta 标签，以便更好地控制 SEO (搜索引擎优化) 。
  * 新增对图片说明的 Markdown 支持。
</Update>

<Update label="January 16, 2026" tags={["New releases", "Improvements"]} rss={{ title: "install.md、Web 编辑器实时预览等" }}>
  ## `install.md` 自动生成

  文档站点现在会自动生成一个 `install.md` 文件，用于聚合与安装相关的页面，例如快速开始、入门、安装和 AI Agent 设置指南。如果你的文档存储库中已有自定义的 `install.md` 文件，它将优先于自动生成的版本被使用。

  ## Web 编辑器功能改进

  * **实时预览**：在 Web 编辑器中编辑文档时实时查看变更。实时预览会精确还原文档发布后的站点效果，而无需创建预览部署。
  * **未使用文件区域**：编辑器现在会显示不在导航中的未使用页面，并支持通过拖拽将它们加入导航。

  ## Git 集成中的 branch 搜索

  为 GitHub 和 GitLab 集成新增了 branch 搜索功能，便于你在控制台的 Git 设置中查找并在不同部署用分支之间切换。

  ## `mintlify validate` 命令行界面 (CLI) 命令

  新增命令行界面 (CLI) 命令，用于在本地验证文档构建是否正常，再进行部署。运行 `mint validate` 即可提前发现配置和构建错误。

  ## AI 助手消息配额档位

  用户现在可以在控制台中按月选择不同档位的 AI 助手消息配额。

  ## 错误修复

  * 修复了 API 参考中的基础路径问题。
  * 使用焕新后的配色方案更新了提示框颜色。
  * 修复了在编辑器中上传后，图片在初次加载时未显示的问题。
  * 修复了卡片链接内的代码样式问题。
  * 修复了 `.md` 文件错误覆盖 `.mdx` 文件的问题。
</Update>

<Update label="January 9, 2026" tags={["New releases", "Improvements"]} rss={{ title: "隐式代码片段与面向所有用户的 AI 助手对话洞察" }}>
  ## 隐式代码片段

  代码片段现在无需显式配置即可工作。此前，你需要在特定的 `/snippets` 目录中定义代码片段。现在，你可以在文档中的任意位置将任意文件作为代码片段导入，从而更灵活地复用内容。更多信息请参见：[可复用代码片段](/zh/create/reusable-snippets)。

  ## 面向所有用户的 AI 助手建议

  对话洞察现已对所有同时启用了 Agent 和 AI 助手的文档站点开放。Agent 会分析用户与 AI 助手对话中的模式，以识别文档空白并给出改进建议，帮助你主动解决用户的常见问题。

  ## Tab 与代码组同步

  Tabs 和代码组现在会在整页范围内同步其选中状态。当你在一个组件中选择某个 Tab 时，所有具有相同标签的其他 Tab 组件都会更新为相同的选中项，从而让整页中的语言或框架选择保持一致。

  ## 功能改进

  * **Tabs 底部边框**：为 Tabs 新增可选的底部边框样式。
  * **Mermaid 控件**：为 [Mermaid 图表](/zh/components/mermaid-diagrams) 提供交互式控件，以便在大型图表中导航。
  * **用于搜索和 AI 助手的 URL 参数**：通过 `?search=` 预填搜索弹窗，或通过 `?assistant=` 打开 AI 助手。支持使用 URL 查询参数进行直接链接和知识分享。
  * **个人资料姓名编辑**：用户现在可以在个人资料设置中编辑自己的名和姓。
</Update>

<Update label="December 23, 2025" tags={["New releases", "Improvements"]} rss={{ title: "Web 编辑器改进与 AI 助手洞察" }}>
  ## Web 编辑器功能改进

  [Web 编辑器](/zh/editor/index) 现在拥有更直观的界面和全新的功能。

  * **可视化导航编辑**：在 Web 编辑器中配置你的导航结构，并在编辑器中预览站点的导航侧边栏效果。所有更改都会自动映射到你的 `docs.json`。
  * **配置选项**：在编辑器中调整所有站点配置选项，而无需手动编辑 `docs.json`。
  * **拖拽上传资源**：直接从电脑将图片和文件拖拽到文件树中即可完成上传。
  * **稳定性改进**：改进了整体稳定性和移动端的响应式表现。

  ## 基于 AI 助手对话的 Agent 建议

  [Agent](/zh/agent) 现在可以基于 AI 助手对话来建议文档更新。启用后，Agent 会分析用户向 AI 助手提出的问题，以识别哪些模式表明文档存在缺失或表述不清。

  这为 Agent 的建议在存储库监控之外新增了第二个来源，帮助你主动解决用户的常见问题。

  ## Slack 机器人自定义

  你现在可以直接在控制台中[自定义 Slack 机器人](/zh/ai/slack-bot)。

  * **选择回复频道**：选择机器人应自动回复所有消息的频道。默认频道为 `#ask-ai`。
  * **自定义机器人的外观**：在控制台中更改机器人的头像和名称。

  ## 移动端导航改进

  * 在移动端导航中新增主题切换器，便于在亮色/暗色模式之间快速切换。
  * 在移动端导航中新增 Logo 显示，以提升品牌呈现效果。

  ## 错误修复

  * 修复了 API 操作台中某些接口缺少请求示例的问题。
  * 修复了在 API 操作台中使用预填示例时，MDX 示例未正确显示的问题。
  * 修复了 AI 助手中的链接在新窗口打开而非当前窗口的问题。
  * 修复了 AI 助手回复中 Markdown 链接的渲染问题。
  * 修复了标题 slug 中特殊字符的处理问题。
</Update>

<Update label="December 19, 2025" tags={["Improvements"]} rss={{ title: "Agent、AI 助手和编辑器改进" }}>
  ## Agent 功能改进

  * 新增从 `AGENTS.md` 文件读取[自定义指令](/zh/agent/customize)的支持。
  * 如果你在控制台中连接 GitHub 账号，Agent 现在会以你的 GitHub 账号身份创建 PR。

  ## AI 助手功能改进

  * 新增复制对话按钮，方便分享或保存与 AI 助手的对话。
  * 改进了对流式响应卡顿场景的处理，使 AI 助手回复更加可靠。
  * 改进了 AI 助手在移动设备上的展示效果。

  ## Web 编辑器功能改进

  * 在编辑器工具栏中新增[可分享的预览链接](/zh/editor/collaborate#share-previews)。
  * 更新了[发布工作流](/zh/editor/publish)，支持一键发布或创建拉取请求 (PR；亦称“合并请求”/Merge Request) 。
  * 使用 Web 编辑器进行文档编辑不再要求必须通过 GitHub 登录。

  ## 入门体验改进

  * 在注册时，可选择使用 Mintlify 托管的文档存储库，或使用你自己的存储库。
  * 在不连接 GitHub 账号的情况下也可以创建文档站点。

  ## 代码片段改进

  * 代码片段现在支持[相对路径导入](/zh/create/reusable-snippets#import-snippets-into-pages)。

  ## 本地化改进

  * 新增对波兰语、乌兹别克语和希伯来语的支持。
  * API 操作台中的 UI 元素 (包括 “Try it” 与 “Send” 按钮) 现已在所有支持的语言中实现本地化。
</Update>

<Update label="December 12, 2025" tags={["New releases", "Improvements"]} rss={{  title: "Agent 建议与问答机器人" }}>
  ## Agent 建议

  Agent 现在可以监控 Git 仓库并建议文档更新。当检测到面向用户的代码发生变更时，这些建议会出现在 Agent 面板中。建议中会包含相关的拉取请求 (pull request) 以及拟议的文档更新列表。你可以将这些建议添加为 Agent 的上下文，让其创建拉取请求，或者直接将其忽略。

  ## Slack 中的问答机器人

  你可以将由 AI 助手驱动的机器人添加到你的 [Slack 工作区](/zh/ai/slack-bot)中。机器人会基于你的文档实时回答问题，为你的社区提供准确、最新的答复。

  这些机器人会响应 `@` 提及，以及所有位于名为 `#ask-ai` 的频道中的消息。

  ## 代码片段现已支持相对路径导入

  现在，你可以在 MDX 文件中使用相对路径导入代码片段 (snippets) 。之前, 导入必须使用以 `/snippets/` 开头的绝对路径。现在你可以使用诸如 `../snippets/example.mdx` 这样的相对路径，以便更灵活地组织文件。

  ## 功能改进

  * 控制台中的 **Insights** 重命名为 **Analytics**。
  * 新增从控制台删除某次部署的功能。
  * 重新设计了 `Tooltip` 组件的样式，并新增可选的 `headline` 属性，用于为提示气泡添加标题。
  * `mint a11y` 命令现在支持 `--skip-contrast` 和 `--skip-alt-text` 标志，允许你在 CI/CD 流水线中运行特定的无障碍检查。使用 `--skip-contrast` 仅检查缺失的 alt 文本，或使用 `--skip-alt-text` 仅检查颜色对比度。

  ## 错误修复

  * 修复了标签页中的链接无法正常工作的问题。
  * 修复了 Web 编辑器中标题等级 5 和 6 的渲染问题。
  * 修复了 API 参考页面中模式 (schema) 页面示例的显示问题。
  * 修复了在 monorepo 设置下的图片上传路径问题。
  * 修复了 API 操作台中首次选择错误请求负载值的问题。
  * 上传图片时，现在会从默认图片标题中移除文件扩展名。
  * 修复了横幅链接出现双下划线的样式问题。
  * 修复了 Analytics 页面加载状态和日期范围值的问题。
  * Web 编辑器中的文件夹现在在打开或关闭其他文件夹时，能够正确保持其展开/收起状态。
  * 修复了过长的 API 页面标题未换行而溢出显示的问题。
</Update>

<Update label="December 9, 2025" tags={["New releases"]} rss={{ title: "预览小组件", description: "在预览部署中使用交互式小组件跟踪更改的文件" }}>
  ## 预览小组件

  预览部署现在包含一个交互式小组件，用于显示部署中所有有变更的文件。该小组件会以浮动按钮的形式出现在右下角，并提供：

  * 一键跳转到已更改的页面。
  * 可搜索的已更改文件列表，并带有状态标记 (新增、已修改、已删除) 。

  该小组件会在所有预览部署中自动启用，帮助审阅者快速定位和浏览已修改的内容。
</Update>

<Update label="December 8, 2025" tags={["New releases"]} rss={{ title: "最近修改时间", description: "通过自动时间戳显示页面的最近更新时间" }}>
  ## 最近修改时间

  你现在可以在文档中的所有页面上显示页面的“最近修改”时间戳。通过在 `docs.json` 设置中启用 [`timestamp`](/zh/organize/settings-seo#metadata) 标志即可开启此功能。

  启用后，每个页面都会自动显示其最近一次更新的时间，帮助读者判断内容是否是最新的。
</Update>

<Update label="December 5, 2025" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "API playground enhancements, web editor improvements, and bug fixes" }}>
  ## Web 编辑器改进

  * 修复了从编辑器可视化模式上传图片的问题。现在图片会使用正确的路径进行上传，改进后的路径解析也可以更好地处理绝对路径和相对路径。
  * 修复了同步操作，能够正确更新当前打开的文件，确保编辑器显示的是最新内容。
  * 改进了分支拉取机制，现在会每 15 分钟自动更新。
  * 修复了创建分支的流程，在不移动未提交更改的情况下创建新分支时，现在可以正确填充文件夹结构。
  * 修复了在创建新分支时出现的文件夹重复问题。

  ## AI 助手改进

  * 修复了 AI 助手消息提交的问题，防止发送空消息。
  * 修复了在输入法组合 (例如日语、中文、韩语) 过程中误触发消息发送的问题。
  * 改进了向 AI 助手添加代码片段时的行为表现。

  ## 错误修复与稳定性

  * 修复了复杂 Mermaid 图表的处理问题。
  * 修复了针对 URL 和目录的 hash 处理问题，当通过带有索引页的根路径访问时，现在可以正确高亮当前页面。
  * 新增配置项，可禁用 404 页面推荐。
  * 修复了 API 操作台中的一个问题：在生成 API 请求时，query 参数中的布尔值 `false` 和数值 `0` 会被过滤掉，导致未出现在生成的 API 请求中。
</Update>

<Update label="December 3, 2025" tags={["New releases"]} rss={{ title: "Assistant query bucketing", description: "Automatically group similar assistant queries to identify common user questions" }}>
  ## AI 助手查询分组

  [Assistant insights](https://dashboard.mintlify.com/products/assistant) 现在会自动将相似的查询聚合为问题类别，帮助你更轻松地识别用户常见的问题模式。

  点击某个类别，可以查看该类别下的所有会话，并深入到单个会话中，查看用户查询、AI 助手的回答以及引用的来源。
</Update>

<Update label="December 1, 2025" tags={["New releases"]} rss={{ title: ".mintignore support", description: "Exclude files and directories from your published documentation" }}>
  ## .mintignore 支持

  * 新增对 `.mintignore` 文件的支持，用于排除特定文件和目录，使其不会被处理或发布到你的文档站点。
  * 使用与 `.gitignore` 相同的模式语法，配置方式更直观易用。
  * 被排除的文件不会出现在已发布文档中，不会被编入搜索索引，也无法被访问者访问。

  在 [.mintignore 文档](/zh/organize/mintignore) 中了解更多。
</Update>

<Update label="November 25, 2025" tags={["Improvements"]} rss={{ title: "Vale version upgrade", description: "Vale version 3.10+ now supported" }}>
  ## Vale 版本升级

  * 升级了后端依赖，使用 Vale 版本 3.11.2-r5，为 Vale CI 检查功能带来了原生 MDX 支持。
</Update>

<Update label="November 21, 2025" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "API playground enhancements, localization updates, and CLI improvements" }}>
  ## API 操作台改进

  * 修复了在切换具有不同响应码的端点时响应区域会消失的问题。现在在导航到新端点时，操作台会正确重置为第一个可用的响应码。
  * 修复了 HTTP Basic 认证方案中重复显示 "Authorization" 头的问题。认证区域现在提供了更简洁的界面以及正确的字段标签和说明。
  * 改进了对嵌套对象和数组中 `oneOf` 模式的处理。具有多种类型选项的复杂 API 模式现在会在合适的场景下正确渲染为下拉框，而不是选项卡。
  * 修复了在 OpenAPI 规范中定义在端点级别的路径参数缺失的问题。现在在单个操作之上的参数会正确出现在主页面和操作台中。
  * 增强了响应示例的生成逻辑，即便示例只指定了部分字段，也会包含所有必填属性，确保响应示例完整且准确。
  * 修复了对象数组中预填示例缺失的问题。带有示例数据的数组项现在会在操作台中根据正确的索引被正确预填。
  * 改进了 API 操作台中说明文本的内边距与间距，从而提升可读性和视觉一致性。

  ## 本地化改进

  * 增强了所有支持语言中，在上下文菜单选项和 AI 助手状态消息里的翻译质量。

  ## 命令行界面 (CLI) 改进

  * 为在 Node.js 20.17 以下版本上运行 `mint dev` 的用户新增错误提示信息，并引导用户升级到 LTS 版本。
</Update>

<Update label="2025 年 11 月 15 日" tags={["New releases", "Improvements"]} rss={{ title: "每周更新", description: "Badge 组件、API playground 改进、自定义语言支持和性能增强" }}>
  ## 新功能

  * **Badge 组件**：新增 <Badge color="green">Badge</Badge> 组件，用于展示状态指示、标签和标记
  * **自定义 Shiki 语言**：通过 `docs.json` 配置在代码块中添加对自定义编程语言的支持，为领域特定语言启用语法高亮
  * **Clarity 分析工具集成**：Microsoft Clarity 现已作为分析工具集成，用于会话录制和热力图追踪

  ## API playground 改进

  * 认证密钥现在会在 API playground 中跨页面导航和浏览器会话持久保存，无需在测试多个端点时重复输入凭据
  * 认证密钥会根据你的配置自动预填，加快带鉴权端点的测试启动速度
  * 修复了 Bearer auth 和 OAuth 的认证头名称，使其符合正确的 HTTP 标准
  * OpenAPI 规范中在 operation 级别定义的 security 输入现在可以正确覆盖顶层的 security 定义
  * 修复了将标记为 security 参数的 header 输入错误地包含在生成代码示例中的问题
  * 改进了在 API 字段展示中对 `deepObject` 形式参数的处理
  * 当在 API 配置中提供无效 URL 时，错误信息更加清晰
  * 改进了 API playground 的 UI，在间距、布局和加载体验方面更佳

  ## 导航与 UI 增强

  * 选项卡悬停指示器的样式得到改进，提供更好的视觉反馈
  * 过长单词现在会正确换行，以避免横向滚动
  * Step 组件现在可以处理未提供步骤标题的情况
  * 通过更合理的内边距改进了 Logo 区域的间距
  * 修复了标题 ID 生成逻辑，现在在用于锚点链接时能够正确处理问号和特殊字符
  * Icon 组件现在接受 `className` prop 以支持自定义样式
  * 修复了主题切换按钮的颜色，使其在明暗模式下都具有更好的可见性

  ## Web 编辑器改进

  * 分支切换现已直接集成到编辑器 UI 中，更易于在分支之间导航
  * 修复了文件创建和重命名逻辑，使其能正确匹配 MDX frontmatter 中的原始文件位置
  * 修复了将文件移动到之前已删除路径时的处理问题
  * 文件夹展开状态现在会在编辑器中跨会话持久保存

  ## 组件与样式增强

  * 图片现在支持缩放，并在明暗模式下都具有改进的遮罩样式
  * 修复了深色模式下 callout 内键盘快捷键样式的问题
  * 改进了 OG 图片生成，支持 Google Fonts，并具有更合理的截断逻辑
  * 改进了表格 UI，在对齐、间距和可读性方面更佳
  * 修复了选项卡内表格以及选项卡内步骤的滚动行为
  * 改进了 Palm 主题的侧边栏样式

  ## 性能与基础设施

  * Shiki 主题现在采用懒加载，以提升初始页面加载性能
  * 通过优化预取行为减少了导航时的卡顿

  ## Bug 修复与可靠性

  * 在 API playground 中可以正确清除对象和数组输入中新增的值
  * 修复了目录渲染问题
  * 修复了 favicon 隔离问题，避免不同文档站点之间发生冲突
  * 修复了非 API 页面上的侧边栏展示问题
  * 修复了图片放大弹窗在打开/关闭时的轮廓闪烁问题
  * 外部链接现在会正确在新标签页中打开
  * 修复了控制台设计不一致的问题，并改进了间距
</Update>

<Update label="October 31, 2025" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "API playground enhancements, table improvements, performance optimizations, and bug fixes" }}>
  ## Assistant 改进

  * **Assistant 的入门问题上线了！你可以在仪表盘的 [Assistant --&gt; Settings](https://dashboard.mintlify.com/mintlify/mintlify/products/assistant/settings) 中添加自定义问题**
  * 通过对辱骂性关键词和 JSON 查询启用默认垃圾防护，Assistant 洞察质量已得到提升。

  ## API playground 改进

  * API playground 现在会自动为参数填充默认值，从而在测试端点时节省时间。
  * 已修复 `allOf`、`oneOf` 和嵌套对象模式导致的渲染问题或字段显示不正确的问题；复杂 API 模式现在能正确渲染，所有字段可见且结构合理。
  * Enum 和可为空字段类型现在在 playground 中显示准确的标签，更清晰地表明可接受的取值以及字段是否可选。
  * 在处理 API 请求中的嵌套对象时，playground 现在为每个字段显示恰当的描述性标签，而非通用占位符，便于理解需要提供的数据。
  * Enum 常量表和 API 字段展示现在在格式和对齐上有所改进，更易于浏览可用选项并理解字段要求。
  * API playground 的模态框现在在顶部显示富 MDX 格式的描述，为包含格式化文本、链接和代码示例的端点提供更好的上下文。

  ## Analytics 变更

  * 延迟加载分析：PostHog 和 LogRocket 现在在文档内容之后加载，在不影响分析数据的情况下改善首屏加载时间和 Core Web Vitals 分数。
  * 条件会话录制：PostHog 会话录制现在可基于用户属性或页面上下文有条件启用，以更好地控制录制时机。

  ## 视觉改进

  * 表格现在具有更好的对齐、统一的间距和更高的可读性。表头与其内容列正确对齐。

  ## Bug 修复

  * 修复了链接溢出导致移动设备出现水平滚动的问题。链接现在会在其容器内正确换行。
  * 改进了 LaTeX/数学块样式，提升可读性并保持格式一致。
  * 为视频嵌入添加了 `playsInline` 和 autoplay 属性，以确保在 iOS 设备上正常工作。
  * 使用正确的圆角更新了 Claude 图标，以保持视觉一致性。
  * 修复了 `/llms.txt` 路由，使 LLM 代理能够正确访问文档。
  * 防止在复杂 OpenAPI 规范中出现无限模式展开，避免浏览器崩溃。
  * 移除了 Palm 主题中的 x-overflow，它会在 API playground 中截断文本。
  * 增大了内容字体大小，以提升与浏览器阅读模式的兼容性。
  * 修复了 Google 登录按钮样式，提升视觉一致性。
</Update>

<Update label="October 24, 2025" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Dashboard enhancements, API playground improvements, authentication fixes, and performance optimizations" }}>
  ## Insights 改进

  * 改进了 insights 页面，修复了“今天”和“昨天”的日期选择器
  * 增强了反馈表，改进了搜索功能
  * 为分类表新增了加载状态

  ## Assistant 改进

  * 在仪表盘中新增 Assistant 放置位置配置
  * 通过修复上下文获取和工具消息，改进了 Assistant 的回复

  ## API playground 和 OpenAPI 增强

  * 重构了 API playground 的端点字段，使用新的 schema 图以获得更好性能
  * 即使在 Assistant 侧边栏打开时，也改进了 playground 模态框中的 API 示例展示
  * 修复了紧邻 `$refs` 和 `x-` 属性的 props 在 OpenAPI 解析中丢失的问题
  * 修复了 API playground 模态框标题样式

  ## Web 编辑器与部署增强

  * 恢复了手动创建预览按钮，便于创建预览部署
  * 在仪表盘中新增了获取分支保护数据的 fetcher
  * 在仪表盘中新增了获取 PR 状态跟踪的 fetcher
  * 改进了编辑器状态管理，使状态可在浏览器会话间持久化
  * 修复了编辑器发布按钮的禁用状态
  * 移除了编辑器中的代码块背景，使外观更简洁

  ## 性能与基础设施

  * 在 Web 编辑器中实现了完整的 Git 同步，以更好地同步代码库
  * 缓存了 MCP 响应，以提升性能
  * 改进了站点地图以规范化 `/index` 路径

  ## Bug 修复与可靠性

  * 修复了 API playground 中认证预填值无法正确预填的问题
  * 修复了来自 `seo.metatags` 的自定义 meta 标签在客户端水合后保留的问题
  * 使用 `break-all` 样式修复了页面标题文本溢出
  * 移除了页面尺寸选项的全宽限制
  * 修复了接受组织邀请时的按钮尺寸
  * 修复了在非 macOS 计算机上键盘快捷键显示为 "Ctrl+I" 但没有加号的问题
</Update>

<Update label="2025年10月17日" tags={["Improvements"]} rss={{ title: "每周更新", description: "AI 助手改进、导航增强、API 操作台更新，以及错误修复" }}>
  ## Assistant 和 AI 改进

  * 升级了助手提示词以提高准确性并提供更具上下文感知的响应
  * 新增置信度评分以改进助手响应中的决策
  * 增强助手搜索，使用并行的文档查询以更快获得结果
  * 修复助手突然消失的问题，并提升其在小尺寸页面上的可见性

  ## 导航和 UI 增强

  * 为导航组件添加稳定的滚动条留白 (gutter) ，确保布局一致
  * 使“本页内容”部分可点击，可快速滚动至页面顶部
  * 修复所有主题下助手栏的位置
  * 改进助手栏以避免与内容重叠
  * 修复 Almond 主题宽页面的最大宽度
  * 调整下拉箭头 icon 的尺寸，以保证导航分组外观一致

  ## API 操作台和 OpenAPI 改进

  * 为新的 API 参考页面设计添加功能开关支持
  * 改进 OpenAPI 模式图工具以正确处理组合
  * 在操作数据中添加端点类型以改进 API 文档
  * 修复当枚举和表格在 Markdown 中时，API 操作台的说明渲染
  * 调整 API 操作台中说明的渲染位置以获得更好的布局

  ## 错误修复和可靠性

  * 修复语言切换以保持在同一页面，而非重定向到首页
  * 修复断链 CLI，使其在 CI/CD 集成中以代码 1 退出
  * 修复本地字体路径以正确添加前导斜杠
  * 修复重定向处理以忽略 `docs.json` 中的前导斜杠
  * 修复规范 URL 对“/index”的去除以获得更好的 SEO (搜索引擎优化) 
  * 修复折叠面板中的有序列表定位
  * 修复 `<span>` 标签样式，使其行为类似 `<p>` 标签
  * 修复列表中第一个 `<p>` 标签的块级显示
  * 修复 OG 图片显示，使索引页面展示 division 名称
  * 修复 icon 路径以包含 `BASE_PATH`，以支持相对路径
  * 移除助手背景虚化以提升性能
</Update>

<Update label="2025年10月11日" tags={["Improvements"]} rss={{ title: "每周更新", description: "API 操作台改进、Analytics 增强、网页编辑器更新，以及错误修复" }}>
  ## Assistant 和 Agent AI 功能

  * 为 agent 新增 list&#95;pull&#95;requests 和 list&#95;commits 工具，使其可以一次性为某个日期范围或多个 PR 生成文档
  * 将 agent 和助手升级至 Claude Sonnet 4.5
  * 改进助手搜索，以并行查询文档从而更快返回响应
  * 修复对话长度统计，排除工具调用

  ## Insights 改进

  * 将 analytics 重命名为 insights
  * 移除 insights 的点击加载要求，让你可以立即查看全部数据
  * 使用服务端时间戳提升 insights 数据准确性

  ## 网页编辑器和控制台改进

  * 移除编辑器中代码块的背景，使外观更干净
  * 修复 branch 创建流程，以正确跳转到新创建的分支
  * 添加部署历史的分页
  * 为预览部署表格添加 cursor 分页
  * 修复预览部署仅返回预览环境部署
  * 改进控制台的 UI/UX，包括更好的间距、输入处理和布局修复
  * 改进控制台助手聊天中的链接处理
  * 修复 Firefox 中聊天助手的轮廓样式问题

  ## API 操作台增强

  * 改进 API 操作台模态框的渲染
  * 修复 API 操作台中可展开项与锚点链接不兼容的问题
  * 在 API 操作台中新增合并示例与用户输入 body 的支持
  * 修复 API 操作台中视频响应的展示方式

  ## 错误修复和可靠性

  * 修复 404 推荐页面中的重复基础路径和链接
  * 自动填充 og:url 标签为适当的规范 URL
  * 添加规范化标签以获得更好的 SEO (搜索引擎优化) 
  * 修复代码块过度滚动问题
  * 使搜索引擎忽略预览部署以满足 SEO 需求
  * 修复引荐来源跟踪，使用 domain 而非完整 URL
  * 修复图片总是变为 MDX 块级元素的问题 (保持行内图片为行内) 
  * 移除原始 Markdown 页面中的注释，使你可以使用 TODO 注释且不会泄露给用户
  * 修复 read&#95;external&#95;files 的目录读取支持

  ## 组件与样式

  * 在 products division 中新增下拉菜单支持
  * 修复中间件导航工具函数中的 products 和菜单
  * 更新 404 页面文案，使其更清晰
</Update>

<Update label="October 3, 2025" tags={["New releases", "Improvements"]} rss={{ title: "Weekly Updates", description: "Products navigation, accessibility CLI, API playground enhancements, and extensive accessibility improvements" }}>
  ## 新功能

  * **产品导航**：使用产品切换器来组织多个产品的文档
  * **可访问性命令行界面 (CLI) 命令**：运行 `mint a11y` 测试文档中的可访问性问题
  * **API 操作台中的视频响应**：API 操作台现已支持显示视频响应类型
  * **API 操作台预填**：新增选项，可预填 API 操作台示例以加快测试
  * **未认证反馈**：对于使用部分认证的网站，用户现在无需认证即可提交反馈
  * **Shiki 主题支持**：现已支持使用 Shiki 主题为代码块设置样式
  * **代码块的 Twoslash**：TypeScript 和 JavaScript 代码块现支持使用 Twoslash 显示内联类型信息

  ## 可访问性改进

  * 在各组件中新增全面的 ARIA 属性，以更好地支持屏幕阅读器
  * 新增“跳转到主内容”按钮，便于键盘导航
  * 在 Tab 组件中支持方向键导航
  * 增强了工具提示、嵌套列表和代码组的可访问性
  * 改进了整个界面的聚焦状态和键盘交互模式

  ## AI 助手与 Analytics 增强

  * 为助手 query 分析新增柱状图可视化
  * 在助手分析页面统一了日期范围选择器
  * 为助手分析图表新增缩放控件
  * 通过热键和聊天抽屉改进了助手历史记录管理

  ## Bug 修复与可靠性

  * 修复了侧边面板遮罩的 z-index 问题
  * 修复了 light 模式的颜色回退以及主题相关的样式问题
  * 修复了 API 操作台可展开项与锚点链接不兼容的问题
  * 修复了面向 ChatGPT 和其他 LLM 代理的 `.md` 链接可访问性
  * 修复了按百分比设置宽度和高度时的图片尺寸处理
  * 修复了带有语言标签和自定义主题的代码块渲染问题
  * 修复了折叠面板链接的格式和样式
  * 当助手配置为空时，修复了页脚间距问题
  * 修复了本地存储库图片的卡片 icon 渲染
  * 修复了 API 操作台中的音频文件处理 (防止 UTF-8 解码) 
  * 改进了网页编辑器中的 PR 发布状态管理
</Update>

<Update label="September 26, 2025" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Language support expansion, UI improvements, and infrastructure enhancements" }}>
  ## 语言支持扩展

  * 在文档界面中新增对罗马尼亚语和捷克语的支持
  * 增强了本地化能力，为新增语言提供完整翻译覆盖
  * 改进了所有主题中的语言选择器功能

  ## 界面与用户体验改进

  * 修复了 404 页面上的 Tab 可见性问题，避免错误的活动标签页高亮
  * 改善了非优化图片的处理，正确传递 width 和 height 属性
  * 改进了 404 页面的布局和样式一致性

  ## 基础设施与性能增强

  * 通过跳过昂贵的 Imgix 自动格式化来增强 GIF 图片处理，从而减少处理时间和带宽使用
  * 通过对动图的特殊处理优化了图片分发性能

  ## Bug 修复与可靠性

  * 修复了在控制台设置中用于 Assistant 插件请求的联系邮箱路由
  * 增强了数据库架构更新以提升用户管理
</Update>

<Update label="September 19, 2025" tags={["Improvements"]} rss={{ title: "Weekly Updates", description: "Web editor and authentication improvements, and bug fixes" }}>
  ## 网页编辑器与控制台登录改进

  * 持续推进网页编辑器的 app router 迁移，移除阻塞并提升性能
  * 增强了登录错误处理，提供明确的邮箱验证消息
  * 修复了邮箱地址验证中的空白字符处理

  ## 认证改进

  * 在登录回调中新增对已验证重定向参数的支持，以降低登录摩擦
  * 改进了 SSO 登录流程，提供更好的重定向处理

  ## Bug 修复与可靠性

  * 修复了 GitLab 集成在较大存储库中的问题
  * 通过优化部署查询改进了控制台的加载性能
  * 修复了文档中的 SVG 路径渲染问题
  * 修复了搜索与聊天功能中的键盘导航
</Update>

<Update label="2025 年 9 月 13 日" tags={["New releases", "Improvements"]} rss={{ title: "每周更新", description: "AI 404 建议、AI 助手网页搜索含外部来源、安全增强与可靠性修复" }}>
  ## 主要发布

  * **重大增强**：在 404 页面提供 AI 推荐页面，[当有人访问失效链接 → AI 智能体读取路径 → 推荐语义相似的页面](https://x.com/mintlify/status/1966625627773059495)
  * **重大发布**：AI 助手的网页搜索现在可包含外部来源\
    *注意：请联系我们为你的网站启用此功能。*

  ## AI 助手与 MCP

  * 修复了由于时间窗口未正确滑动导致 AI 助手被错误限流的问题
  * 修复了 AI 助手工具调用对空 `text` 块处理不当的问题
  * 修复了 MCP 服务器名称与工具调用拼接后有时会超过 MCP 客户端强制的 60 个字符限制的问题
  * 修复了 AI 助手菜单高度 (height) 远大于视口并无限滚动的问题
  * 修复了在控制台中 AI 助手花费数值可能显示超过两位小数的问题

  ## 网页编辑器与部署

  * 为编辑器添加了安全增强，只有对已连接的 Git 托管存储库具有 `write permissions` 的用户才能进行更改
  * 修复了名称中包含 `=` 的 branch 无法进行预览部署的问题
  * 修复了过长的 branch 名称在创建预览部署的模态框中溢出的问题
  * 易用性优化：电子邮件 query 参数将在注册邀请中预填输入框
  * 修复了在 Safari 上通过上下文菜单复制页面不起作用的问题

  ## API 操作台与导航

  * 多个 API 操作台响应码在聚焦时现在显示为受控样式的下拉选择菜单，而非系统默认的下拉菜单
  * 你现在可以在 docs.json 的导航 groups 上使用 [`expanded` 字段让其默认展开](https://mintlify.com/docs/navigation#default-expanded-state)

  ## SEO 与界面

  * 通过改为从与各自文档站点相同的 URL 提供 favicon，修复了其在搜索引擎中不显示的问题
  * 修复了 YouTube 嵌入在加载时闪烁的问题
  * 修复了将反馈菜单扩展为包含书面回复时与目录产生布局偏移的问题
  * 修复了在 Maple 主题中关闭通知横幅后文本溢出到顶栏之上的问题
  * 通过在侧边栏添加登录/登出按钮增强了 Maple 和 Willow 主题，访问更便捷

  ## Analytics 与导出

  * 修复了 AI 助手分析视图和导出的可靠性问题
  * AI 助手分析导出现已在后台执行并通过电子邮件发送，以提供更可靠的体验
</Update>

<Update label="2025 年 8 月 30 日" tags={["Improvements"]} rss={{ title: "每周更新", description: "增强反馈收集、导航改进以及认证相关的错误修复" }}>
  ## 重大版本发布：增强反馈收集能力

  * **重大改进**：读者现在在选择 *thumbs up/down* 之后，可以给出更详细的反馈，包括选择项和文字评论。你还可以在代码块上收集反馈，并在控制台的 Analytics 中查看所有回复。\
    *注意：请联系我们为你的站点开启此功能。*

  ## 导航与使用体验改进

  * 使用体验改进：忽略 URL 末尾多余的斜杠以及双斜杠，因此你无需在 docs.json 中把它们写得完全精确
  * 你现在可以在 `h1-6` HTML 标签中添加 `noAnchor` 属性，以避免它们自动生成锚点链接
  * Palm 主题现在在左下角提供了一个悬浮语言选择器，类似 Stripe 的做法
  * 在 docs.json 中新增了一个名为 [`drilldown`](https://mintlify.com/docs/navigation#enable-auto-navigation-for-groups) 的字段，用于控制当某个导航分组展开时，是否自动将用户导航到该分组中的第一个页面
  * 使用体验改进：让嵌套有序列表在十进制/罗马数字与字母样式之间交替显示

  ## 错误修复与可靠性

  * 修复了当页面中存在 JS 组件时，滚动位置锚点链接无法正常工作的问题
  * 修复了由于缺少 `x-robots-tag noindex` 响应头而导致 Google 对原始 `*.md` 文件进行索引收录的问题
  * 修复了受保护文档中的 OAuth 问题：在你成功完成认证流程后，无法重定向回起始页面的问题
  * 修复了受认证保护文档预览中的问题：你无法看到完整导航栏
  * 修复了在我们的新图片 CDN 下处理 SVG 时存在的问题

  ## 组件与样式增强

  * 为 `SidebarNavGroupDivider` 添加了一个新的 CSS 选择器，以便应用自定义样式
  * 为在 MDX 中定义并带有安全配置的 API 页面新增回归测试，从而确保更高的稳定性

  ## 性能改进

  * 性能优化：将 KaTeX CSS 从 cdnjs 迁移到我们在 Cloudfront 上的自有 CDN，以减少延迟
</Update>

<Update label="2025 年 8 月 23 日" tags={["Improvements"]} rss={{ title: "每周更新", description: "图片布局修复、认证增强、移动端导航改进以及 Web 编辑器稳定性提升" }}>
  ## 图片处理改进

  * **重大改进**：即使未指定 width 和 height 属性，图片现在默认也不会再引发布局偏移——自动尺寸调整可防止页面加载时内容发生跳动
  * 存储库中的所有静态文件 (PDF、TXT、XML 等) 现在在部署时都会自动上传和提供服务，从而实现完整的资源文件覆盖

  ## Web 编辑器与部署增强

  * 修复了 Web 编辑器中的 branch 创建流程，现可正确跳转并停留在新创建的 branch 上
  * 增强了合并冲突对话框，提供了正确的退出功能，无需再通过刷新页面来关闭冲突提示
  * 通过在部分更新时仅对变更页面进行缓存失效处理来优化更新流程性能，从而缩短部署时间

  ## 认证与导航改进

  * 新增对自定义子路径上的认证支持：如果你在 `https://yourdomain.com/docs` 提供文档服务，现在认证流程可以无缝工作
  * 修复了在仅配置一个链接时侧边栏显示不正确的错误
  * 对移动端导航进行了全面优化：按钮居中并带有合理的边距/内边距，改进了下拉菜单中的间距，移除了空区块中不必要的分隔线和边距，并修复了 Maple 主题中的间距和内边距问题

  ## 组件与样式修复

  * 解决了 `<h1-6>` 标签转换问题，该问题会错误地将其转换为 Heading 组件并破坏自定义样式
  * 在控制台中新增了一键切换 AI 助手配置的开关，便于管理

  ## 技术改进与可靠性

  * 增强了更新流程的日志系统，以便更快速地进行调试和问题排查
  * 通过从单文件拉取改为克隆存储库，修复了拥有 10 份以上 OpenAPI/AsyncAPI 规范的客户所遇到的 GitHub 速率限制问题
  * 通过增加备用 LLM 支持、改进限流错误处理以及增强搜索工具功能，提高了 AI 助手的可靠性
</Update>

<Update label="2025 年 8 月 16 日" tags={["Improvements"]} rss={{ title: "每周更新", description: "性能优化、LLM 集成、Web 编辑器优化，以及 API 操作台增强" }}>
  ## 性能与构建优化

  * 在未缓存的 Next.js 无服务器环境中，MDX 转译现已在部署时进行，而非每次页面加载时执行，从而提升未缓存页面的首字节时间 (TTFB) 。
  * 基于内容的哈希可在 MDX 未变化时避免重新转译，将大体量页面客户的更新流程耗时减少约 50% (超过 5 分钟的部署应大致减半) 
  * 在控制台中查看预览部署现已更快：我们在后端新增数据库索引并并行化了查询
  * 通过消除每个页面 `rsc` 负载中的重复 `navigation` 数据降低页面体积——在页面数量多或导航结构复杂时性能提升最明显
  * 更积极的预取使页面更频繁地实现即刻加载

  ## API 操作台与 OpenAPI 增强

  * 将 OpenAPI 到 MCP 的转换移至后端，托管的 MCP 服务器可包含工具 (更清晰的文档与配置选项即将推出) 
  * 为 API 操作台新增 Ruby 支持
  * 新增功能：现在你可以[仅用 docs.json 指定 API 页面](/zh/api-playground/openapi-setup#auto-populate-api-pages)，无需创建任何新的 mdx 文件。
  * 在文档导航中支持来自 OpenAPI 规范的[`webhook pages`](/zh/api-playground/openapi-setup#webhooks)
  * 通过在跳转至 Anthropic、OpenAI 或其他提供方时，从 Markdown 链接中移除锚点参数，优化了 AI 模型上下文

  ## Web 编辑器改进

  * 创建/重命名文件时，点击空白处即可保存更改，而不再需要按 Enter
  * 修复了 branch 导航：将 URL 改为特定 branch 时会被重定向到上次活动的 branch，而非目标位置
  * 对包含 `/` 的 branch 标题进行正确的 URL 编码，防止导航异常
  * 修复了 monorepo 控制台编辑器中的 `Ctrl+K` 链接快捷键，之前会在前面加上文档仓库路径并生成错误链接

  ## Analytics 与 LLM 集成

  * 支持自定义 `llms.txt` 和 `llms-full.txt`——将其添加到文档仓库根目录即可在 `/llms.txt` 和 `/llms-full.txt` 端点提供，便于自定义 LLM
  * 新增 [Hightouch 分析集成](/zh/integrations/analytics/hightouch)
  * 增强了上下文菜单的分析跟踪 (控制台视图即将推出) 
  * 为 `llms.txt` 和 `llms-full.txt` 新增端到端测试，确保正确提供

  ## 组件与样式增强

  * 在 `h{1-4}` 标签中支持自定义 classnames，以应用自定义标题样式
  * 修复了 `h{1-4}` 标签在自定义页面模式下渲染为带徽标片的 `Heading` 组件的问题
  * 为[面包屑](/zh/organize/navigation#breadcrumbs)添加了 CSS 选择器，便于自定义 CSS 定向
  * 通过分析尺寸以在 56px height 下保持比例，修复了被拉伸的 open-graph 图像
  * 在上下文菜单中将 `VSCode` 更正为 `VS Code` (启用时) 
  * 修复了自定义组件内的标题与语义标题一同出现在目录中的问题

  ## Bug 修复与可靠性

  * 通过清理导致生成问题的字符，修复了某些页面标题的 PDF 渲染问题
  * 当遇到空的 OpenAPI JSON 文件时，解决了命令行界面 (CLI) 错误 `Cannot convert undefined or null to object`
  * 修复了自定义 `docs.json` open-graph 元标签被生成标签覆盖的问题
  * 通过对 RSS 链接使用 origin + pathname，修复了在锚点链接落地时 RSS 订阅按钮点击的问题
  * 通过移除 sourcemaps 提升了命令行界面 (CLI) 的下载速度

  ## 技术改进

  * 在 CI 流水线中加入可视化测试，以更早发现回归
  * 增强了错误处理与调试能力
  * 为新功能与边界情况提供了更全面的测试覆盖
</Update>

<Update label="2025年8月9日" tags={["Improvements"]} rss={{ title: "每周更新", description: "Search API、OAuth 优化、资产服务与 MCP 工具" }}>
  ## 认证改进

  * 组级公开访问：通过 `docs.json` 将整个页面组设为公开，这样就不需要在每个页面上设置 `public: true` ([了解更多](https://mintlify.com/docs/authentication-personalization/authentication-setup#group-level)) 
  * 支持在[`OAuth 配置中使用 logoutURL`](https://mintlify.com/docs/authentication-personalization/authentication-setup#implementation-3) 以删除上游 cookies 并完成登出
  * 遇到 OAuth 错误时，用户会被重定向到你指定的 `logoutURL` 以重新开始认证流程
  * 修复了在回调前 OAuth/JWT 流程中短暂闪现 500 错误的问题
  * 在 OAuth/JWT 认证配置中自动剥离 URL 的 `https://` 以防止配置错误

  ## API 操作台增强

  * 新增 [Search API 端点](https://mintlify.com/docs/api-reference/assistant/search)，便于你在文档之上构建代理和 MCP 服务器
  * 现在会在指定路径提供 `openapi` 和 `asyncapi` 文件 (例如 `https://mydocsurl.extension/{openapi-or-file-name}.json`) 
  * 你现在可以在[`openapi 文件中使用 x-mint 字段`](https://mintlify.com/docs/api-playground/openapi-setup#x-mint-extension) 来覆盖生成的字段、自定义前言内容，或更改代码示例中的端点 URL
  * 在 OpenAPI 配置中，[`x-mcp` 现为 `x-mint.mcp`](https://mintlify.com/docs/api-playground/openapi-setup#mcp)，用于控制哪些路由以 MCP 工具的形式暴露

  ## AI 助手更新

  * 修复了当新消息流入时，旧消息的操作菜单 (包含复制、点赞等选项) 消失的问题
  * 修复了上周[托管 MCP 服务器发布](https://mintlify.com/docs/ai/model-context-protocol#accessing-your-mcp-server)后嵌套的 `/mcp/...` 页面可访问性问题

  ## 性能与可靠性

  * 你仓库中的所有图片和视频资产现在都会在你的 domain 的相应路径提供服务。例如，如果你的仓库中有 `/assets/marketing/my-logo.png`，它将可通过 `https://mydocsurl.extension/assets/marketing/my-logo.png` 访问。
  * Mintlify 控制台登录页的邮箱输入框现在会自动聚焦，这样你可以立即开始输入 (易用性提升) 
  * 在 Redis 中同时处理自定义域与子域，以提升导航加载性能 (约 50ms 时延降低) 
  * 为 PDF 导出增加了重试逻辑以提升可靠性
  * 修复了在同意或关闭后 Cookie 同意弹窗仍会再次出现的问题——现在首次选择会被正确尊重
  * 通过在 `navigator.write` 中指定 MIME `type`，修复了在 Safari 上复制页面到剪贴板的问题

  ## 技术改进

  * 针对 Windows 和 pnpm 的 命令行界面 (CLI)  缺陷修复，并加入 CI 测试以防止回归
  * 改进了错误日志输出——为我们工程团队调试带来易用性升级
  * 当缺少 `contentDirectory` 文件时，修复了 broken-link CI 动作的一些小问题
  * 修复了上周因受保护预览修复引发的回归问题，该问题导致导航 UI 中的活动标签页未被正确设置
  * 修复了主题的 light 背景色未应用到活动 Tab 图标的问题
  * 修复了在控制台更改认证类型会先更新然后又切回之前保存类型的问题——现在新选择在保存后会持久生效
  * 面向拥有自定义 UI 库的企业客户的内部 DX 改进——我们更容易在更短周期内纳入你的组件并响应需求
</Update>

<Update label="August 2, 2025" tags={["Improvements"]} rss={{ title: "每周更新", description: "认证改进、搜索增强，以及 Assistant API" }}>
  ## 认证改进

  * 改善本地环境下的认证开发体验，加快该模块的功能迭代与缺陷修复
  * 现已支持对受认证保护站点进行预览部署
  * 修复重定向行为，确保认证后正确返回用户的起始页面
  * 修复完整认证场景下的登出按钮显示问题 (此前仅在部分认证下正常) 

  ## API 操作台增强

  * 修复 API 操作台中的 `multipart/form-data` 文件上传功能
  * 修复锚点链接行为，点击后仅更新 URL，不会滚动到页面顶部
  * 修复嵌套选项卡中的锚点链接问题

  ## AI 助手更新

  * 新增 Assistant API，可集成到你自己的产品中，兼容 AI SDK
  * 为聊天回复新增复制按钮
  * 修复助手中重试消息的问题
  * 优化默认助手提示词，使其默认更为简洁

  ## 性能与可靠性

  * 通过在输入时中止防抖请求，让搜索更为灵敏且准确
  * 为新 CDN 配置资源——预计图片与页面加载速度将很快提升
  * 修复渲染复杂 Mermaid 图表 (如 GANTT) 的缺陷
  * 修复 Windows 上的 CLI 缺陷以提升稳定性，并新增测试防止回归

  ## 技术改进

  * 在 NextJS 应用中加入 OpenTelemetry 追踪，提升客户的首字节时间 (TTFB) 
  * 从 Octokit 迁移到 GitHub API Client，降低网页编辑器体验中的延迟
  * 修复 OpenGraph 的重复 meta 标签
  * 将 MongoDB 从 6 升级到 7，以获得更好的性能和新特性
</Update>

<Update label="July 2025" tags={["New releases", "Improvements"]} rss={{ title: "七月产品更新", description: "Slack 应用集成、托管 MCP 服务器、Cursor 集成，以及性能改进" }}>
  ## Slack 应用

  * 零阻碍访问：Bot 会回复私信、@提及，以及你 `#ask-ai` 频道中的任何问题
  * 一键安装：可在数秒内直接从你的 Mintlify 控制台安装
  * 具备上下文的回答：搜索你的整站文档以提供相关且准确的回复
  * 降低支持干扰：将日常问题转化为即时的自助式答案

  在我们的[Slack 机器人指南](/zh/ai/slack-bot)中了解更多。

  ## 托管 MCP 服务器

  通过 Mintlify 直接部署托管的 Model Context Protocol (MCP) 服务器，以集成到 Claude、Cursor 等 AI 工具。详情见我们的 [MCP 指南](/zh/ai/model-context-protocol)。

  通过上下文菜单，帮助用户在文档任意页面快速将你的 MCP 服务器连接到 Cursor 或 VS Code。更多信息参见[上下文菜单](/zh/ai/contextual-menu)。

  ## 代码块改进

  * 改进语法高亮
  * 新增更多自定义选项，包括专注模式、可展开代码块、深浅色模式自适应、语言下拉菜单、行号与图标
</Update>

<Update label="June 2025" tags={["New releases", "Improvements"]} rss={{ title: "六月产品更新", description: "AI 助手更新与可订阅的更新日志" }}>
  ## AI 助手更新

  * 通过具备工具调用的代理式 RAG 提升准确性
  * 提供可导航的引用页面链接，便于用户直接前往答案来源
  * 为助手生成的代码示例提供复制快捷方式
  * 在文档的代码块上提供“Ask AI”快捷方式，由助手生成解释

  在[助手文档](/zh/assistant/index)中了解更多。

  ## 可订阅的更新日志

  * 从更新日志页面自动生成 RSS 源
  * 将启用 RSS 的更新集成到 Slack、电子邮件及其他工具

  在我们的全新[更新日志指南](/zh/create/changelogs)中了解更多
</Update>

<Update label="May 2025" tags={["Improvements"]}>
  ## API 操作台稳定性更新

  * 通过搜索查找端点
  * 以标签标注已废弃的端点
  * 从导航中隐藏自动生成的 API 页面
  * 上传 multipart 或表单数据文件

  了解更多：[API 操作台文档](/zh/api-playground/)

  ## `mint update`

  现在可以使用 `mint update` 来更新你的命令行界面 (CLI) 。
</Update>

<Update label="2025 年 4 月" tags={["New releases", "Improvements"]}>
  ## Web Editor 3.0

  <Frame>
    ![Webeditor3 Jpe](/images/webeditor3.jpeg)
  </Frame>

  全面提升 WYSIWYG (所见即所得) 编辑器的易用性。

  **重大改进**

  * 使用 ⌘ + P 快捷键按文件名搜索
  * 页面加载速度提升至原来的 10 倍
  * 搜索 branch 时加载更快
  * 页面选项 Tab 可配置布局、标题与用于 SEO (搜索引擎优化) 的 metadata
  * 选中文本时显示浮动工具栏

  **其他修复**

  * 修复更新日志组件的顶部外边距
  * 提升右键交互的可靠性
  * 点击发布后将停留在当前页面，而非跳转到空状态
  * 统一文件 icon 的颜色
  * 连续多次选择新 branch 后的稳定性改进
  * 移除 Diff 模式
  * 通过下拉菜单新建文件夹时的一致性更高
  * 修复尝试取消选择时引用块会继续创建更多引用块的问题

  ## AI 翻译 (测试版) 

  <Frame>
    ![AI Translations graphic](/images/changelog/translations.png)
  </Frame>

  使用 AI 翻译你的全部文档。

  ## 导出文档为 PDF (测试版) 

  将全部文档、某个子目录或单个页面导出为 PDF。

  ## 支持 React hook

  为文档带来交互能力。所有标准的 React hooks 在你的 MDX 文件中将自动可用。[了解更多。](customize/react-components)
</Update>

<Update label="2025 年 3 月" tags={["New releases", "Improvements"]}>
  ## MCP 服务器生成器

  <Frame>
    ![screenshot of MCP server generator](/images/changelog/mcpgenerator.png)
  </Frame>

  生成 MCP 服务器，让 AI 应用能够与你的文档或 API 交互。书面内容会自动生成为 MCP 服务器，你也可以一键从 OpenAPI 规范生成 MCP 服务器。查看[MCP 入门文档。](/zh/ai/model-context-protocol)

  ## 改进

  * 为更新日志添加标签，便于终端用户筛选更新
  * AI Chat 支持 Sonnet-3.7。可在控制台配置你偏好的模型
  * 可在控制台设置中直接更改部署名称

  ## Bug 修复

  * 修复 OG 图片
  * 修复无容器锚点的 icon 样式不一致
  * 优化控制台边框样式细节，提升在移动端/平板/桌面端的响应式表现
  * 在 API 操作台的简洁模式下也显示代码示例
  * Web 编辑器支持 “command + k” 搜索快捷键
  * Callout 内的代码块将扩展以填满 Callout 区域的宽度
</Update>

<Update label="2025年2月" tags={["New releases", "Improvements"]}>
  ## 新的配置架构 `docs.json`

  <Frame>
    ![docs.json 截图](/images/changelog/docsjson.png)
  </Frame>

  我们引入了全新的 `docs.json` 架构以取代 `mint.json`，以支持更强的多级版本管理、更易理解的可视化结构，以及更一致的术语。了解更多变更内容，请[查看我们的博客](https://mintlify.com/blog/refactoring-mint-json-into-docs-json)。

  按以下步骤从 `mint.json` 升级到 `docs.json`：

  1. 确保你的命令行界面 (CLI) 为最新版本

  ```bash
  npm i mint@latest -g
  ```

  1. 在你的文档存储库中运行

  ```bash
  mint upgrade
  ```

  1. 删除旧的 `mint.json` 文件并推送你的更改

  ## CI 检查

  自动对文档进行 lint，查找失效链接、拼写和语法问题，或使用你自己的 Vale 配置来约束写作风格。详见我们的[文档](deploy/ci)。

  ## 面向 LLM 的 .md 支持

  所有文档页面现已自动提供为纯 Markdown 文件——只需在 URL 末尾追加 `.md`。这便于 LLM 吸收你的文档中单个页面的内容。

  ## 更多主题

  <Frame>
    ![带有文本 “Themes v2” 的图形](/images/changelog/themes.png)
  </Frame>

  新增[预构建主题](customize/themes)，用于调整文档的外观与体验。可通过你的 [docs.json 文件](organize/settings) 进行配置。

  现已提供：

  * Maple
  * Palm
  * Willow

  ## 其他改进

  * [技术写作指南：](https://mintlify.com/guides/introduction)编写技术文档的最佳实践，包括受众研究、内容类型与写作技巧。
  * [Dropdown 组件](organize/navigation#dropdowns)：除 Tabs 和锚点外，可使用下拉菜单组织导航。
  * [AI 语法修复器](https://x.com/ricardonunez_io/status/1892334887644123192)：网页编辑器若检测到解析错误，将使用 AI 提出修复建议。
</Update>

<Update label="2025年1月" tags={["Improvements"]}>
  ## AI 助手改进

  * 全新的 UI，提供专用聊天页面与预填提示
  * 稳定性提升。例如，修复误编辑到错误文件或未编辑任何文件的问题
  * 更健全的组件添加与编辑相关知识
  * 优化 `docs.json` 文件编辑体验

  ## 部分认证

  可根据用户权限自定义对任意页面或内容分区的访问。支持接入你自有的认证系统。

  ## 全面焕新的 API 操作台

  我们对 [API 操作台](/zh/api-playground/) 的设计与性能进行了全面升级。更新包括：

  * 更便捷地展开详情以查看字段概览
  * 更直观的嵌套交互。例如，添加或删除条目
  * 更快的响应时间

  ## 质量改进

  * 支持要求认证后才能访问预览部署
</Update>

<Update label="2024年12月">
  ## 认证

  <Frame>
    ![认证截图](/images/changelog/authentication.png)
  </Frame>

  通过设置 JWT (JSON Web Token) 、OAuth 或通用密码，使文档仅限私有访问。借助该隐私控制，你可以创建内部知识库，或防止竞争对手查看你的文档。
</Update>

<Update label="November 2024">
  ## AI Writer

  <Frame>
    ![AI Assistant](/images/changelog/ai-assistant.jpg)
  </Frame>

  现在你可以在结合所有现有文档的上下文下，请求 AI 对文档进行修改。输入提示后，Writer 会通过生成拉取请求 (PR) 来提出修改建议。

  ## GitLab 集成升级

  我们改进了与 GitLab 的同步支持，例如启用自动更新和预览部署。查看我们的[GitLab 文档](/zh/deploy/gitlab)以开始使用。

  ## Web Editor

  <Frame>
    ![Web Editor](/images/changelog/webeditor.jpg)
  </Frame>

  我们重构了 Web Editor，现在你可以在与 Markdown 同步的同时，以完整的 WYSIWYG (所见即所得) 体验来更新文档。

  查看我们的[Web Editor 入门文档](/zh/editor)。

  ## /llms.txt 支持

  <Frame>
    ![llms.txt support](/images/changelog/llms.jpg)
  </Frame>

  所有文档站点现在都会自动在 /llms.txt 和 /llms-full.txt 提供服务，便于 LLM 轻松摄取你的文档。更多信息请阅读[新的 llms.txt 标准文档](https://llmstxt.org)。

  ## 本地化

  你现在可以对文档进行本地化，其工作方式与版本管理类似。为某个版本添加一个 `locale` 后，Mintlify 中固定的内容 (如 “Was this page helpful?”) 也会匹配该 locale。

  ### 质量改进

  * 基于用户当前阅读的版本返回聊天与搜索结果
  * 除了 JWT 或 Shared Session 令牌外，新增支持使用 OAuth 对用户进行身份验证
</Update>

<Update label="2024 年 10 月">
  ## 更新日志

  推出全新的 [Update 组件](/zh/components/update)，让你更轻松地向用户展示并告知更新 (就像这条一样) 。

  <Frame>
    ![更新日志](/images/changelog/changelog.jpg)
  </Frame>

  ## 代码行高亮

  你现在可以在文档中高亮代码行：在语言标识后添加特殊注释，以突出重要部分。使用花括号 `{}`，并用逗号分隔指定的行号或范围。

  ```javascript Line Highlighting Example {1,3,4,5}
  const greeting = "Hello, World!";
  function sayHello() {
    console.log(greeting);
  }
  sayHello();
  ```

  ````mdx
  ```javascript Line Highlighting Example {1,3-5}
  const greeting = "Hello, World!";
  function sayHello() {
    console.log(greeting);
  }
  sayHello();
  ```
  ````

  ## 浅色模式代码块

  代码块现在提供浅色模式变体，可通过在你的 `docs.json` 中添加以下内容启用：

  ```json
  "codeBlock": {
    "mode": "auto"
  }
  ```

  ## 高级页脚

  <Frame>
    ![高级页脚](/images/changelog/advanced-footer.gif)
  </Frame>

  你现在可以在标准页脚中添加更多链接。此升级让着陆页与文档间的体验更一致；如果你想突出显示特定页面 (如社交或状态页) ，也可进行更灵活的自定义。

  ## 基于当前用户的搜索筛选

  启用个性化后，搜索结果将基于当前登录用户进行筛选，仅显示相关内容。

  ## AI Chat 的自定义提示词

  你现在可以自定义 AI 聊天的提示词。如果你希望自定义提示词，请联系 [support](mailto:support@mintlify.com)。

  ## 控制台改进

  * 新增可通过控制台设置将自定义 domain 直接更改为 /docs 的功能。
  * 合并登录与注册页面，降低阻碍与困惑。
  * 实现发现式登录流程，使属于多个组织的用户可以在其间切换。
  * 新增使用 Google OAuth 登录。
  * 新增可通过控制台设置添加新的部署的功能。

  ## 缺陷修复

  * 现在可以在 navigation 中使用前导斜杠。
  * 现在可以在网页编辑器中编辑 CSS 与 JS 文件。
  * 修复了即使启用也不显示 `suggestEdit` 的问题。
  * 修复了搜索与聊天的键盘导航，现在可以使用上下方向键浏览结果。
  * 不允许搜索引擎抓取受用户身份验证保护的页面。
  * 删除组织时重新验证缓存。
  * 现使用 Scalar OpenAPI 解析器解析 OpenAPI 定义，提升性能、修复解析问题，并提供更清晰的错误信息。
  * 现在支持在由 OpenAPI 定义自动生成的 API 参考页面中显示顶层 description。
  * 为 icon 提供内联样式支持。
  * 修复了文档中自定义 CSS 的闪入问题。
  * 在存在链接的情况下，正确显示行内代码样式。
  * 在浏览器中点击返回按钮时保持滚动位置。
</Update>

<Update label="2024年9月">
  ## 自定义字体

  <Frame>
    ![自定义字体](/images/changelog/custom-fonts.jpeg)
  </Frame>

  你可以将文档字体设置为托管在 CDN 上的自有字体，或从 Google Fonts 中选择，使文档更契合你的品牌。

  ## Card 组件中的图片

  在卡片上添加一个 `img` 属性即可在卡片顶部显示图片。了解更多内容请见[这里](/zh/components/cards#image-cards)。

  ## 更新速度优化

  <Frame>
    ![性能改进](/images/changelog/performance-improvements.png)
  </Frame>

  对于大型项目 (约 3,000 个文件) ，文档更新的下载步骤现已提速约 440 倍——用时减少 99.8%。整体而言，更新过程中下载文件的速度现已提升约 5.5 倍——用时减少 81.8%。

  ## SEO 改进

  <Frame>
    ![SEO 改进](/images/changelog/seo-improvements.jpeg)
  </Frame>

  我们修复了文档在移动端和桌面端的布局，使其更符合 SEO (搜索引擎优化) 要求——包括为导航栏和切换元素添加合适的 aria 标签。

  ## 控制台改进

  * 控制台完成 App router 迁移。
  * 控制台中现已提供搜索分析。
  * 控制台中已添加删除组织功能。
  * 上线了 GitLab 连接 UI。
  * 修复了不正确的分析数据。
  * 现在可通过控制台直接购买附加组件。

  ## 错误修复

  * 修复了在自定义模式且侧边栏布局为 `sidenav` 时，顶部栏未能延伸至屏幕宽度的问题。
  * 修复了 AI 小部件的相对定位问题。

  ## 更多

  * **API 页面疑难解答**：API 页面可能较为复杂，因此我们列出了常见问题，帮助你快速排查——[阅读文档](/zh/api-playground/troubleshooting)
</Update>

<Update label="2024年8月">
  ## OpenAPI 参考页面

  * 由 OpenAPI 定义的复杂且递归的端点现在体积缩小 98%。
  * 我们现在在 OpenAPI 页面中展示 [additionalProperties](https://swagger.io/docs/specification/data-models/dictionaries/)。

  ## API 操作台中的文件上传

  默认情况下，API 操作台的请求由 Mintlify 进行代理。现在你可以使用 `disableProxy` 禁用该行为，并支持文件上传等请求类型。

  * [了解更多 API 配置](organize/settings#api-configurations)

  ## 移动端 SEO 改进

  我们修复了文档的移动端布局，使其更符合 SEO (搜索引擎优化) 要求——包括为元素添加合适的 aria 标签。

  ## 支持表单

  我们在 Mintlify 控制台中新增了更详细的支持表单。现在你可以提交表单与我们联系。

  ## 错误修复

  * 修复了 Segment 集成功能的一个问题。
  * 与编辑器交互时，我们现在会针对 GitHub 权限提供更细化的错误信息。
  * 修复了使用直接链接时导航无法正确展开的问题。
</Update>

<Update label="2024年7月">
  ## AI 小部件

  <Frame>
    ![AI 小部件](/images/changelog/widget.png)
  </Frame>

  我们推出了 Mintlify Widget，这是你文档的延伸，可在用户提出问题的时间和地点即时作答。你可以将这个由 AI 驱动的聊天机器人添加到任意网页：你的首页、产品内页面，或现有的文档页面。

  * [阅读博客公告](https://mintlify.com/blog/widget)

  ## API 操作台代码示例同步

  当你浏览 API 文档时，所选代码示例现在会在页面之间同步。

  ## Insights

  目前处于测试阶段，该功能将常见用户问题与模式汇总为易于理解的报告，并提供由 AI 驱动的产品优化建议。
</Update>

<Update label="2024年6月">
  ## 发布周亮点

  * 主题：使用预配置主题自定义样式。只需将 Quill、Prism 或 Venus 主题添加到你的 `docs.json` 文件中，即可更新文档样式。
  * 搜索 V2：可直接检索 OpenAPI 端点的说明和标题，快速抵达 API 参考页面；从搜索中排除隐藏页面，并体验我们升级后的搜索栏 UI。
  * Web 编辑器分支：无需 IDE，即可在我们的 Web 编辑器中创建分支。
  * 用户个性化：通过 Shared Session 或 JWT (JSON Web Token) 对用户进行认证，以便展示定制内容，例如预填 API key 或为特定客户显示专属内容。
  * OpenAPI 自动化升级：为自动填充 API 操作台页面，你可以在 `docs.json` 的 tabs 或 anchors 数组中的对象里添加一个 `openapi` 字段。
</Update>

<Update label="2024年5月">
  ## Okta 单点登录 (SSO) 

  我们现已支持通过 Okta 的 SAML 和 OIDC 登录。

  ## Mintlify REST API

  以编程方式触发文档更新。
</Update>

<Update label="2024年4月">
  ## 自定义模式

  在 metadata 中添加配置，以移除除顶部栏之外的所有元素。示例用法：

  * 使用自定义组件创建全局自定义落地页
  * 添加全屏视频或图片库
  * 嵌入自定义 iFrame 演示元素，为你的文档增加交互性

  查看我们的[自定义模式文档](organize/pages#custom)。
</Update>

<Update label="2024年3月">
  ## 面向 VSCode 的 Mintlify MDX

  无需离开 VSCode，即可调用我们预构建组件和提示的代码片段。[在此安装扩展](https://marketplace.visualstudio.com/items?itemName=mintlify.mintlify-snippets)。
</Update>

<Update label="2024年2月">
  ## 质量改进

  * 控制台升级：查看更新日志以了解变更内容和更新状态；在不同 Mintlify 项目间切换以管理部署
  * 完整支持基于 Tabs 的版本管理
  * 支持通配符重定向
  * 命令行界面 (CLI) 错误检测：本地开发解析出现问题时，我们现在会显示无效 frontmatter 的位置
</Update>

<Update label="2024年1月">
  ## 发布周亮点

  * 预览部署：当你创建拉取请求 (PR；亦称“合并请求”/Merge Request) 时，我们会生成一个唯一链接，实时预览你的文档在生产环境中的效果。你可以将该链接分享给队友。
  * 代码片段 V2：我们现在支持完全可复用的组件和变量，用于片段。
  * 开源 MDX 引擎：我们开放了两个 API——getCompiledMdx 和 MDXComponent——以便你使用 Mintlify 的 Markdown 与代码语法高亮。[欢迎为该项目贡献](https://github.com/mintlify/mdx)。
  * AI 聊天洞察：按日期分段聊天历史、在控制台中提升 AI Chat 配额，并查看特定 query 的出现频率。
</Update>