会话战报 louisyeaaah/dsh-receipt

dsh-receipt

一次会话，一张战报。 数字全部来自会话日志，默认脱敏，可以在 X 上直接发。

左：单次会话 · 右：最近 7 天汇总（都是真实输出，见 docs/README.md）

npx github:louisyeaaah/dsh-receipt # 最新一次会话，打印文本战报
npx github:louisyeaaah/dsh-receipt --png receipt.png # 出一张 1080×1350 的卡片
npx github:louisyeaaah/dsh-receipt --list # 列出最近的会话

别用 npx dsh-receipt：npm 上已有的 dsh-receipt 是另一个人的包（deronendless/dsh-receipt，每轮结束写一份 JSON/Markdown 凭据，没有 bin），跑起来不是你想要的东西。这个仓库没发 npm，走 GitHub 路径。

会话战报 f6832c10 项目 dsh-plugin 模型 deepseek-flash 时长 13 小时 21 分

轮次 15 步数 572 工具调用 620 涉及文件 45 消息 571（我的输入 86）

tokens
输入（新） 1,777,902 输出 478,609 缓存读 236,763,392

上下文压缩 14 次（被裁掉 77,897 tokens）

用得最多的工具： 384 bash 57 write 37 edit 16 read 14 reload_plugin

（上面是真实输出，不是示意图。）

周期战报：把一段时间的所有会话合成一张

npx github:louisyeaaah/dsh-receipt --since 7d # 最近 7 天
npx github:louisyeaaah/dsh-receipt --since 30d --project dsh-plugin
npx github:louisyeaaah/dsh-receipt --since 7d --png week.png

最近 7d 战报会话数 55 项目数 1 时间跨度 143 小时 43 分（2026-09-27 → 2026-10-03）会话时长合计（含挂机，会重复计算） 253 小时 34 分

轮次 186 步数 5,614 工具调用 6,609 涉及文件 389 tokens: 输入 12,460,512 · 输出 5,028,237 · 缓存读 1,543,818,240

用得最多的工具：bash 4,129 · read 581 · edit 487 · write 322 · web_fetch 238

口径上诚实的两点（都写进了输出本身）：

- 时长合计 > 时间跨度是正常的：每个会话的时长是「首尾事件之差」，包含挂机时间，多个会话并行时会重复计算。所以两个数都给：时间跨度（真实墙上时间）和时长合计。
- 涉及文件是并集去重：跨会话同名文件只算一次。

与同类工具的区别（重要）

同一个位置上已经有人了。先看这两条，再决定要不要用这个仓库：

| 同类 | 覆盖范围 |
| 988hj7tczd-oss/dsh-receipts | 挖本地会话 JSONL → 个人用量与影响战报：Markdown 日/周/月报 + 自包含的 HTML 战报，跨会话汇总。 |
| ciceroyang/dsh-report-studio | 会话 → 日报 / 周报 / 交接 / 文章，带可验证的 HTML 导出与一份会重新核对已存文件的 receipt。 |

本仓库不做市场投稿（2026-10-03 决定，2026-10-04 复查维持）：这两条都还在，而且现在各自都带 HTML 战报/导出 ——原本唯一的差异点「一张可直接发布的卡片」已经被覆盖了。投进去只是第 3 个同类，位置上没有不可替代的东西。

那还剩什么真的不一样？只有两点，都很小但确实不同：

1. 产出是图片（PNG/SVG），不是 HTML/Markdown —— 生成完可以直接贴进社交平台或聊天窗口，不用打开浏览器、也不依赖对方能渲染 HTML。
2. 同一份数据两个入口：零依赖 CLI（bin/receipt.mjs）与 DSH 内的插件工具（dsh_receipt()），口径完全一致，包括上面那两点透明度说明。

如果你要的是「完整的报告体系」（周报、交接文档、HTML 归档），用上面那两条，它们比这里完整得多。

作为 DSH 插件用（不只是命令行）

装进 DSH 之后，会话里可以直接要战报，不用离开应用：

dsh_receipt() 当前会话
dsh_receipt({ scope: 'period', since: '7d' }) 最近 7 天汇总
dsh_receipt({ out: '/tmp/card.svg' }) 顺便把卡片写出来
/dsh-receipt period 7d en out:/tmp/card.svg 人也可以直接敲

