> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# 产品更新

> 新版本与功能改进

<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/ai/agent) 现在可以基于[与 AI 助手的对话](/zh/ai/suggestions#conversation-insights)来建议文档更新。启用后，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/ai/agent#customize-agent-behavior)。
  * 如果你在控制台[连接你的账号](/zh/ai/agent#connect-your-github-account)，Agent 现在会以你的 GitHub 账号身份打开 PR。

  ## AI 助手功能改进

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

  ## Web 编辑器功能改进

  * 在编辑器工具栏中新增[可分享的预览链接](/zh/editor#share-preview-deployments)。
  * 更新了[发布流程](/zh/editor#publish-your-changes)，支持一键发布或创建拉取请求（PR）。
  * 在 Web 编辑器中进行编辑时不再需要使用 GitHub 登录。

  ## 上手流程改进

  * 在注册过程中，你可以选择使用由 Mintlify 托管的文档存储库或你自己的存储库。
  * 在不关联 GitHub 账号的情况下创建文档站点。

  ## 代码片段（snippets）功能改进

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

  ## 本地化改进

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

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

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

  ## Slack 和 Discord 中的问答机器人

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

  这些机器人会响应 `@` 提及，以及所有位于名为 `#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#param-timestamp) 标志即可开启此功能。

  启用后，每个页面都会自动显示其最近一次更新的时间，帮助读者了解内容的时效性。
</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 规范中定义在端点级别的路径参数缺失的问题。现在定义在各个 operation 之上的参数会正确包含在主页面和操作台中。
  * 增强了响应示例的生成逻辑，即使示例中只指定了部分字段，也会包含所有必填属性，从而保证响应示例完整且准确。
  * 修复了对象数组中预填示例缺失的问题。带有示例数据的数组项现在会在操作台中按照正确的索引位置被正确预填。
  * 改进了 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 --> 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\_pull\_requests 和 list\_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\_external\_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#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/ai/assistant)中了解更多。

  ## 可订阅的更新日志

  * 从更新日志页面自动生成 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>
    <img src="https://mintcdn.com/anotherhorizon/c56XyBFaIRu-DtQw/images/webeditor3.jpeg?fit=max&auto=format&n=c56XyBFaIRu-DtQw&q=85&s=46515a6182c7ace38cdc03b63bead0dd" alt="Webeditor3 Jpe" width="3240" height="3240" data-path="images/webeditor3.jpeg" />
  </Frame>

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

  **重大改进**

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

  **其他修复**

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

  ## AI 翻译（测试版）

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/translations.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=d85fcbf4de8dd194c8ebf54c37c89e3a" alt="AI Translations graphic" width="995" height="611" data-path="images/changelog/translations.png" />
  </Frame>

  使用 AI 翻译你的全部文档。[了解更多。](organize/navigation#localization)

  ## 导出文档为 PDF（测试版）

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

  ## 支持 React hook

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

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

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/mcpgenerator.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=ba5ff9bce7dc06e5aa8ea9a125f773e4" alt="screenshot of MCP server generator" width="1200" height="675" data-path="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>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/docsjson.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=da701a36041c9ce53a15d57080fe8ee0" alt="docs.json 截图" width="1200" height="630" data-path="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 theme={null}
  npm i mint@latest -g
  ```

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

  ```bash theme={null}
  mint upgrade
  ```

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

  ## CI 检查

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

  ## 面向 LLM 的 .md 支持

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

  ## 更多主题

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/themes.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=5f6e88fcbe6579e169ffff326c9d61fb" alt="带有文本 “Themes v2” 的图形" width="1200" height="630" data-path="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>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/authentication.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=5c3d578ea7a30c076c70f1ae49a93296" alt="认证截图" width="1200" height="630" data-path="images/changelog/authentication.png" />
  </Frame>

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

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

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/ai-assistant.jpg?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=f5c479bd5b04cf24a9951ef736685bff" alt="AI Assistant" width="1280" height="800" data-path="images/changelog/ai-assistant.jpg" />
  </Frame>

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

  ## GitLab 集成升级

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

  ## Web Editor

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/webeditor.jpg?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=9e0db58bebbb606f34f8fb27062bce99" alt="Web Editor" width="5760" height="3520" data-path="images/changelog/webeditor.jpg" />
  </Frame>

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

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

  ## /llms.txt 支持

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/llms.jpg?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=3cbb1545c7bfb623d806787d729ddc0e" alt="llms.txt support" width="1200" height="630" data-path="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>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/changelog.jpg?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=33621ea816c94f4023850c7e0e829b8a" alt="更新日志" width="4800" height="2520" data-path="images/changelog/changelog.jpg" />
  </Frame>

  ## 代码行高亮

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

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

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

  ## 浅色模式代码块

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

  ```json theme={null}
  "codeBlock": {
    "mode": "auto"
  }
  ```

  ## 高级页脚

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/advanced-footer.gif?s=3a5600bfaf8e368d37c703b037f2be97" alt="高级页脚" width="1040" height="720" data-path="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>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/custom-fonts.jpeg?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=d48771887f72b8861a8c22d0b5532500" alt="自定义字体" width="2048" height="1075" data-path="images/changelog/custom-fonts.jpeg" />
  </Frame>

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

  ## Card 组件中的图片

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

  ## 更新速度优化

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/performance-improvements.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=1102d480bd6da618600f50eeb23538b6" alt="性能改进" width="1800" height="945" data-path="images/changelog/performance-improvements.png" />
  </Frame>

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

  ## SEO 改进

  <Frame>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/seo-improvements.jpeg?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=50515995c4797b0d4e98c12cecb1d345" alt="SEO 改进" width="2048" height="1075" data-path="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>
    <img src="https://mintcdn.com/anotherhorizon/xUu33r2fE-ckWJ-B/images/changelog/widget.png?fit=max&auto=format&n=xUu33r2fE-ckWJ-B&q=85&s=3a1c1f281e2d52ce353789f251b245fe" alt="AI 小部件" width="1548" height="1021" data-path="images/changelog/widget.png" />
  </Frame>

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

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

  ## Pro 方案

  我们也更新了定价方案，以获得更好的可定制性和扩展性。

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

  ## 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-mode)。
</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>
