用途：在 Claude Code 的会话历史中检索与恢复内容。数据来源分两类：自动发现的活跃目录（~/.claude、各 profile 目录、当前 CLAUDE_CONFIG_DIR）以及 ~/.claude/history-sources.json 中注册的长期归档。会话文件位于 <history-root>/projects/<编码后的项目绝对路径>/<session-id>.jsonl，目录名是绝对路径把 / 换成 -，不是 basename。
主要能力：列出项目会话（按内部时间戳排序，含范围、大小、来源）；关键词搜索（覆盖消息、thinking 文本、工具输入输出、附件、摘要等，按词频排序）；从 file-history 快照恢复被删除或丢失文件的原始字节；统计会话消息数、工具使用与文件操作；提取用户实际输入的消息；对会话结束方式做分类（如崩溃中断、待回复）。
使用方式：核心命令为 python3 scripts/analyze_sessions.py list /path/to/project、search /path/to/project '<keyword>'、stats /path/to/session.jsonl、triage，以及 python3 scripts/recover_content.py <session-path>。搜索可用 --all-projects 扫描全部项目，--codex、--kimi 分别纳入 Codex rollout 与 Kimi CLI wire 日志，--exclude-session <id> 排除当前会话，--from-date/--to-date 按内部时间过滤。恢复支持 -k 关键词过滤、-o 输出目录、--file-history-root 指定额外快照根。
限制：--home 与 --main-only 是诊断范围，不能用于断言全历史不存在；未搜索注册归档前不得判定缺失。Codex 与 Kimi 日志不含 Claude 的 file-history 映射，不能用于文件恢复。JSONL 与快照格式属观察到的运行时细节，非稳定 API。当前会话总会匹配刚输入的短语，需排除后再判断。资料未提供安装方式、收费与平台信息。