SuperAPI AI 工具集

session-inspector

办公与效率

查看项目

更新于 10-15 20:31

技能介绍

用途:Session Inspector 用于检查、分析和查询存储在 ~/.claude/projects/ 下的 Claude Code 会话日志,适用于查看会话历史、按 ID 或内容查找会话、分析上下文窗口消耗、排查智能体子进程执行问题,以及从会话中提取计划。

主要能力:列出项目或 worktree 的会话(含分支上下文、会话 ID、修改时间、大小、摘要等元数据);将 JSONL 日志预处理为压缩 XML;分析上下文窗口占用;提取最近计划;从会话内容创建计划 PR;将 session XML 渲染为 GitHub 评论块;从 GitHub issue 中提取会话内容。

使用方式:命令通过 erk exec 调用,如 erk exec list-sessions [--limit N] [--min-size BYTES]、erk exec preprocess-session <log-path> [OPTIONS]、erk exec extract-latest-plan [--session-id SESSION_ID]、erk exec create-pr-from-session [--session-id SESSION_ID]、erk exec render-session-content --session-file <path>、erk exec extract-session-from-issue <issue-number>。斜杠命令包括 /erk:sessions-list 和 /local:analyze-context。会话 ID 通过 --session-id 显式传入,典型流程是 hook 接收会话上下文并输出提醒,智能体提取后作为 CLI 参数传入。

适用场景:查找某项目中发生过什么、调试上下文膨胀、提取计划用于实现、从会话计划创建 issue、查找智能体子进程日志以及检查智能体错误。

限制:资料中未提供完整的错误处理细节、平台兼容性说明以及非 Claude Code 会话日志的支持情况。预处理会应用过滤优化,包括空/热机会话过滤、文档去重、工具参数截断(超过 200 字符)和工具结果裁剪(保留前 30 行并保留错误)。两阶段提取管线中第一阶段为确定性机械精简,第二阶段为可选的 Haiku 语义蒸馏,会保留错误、堆栈跟踪和警告。