用途:处理 Claude Code 会话数据,包括回顾历史对话、搜索提及某主题/工具/文件的会话、解析 JSONL 转录、构建读取 ~/.claude/projects/ 数据的工具,以及排查 jq 查询为何无返回。不适用场景:实时会话上下文、Git 历史、当前对话、非 CC 的 JSONL 文件。
安装:uv tool install ~/Repos/batterie/deglacer
主要命令:deglacer SESSION.jsonl 输出对话文本;--summary 仅人类消息;--with-tools 含工具调用摘要;--with-thinking 含思考块;--last 5 仅最近 5 轮;--json 结构化输出;--stats 会话统计;--timeline 带时间戳轮次日志;--find "搜索词" 跨近期会话搜索;--recent [N] 列出最近会话;--today 今日会话;--since 2026-03-25 按日期筛选。标志可组合使用。
文件位置:~/.claude/projects/{encoded-cwd}/{session-uuid}.jsonl,子代理转录位于 {session-uuid}/subagents/agent-{id}.jsonl。用 ls -lt 查找最近会话。
架构要点:每行一个 JSON 对象,由 .type 区分条目类型(assistant、user、progress、system、summary、queue-operation 等)。user 条目有双重职责(人类消息、工具结果、技能注入),需按 content 类型与 toolUseResult/isMeta 区分。assistant 的 message.id 会被流式重复,需合并内容块并按 tool_use 的 id 去重。真实输入 token = input_tokens + cache_creation_input_tokens + cache_read_input_tokens。
主要限制与警示:.role 位于 .message.role 而非顶层;助手 content 始终为数组,用户 content 类型不定,访问前需检查;不要对 JSONL 使用 jq -s '.' 或 jq '.[]';stop_reason 在旧版本中为 null;schema 随版本变化,字段存在性不一致。架构细节以该参考为准,deglacer 自动处理流式合并。其他功能细节暂未提供。