dsh plugin --profile <profile> add github:louisyeaaah/dsh-receipt
插件层（lib/）和命令行层（bin/）共享同一套统计与渲染代码（src/），所以两条路的数字口径完全一致 —— 不会出现「命令行说 691 步、插件说 700 步」。

- 插件只读会话日志；唯一的写操作是你显式给 out 时写出的那张卡片。
- 官方 @deepseek-ai/* 包声明为 peerDependencies（由 DSH 提供），不重复打包。

为什么做这个

build in public 的人要发「今天干了什么」，现在只有两条路：手截一张丑图，或者写一段没有信源的形容词。
dsh-receipt 给第三种：从会话日志里算出来的真实数字，配一张能直接发出去的卡片。

数字的口径（写清楚，免得被质疑）

| 字段 | 怎么算的 |
| 时长 | 第一个事件到最后一个事件的时间差（不是你坐在电脑前的时间） |
| 轮次 | 你的每一次输入算一轮（turn/start 去重） |
| 步数 | 模型的每一次响应算一步（step/start 去重） |
| 工具调用 | tool/call 事件条数，按工具名分组 |
| 涉及文件 | 从工具参数里抽出的文件，同名去重，只保留文件名 |
| tokens | assistant/message 上的 usage 累加；缓存读单独列，不混进输入 |
| 上下文压缩 | compaction/prune 次数，以及被裁掉的 token 数 |

脱敏

默认就脱敏，不是可选项：

- 项目路径只留最后一段（/Users/xxx/project/dsh-plugin → dsh-plugin），不暴露用户名
- 文件只出现 basename 和计数，不出现路径、不出现任何对话内容
- 会话 id 只显示前 8 位

要看完整路径必须显式 --show-paths。

不编数字

没有内置价目表。 只有你自己给单价时才估成本：

dsh-receipt --price-in 2 --price-out 8 --price-cache 0.2 # 每百万 token 的美元价

价格会变、各家的缓存计价规则也不一样，工具里编一个数字比不给更糟。

零依赖

只需要 Node ≥ 22（用到内置的 zlib）。没有 npm 依赖，没有 node_modules。

会话文件在 ~/.dsh/sessions/<项目>/session-<id>/session.v4.jsonl.zstd，每行一个 JSON 事件；assistant/message 上带真实的 usage。

实现注意：这个文件是追加写的多帧 zstd，而 Node 的 zstdDecompressSync / createZstdDecompress 只解第一帧而且不报错（3.7MB 的会话只会读出 1 个事件）。
本工具按帧魔数切分逐帧解，scripts/selftest.mjs 里有这条回归测试。

命令

| 命令 | 作用 |
| dsh-receipt [会话id前缀] | 文本战报（默认取最新会话） |
| --since 7d\|24h\|2026-10-01 | 周期战报：窗口内所有会话合成一份 |
| --project <名字> | 只统计某个项目（配合 --since） |
| --list | 列出最近 20 个会话 |
| --svg out.svg | 输出卡片（SVG，1080×1350） |
| --png out.png | 输出 PNG（用本机 Chrome 把 SVG 转出来） |
| --json | 机器可读 |
| --lang zh\|en | 语言 |
| --theme dark\|light | 卡片配色 |
| --show-paths | 不脱敏 |
| --price-in/-out/-cache | 给了才估成本 |

自检：bash scripts/verify.sh（语法 + 包元信息 + 33 项离线单测）。

和同名工具的区别

npm 上的 dsh-receipt 做的是每轮结束自动落一份凭据文件
（JSON + Markdown，带 Git 状态、审批审计、SHA-256 完整性摘要，做得很细）。
本工具做的是另一件事：把整次会话汇总成一张给人看的卡片，可以直接发出去。

两者不冲突：那份适合审计留档，这张适合发布。要审计留档就用它的。

限制

- 只读 DSH 的会话格式（session.v4），DSH 改格式就得跟着改；
- 时长的口径是「首尾事件之差」，跨天挂着不动的会话会显得很长；
- 卡片是 SVG 转的 PNG，依赖本机有 Chrome/Chromium/Edge；没有的话 SVG 也能直接发。

MIT

作者 @louisyeaah（悉尼）—— 发了什么、翻车了什么都会写。
作品站：louisyeaaah.github.io · 全部工具：github.com/louisyeaaah