名称： vector-memory
描述： 智能记忆搜索，支持自动向量回退。在可用时使用语义嵌入，否则回退到内置搜索。零配置——安装 ClawHub 后立即可用。无需设置，安装后 memory_search 立即生效，可选同步后效果更佳。

向量记忆

智能记忆搜索，自动选择最佳方法：
- 向量搜索（语义理解，高质量）同步后可用
- 内置搜索（关键词匹配，快速）作为备用方案

无需任何配置。 安装后立即生效。

快速开始

通过 ClawHub 安装

npx clawhub install vector-memory

完成！memory_search 现已支持自动方法选择。

可选：同步以获得更好效果

node vector-memory/smart_memory.js --sync

同步后，搜索将使用神经嵌入进行语义理解。

工作原理

智能选择

// 同一调用，自动选择最佳方法
memory_search("James principles values") 

// 如果向量就绪：找到“autonomy, competence, creation”（语义匹配）
// 如果未就绪：使用关键词搜索（回退）

行为流程

1. 检查：向量索引是否就绪？
2. 是：使用语义搜索（同义词、概念）
3. 否：使用内置搜索（关键词）
4. 向量失败：自动回退

工具

memory_search

自动选择最佳方法

参数：
- query (字符串)：搜索查询
- max_results (数字)：最大结果数（默认：5）

返回：匹配项，包含路径、行号、分数、片段

memory_get

从文件中获取完整内容。

memory_sync

为向量搜索索引记忆文件。编辑后运行。

memory_status

检查当前激活的方法。

对比

使用方式

立即使用（无需操作）：

node vector-memory/smart_memory.js --search "查询内容"

更高质量（同步后）：

# 一次性设置
node vector-memory/smart_memory.js --sync

# 现在所有搜索都使用向量
node vector-memory/smart_memory.js --search "查询内容"

文件

配置

无需配置。

可选环境变量：

export MEMORY_DIR=/path/to/memory
export MEMORY_FILE=/path/to/MEMORY.md

扩展性

• < 1000 个块：内置 + JSON（当前方案）
• > 1000 个块：使用 pgvector（参见 references/pgvector.md）

参考

• 集成 - 详细设置说明
• pgvector - 大规模部署指南