Meta 发布 Docusaurus 3.9，新增 AI 搜索功能

Docusaurus 是一个由 Meta 开源团队维护的基于 React 的静态网站生成器。近日，Docusaurus 3.9 版本发布。本次更新的重点是现代化运行时环境，通过 Algolia DocSearch v4 AI 增强搜索能力，并提升国际化（i18n）灵活性，同时向后兼容现有的文档项目。

Docusaurus 3.9 引入了三项关键更新：AI 驱动的搜索、运行时现代化和全球网站管理。在这些新功能中，最引人注目的是全面支持 DocSearch v4 ，将 Algolia 的新特性 Ask AI 直接引入了文档网站。这样，用户就可以通过对话的方式查询内容。该功能使用了一个嵌入式聊天助手，该助手使用网站的索引页面进行了训练。现有项目可以继续使用 DocSearch v3 或逐步升级到 v4 以便解锁 AI 助手。如果要升级的话，开发人员可以使用 npm update @docsearch/react 命令。

该版本将 Node.js 的最低要求提高到 v20.0.0，放弃了对 Node 18 的支持。虽然这一变化可能会影响 CI/CD 管道或容器化构建，但由于 Node 18 已经到达生命周期的终点，不再受支持，所以这没有被视为破坏性更改。也有一些开发人员认为，由于不再支持 Node v18 ，所以它应该被视为破坏性更改。

Docusaurus 3.9 改进了 i18n 配置。现在，开发人员可以使用新引入的 i18n.localeConfigs[locale] 字段覆盖每个语言环境的 baseUrl 和 url 属性，实现多域名或深度本地化部署设置。

对 i18n 的改进还包括一个新的翻译标志，默认设置为 false。对于不使用翻译的网站，该标志可以缩短构建时间。侧边栏还添加了一个新的 key 属性，使开发人员能够显式地为侧边栏条目分配 key 值。

该版本还修复了巴西葡萄牙语和乌克兰语的一些翻译。

其他改进包括支持 Mermaid ELK 布局，实现更丰富的图表渲染，并通过 Rspack 1.5 升级进行内部构建优化。

根据设计，从 3.8 到 3.9 的迁移过程已经最小化。该项目的维护者建议，在升级到 DocSearch v4 时验证 Node.js 版本并检查搜索配置。集成 Ask AI 的团队务必要确保他们的 Algolia 爬虫已经更新，并且在 themeConfig.algolia 部分添加了适当的凭据。除此之外，如果没有 API 层面的破坏性变更，那么大多数网站可以通过简单地更新依赖项来完成升级。

该版本还包括许多其他更改和修复，点击这里可以查看完整的更改列表。

Docusaurus 是一个开源框架，用于基于 React 构建现代文档网站和以内容为驱动的网站。该框架最初由 Meta 和 Facebook 开发并维护，为众多大型开源项目和企业文档网站提供了支持。要了解本次发布的详细内容，可以查看官网或 GitHub 上有关本次发布的讨论帖。

声明：本文为 InfoQ 翻译，未经许可禁止转载。

原文链接：https://www.infoq.com/news/2025/10/docusaurus-3-9-ai-search/