SuperAPI AI 工具集

exploring-claude-sessions

智能体与模型

查看项目

更新于 10-15 23:33

技能介绍

用途:查找与探索 Claude Code 本地保存的会话历史(JSONL 转录),支持搜索、读取、导出与恢复过往会话。

主要能力:定位会话存储位置;按项目列出会话(最新在前);跨项目按关键词搜索;把会话导出为可读 Markdown;查找某文件被哪个会话改动;用前缀解析不完整会话 ID;恢复会话。

存储位置:主转录在 $CLAUDE_ROOT/projects/<project-slug>/<session-id>.jsonl;子代理转录在同目录 <session-id>/subagents/agent-<agent-id>.jsonl(附 .meta.json);journal.jsonl 为子代理生命周期记录;tool-results/<id>.txt 存放大工具输出;workflows/wf_*.json 为工作流记录;memory/ 为项目自动记忆;.session-aliases 指向同一工作目录的兄弟项目目录;$CLAUDE_ROOT/history.jsonl 为全局提示历史;file-history/ 为文件快照;sessions/<pid>.json 为运行中会话注册表。项目 slug 由工作目录的 / 替换为 - 得到。

使用方式:设置 CLAUDE_ROOT="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"。列出会话可用 jq 遍历 $PROJ/.jsonl;搜索可先 grep -rl "KEYWORD" "$CLAUDE_ROOT"/projects//.jsonl "$CLAUDE_ROOT"/projects///subagents/.jsonl,或查 history.jsonl;导出用 jq 提取 user/assistant 文本与 tool_use 名称;恢复用 claude --resume <session-id|title>、claude --continue,会话内用 /resume <id-or-title>,/export 为交互式。

限制:CLI 转录默认 30 天后自动清理(cleanupPeriodDays,最小 1),子代理与工具结果随之过期,history.jsonl 不自动清理;本技能仅限 CLI,Claude Desktop 另有保留策略。headless 或 SDK 会话虽被保存,但 /resume 会隐藏 entrypoint 为 sdk-cli、sdk-ts、sdk-py 的会话及 sidechain、/loop、daemon 类会话,需直接从磁盘读取。tool_result 内容可能极大,打印时应截断,超大 Bash 输出需按 toolUseResult.persistedOutputPath 读取。转录首行可能是注入的上下文块而非用户输入,promptSource:"typed"、last-prompt 与 history.jsonl 才反映真实输入。todos/、statsig/、logs/ 等为旧版遗留,不再写入。