dsh-session-audit

看清你的 DeepSeek Harness Agent 这次到底是怎么干活的。

对一个 DSH Session 做 Steps / Tool Calls / 失败 / 重复动作 / Token / 验证命令（test/build/lint）的执行审计，通过一次 session_audit 工具调用输出一份可读的审计报告。

简体中文 | English

DSH Session Audit
──────────────────────────────────────────────

Session
ID              session-d2309fa2-47d3-484a-8357-236e0acdd9aa
Model           glm-5.3
Provider        zai-coding-cn
Duration        51m 42s
Started         2026-08-14T09:08:08.384Z

Execution
Turns           4
Steps           121
Assistant msgs  120
Turn endings    completed×1, interrupted×1, error×1

Tools
Total calls     150
Succeeded       143
Failed          6
Unresolved      1
Failure rate    4.0%

Top tools
  bash                  83  (1 failed)
  write                 26
  edit                  21  (4 failed)
  read                  12

Tokens
Input           349,428
Output          80,415
Cache read      9,243,520
Total           9,673,363

Execution signals
  ⚠ 3 consecutive failed tool calls detected
  ⚠ `bash` called 83 times
  ℹ session has a turn that never closed

Verification
  ✓ pnpm run typecheck  [typecheck]
  ✓ npm test  [test]  (2 attempts, 2 ok)

(来自本机真实会话的报告)

为什么需要

DSH 的 session 日志已经完整记录了"发生了什么"——它是 append-only 的事实源。 但读完一份上千事件的日志，并不能直接回答你真正关心的问题：

跑了多久？多少个 Turn / Step？哪些工具用得最多？在哪里失败？ 有没有重复调用？最后验证过没有？

dsh-session-audit 把单个 session 的持久化事件日志折叠成这些答案。 它是 Step / Tool-call Profiler 和失败分析器，不是 Token 仪表盘 （见现有同类插件）。

功能

• Session 指标 — 时长、Turns、Steps、assistant 消息数、工具调用 总数、按工具分布、成功/失败拆分。
• Token 用量 — 按 turn:step 折叠 input / output / cache 桶，语义与 官方 session-stats 投影一致；provider 没上报时显示 Unavailable， 绝不估算。
• 确定性审计信号 — 连续失败、失败率、高频工具、完全相同的重复 调用（对参数 key 顺序不敏感）、重复读取同一文件。纯规则判定，不用 LLM 打分。
• 验证命令识别 — 识别 shell 工具调用中的 test/build/lint/typecheck 命令（npm test、pytest、cargo test、tsc、eslint……）并报告 实际观察到的结果。
• 三种格式 — text（默认）、Markdown、JSON（带稳定 schemaVersion）。
• 当前或历史 Session — 默认审计当前内存中的 session，也可按 id 审计任一持久化 session；支持列出最近的 session。
• 健壮 — 空会话、畸形事件、未来新增的事件类型、孤儿 result、 崩溃尾部残帧：全部安全处理，并在报告中以数据质量说明呈现。