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

作者 | Daniel Curtis

译者 | 平川

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 上有关本次发布的讨论帖。

https://www.infoq.com/news/2025/10/docusaurus-3-9-ai-search/

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