产品更新

​

AI 助手查询分组

​

.mintignore 支持

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

​

Vale 版本升级

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

​

API 操作台改进

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

​

本地化改进

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

​

CLI 改进

• 为在 Node.js 20.17 以下版本上运行 mint dev 的用户新增错误提示，并引导用户升级到 LTS 版本。

​

新功能

• 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 页面上的侧边栏展示问题
• 修复了图片放大弹窗在打开/关闭时的轮廓闪烁问题
• 外部链接现在会正确在新标签页中打开
• 修复了仪表盘设计不一致的问题，并改进了间距

​

Assistant 改进

• Assistant 的入门问题上线了！你可以在仪表盘的 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 登录按钮样式，提升视觉一致性。

​

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” 但没有加号的问题

​

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，以支持相对路径
• 移除助手背景虚化以提升性能

​

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 页面文案，使其更清晰

​

新功能

• 产品导航：使用产品切换器来组织多个产品的文档
• 可访问性命令行界面（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 发布状态管理

​

语言支持扩展

• 在文档界面中新增对罗马尼亚语和捷克语的支持
• 增强了本地化能力，为新增语言提供完整翻译覆盖
• 在文档界面中新增对罗马尼亚语和捷克语的支持

​

界面与用户体验改进

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

​

基础设施与性能增强

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

​

Bug 修复与可靠性

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

​

网页编辑器与控制台登录改进

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

​

认证改进

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

​

Bug 修复与可靠性

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

​

主要发布

• 重大增强：在 404 页面提供 AI 推荐页面，当有人访问失效链接 → AI 智能体读取路径 → 推荐语义相似的页面
• 重大发布：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 字段以默认展开

​

SEO 与界面

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

​

Analytics 与导出

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

​

重大版本发布：增强反馈收集能力

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

​

导航与使用体验改进

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

​

错误修复与可靠性

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

​

组件与样式增强

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

​

性能改进

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

​

图片处理改进

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

​

Web 编辑器与部署增强

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

​

认证与导航改进

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

​

组件与样式修复

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

​

技术改进与可靠性

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

​

性能与构建优化

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

​

API 操作台与 OpenAPI 增强

• 将 OpenAPI 到 MCP 的转换移至后端，托管的 MCP 服务器可包含工具（更清晰的文档与配置选项即将推出）
• 为 API 操作台新增 Ruby 支持
• 新增功能：现在你可以仅用 docs.json 指定 API 页面，无需创建任何新的 mdx 文件。
• 在文档导航中支持来自 OpenAPI 规范的webhook pages
• 通过在跳转至 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 分析集成
• 增强了上下文菜单的分析跟踪（控制台视图即将推出）
• 为 llms.txt 和 llms-full.txt 新增端到端测试，确保正确提供

​

组件与样式增强

• 在 h{1-4} 标签中支持自定义 classnames，以应用自定义标题样式
• 修复了 h{1-4} 标签在自定义页面模式下渲染为带徽标片的 Heading 组件的问题
• 为面包屑添加了 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 流水线中加入可视化测试，以更早发现回归
• 增强了错误处理与调试能力
• 为新功能与边界情况提供了更全面的测试覆盖

​

认证改进

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

​

API 操作台增强

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

​

AI 助手更新

• 修复了当新消息流入时，旧消息的操作菜单（包含复制、点赞等选项）消失的问题
• 修复了上周托管 MCP 服务器发布后嵌套的 /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 改进——我们更容易在更短周期内纳入你的组件并响应需求

​

认证改进

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

​

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，以获得更好的性能和新特性

​

Slack 应用

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

​

托管 MCP 服务器

​

代码块改进

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

​

AI 助手更新

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

​

可订阅的更新日志

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

​

API 操作台稳定性更新

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

​

mint update

​

Web Editor 3.0

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

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

​

AI 翻译（测试版）

​

导出文档为 PDF（测试版）

​

支持 React hook

​

MCP 服务器生成器

​

改进

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

​

Bug 修复

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

​

新的配置架构 docs.json

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

npm i mint@latest -g

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

mint upgrade

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

​

CI 检查

​

面向 LLM 的 .md 支持

​

更多主题

• Maple
• Palm
• Willow

​

其他改进

• 技术写作指南：编写技术文档的最佳实践，包括受众研究、内容类型与写作技巧。
• Dropdown 组件：除 Tabs 和锚点外，可使用下拉菜单组织导航。
• AI 语法修复器：网页编辑器若检测到解析错误，将使用 AI 提出修复建议。

​

AI 助手改进

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

​

部分认证

​

全面焕新的 API 操作台

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

​

质量改进

• 支持要求认证后才能访问预览部署

​

认证

​

AI Writer

​

GitLab 集成升级

​

Web Editor

​

/llms.txt 支持

​

本地化

​

质量改进

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

​

更新日志

​

代码行高亮

const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();

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

​

浅色模式代码块

"codeBlock": {
  "mode": "auto"
}

​

高级页脚

​

基于当前用户的搜索筛选

​

AI Chat 的自定义提示词

​

控制台改进

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

​

缺陷修复

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

​

自定义字体

​

Card 组件中的图片

​

更新速度优化

​

SEO 改进

​

控制台改进

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

​

错误修复

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

​

更多

• API 页面疑难解答：API 页面可能较为复杂，因此我们列出了常见问题，帮助你快速排查——阅读文档

​

OpenAPI 参考页面

• 由 OpenAPI 定义的复杂且递归的端点现在体积缩小 98%。
• 我们现在在 OpenAPI 页面中展示 additionalProperties。

​

API 操作台中的文件上传

• 了解更多 API 配置

​

移动端 SEO 改进

​

支持表单

​

错误修复

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

​

AI 小部件

• 阅读博客公告

​

Pro 方案

• 阅读博客公告

​

API 操作台代码示例同步

​

Insights

​

发布周亮点

• 主题：使用预配置主题自定义样式。只需将 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 字段。

​

Okta 单点登录（SSO）

​

Mintlify REST API

​

自定义模式

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

​

面向 VSCode 的 Mintlify MDX

​

质量改进

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

​

发布周亮点

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