用途:检查并解释本地 Deep Agents Code SQLite 会话存储中的对话。当某个被追踪线程可用 LangSmith 工具时优先使用它;否则用 scripts/inspect_sessions.py 代替手动解码数据库 blob。
主要能力:脚本以只读方式打开数据库,用 LangGraph 的严格 MsgPack 加载器反序列化根消息通道,从最新检查点读取已物化消息,或在快速路径不可用时按检查点顺序重放写入,并输出 JSON。支持按线程 ID 前缀查询,提供 latest-turn、summary、transcript 等视图,可用 --include-metadata 查看运行、仓库、模型、检查点或 LangGraph 元数据,用 --max-content N 调整每条消息、工具结果或工具调用参数默认 4000 字符的上限。
使用方式:先将 SKILL_DIR 解析为包含 SKILL.md 的目录,不要假定用户、项目或安装特定位置。最小视图示例:python3 "$SKILL_DIR/scripts/inspect_sessions.py" THREAD_ID --mode latest-turn。其他视图:--mode summary、--mode transcript。不知道 ID 时先列出最近线程:python3 "$SKILL_DIR/scripts/inspect_sessions.py" --list 20。仅对非默认会话存储传 --db PATH;默认是 $DEEPAGENTS_HOME/.state/sessions.db,未设置时为 ~/.deepagents/.state/sessions.db,DEEPAGENTS_SESSIONS_DB 可覆盖两者。脚本应用与 dcode 相同的规则,相对路径或 ~user 值会被拒绝。
解释结果:应综合 JSON 而非原样粘贴,说明用户请求、助手结论及重要工具操作或失败,区分存储事实与自身解读;对最新轮次只描述最后一条用户消息及后续活动,除非需要更早上下文;当相关记录设置了 content_truncated 或 args_truncated 时说明截断;结果含顶层 warnings 数组时提示重建问题;不要暴露无关凭据、令牌、个人数据或隐藏推理。
限制与安全:保持只读检查,不要反序列化不受信任的数据库,检查点反序列化仅用于受信任的本地 Deep Agents 状态;除非用户单独明确要求,不要修改或删除会话行。