receipt：Claude Code 回合回执

简体中文 · English

Claude 每轮回复结束后，输入框上方会留下一行回执：改了几个文件、增删多少行、跑了几条命令、有几条失败。不用翻记录，就知道这一轮做了什么。Claude 原地打转时还会弹提示。全程不消耗 token。

功能

• 一行回执：先显示这一轮怎么结束的（✓ 正常回答、◼ 被中断、✗ 出错）和用时，再列出有内容的几项：改动的文件和增删行数、执行的命令和失败数、读取次数（Read、Grep、Glob）、开了几个子代理、产生了几条预警。
• 子代理也算：子代理改的文件和跑的命令都计入开启它的这一轮。
• 不打扰：没用工具的纯聊天轮不留回执，下一轮开始时回执自动收起；输入框弹出 / 或 @ 选择器时也会让开。
• 原地打转提醒：这一轮进行中，出现下面两种情况会弹 toast，每段连续只提醒一次：
  • 同一个调用连续失败 repeatFailures 次（默认 3），中间没有任何改动。编辑文件或跑了会改东西的命令（如 sed -i、npm install）算在推进，计数重来；cat、ls 这类只读命令不算。
  • 同一个文件被改回之前的样子，达到 flipFlops 次（默认 2）。
• 零 token：只在工具调用执行完后读取结果（Edit、Write、NotebookEdit 统计文件；有 git 行数用 git 的，没有就按补丁算；Bash 统计命令），不注册工具，不加提示词，不拦截调用。

安装

claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install receipt@hoobnn-agent-mods

命令

• /receipt：完整列出上一轮的回执：每个文件的增删行数（新建的文件标「新建」）、每条失败的命令、每条预警。
• /receipt off、/receipt on：隐藏或显示回执。这个设置会写回 /config，以后的会话也会沿用。

选项

在 /config 里修改，或写在 ~/.claude/settings.json 的 pluginConfigs 里：

| 选项 | 作用 | 默认 | | --- | --- | --- | | visible | 两轮之间在输入框上方显示回执 | 开 | | repeatFailures | 同一调用连续失败几次后提醒；0 关闭 | 3 | | flipFlops | 同一文件来回改几次后提醒；0 关闭 | 2 | | language | 界面语言：auto、en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru | auto |

language 为 auto 时，依次跟随 Claude Code 的 language 设置和系统语言环境，都没有时用英语。

同系列 mod

hoobnn-agent-mods 里还有任务进度条（todo-bar）、状态栏 HUD（hud）、运行动画和宠物（spinner）、Tailscale 节点状态（ts-band）和一言（hitokoto），可以搭配使用。

开发

• hooks/register.tsx：钩子（会话开始时的语言和 /receipt，回合开始与结束，读取工具调用，命令和横条）。
• hooks/ledger.ts：根据每次调用的内容生成回执，以及两条打转规则。
• hooks/config.ts：选项，一次性读成类型化的 Config。
• hooks/i18n.ts：各语言文案。
• hooks/kit/：claude-code/kit 的副本；改源文件后运行 scripts/sync-kit.sh。