发布日期: 2025-12-08
版本号: v1.29.0

这是Meilisearch v1.29.0的更新摘要。构建现在需要git二进制文件以填充版本信息，提升了构建性能。主要改进包括：新的设置索引器扩展了支持范围，能处理searchableAttributes、exactAttributes、proximityPrecision和embedders的组合变更，提供更好扩展性和操作进度显示；新创建的索引默认使用性能更好的新向量存储后端；HuggingFace嵌入器现在支持更多本地模型。修复了实验性向量存储中的一个罕见内部错误。维护方面，CI流水线显著提速至30分钟内并增加了自动化测试，同时调整了macOS和Windows测试策略。此外，由于编译问题，macOS AMD64版本的二进制文件暂时不可用，苹果芯片版本正常。

更新内容 （中文）

构建兼容性说明

构建时必须存在 git 二进制文件，以填充 /version 字段的 commitSha1 字段。

此更改是出于构建性能考虑。

由 @dureuill 提交于 https://github.com/meilisearch/meilisearch/pull/6030

🌈 改进

设置索引器的另一部分已可用：可搜索与精确属性

新的设置索引器具有更好的扩展性，支持近即时取消操作，并能显示索引操作进度。

此前，新的设置索引器仅在设置批处理中唯一变更嵌入器设置时启用。在 Meilisearch v1.29.0 中，只要变更包含以下任意组合，新的设置索引器即会启用：

  • searchableAttributes（可搜索属性）
  • exactAttributes（精确属性）
  • proximityPrecision（邻近精度）
  • embedders（嵌入器，与之前相同）

批处理中出现任何其他设置变更，都将导致该批处理使用传统设置索引器。 此外，新的设置索引器目前默认为云用户禁用。

希望禁用新设置索引器的自托管用户，应将环境变量 MEILI_EXPERIMENTAL_NO_EDITION_2024_FOR_SETTINGS 设置为 true。

由 @Kerollmops 提交于 https://github.com/meilisearch/meilisearch/pull/5983

为新索引默认启用新的向量存储

Meilisearch v1.21.0 引入了新的向量存储后端，提供更好的性能和相关性。

从 v1.29.0 开始，任何新创建的索引都将默认使用新后端。 现有索引将保持不变。

仍然可以显式选择向量存储后端，请参阅相关的实验性功能讨论页面。

由 @Kerollmops 提交于 https://github.com/meilisearch/meilisearch/pull/6004

为 huggingFace 嵌入器支持更多模型

现在，当使用 huggingFace 嵌入器在 CPU 或 GPU 上本地生成嵌入向量时，您可以选择具有 XLM Roberta 架构的模型。

由 @qdequele 提交于 https://github.com/meilisearch/meilisearch/pull/6018

🦋 错误修复

🔧 维护与杂项

上周是“提升生活质量”的一周，虽然我们仍有一些改进在推进，但大部分工作都投入到了维护任务中。

最值得注意的是，CI 现在更快了，从超过一小时缩短到不到 30 分钟，并且也更加可靠，因为它会自动测试无转储升级。

资源可用性说明

⚠️ 由于编译疏漏，meilisearch-enterprise-macos-amd64 和 meilisearch-macos-amd64 版本的 Meilisearch 二进制文件不可用。https://github.com/meilisearch/meilisearch/pull/6037 旨在为未来的发布修复此问题。

较新的 meilisearch-enterprise-macos-apple-silicon 和 meilisearch-macos-apple-silicon 版本没有问题。

完整更新日志：https://github.com/meilisearch/meilisearch/compare/v1.28.2…v1.29.0

更新内容 （原始）

Build compatibility note

The git binary must now be present at build time to populate the commitSha1 field of the /version field.

This change was made for build performance reasons.

by @dureuill in https://github.com/meilisearch/meilisearch/pull/6030

🌈 Improvements

Another piece of the settings indexer is available: searchable and exact attributes

The new settings indexer scales better, supports near-instant cancellations and displays the progress of the indexing operation.

Previously, the new settings indexer was enabled only if the only changes in a settings batch were to embedder settings. In Meilisearch v1.29.0, the new settings indexer will be enabled if the change is any combination of:

  • searchableAttributes
  • exactAttributes
  • proximityPrecision
  • embedders (as before)

Any other change to settings appearing in a batch will cause the batch to use the legacy settings indexer. Additionally, the new settings indexer is currently disabled by default for Cloud users.

OSS users who would like to disable the new settings indexer should pass the MEILI_EXPERIMENTAL_NO_EDITION_2024_FOR_SETTINGS environment variable to true.

by @Kerollmops in https://github.com/meilisearch/meilisearch/pull/5983

Enable the new vector store by default for new indexes

Meilisearch v1.21.0 introduced a new vector store backend providing better performance and relevancy.

Starting with v1.29.0, any newly created index will default to the new backend. Existing indexes will be left unchanged.

It is still possible to explicitly choose the vector store backend, please refer to the relevant experimental feature discussion page.

by @Kerollmops in https://github.com/meilisearch/meilisearch/pull/6004

Support more models for huggingFace embedder

You can now select models with the XLM Roberta architecture when generating embeddings locally on CPU or GPU with the huggingFace embedder.

by @qdequele in https://github.com/meilisearch/meilisearch/pull/6018

🦋 Bug fixes

🔧 Maintenance and Misc.

Last week was a Quality of Life week, and while we still had improvements in the pipe, the bulk of our work was dedicated to maintenance tasks.

Most notably, the CI is now faster, going from over one hour to less than 30 minutes, and also more reliable as it automatically tests the dumpless upgrade.

Asset availability note

⚠️ The Meilisearch binary is not available for meilisearch-enterprise-macos-amd64 and meilisearch-macos-amd64 due to a compilation oversight. https://github.com/meilisearch/meilisearch/pull/6037 aims at fixing this for future releases.

The more recent meilisearch-enterprise-macos-apple-silicon and meilisearch-macos-apple-silicon are fine.

Full Changelog: https://github.com/meilisearch/meilisearch/compare/v1.28.2...v1.29.0

下载链接