From a86a754a78e6a04bfbbd2deef87d231a7fae4f1c Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 12 Apr 2026 17:38:07 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/concepts/memory-search.md | 44 +++++++++++++++------------- 1 file changed, 23 insertions(+), 21 deletions(-) diff --git a/docs/zh-CN/concepts/memory-search.md b/docs/zh-CN/concepts/memory-search.md index 35c5b10d6..f7fab2aad 100644 --- a/docs/zh-CN/concepts/memory-search.md +++ b/docs/zh-CN/concepts/memory-search.md @@ -2,39 +2,39 @@ read_when: - 你想了解 `memory_search` 的工作原理 - 你想选择一个嵌入提供商 - - 你想调优搜索质量 + - 你想调整搜索质量 summary: 内存搜索如何使用嵌入和混合检索来查找相关笔记 title: 内存搜索 x-i18n: - generated_at: "2026-04-09T16:29:12Z" + generated_at: "2026-04-12T17:37:51Z" model: gpt-5.4 provider: openai - source_hash: ca0237f4f1ee69dcbfb12e6e9527a53e368c0bf9b429e506831d4af2f3a3ac6f + source_hash: 71fde251b7d2dc455574aa458e7e09136f30613609ad8dafeafd53b2729a0310 source_path: concepts/memory-search.md workflow: 15 --- # 内存搜索 -`memory_search` 会从你的内存文件中查找相关笔记，即使措辞与原始文本不同也能找到。它的工作方式是将内存索引为小块，然后使用嵌入、关键词或两者结合进行搜索。 +`memory_search` 会从你的内存文件中查找相关笔记，即使措辞与原文不同也可以。它的工作方式是先将内存索引为较小的分块，然后使用嵌入、关键词或两者结合来搜索这些分块。 ## 快速开始 -如果你已配置 OpenAI、Gemini、Voyage 或 Mistral API 密钥，内存搜索会自动工作。要显式设置提供商： +如果你已配置 OpenAI、Gemini、Voyage 或 Mistral 的 API 密钥，内存搜索会自动工作。要显式设置提供商： ```json5 { agents: { defaults: { memorySearch: { - provider: "openai", // or "gemini", "local", "ollama", etc. + provider: "openai", // 或 "gemini"、"local"、"ollama" 等 }, }, }, } ``` -对于不使用 API 密钥的本地嵌入，请使用 `provider: "local"`（需要 `node-llama-cpp`）。 +如果要在没有 API 密钥的情况下使用本地嵌入，请使用 `provider: "local"`（需要 `node-llama-cpp`）。 ## 支持的提供商 @@ -46,7 +46,7 @@ x-i18n: | Mistral | `mistral` | 是 | 自动检测 | | Bedrock | `bedrock` | 否 | 当 AWS 凭证链可解析时自动检测 | | Ollama | `ollama` | 否 | 本地，必须显式设置 | -| Local | `local` | 否 | GGUF 模型，下载大小约 0.6 GB | +| Local | `local` | 否 | GGUF 模型，约需下载 0.6 GB | ## 搜索如何工作 @@ -66,23 +66,25 @@ flowchart LR - **向量搜索** 会查找语义相近的笔记（“gateway host” 可以匹配 “the machine running OpenClaw”）。 - **BM25 关键词搜索** 会查找精确匹配项（ID、错误字符串、配置键）。 -如果只有一条路径可用（没有嵌入或没有 FTS），则只运行另一条路径。 +如果只有一条路径可用（没有嵌入或没有 FTS），则仅运行另一条路径。 + +当嵌入不可用时，OpenClaw 仍会对 FTS 结果使用词法排序，而不是仅退回到原始精确匹配顺序。这种降级模式会提升那些对查询词覆盖更强、文件路径更相关的分块，因此即使没有 `sqlite-vec` 或嵌入提供商，也能保持不错的召回效果。 ## 提升搜索质量 -当你有大量笔记历史时，有两个可选功能可以提供帮助： +当你有大量笔记历史时，有两个可选功能会很有帮助： ### 时间衰减 -旧笔记的排名权重会逐渐降低，因此较新的信息会优先显示。使用默认的 30 天半衰期时，上个月的笔记得分会降为原始权重的 50%。像 `MEMORY.md` 这样的常青文件永远不会衰减。 +旧笔记的排名权重会逐渐降低，因此最近的信息会优先显示。默认半衰期为 30 天，这意味着上个月的笔记得分会降到原始权重的 50%。像 `MEMORY.md` 这样的常青文件永远不会衰减。 -如果你的智能体拥有数月的每日笔记，且过时信息总是排在最近上下文之前，请启用时间衰减。 +如果你的智能体积累了数月的每日笔记，并且过时信息总是排在最近上下文之前，请启用时间衰减。 ### MMR（多样性） -可减少重复结果。如果五条笔记都提到了相同的路由器配置，MMR 会确保顶部结果覆盖不同主题，而不是重复相同内容。 +可减少重复结果。如果五条笔记都提到同一个路由器配置，MMR 会确保顶部结果覆盖不同主题，而不是反复重复。 如果 `memory_search` 总是从不同的每日笔记中返回几乎重复的片段，请启用 MMR。 @@ -109,22 +111,22 @@ flowchart LR ## 多模态内存 -使用 Gemini Embedding 2 时，你可以在 Markdown 之外一并索引图像和音频文件。搜索查询仍然是文本，但会与视觉和音频内容进行匹配。有关设置，请参阅 [内存配置参考](/zh-CN/reference/memory-config)。 +借助 Gemini Embedding 2，你可以在 Markdown 之外一并索引图像和音频文件。搜索查询仍然是文本，但可以匹配视觉和音频内容。有关设置，请参阅 [内存配置参考](/zh-CN/reference/memory-config)。 ## 会话内存搜索 -你还可以选择为会话转录建立索引，这样 `memory_search` 就能回忆更早的对话。这是通过 `memorySearch.experimental.sessionMemory` 选择启用的。详情请参阅[配置参考](/zh-CN/reference/memory-config)。 +你还可以选择为会话转录建立索引，这样 `memory_search` 就能回忆更早的对话。这是通过 `memorySearch.experimental.sessionMemory` 选择启用的。详见 [配置参考](/zh-CN/reference/memory-config)。 ## 故障排除 -**没有结果？** 运行 `openclaw memory status` 检查索引。如果为空，运行 `openclaw memory index --force`。 +**没有结果？** 运行 `openclaw memory status` 检查索引。如果为空，请运行 `openclaw memory index --force`。 -**只有关键词匹配？** 你的嵌入提供商可能尚未配置。检查 `openclaw memory status --deep`。 +**只有关键词匹配？** 你的嵌入提供商可能尚未配置。请检查 `openclaw memory status --deep`。 -**找不到 CJK 文本？** 使用 `openclaw memory index --force` 重建 FTS 索引。 +**找不到 CJK 文本？** 请使用 `openclaw memory index --force` 重建 FTS 索引。 ## 延伸阅读 -- [Active Memory](/zh-CN/concepts/active-memory) -- 用于交互式聊天会话的子智能体内存 -- [内存](/zh-CN/concepts/memory) -- 文件布局、后端、工具 -- [内存配置参考](/zh-CN/reference/memory-config) -- 所有配置选项 +- [Active Memory](/zh-CN/concepts/active-memory) —— 用于交互式聊天会话的子智能体内存 +- [Memory](/zh-CN/concepts/memory) —— 文件布局、后端、工具 +- [Memory configuration reference](/zh-CN/reference/memory-config) —— 所有配置项