用途
lore 是面向 AI 编程会话的语义搜索 MCP 服务器，用于检索你和 Claude Code、OpenAI Codex CLI 的历史对话。它解决的核心问题是：随着使用时间增长，本地会积累数百个会话（架构决策、调试过程、代码审查、设计探索等），但没有任何方式可以搜索这些记录，无法回答“当初 auth 中间件采用的是什么方案”这类问题。
主要能力
- 混合搜索（向量 + 关键词）：结合 multilingual-e5-small 嵌入与 FTS5/BM25，通过 Reciprocal Rank Fusion 融合排序，既能按语义也能按精确词项命中结果。
- 多智能体支持：同一数据库同时索引 Claude Code 的 ~/.claude/projects/ 与 Codex CLI 的 ~/.codex/sessions/。Codex 会话按 session_meta 中的 cwd 分组，以 codex-<path> 虚拟项目形式呈现，可合并搜索或仅筛选某一智能体。
- 完全本地、零 API 密钥：嵌入由 ONNX Runtime 运行，存储使用 sqlite-vec，数据不离开设备，除 Node.js 外无额外依赖。
- 自动索引：SessionEnd 钩子会在会话结束时自动在后台索引所有新会话，无需手动触发。
- 后台索引：手动索引触发会立即返回，可在继续工作的同时监控进度，并搜索已完成索引的部分。
- 默认索引、可选排除：所有项目自动索引，可排除不需要的项目，无需注册。
- 会话感知分块：按逻辑轮次（用户提问 + 完整助手响应链）切分，而非任意 token 窗口，能正确处理工具调用链、思考块与多步交互。
- 多语言：支持韩语、日语、中文、英语等 100 多种语言，针对 CJK 的 token 估算保证分块准确。
使用方式
将 lore 添加到 Claude Code 或 OpenAI Codex CLI 后，AI 可直接调用其工具：
- 首次设置：调用 index() 自动扫描全部项目，在后台运行。
- 搜索：直接询问过去对话中的任何内容。
- 排除（可选）：隐藏不需要的嘈杂项目。
存储位置：单个 SQLite 文件 ~/.lore/lore.db，使用 WAL 模式支持并发读取。配置：项目排除项保存在 ~/.lore/config.json。
适用场景
- 查找某个项目过去讨论过的架构决策或技术方案。
- 回溯调试会话、代码审查与设计探索的上下文。
- 同时使用 Claude Code 和 Codex CLI 时，需要跨智能体统一检索历史记录。
- 对数据本地化有要求、不希望对话内容上传到云端的开发者。
技术栈与限制
- 基于 Model Context Protocol SDK（stdio 传输）、@huggingface/transformers 的 multilingual-e5-small（INT8）、better-sqlite3 + sqlite-vec 嵌入式向量数据库、Reciprocal Rank Fusion 混合排序。
- 性能在 Apple Silicon（M 系列）上测量，其他平台的性能数据暂未提供。
- 常见问题处理：出现“No sessions found”时可运行 manage_projects 并选择 action list 查看可用项目；索引被中断产生的锁文件会在下次运行时基于 PID 自动清理；如需重建可删除 ~/.lore/lore.db 后重新索引，源数据 ~/.claude/projects/ 不会被修改。
- 收费、价格与平台支持范围：暂未提供。
