session-index

会话索引技能

你可以使用会话索引——一个 SQLite 数据库，其中包含对所有 Claude Code 会话进行 FTS5 全文搜索的功能。当用户询问过去的会话、之前的对话，或想了解以前尝试过什么时，请使用它。

用户的界面就是这段对话。 用户会自然地提问（例如“我们最近是不是讨论过浏览器控制？”），你将问题转换为 CLI 命令，并以对话式的方式呈现结果。用户不应需要了解 CLI 语法。

如何处理会话查询

1. 从问题中提取关键词

用户说：“我们最近是不是讨论过浏览器控制？” 你搜索：sessions "browser control"

用户说：“我试过哪些表单自动化方案？” 你搜索：sessions "form automation"

用户说：“我这周在 Acme 上花了多少时间？” 你运行：sessions analytics --client "Acme" --week

2. 通过 Bash 运行合适的命令

搜索 — 按主题查找会话：

sessions "relevant keywords"
sessions "relevant keywords" --context    # includes conversation excerpts

上下文 — 阅读会话中的实际对话：

sessions context <session_id> "search term"   # exchanges matching a term
sessions context <session_id>                 # all exchanges

分析 — 工作量、时间、工具使用情况：

sessions analytics                    # overall
sessions analytics --client "Acme"    # per client
sessions analytics --week             # this week
sessions analytics --month            # this month

筛选 — 按元数据查找会话：

sessions find --client "Acme"              # by client
sessions find --tool Task --week           # by tool + date
sessions find --project myapp              # by project
sessions recent 20                         # last N sessions

3. 综合分析（“哪些方法有效？”、“我试过什么？”）

这是最有价值的功能。当用户提出的问题涉及多个会话时：

1. 搜索：sessions "topic" -n 10
2. 提取排名前 3-5 条结果的上下文：sessions context <id> "topic" -n 3
3. 使用 model="haiku" 启动一个 Task 进行综合分析：
   • 尝试过哪些方法？
   • 哪些有效／哪些失败了？
   • 有哪些反复出现的模式？
   • 当前进展如何？
4. 以对话式的方式呈现综合结果，并为每个来源会话附上 claude --resume <id> 链接

这会使用会话内的 Haiku 子 Agent，无需外部 API 密钥。

4. 以对话式的方式呈现结果

不要直接输出原始 CLI 结果。请概括说明：

• “你上周在 3 个会话中讨论了浏览器控制……”
• “主要有效的方法是……”
• 添加 claude --resume <session_id> 链接，方便用户跳回相应会话
• 如果上下文相关，请引用关键对话

安装

pip install claude-session-index

首次运行任何命令时，都会自动为所有现有会话建立索引。

数据位置

• 数据库： ~/.session-index/sessions.db
• 主题： ~/.claude/session-topics/
• 配置： ~/.session-index/config.json（可选）