Merge branch 'master' into udf_mva

Author: sanikolaev

deps.txt

@@ -1,7 +1,7 @@
 backup 1.9.6+25070510-5247d066
 buddy 3.36.0+25102120-cdfb9546-dev
 mcl 8.1.0+25100220-e1522a23-dev
-executor 1.3.5+25071517-8398b079
+executor 1.3.6+25102902-defbddd7-dev
 tzdata 1.0.1 250714 7eebffa
 load 1.19.0+25063014-1ff59652
 ---

manual/chinese/Changelog.md

@@ -9,11 +9,13 @@
 
 如果您遵循 [官方安装指南](https://manticoresearch.com/install/)，则无需担心此问题。
 
+### ⚠️ Important
 
 由于配置文件已更新，**您可能会在 Linux 升级期间看到一个警告，询问是否保留您的版本或使用来自软件包的新版本**。如果您有自定义（非默认）配置，建议保留您的版本并将 `pid_file` 路径更新为 `/run/manticore/searchd.pid`。不过，即使您不更改路径，也应能正常工作。
 
 ### 新功能和改进
 * 🆕 [v13.13.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.13.0) 添加了对带有 SI 块缓存的 MCL 8.1.0 的支持。
+* 🆕 [v13.12.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.12.0) Implemented the [secondary_index_block_cache](../Server_settings/Searchd.md#secondary_index_block_cache) option, updated the secondary index API, and inlined sort accessors.
 
 ### Bug 修复
 * 🪲 [v13.11.8](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.8) [问题 #3791](https://github.com/manticoresoftware/manticoresearch/issues/3791) 修复了检查和调用已触发计时器之间的竞态条件。
@@ -23,39 +25,10 @@
 * 🪲 [v13.11.4](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.4) [PR #3765](https://github.com/manticoresoftware/manticoresearch/pull/3765) 修复了别名连接属性的处理。
 * 🪲 [v13.11.3](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.3) [PR #3763](https://github.com/manticoresoftware/manticoresearch/pull/3763) 修复了字符串属性批量连接时可能发生的崩溃问题，并解决了过滤器有时无法与 LEFT JOIN 一起使用的问题。
 * 🪲 [v13.11.2](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.2) [问题 #3065](https://github.com/manticoresoftware/manticoresearch/issues/3065) 修复了在启用 index_field_lengths 的列式表中插入数据时的崩溃。
- 
-## 版本 13.13.0
-**发布时间**：2025年10月7日
-
-### 推荐库
-- 推荐 [MCL](https://github.com/manticoresoftware/columnar) 版本：8.1.0
-- 推荐 [Buddy](Installation/Manticore_Buddy.md#Manticore-Buddy) 版本：3.35.1
-
-如果您遵循[官方安装指南](https://manticoresearch.com/install/)，则无需担心此问题。
-
-### ⚠️ 重要
-该版本的主要亮点是 [自动嵌入](Searching/KNN.md#Auto-Embeddings-%28Recommended%29) — 一项让语义搜索像 SQL 一样简单的新功能。
-
-由于配置文件已更新，**升级过程中在 Linux 上可能会看到是否保留您当前版本或使用包中新版的警告**。如果您有自定义（非默认）配置，建议保留您现有版本，并将 `pid_file` 路径更新为 `/run/manticore/searchd.pid`。不过，即使不更改路径，也应能正常工作。
-
-### 新功能和改进
-* 🆕 [v13.13.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.13.0) 增加了对带有 SI 块缓存的 MCL 8.1.0 的支持。
-- **直接从文本自动生成嵌入**
-- **理解含义而非仅仅关键词的自然语言查询**
-- **支持多种模型**（OpenAI、Hugging Face、Voyage、Jina）
-- **与 SQL 及 JSON API 的无缝集成**
-* 🆕 [v13.12.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.12.0) 实现了 [secondary_index_block_cache](../Server_settings/Searchd.md#secondary_index_block_cache) 选项，更新了二级索引 API，内联了排序访问器。
-
-### Bug 修复
-* 🪲 [v13.11.8](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.8) [问题 #3791](https://github.com/manticoresoftware/manticoresearch/issues/3791) 修复了检测和调用已触发计时器之间的竞态条件。
-* 🪲 [v13.11.7](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.7) [问题 #1045](https://github.com/manticoresoftware/manticoresearch/issues/1045) 修复了 RHEL 8 在 systemd 更新期间 systemctl 警告问题，通过将配置中的过时路径 `/var/run/manticore` 替换为正确的 `/run/manticore`。由于配置文件已更新，升级时可能会看到保留当前版本或使用包中新版本的提示。若为自定义（非默认）配置，建议保留当前配置，并将 `pid_file` 路径更新为 `/run/manticore/searchd.pid`。
-* 🪲 [v13.11.6](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.6) [PR #3766](https://github.com/manticoresoftware/manticoresearch/pull/3766) 新增对 MCL 版本 8.0.6 的支持。
-如果您遵循 [官方安装指南](https://manticoresearch.com/install/)，则无需担心此问题。
-* 🪲 [v13.11.5](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.5) [PR #3767](https://github.com/manticoresoftware/manticoresearch/pull/3767) 改进了中文文档翻译并更新了子模块。
-* 🪲 [v13.11.3](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.3) [PR #3763](https://github.com/manticoresoftware/manticoresearch/pull/3763) 修复了字符串属性批量连接时可能导致的崩溃，并解决了过滤器有时不生效于 LEFT JOIN 的问题。
 * 🪲 [v13.11.1](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.1) [问题 #3751](https://github.com/manticoresoftware/manticoresearch/issues/3751) 修复了启用 embeddings 时删除文档导致的崩溃。
 
 ## 版本 13.11.1
+**发布时间**：2025年9月13日
 
 ### Bug 修复
 * 🪲 [v13.11.1](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.1) [问题 #3751](https://github.com/manticoresoftware/manticoresearch/issues/3751) 修复了启用 embeddings 时删除文档导致的崩溃。
@@ -81,6 +54,7 @@
 
 推荐的 [MCL](https://github.com/manticoresoftware/columnar) 版本：8.0.1
 推荐的 [Buddy](Installation/Manticore_Buddy.md#Manticore-Buddy) 版本：3.34.2
+
 ### 新功能和改进
 * 🆕 [v13.11.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.11.0) [PR #3746](https://github.com/manticoresoftware/manticoresearch/pull/3746) 在 JSON 查询中新增了用于嵌入生成的 “query” 支持。
 如果您遵循 [官方安装指南](https://manticoresearch.com/install/)，则无需担心此问题。
@@ -114,9 +88,6 @@ Recommended [MCL](https://github.com/manticoresoftware/columnar) version: 8.0.1
 Recommended [Buddy](Installation/Manticore_Buddy.md#Manticore-Buddy) version: 3.34.2  
 
 If you follow the [official installation guide](https://manticoresearch.com/install/), you don't need to worry about this.
-* ⚠️ [PR #3586](https://github.com/manticoresoftware/manticoresearch/pull/3586) 停止支持 Debian 10 (Buster)。Debian 10 已于 2024 年 6 月 30 日停止生命周期。建议用户升级到 Debian 11 (Bullseye) 或 Debian 12 (Bookworm)。
-* ⚠️ [v13.0.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.0.0) 更新了 KNN 库 API，支持空的 [float_vector](https://manual.manticoresearch.com/Creating_a_table/Data_types#Float-vector) 值。此更新不更改数据格式，但提高了 Manticore Search / MCL API 版本。
-* ⚠️ [v12.0.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/12.0.0) [PR #3516](https://github.com/manticoresoftware/manticoresearch/pull/3516) 修复了 KNN 索引训练和构建过程中源和目标行 ID 错误的 Bug。此更新不更改数据格式，但提高了 Manticore Search / MCL API 版本。
 
 ### New Features and Improvements
 * 🆕 [v13.6.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.6.0) [ Issue #2226](https://github.com/manticoresoftware/manticoresearch/issues/2226) 支持在 PHRASE、PROXIMITY 和 QUORUM 操作符中显式使用“|”（或）。
@@ -147,6 +118,7 @@ If you follow the [official installation guide](https://manticoresearch.com/inst
 **Released**: 2025年7月8日
 
 ### 重大变更
+* ⚠️ [PR #3586](https://github.com/manticoresoftware/manticoresearch/pull/3586) Support for Debian 10 (Buster) has been discontinued. Debian 10 reached end of life on June 30, 2024. Users are encouraged to upgrade to Debian 11 (Bullseye) or Debian 12 (Bookworm).
 * ⚠️ [v13.0.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/13.0.0) 更新了 KNN 库 API，支持空的 [float_vector](https://manual.manticoresearch.com/Creating_a_table/Data_types#Float-vector) 值。此更新不更改数据格式，但提高了 Manticore Search / MCL API 版本。
 * ⚠️ [v12.0.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/12.0.0) [ PR #3516](https://github.com/manticoresoftware/manticoresearch/pull/3516) 修复了 KNN 索引训练和构建过程中源和目标行 ID 不正确的 bug。此更新不更改数据格式，但提高了 Manticore Search / MCL API 版本。
 * ⚠️ [v11.0.0](https://github.com/manticoresoftware/manticoresearch/releases/tag/11.0.0) 新增支持 KNN 向量搜索的新特性，如量化、重新评分和过采样。此版本更改了 KNN 数据格式和 [KNN_DIST() SQL 语法](https://manual.manticoresearch.com/Searching/KNN?client=SQL#KNN-vector-search)。新版本可读取旧数据，而旧版本无法读取新格式。

manual/chinese/Integration/Filebeat.md

@@ -2,24 +2,23 @@
 
 > 注意：与 Filebeat 的集成需要 [Manticore Buddy](../Installation/Manticore_Buddy.md)。如果无法正常工作，请确保已安装 Buddy。
 
-[Filebeat](https://www.elastic.co/beats/filebeat) 是一个轻量级的转发器，用于转发和集中日志数据。它作为代理安装后，会监控您指定的日志文件或位置，收集日志事件，并将其转发进行索引，通常是发送到 Elasticsearch 或 Logstash。
+[Filebeat](https://www.elastic.co/beats/filebeat) 是一个轻量级的日志数据转发和集中器。安装为代理后，它会监控您指定的日志文件或位置，收集日志事件，并将其转发以进行索引，通常是发送到 Elasticsearch 或 Logstash。
 
-现在，Manticore 也支持将 Filebeat 用作处理流水线。这允许将收集和转换后的数据像发送到 Elasticsearch 一样发送到 Manticore。目前，所有版本直到 9.0 都得到了完全支持。
+现在，Manticore 也支持将 Filebeat 用作处理管道。这允许收集和转换后的数据像发送到 Elasticsearch 一样发送到 Manticore。目前，所有版本到 9.0 都完全支持。
 
 ## Filebeat 配置
 
-配置根据您使用的 Filebeat 版本而异。
+配置因您使用的 Filebeat 版本而异。
 
 ### Filebeat 7.17 - 8.0 的配置
 
-
 ```
 filebeat.inputs:
 - type: log
   enabled: true
-    - /var/log/dpkg.log
   paths:
-	- /var/log/dpkg.log
+    - /var/log/dpkg.log
+  close_eof: true
   scan_frequency: 1s
 
 output.elasticsearch:
@@ -35,21 +34,21 @@ setup.template.pattern: "dpkg_log"
 
 
 ### Filebeat 8.1 - 8.10 的配置
-对于版本 8.1 到 8.10，您需要添加 `allow_older_versions` 选项：
-对于版本 8.1 到 8.10，添加 `allow_older_versions` 选项：
+
+对于 8.1 到 8.10 版本，您需要添加 `allow_older_versions` 选项：
 
 ```
 filebeat.inputs:
 - type: log
   enabled: true
+  paths:
     - /var/log/dpkg.log
-	- /var/log/dpkg.log
   close_eof: true
   scan_frequency: 1s
 
 output.elasticsearch:
   hosts: ["http://localhost:9308"]
-  compression_level: 0
+  index: "dpkg_log"
   compression_level: 0
   allow_older_versions: true
 
@@ -60,15 +59,15 @@ setup.template.pattern: "dpkg_log"
 ```
 
 ### Filebeat 8.11 - 8.19 的配置
-从 8.11 版本开始，默认启用输出压缩，因此必须明确设置 `compression_level: 0` 以确保与 Manticore 的兼容性：
 
+从 8.11 版本开始，默认启用了输出压缩，因此必须显式设置 `compression_level: 0` 以兼容 Manticore：
 
 ```
 filebeat.inputs:
 - type: log
   enabled: true
-    - /var/log/dpkg.log
   paths:
+    - /var/log/dpkg.log
   close_eof: true
   scan_frequency: 1s
 
@@ -83,56 +82,22 @@ setup.template.enabled: false
 setup.template.name: "dpkg_log"
 setup.template.pattern: "dpkg_log"
 ```
-### Filebeat 9.0 及更高版本的配置
-### Filebeat 9.0 - 9.1 的配置
-Filebeat 9.0 引入了重大架构变更，用 `filestream` 替代了 `log` 输入类型。从 9.0 版本开始，默认的文件识别方法也改为指纹识别，这要求文件大小至少为 1024 字节（[参见 issue #44780](https://github.com/elastic/beats/issues/44780)）。为了使 Manticore 兼容任何大小的文件，必须禁用指纹识别。
 
-以下是 Filebeat 9.0 及所有后续版本所需的配置：
-Filebeat 9.0 引入了重大架构变化，替换了日志输入类型为 filestream。以下是所需的配置：
+### Filebeat 9.0+ 的配置
 
-```
-filebeat.inputs:
-- type: filestream
-  id: dpkg-log-input
-  enabled: true
-    - /var/log/dpkg.log
-  paths:
-  prospector.scanner.check_interval: 1s
-  close.on_eof: true
-output.elasticsearch:
-  hosts: ["http://localhost:9308"]
-  index: "dpkg_log"
-  compression_level: 0
-  allow_older_versions: true
-
-setup.ilm.enabled: false
-setup.template.enabled: false
-setup.template.name: "dpkg_log"
-setup.template.pattern: "dpkg_log"
-```
+Filebeat 9.0 引入了重大架构变更，用 `filestream` 替代了 `log` 输入类型。从 9.0 版本开始，默认的文件识别方法也改为指纹识别，这要求文件至少为 1024 字节（[参见 issue #44780](https://github.com/elastic/beats/issues/44780)）。为了使 Manticore 兼容任意大小的文件，必须禁用指纹识别。
 
-**Filebeat 9.0+ 重要说明：**
-- `type: filestream` 输入替代了旧的 `type: log`
-- `prospector.scanner.fingerprint.enabled: false` 设置是 **必需的**，用于禁用基于指纹的文件识别，确保可靠处理小于 1024 字节的文件
-- filestream 输入需要 `id` 字段且必须唯一
-### Filebeat 9.2+ 的配置
-从 Filebeat 9.0 开始，默认的文件识别方法更改为指纹识别，这可能会导致文件处理问题（[参见 issue #44780](https://github.com/elastic/beats/issues/44780)）。为了兼容 Manticore，添加以下行以禁用指纹识别：
+以下是 Filebeat 9.0 及以后版本所需的配置：
 
 ```
-prospector.scanner.fingerprint.enabled: false
-```
-
-
-
 filebeat.inputs:
 - type: filestream
   id: dpkg-log-input
+  enabled: true
   paths:
     - /var/log/dpkg.log
-	- /var/log/dpkg.log
   prospector.scanner.check_interval: 1s
   prospector.scanner.fingerprint.enabled: false
-  close.on_state_change.inactive: 1s
 
 output.elasticsearch:
   hosts: ["http://localhost:9308"]
@@ -141,15 +106,20 @@ output.elasticsearch:
   allow_older_versions: true
 
 setup.ilm.enabled: false
+setup.template.enabled: false
 setup.template.name: "dpkg_log"
 setup.template.pattern: "dpkg_log"
 ```
 
-**注意：** 设置 `prospector.scanner.fingerprint.enabled: false` 允许 Filebeat 处理任意大小的文件。如果您正在处理较大的文件（>1024 字节），可以省略此选项或调整 `prospector.scanner.fingerprint.length` 和 `prospector.scanner.fingerprint.offset` 以满足您的需求。
+**Filebeat 9.0+ 的重要注意事项：**
+- `type: filestream` 输入替代了旧的 `type: log`
+- 必须设置 `prospector.scanner.fingerprint.enabled: false` 来禁用基于指纹的文件识别，确保可靠处理小于 1024 字节的文件
+- filestream 输入需要 `id` 字段，且必须唯一
 
 ## Filebeat 结果
 
-运行此配置的 Filebeat 后，日志数据将被发送到 Manticore 并正确建立索引。以下是 Manticore 创建的表的结果模式以及插入文档的示例：
+一旦使用此配置运行 Filebeat，日志数据将发送到 Manticore 并正确索引。以下是 Manticore 创建的表的结果模式和插入文档的示例：
+
 ```
 mysql> DESCRIBE dpkg_log;
 +------------------+--------+--------------------+
@@ -178,4 +148,3 @@ host: {"name":"logstash-db848f65f-lnlf9"}
 agent: {"ephemeral_id":"587c2ebc-e7e2-4e27-b772-19c611115996","id":"2e3d985b-3610-4b8b-aa3b-2e45804edd2c","name":"logstash-db848f65f-lnlf9","type":"filebeat","version":"7.10.0","hostname":"logstash-db848f65f-lnlf9"}
 log: {"offset":80,"file":{"path":"/var/log/dpkg.log"}}
 ```
-