全面提升 WYSIWYG (所见即所得) 编辑器的易用性。
**重大改进**
* 使用 ⌘ + P 快捷键按文件名搜索
* 页面加载速度提升至原来的 10 倍
* 搜索 branch 时加载更快
* 页面选项 Tab 可配置布局、标题与用于 SEO (搜索引擎优化) 的 metadata
* 选中文本时显示浮动工具栏
**其他修复**
* 修复更新日志组件的顶部外边距
* 提升右键交互的可靠性
* 点击发布后将停留在当前页面，而非跳转到空状态
* 统一文件 icon 的颜色
* 连续多次选择新 branch 后的稳定性改进
* 移除 Diff 模式
* 通过下拉菜单新建文件夹时的一致性更高
* 修复尝试取消选择时引用块会继续创建更多引用块的问题
## AI 翻译 (测试版)
使用 AI 翻译你的全部文档。
## 导出文档为 PDF (测试版)
将全部文档、某个子目录或单个页面导出为 PDF。
## 支持 React hook
为文档带来交互能力。所有标准的 React hooks 在你的 MDX 文件中将自动可用。[了解更多。](customize/react-components)
生成 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 区域的宽度
我们引入了全新的 `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 吸收你的文档中单个页面的内容。
## 更多主题
新增[预构建主题](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 提出修复建议。
通过设置 JWT (JSON Web Token) 、OAuth 或通用密码，使文档仅限私有访问。借助该隐私控制，你可以创建内部知识库，或防止竞争对手查看你的文档。
现在你可以在结合所有现有文档的上下文下，请求 AI 对文档进行修改。输入提示后，Writer 会通过生成拉取请求 (PR) 来提出修改建议。
## GitLab 集成升级
我们改进了与 GitLab 的同步支持，例如启用自动更新和预览部署。查看我们的[GitLab 文档](/zh/deploy/gitlab)以开始使用。
## Web Editor
我们重构了 Web Editor，现在你可以在与 Markdown 同步的同时，以完整的 WYSIWYG (所见即所得) 体验来更新文档。
查看我们的[Web Editor 入门文档](/zh/editor)。
## /llms.txt 支持
所有文档站点现在都会自动在 /llms.txt 和 /llms-full.txt 提供服务，便于 LLM 轻松摄取你的文档。更多信息请阅读[新的 llms.txt 标准文档](https://llmstxt.org)。
## 本地化
你现在可以对文档进行本地化，其工作方式与版本管理类似。为某个版本添加一个 `locale` 后，Mintlify 中固定的内容 (如 “Was this page helpful?”) 也会匹配该 locale。
### 质量改进
* 基于用户当前阅读的版本返回聊天与搜索结果
* 除了 JWT 或 Shared Session 令牌外，新增支持使用 OAuth 对用户进行身份验证
## 代码行高亮
你现在可以在文档中高亮代码行：在语言标识后添加特殊注释，以突出重要部分。使用花括号 `{}`，并用逗号分隔指定的行号或范围。
```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"
}
```
## 高级页脚
你现在可以在标准页脚中添加更多链接。此升级让着陆页与文档间的体验更一致；如果你想突出显示特定页面 (如社交或状态页) ，也可进行更灵活的自定义。
## 基于当前用户的搜索筛选
启用个性化后，搜索结果将基于当前登录用户进行筛选，仅显示相关内容。
## AI Chat 的自定义提示词
你现在可以自定义 AI 聊天的提示词。如果你希望自定义提示词，请联系 [support](mailto:support@mintlify.com)。
## 控制台改进
* 新增可通过控制台设置将自定义 domain 直接更改为 /docs 的功能。
* 合并登录与注册页面，降低阻碍与困惑。
* 实现发现式登录流程，使属于多个组织的用户可以在其间切换。
* 新增使用 Google OAuth 登录。
* 新增可通过控制台设置添加新的部署的功能。
## 缺陷修复
* 现在可以在 navigation 中使用前导斜杠。
* 现在可以在网页编辑器中编辑 CSS 与 JS 文件。
* 修复了即使启用也不显示 `suggestEdit` 的问题。
* 修复了搜索与聊天的键盘导航，现在可以使用上下方向键浏览结果。
* 不允许搜索引擎抓取受用户身份验证保护的页面。
* 删除组织时重新验证缓存。
* 现使用 Scalar OpenAPI 解析器解析 OpenAPI 定义，提升性能、修复解析问题，并提供更清晰的错误信息。
* 现在支持在由 OpenAPI 定义自动生成的 API 参考页面中显示顶层 description。
* 为 icon 提供内联样式支持。
* 修复了文档中自定义 CSS 的闪入问题。
* 在存在链接的情况下，正确显示行内代码样式。
* 在浏览器中点击返回按钮时保持滚动位置。
你可以将文档字体设置为托管在 CDN 上的自有字体，或从 Google Fonts 中选择，使文档更契合你的品牌。
## Card 组件中的图片
在卡片上添加一个 `img` 属性即可在卡片顶部显示图片。了解更多内容请见[这里](/zh/components/cards#image-cards)。
## 更新速度优化
对于大型项目 (约 3,000 个文件) ，文档更新的下载步骤现已提速约 440 倍——用时减少 99.8%。整体而言，更新过程中下载文件的速度现已提升约 5.5 倍——用时减少 81.8%。
## SEO 改进
我们修复了文档在移动端和桌面端的布局，使其更符合 SEO (搜索引擎优化) 要求——包括为导航栏和切换元素添加合适的 aria 标签。
## 控制台改进
* 控制台完成 App router 迁移。
* 控制台中现已提供搜索分析。
* 控制台中已添加删除组织功能。
* 上线了 GitLab 连接 UI。
* 修复了不正确的分析数据。
* 现在可通过控制台直接购买附加组件。
## 错误修复
* 修复了在自定义模式且侧边栏布局为 `sidenav` 时，顶部栏未能延伸至屏幕宽度的问题。
* 修复了 AI 小部件的相对定位问题。
## 更多
* **API 页面疑难解答**：API 页面可能较为复杂，因此我们列出了常见问题，帮助你快速排查——[阅读文档](/zh/api-playground/troubleshooting)
我们推出了 Mintlify Widget，这是你文档的延伸，可在用户提出问题的时间和地点即时作答。你可以将这个由 AI 驱动的聊天机器人添加到任意网页：你的首页、产品内页面，或现有的文档页面。
* [阅读博客公告](https://mintlify.com/blog/widget)
## API 操作台代码示例同步
当你浏览 API 文档时，所选代码示例现在会在页面之间同步。
## Insights
目前处于测试阶段，该功能将常见用户问题与模式汇总为易于理解的报告，并提供由 AI 驱动的产品优化建议。