mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
a8f27a0fca
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
2082 lines
107 KiB
Plaintext
2082 lines
107 KiB
Plaintext
---
|
||
title: "产品更新"
|
||
description: "及时了解最新的 Mintlify 产品更新、新功能、平台改进、错误修复和文档工具变更。"
|
||
rss: true
|
||
noindex: true
|
||
---
|
||
|
||
<Update label="May 22, 2026" tags={["New releases", "Improvements"]} rss={{ title: "网页编辑器增强、新工作流、搜索改进等更多更新" }}>
|
||
|
||
<div id="web-editor">
|
||
## 网页编辑器
|
||
</div>
|
||
|
||
我们持续增强网页编辑器，带来多项功能与界面改进。
|
||
|
||
- **更多可编辑文件类型：** 现在可以在网页编辑器中直接打开并编辑更多文件扩展名，同时出于安全考虑会阻止上传可执行文件。
|
||
- **Agent 聊天面板重新布局：** Agent 聊天面板经过重新打磨，现位于文件资源管理器左侧，便于同时聊天与导航。
|
||
- **编辑器设置：** 新的设置面板与重新设计的设置弹窗，让你可以在同一处管理编辑器偏好。详见 [网页编辑器](/zh/editor)。
|
||
- **默认使用文件树导航：** 新入驻用户默认进入文件树视图，而非旧版列表视图。
|
||
- **浏览器标签页标题：** 浏览器标签页名称现在会动态更新为当前文件，便于识别正在编辑的文件。
|
||
|
||
<div id="workflows">
|
||
## 工作流
|
||
</div>
|
||
|
||
- 新增 **Improve content from assistant conversations** 工作流，可分析用户提问趋势并建议文档更新以填补缺口。详见 [Workflows](https://www.mintlify.com/docs/workflows/enable#improve-docs-from-assistant-chats)。
|
||
- 部分工作流现在可以直接配置 **Context repositories**，以便添加工作流运行时应引用的仓库。
|
||
- 工作流设置现在在 **侧边面板** 中打开，而非弹窗，便于在查看 Workflow 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://dashboard.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-workflows">
|
||
## 工作流的 GitLab OAuth
|
||
</div>
|
||
|
||
[工作流](/workflows)现在通过 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`](/zh/cli/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 />`）。
|
||
- [工作流](/workflows)现在会在仪表板收件箱中显示，便于跟踪。工作流列表还会显示 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 文件现在在本地开发期间可以正确渲染。
|
||
- [工作流](/workflows)现在可以从仪表板禁用和重新启用。
|
||
- 助手分析现在在仪表板中显示按来源（Web 与 API）分类的使用情况。
|
||
- 经过身份验证的 MCP 搜索现在可以根据用户的身份验证组正确过滤结果。
|
||
- Slack agent 响应现在显示工具调用摘要，而不是原始工具调用，以更清晰地展示 agent 正在执行的操作。
|
||
- 前置数据中的 `title` 和 `sidebarTitle` 现在优先于侧边栏中的推断元数据。
|
||
- 页面描述中的 MDX 内容现在在经过身份验证的部署上可以正确渲染。
|
||
|
||
<div id="bug-fixes">
|
||
## 错误修复
|
||
</div>
|
||
|
||
- 修复了某些端点的 API playground 请求体构建问题。
|
||
- 修复了编辑器中亮色和暗色模式图像解析的问题。
|
||
- 修复了文本选择工具提示导致的布局偏移。
|
||
- 修复了编辑器中 badge 和图标视觉差异检测的问题。
|
||
- 修复了通过文件路径引用的页面的 OpenAPI 标题和描述无法解析的问题。
|
||
- 修复了[工作流](/workflows)自动合并开关在设置为关闭时无法正确禁用的问题。
|
||
- 修复了 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` 中的导航条目现已支持锚点链接（`#` 链接）。
|
||
- Workflow 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 中显示，提供更个性化的体验。
|
||
- Workflow 模板已更新，包含改进的 prompt。
|
||
- Workflow 运行历史现可从 dashboard 查看，支持监控状态和关闭 PR。
|
||
- Workflow 的 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: "Workflow 模板和 CLI 命令、Agent API v2 等更多功能" }}>
|
||
|
||
<div id="workflow-templates">
|
||
## Workflow 模板
|
||
</div>
|
||
|
||
使用 [dashboard](https://dashboard.mintlify.com/products/workflows) 中的预置模板更快地创建 [workflows](/workflows)。可选择的模板包括：changelog 生成、API 文档同步、功能文档草稿、断链检测、SEO 审计等。模板包含优化的 prompt 和触发器配置，帮助你快速上手。
|
||
|
||
<div id="workflow-cli-command">
|
||
## Workflow CLI 命令
|
||
</div>
|
||
|
||
使用 `mint workflow` CLI 命令从命令行创建 [workflows](/workflows) 文件。交互式提示将引导你完成名称、触发器、上下文和指令的配置。
|
||
|
||
<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/optimize/analytics) dashboard 中按单个页面查看反馈数据。
|
||
|
||
<div id="improvements">
|
||
## 改进
|
||
</div>
|
||
|
||
- 编辑器斜杠命令菜单中现提供 YouTube 和 Loom 嵌入功能
|
||
- 页脚和导航栏内容按语言本地化
|
||
- Slack 助手在处理时显示状态指示器
|
||
- Workflows 现在可以发送包含自动合并状态的 Slack 通知
|
||
- 编辑器现在支持拼写检查
|
||
- 改进了移动端和响应式视图的 dashboard 布局
|
||
|
||
<div id="bug-fixes">
|
||
## 错误修复
|
||
</div>
|
||
|
||
- 修复了 HTTP 重定向状态码，现使用正确的 308 和 307 响应
|
||
- 修复了高级页脚配置下侧边栏闪烁的问题
|
||
- 修复了标签页内第一个元素的外边距间距问题
|
||
- 修复了编辑器刷新问题
|
||
- 修复了 PDF 导出样式问题
|
||
- 修复了 Mint、Maple、Willow 和 Linden 主题中自定义页面的页脚隐藏问题
|
||
- 修复了 `.md` 路由不能从 slug 生成标题的问题
|
||
- 修复了通过 dashboard 创建的 cron workflow 不能自动触发的问题
|
||
- 修复了 workflow 递归运行的问题
|
||
- 修复了 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`，来避免这些错误。
|
||
|
||
## 改进
|
||
|
||
* Workflows 现在支持每天最多运行 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: "使用工作流自动化文档任务，并在编辑器中通过评论和建议协作" }}>
|
||
## Workflows
|
||
|
||
使用[workflows](/workflows)自动化文档相关任务。你可以配置定时或事件触发的自动化流程，由 agent 运行以更新你的文档。
|
||
|
||
Workflows 目前处于测试阶段，现已在 [Enterprise 套餐](https://mintlify.com/pricing) 中提供，很快也将支持 Pro 套餐。
|
||
|
||
## 评论与建议
|
||
|
||
在 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](optimize/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 --> 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)
|
||
* 增强了上下文菜单的分析跟踪 (控制台视图即将推出)
|
||
* 为 `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>
|
||
|
||
</Frame>
|
||
|
||
全面提升 WYSIWYG (所见即所得) 编辑器的易用性。
|
||
|
||
**重大改进**
|
||
|
||
* 使用 ⌘ + P 快捷键按文件名搜索
|
||
* 页面加载速度提升至原来的 10 倍
|
||
* 搜索 branch 时加载更快
|
||
* 页面选项 Tab 可配置布局、标题与用于 SEO (搜索引擎优化) 的 metadata
|
||
* 选中文本时显示浮动工具栏
|
||
|
||
**其他修复**
|
||
|
||
* 修复更新日志组件的顶部外边距
|
||
* 提升右键交互的可靠性
|
||
* 点击发布后将停留在当前页面，而非跳转到空状态
|
||
* 统一文件 icon 的颜色
|
||
* 连续多次选择新 branch 后的稳定性改进
|
||
* 移除 Diff 模式
|
||
* 通过下拉菜单新建文件夹时的一致性更高
|
||
* 修复尝试取消选择时引用块会继续创建更多引用块的问题
|
||
|
||
## AI 翻译 (测试版)
|
||
|
||
<Frame>
|
||
|
||
</Frame>
|
||
|
||
使用 AI 翻译你的全部文档。
|
||
|
||
## 导出文档为 PDF (测试版)
|
||
|
||
将全部文档、某个子目录或单个页面导出为 PDF。
|
||
|
||
## 支持 React hook
|
||
|
||
为文档带来交互能力。所有标准的 React hooks 在你的 MDX 文件中将自动可用。[了解更多。](customize/react-components)
|
||
</Update>
|
||
|
||
<Update label="2025 年 3 月" tags={["New releases", "Improvements"]}>
|
||
## MCP 服务器生成器
|
||
|
||
<Frame>
|
||
|
||
</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>
|
||
|
||
</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>
|
||
|
||
</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>
|
||
|
||
</Frame>
|
||
|
||
通过设置 JWT (JSON Web Token) 、OAuth 或通用密码，使文档仅限私有访问。借助该隐私控制，你可以创建内部知识库，或防止竞争对手查看你的文档。
|
||
</Update>
|
||
|
||
<Update label="November 2024">
|
||
## AI Writer
|
||
|
||
<Frame>
|
||
|
||
</Frame>
|
||
|
||
现在你可以在结合所有现有文档的上下文下，请求 AI 对文档进行修改。输入提示后，Writer 会通过生成拉取请求 (PR) 来提出修改建议。
|
||
|
||
## GitLab 集成升级
|
||
|
||
我们改进了与 GitLab 的同步支持，例如启用自动更新和预览部署。查看我们的[GitLab 文档](/zh/deploy/gitlab)以开始使用。
|
||
|
||
## Web Editor
|
||
|
||
<Frame>
|
||
|
||
</Frame>
|
||
|
||
我们重构了 Web Editor，现在你可以在与 Markdown 同步的同时，以完整的 WYSIWYG (所见即所得) 体验来更新文档。
|
||
|
||
查看我们的[Web Editor 入门文档](/zh/editor)。
|
||
|
||
## /llms.txt 支持
|
||
|
||
<Frame>
|
||
|
||
</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>
|
||
|
||
</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>
|
||
|
||
</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>
|
||
|
||
</Frame>
|
||
|
||
你可以将文档字体设置为托管在 CDN 上的自有字体，或从 Google Fonts 中选择，使文档更契合你的品牌。
|
||
|
||
## Card 组件中的图片
|
||
|
||
在卡片上添加一个 `img` 属性即可在卡片顶部显示图片。了解更多内容请见[这里](/zh/components/cards#image-cards)。
|
||
|
||
## 更新速度优化
|
||
|
||
<Frame>
|
||
|
||
</Frame>
|
||
|
||
对于大型项目 (约 3,000 个文件) ，文档更新的下载步骤现已提速约 440 倍——用时减少 99.8%。整体而言，更新过程中下载文件的速度现已提升约 5.5 倍——用时减少 81.8%。
|
||
|
||
## SEO 改进
|
||
|
||
<Frame>
|
||
|
||
</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>
|
||
|
||
</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)。
|
||
</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> |