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

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

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

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

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

本仓库不做市场投稿（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 给第三种：从会话日志里算出来的真实数字，配一张能直接发出去的卡片。

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

脱敏

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

• 项目路径只留最后一段（/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 里有这条回归测试。

命令

自检：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