Memory System
脚本路径: ~/.claude/skills/public/memory-system/scripts/memory.py
环境要求
首次使用前，请安装 Python 依赖：
pip3 install sentence-transformers numpy
-
嵌入模型: all-MiniLM-L6-v2 （~80MB，首次运行自动下载）
-
Python: 3.10+
-
SQLite: 内置，FTS5 可选（增强全文搜索）
自动行为
当用户说"搜索记忆"或"在记忆中查找 X"
python3 ~/.claude/skills/public/memory-system/scripts/memory.py search "用户的查询"
--db ./memory/memory.sqlite --json --top 6
读取 JSON 结果后，用搜索到的上下文回答用户问题。如果数据库不存在，先执行索引。
当用户说"记住这个"或"添加到记忆"
将内容写入 memory/ 目录的 .md 文件：
python3 ~/.claude/skills/public/memory-system/scripts/memory.py add "内容"
--file 合适的文件名.md --dir ./memory --db ./memory/memory.sqlite
当用户说"索引记忆"或"更新记忆索引"
python3 ~/.claude/skills/public/memory-system/scripts/memory.py index
--dir ./memory --db ./memory/memory.sqlite
可选：通过 --memory-file 指定额外索引的文件：
python3 ~/.claude/skills/public/memory-system/scripts/memory.py index
--dir ./memory --db ./memory/memory.sqlite --memory-file ./MEMORY.md
当用户说"记忆状态"或"memory status"
python3 ~/.claude/skills/public/memory-system/scripts/memory.py status
--db ./memory/memory.sqlite -v
当用户说"清理记忆"
python3 ~/.claude/skills/public/memory-system/scripts/memory.py cleanup
--days 90 --dir ./memory --force
注意事项
-
./memory/ 和 --db 路径相对于项目工作目录
-
索引是增量的（SHA256 哈希比对），重复运行不会重新处理未变化的文件
-
搜索使用混合策略：向量相似度(70%) + 全文匹配(30%)
-
--json 输出适合程序解析，不加则人类可读
-
详细配置参考: references/config.md
常见问题
问题 解决方案
ModuleNotFoundError: sentence_transformers
运行 pip3 install sentence-transformers numpy
ModuleNotFoundError: numpy
运行 pip3 install numpy
搜索无结果 先运行 index 命令建立索引
FTS5 不可用 不影响使用，向量搜索仍可工作，仅全文搜索降级
索引后数据库损坏 删除 .sqlite 文件后重新索引