SuperAPI AI 工具集

observability-analyze-session-logs

部署与运维

查看项目

更新于 10-15 20:34

技能介绍

用途:分析 Claude Code 会话记录(JSONL 文件),查看 Claude 在对话中看到和思考的内容,用于排查行为异常、token 使用和上下文耗尽等问题。注意它分析的是会话记录,不是应用/生产日志;后者应使用 analyze-logs 技能。

主要能力:查看任意对话点的上下文窗口内容;拆分 token 用量(输入、缓存创建、缓存读取、输出);还原消息父子链;识别智能体委派(sidechain 与主线程);观察上下文窗口增长;读取思考块、工具调用及参数与结果。

使用方式:会话文件通常位于 ~/.claude/projects/-Users-{username}-{project-path}/{session-uuid}.jsonl。常用命令: python3 .claude/tools/utils/view_session_context.py <session-file.jsonl> --list python3 .claude/tools/utils/view_session_context.py <session-file.jsonl> --message-index 10 python3 .claude/tools/utils/view_session_context.py <session-file.jsonl> --uuid "3c8467d6-..." 加 --raw 可查看原始 JSON。查找最近会话: ls -lt ~/.claude/projects/-Users-$(whoami)-/.jsonl | head -5

适用场景:解释“Claude 为什么这样做”、调查 token 用量、跟踪智能体委派、诊断上下文窗口耗尽与缓存抖动、分析性能问题。建议先用 --list 总览,再用 --message-index 深入。

限制:需要 Python 3.12+ 和随附的 view_session_context.py;jq 为可选。会话文件由 Claude Code 自动生成。资料未提供价格、平台支持范围及效果保证等信息。