会话成本报表yangyongzhen/dsh-session-report

dsh-session-report

DeepSeek Harness 会话成本与耗时复盘报表插件：turn 结束后生成 Markdown 报表卡——token 消耗（含缓存命中率）、按 turn 拆分、工具调用频率、错误记录、可选成本估算。

与 dsh-session-export（对话导出）互补：导出看内容，报表看数字。

- 监听 session/event 事件流，turn/end 后防抖 debounceMs 生成报表
- 输出 $DSH_HOME/reports/report-.md（默认 ~/.dsh/reports/）
- 缓存命中率按 DeepSeek 口径：cacheRead / (未缓存输入 + 缓存读 + 缓存写)
- 配置单价后自动估算成本（计费输入 = 三项之和）
- 进程退出时同步 flush（headless 一次性任务不丢报表）

安装

本地 checkout 安装
dsh plugin --profile  add file:/path/to/dsh-session-report

或从 Git 仓库安装
dsh plugin --profile  add https://gitcode.com/qq8864/dsh-session-report.git

配置

- id: report
config:
enabled: true
outDir: ~/reports        # 报表目录，默认 $DSH_HOME/reports
debounceMs: 1000         # turn/end 后的静默等待
costPerMInput: 1.2       # 可选：每百万输入 token 价格（元），配置后估算成本
costPerMOutput: 4.0      # 可选：每百万输出 token 价格（元）

价格单位任意（元/美元/分），按"每百万 token"填写；不配置则不显示成本。

报表样例

会话成本与耗时报表

- 会话 ID：session-29487994-...  ·  模型：deepseek-official/deepseek-v4-flash
- 总耗时：2s  ·  估算成本：0.0105

Token 消耗
| 输入 tokens（未缓存） | 6322 |
| 缓存命中（读） | 1920 |
| 计费输入合计 | 8242 |
| 缓存命中率 | 23.3% |

按 Turn 拆分
| Turn | Step | 工具调用 | 输入 | 输出 | 缓存读 | 耗时 | 结果 |
| 1 | 1 | 0 | 6322 | 156 | 1920 | 2s | 完成 |

工具调用频率
| pwsh | 2 |
| glob | 1 |

口径说明

dsh 的 TokenUsage 计数是不相交的：inputTokens 只含未缓存输入，缓存命中/写入分开报。因此：

- 计费输入 = inputTokens + cacheReadTokens + cacheWriteTokens
- 缓存命中率 = cacheReadTokens / 计费输入（DeepSeek 口径，clamp 到 0–100%）
- 成本估算按计费输入计算

开发

pnpm install
pnpm run build        # tsc -> lib/

端到端验证：

dsh plugin --profile headless add file:./
dsh --profile headless --patch ./test/report-patch.yml "一句话介绍你自己"
cat ~/.dsh/reports/*.md