用途：在 Claude Code 的历史会话记录中按语义查找过往工作，例如“查找关于 X 的会话”、调试对话或研究任务。
主要能力：先用关键词对所有会话做预过滤，再从候选会话中提取有意义的片段，最后对每个会话与查询的相关性做语义评估并打分（0-10），按相关性排序展示。评估时会考虑同义词匹配（如 bug 匹配 error、issue、problem、fix）、相关概念、工具使用模式（如重构对应大量 Edit 操作）和领域上下文。
使用方式：第一步运行搜索脚本：python3 scripts/search.py "<query>" [max_results] [max_age_days]。query 为必填的自然语言查询；max_results 可选，默认 10；max_age_days 可选，默认 90。脚本输出包含 SESSIONS_DATA JSON 块。第二步对结果做语义评估并打分。第三步展示排序后的结果，格式为标题含相关性分数、项目与日期，附 1-2 句摘要及 claude --resume <session-id>。若无可信结果则报告并建议其他查询。也可用 /session-search "query" 20 180 搜索更早会话或获取更多结果。
存储：会话以 JSONL 文件存放在 ~/.claude/projects/，每个文件包含用户/助手消息与工具调用事件，脚本自动处理文件发现与文本提取。
限制：资料未提供脚本依赖、性能上限、隐私处理方式及对非 Claude Code 会话的兼容性说明。