mcpField
S
session-search

session-search

github.com/glebisAgent 工作流403189 次安装3 天前更新
代码仓库

关于 session-search

Session Search 是搜索 Claude Code 历史会话的技能，适合查找过去的项目工作、调试或研究记录。它先按关键词筛选会话，再依据语义评估相关性并排序结果。

主要功能

  1. 01搜索 Claude Code 会话记录
  2. 02先按关键词预筛选
  3. 03语义评估结果相关性
  4. 04按相关度排序并展示摘要
  5. 05可调整结果数和回溯天数

适用场景

  1. 01查找过去讨论某主题的会话
  2. 02寻找曾处理特定错误的记录
  3. 03检索以前的研究或项目工作
  4. 04扩大搜索的结果数或时间范围

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/glebis/claude-skills --skill session-search

安装后在 Claude Code 中输入/session-search确认已加载。

附带文件.claude-plugin/plugin.jsonscripts/search.py

详细介绍

会话搜索

通过结合关键词预筛选与语义评估，搜索 Claude Code 会话记录。查找过去涉及特定主题、调试对话、研究任务或其他工作的会话。

工作流

步骤 1：运行搜索脚本

使用用户的查询执行 scripts/search.py：

python3 scripts/search.py "<query>" [max_results] [max_age_days]
  • query（必填）：自然语言搜索查询
  • max_results（可选，默认值为 10）：返回结果的最大数量
  • max_age_days（可选，默认值为 90）：搜索的时间范围

脚本会对所有会话进行关键词预筛选，然后从最匹配的候选会话中提取有意义的摘录。输出包含一个 SESSIONS_DATA JSON 块。

步骤 2：对结果进行语义评估

收到脚本输出后，评估每个会话与查询的相关性。请考虑：

  • 同义词匹配："bug" 可匹配 "error"、"issue"、"problem"、"fix"
  • 相关概念："debugging" 可匹配包含测试失败或错误消息的会话
  • 工具模式："refactoring" 可匹配大量使用 Edit 的会话
  • 领域背景："obsidian" 可匹配与 vault 相关的工作

根据摘录内容和查询意图，为每个会话分配相关性评分（0-10）。

步骤 3：展示结果

按相关性排序，展示排名靠前的结果（最多 max_results 个），格式如下：

### [Relevance: N/10] Project — Date
Summary of what the session was about (1-2 sentences based on excerpts)
`claude --resume <session-id>`

如果未找到相关结果，请说明这一点并建议尝试其他查询。

会话存储

会话以 JSONL 文件的形式存储在 ~/.claude/projects/ 中。每个文件都包含用户/助手消息和工具调用事件。搜索脚本会自动处理文件发现和文本提取。

自定义

若要搜索更早的会话或获取更多结果：

/session-search "query" 20 180

（20 个结果，回溯 180 天）

评论

支持 Markdown