# session-indexer

面向开发者的 Claude Code 会话记录索引与语义搜索工具：将 JSONL 转为 SQLite，并支持基于 Ollama 的 bge-m3 语义检索及 FTS5 回退搜索。

- Findings24: <https://findings24.com/zh-CN/products/session-indexer>
- 网站: <https://valpere.github.io/projects/session-indexer/>
- 价格: Freemium
- 分类: AI开发者工具, AI搜索引擎

## 什么是 session-indexer？

session-indexer 是一款面向开发者的工具，用于按项目搜索 Claude Code 会话历史。它会将 JSONL 会话记录索引到 SQLite 中，然后通过 Ollama 使用 bge-m3 嵌入提供语义搜索，无法使用嵌入检索时则可回退到 FTS5。

该项目以 GitHub 仓库形式呈现，面向希望获得 Claude Code 会话本地可查询记录的开发者，而不是通用的笔记或搜索应用。它的核心用途是将记录文件转换为可搜索索引，让用户更容易找到过去的会话。

## session-indexer 能做什么？

### 将 JSONL 会话记录索引到 SQLite

项目将会话历史存储在 SQLite 中，使记录数据可以在结构化的本地数据库中查询，而不只是保留为原始文件。

### 使用 bge-m3 嵌入进行语义检索

页面描述指出，搜索通过 Ollama 使用 bge-m3 嵌入完成，表明它支持基于含义的匹配，而不只依赖精确文本。

### 支持 FTS5 回退搜索

在不使用或无法使用语义检索时，项目可以回退到 SQLite FTS5，为已索引的记录内容提供文本搜索路径。

### 按项目限定会话范围

产品被描述为针对 Claude Code 历史记录的按项目搜索，表明索引围绕单个项目上下文组织，而不是集中管理所有记录。

### 仓库包含项目文档

仓库包含 docs 目录和 .claude 目录，表明使用说明以及项目特定的配置或文档属于代码库的一部分。

## 使用场景

### 在一个项目中查找之前的 Claude Code 讨论

开发者可以搜索特定项目的会话历史，以找回早期 Claude Code 工作中的决策、命令或故障排查过程。

### 按含义而非精确措辞查找信息

当用户记得会话主题但不记得记录中使用的确切短语时，语义搜索会很有用。

### 嵌入检索不可用时进行搜索

如果未使用嵌入检索路径，FTS5 可为仍需在已索引记录上进行文本检索的用户提供回退方案。

### 维护结构化的会话记录归档

开发者可以将 JSONL 会话记录保存在 SQLite 中，以便之后更容易查看和复用会话历史。

## 常见问题

### session-indexer 会索引什么？

它会将 Claude Code 会话历史中的 JSONL 会话记录索引到 SQLite。

### 搜索如何工作？

项目通过 Ollama 使用 bge-m3 嵌入进行语义检索，并以 FTS5 作为回退方案。

### 这是云服务还是本地工具？

来源将其描述为一个把数据索引到 SQLite 的仓库，并未表明它是托管式 SaaS 产品。

### 它支持非语义搜索吗？

支持。页面明确提到了 FTS5 回退搜索。

### 在哪里可以进一步了解使用方法？

仓库包含文档和项目文件，但提供的页面文本未展示完整的使用指南。

## 快速信息

- **类别**: 开发者工具
- **主要任务**: 对 Claude Code 会话历史进行语义搜索
- **数据格式**: JSONL 会话记录
- **存储**: SQLite
- **搜索方式**: 通过 Ollama 使用 bge-m3 嵌入，并支持 FTS5 回退
- **来源域名**: github.com