dsh-session-audit

别再一行行翻 session 日志：一次调用，就把 agent 这次怎么干活的、在哪里失败、有没有验证，折叠成一份可读报告。

解决什么问题

DSH 的 session 日志是 append-only 的事实源，忠实记录了「发生了什么」；但读完一份上千事件、上万行的日志，并不能直接回答你真正关心的问题——跑了多久、调了哪些工具、在哪里失败、有没有重复操作、最后验证过没有。

dsh-session-audit 通过一次 session_audit 工具调用，把单个会话的持久化日志折叠成可读审计：时长与回合/步骤数、工具调用分布与成功/失败拆分、token 用量、确定性信号（连续失败、高频工具、完全相同调用、重复读文件），以及验证命令识别（在 shell 调用里认出 test / build / lint / typecheck 并报告实际结果）。支持 text / markdown / JSON（带稳定 schemaVersion）三种格式，纯本地分析，不调 LLM、不发网络请求、不写盘。

核心功能

会话指标：时长、Turns、Steps、assistant 消息数、工具调用总数与按工具分布、成功/失败拆分
Token 用量：按 turn:step 折叠 input / output / cache 桶，语义与官方 session-stats 一致，缺失时如实显示 Unavailable
确定性信号：连续失败、失败率、高频工具、完全相同调用、重复读文件，纯规则判定，不用 LLM 打分
验证命令识别：识别 npm test、pytest、cargo test、tsc、eslint 等并报告实际结果
三种格式：text（默认）/ markdown / JSON，带稳定 schemaVersion
当前或历史会话：默认审计当前会话，也可按 id 审计任一持久化会话，或列出最近会话
健壮容错：空会话、畸形事件、未来事件类型、孤儿 result 均安全处理

快速上手

安装并重启 dsh web 后，直接用自然语言让 agent 审计，或用斜杠命令：

审计当前会话

审计 session session-abc123

用 markdown 格式审计当前会话

斜杠命令：/session-audit [text|markdown|json] 审计当前会话（默认 text），/audit-list 列出最近的持久化会话。工具参数：session_id、format、list_sessions、thresholds。报告只留在本地，作为工具结果返回，不写盘。