运单（Waybill）

带上收据。 Waybill 是针对 AI 辅助工作的代币会计系统——一个 Claude Code 插件，它计量每一个代币，将其归因于所交付的 Jira 故事，并将其转化为经得起审视的价值报告、绩效评估包和代币预算申请。

运单 是详细列出货物及其费用的运输单据。你发货；Waybill 负责保留详细记录。

为什么

工程师一年中很多决定都取决于两次对话，而这两次对话都基于同样残缺的输入：

• "AI 预算值多少钱？"——越来越多的团队根据展示的价值分配 Claude 代币。用得好，展示出来，就能获得更多。

• "你这个周期完成了什么？"——绩效评估、晋升材料、冲刺回顾。

人类都是凭记忆回答，在截止日期的前一夜，用形容词回答。决策者无法区分诚实主张和夸大主张，因此他们会对所有内容打折扣。Waybill 修复的是 证据，而不是说服力：它在工作时记录工作，将每一项主张与一个产物（PR、问题、部署标签、记录）绑定，并且拒绝让你做出那种会导致你下一次推介被忽视的主张。

Related MCP server: Token Analyzer MCP

六十秒内获得你的第一张收据

claude plugin marketplace add Jakeintech/waybill
claude plugin install waybill@waybill

然后在 Claude Code 会话中，说 "initialize my waybill ledger"。这就是 整个设置过程：无需账户、无需代币、无需 OAuth。Waybill 从 git config 中植入你的身份，导入 Anthropic 的标价费率，以便从第一天起就显示成本，检查你的记录保留设置，并仅从你的本地 git 历史生成一张 引导收据——你已交付的工作，逐项列出，不到一分钟。

更新

Claude Code 不会推送插件更新通知；更新只需在你方便时执行一条命令：

claude plugin update waybill@waybill

然后重启 Claude Code。waybill status（或 waybill --version）会显示你正在运行的引擎版本。Waybill 从不主动检查更新——没有你要求的网络调用是 一项承诺，而非疏忽。发布版本和变更日志位于 releases 页面；如果你想收到 GitHub 邮件通知，可以关注该仓库（Watch → Custom → Releases）。

升级路径（可选，五分钟）

连接你的跟踪器和 git 主机，可以将提交转化为带有故事点、史诗和合并时间戳的收据：

# Easiest — reuse your authenticated gh CLI:
export GITHUB_MCP_PAT="$(gh auth token)"
# Or mint a fine-grained read-only PAT (repos/PRs) at
# https://github.com/settings/personal-access-tokens and export it instead.

1. /mcp → 完成 atlassian 的 OAuth 流程（无需令牌）。

2. 说 "sync my ledger and give me a bootstrap report."

不确定哪些已连接或未连接？waybill status 会显示，并打印出修复任何缺失项的确切命令。

这会导入你过去大约 90 天内的 你自己的 问题和已合并的 PR，并生成一份仅包含事实的报告——已交付项、故事点、PR、部署——在你改变任何习惯之前。从那时起，通过账本开启任务即可解锁更强的主张（参见下面的层级）。

工作原理

每个 Claude Code 代币都从你的本地记录中以确定性方式计量，并归因于它服务的那个故事，包含每个事件的解析器名称和置信度、一个守恒检查（每会话 Σ 归因 = Σ 观测），你可以通过 waybill verify 离线重新运行、一个用于模糊遗留项的归属收件箱，以及每个故事的浪费诊断（代币买了什么——以及它们在重试循环中浪费了什么）。从 1.0 版本开始，schema 已冻结：收据就是契约。

证据层级（核心理念）

报告中的每个数字都说明了其来源：

1. 事实——合并时间戳、部署标签、故事点、代币数量。

2. 基线差异——你自身的无 Claude 速度/周期时间与现在的对比。

3. 预注册预估——在 工作开始前 记录，并以范围形式报告。

4. 回顾性判断——保留在账本中，默认从推介中排除。

此外还有结构性诚实：只追加存储（修正覆盖，从不覆盖）、范围从不收缩为中点、价值仅在合并或部署时计数，以及成本（花费的代币、返工）出现在每个推介中。完整规则：方法论。

报告预设

• token-pitch——请求、收据、支出账本、效率趋势、预测。

• perf-review——评审周期内的史诗级成果，包括评审/事故/文档工作。

• sprint-recap / quarterly——持续记录。

报告以三个受众级别呈现——self、internal、external——在离开组织之前进行确定性假名化处理。

Waybill 永远不会做什么

• 没有管理者模式，没有监视。 它只查询 你 被分配的问题和 你 创作的 PR。

• 没有同级排名。 方法论有意识地拒绝个人同事比较——你与自己的基线竞争，而不是与 Dave 竞争。

• 没有托管服务，没有遥测。 所有内容都保存在 ~/.waybill/ 中（你拥有的本地 git 仓库）。

• 没有时间跟踪。 它记录成果和预估，而不是击键次数。

这些是承诺，而非缺陷。参见 ROADMAP.md。

暂停、静音、离开

信任一个记录你工作的工具，也包括确切知道如何停止它。从降低使用到完全离开的完整退出路径：

• 暂停计量（客户参与、共享机器、调试）：在 ~/.waybill/config.json 中设置 "metering": { "enabled": false }。暂停时不会捕获或计量任何内容——waybill status 报告 metering: PAUSED，因此状态永远不会静默。现有数据不受影响；将其改回以恢复。

• 降低提示频率："notices": { "level": "minimal" } 仅保留预算阈值行（"off" 会静音 Waybill 所有未经请求的发言——计量仍然运行）。续订提醒（budgets.renewal_reminder_days，默认 14 天）遵循相同的开关。

• 带走你的数据：waybill export --format json（或 csv）输出支出账本；整个账本已经是 ~/.waybill/ 中的纯 JSONL——你拥有的本地 git 仓库。将其复制到任何地方；没有任何内容是专有的。

• 卸载工具，保留数据： claude plugin uninstall waybill@waybill，然后重启 Claude Code。 钩子和技能消失；~/.waybill/ 仍然属于你。

• 删除所有内容：rm -rf ~/.waybill（或如果你设置了 $WAYBILL_HOME，则删除该路径）。这就是全部足迹——Waybill 不保留其他状态。~/.claude/ 下的会话记录属于 Claude Code，而非 Waybill，并受其 cleanupPeriodDays 设置管辖。

与替代方案比较

文档

• 教程：本 README 快速入门，如上。

• 操作指南：将 Jira/GitHub 替换为 Linear、GitLab、Bitbucket…

• 参考：账本条目和配置 schema · 技能参考 · 测试计划——Claude 阅读的文档就是你阅读的文档。

• 解释：价值度量方法论 · 路线图和范围 · 品牌和声音 · Schema 冻结和迁移策略

• 规范：完整产品规范——已发布引擎实现的规范性设计。

常见问题

没有 Jira 或 GitHub 也能工作吗？ 是的——这是默认模式。纯 Git 模式无需任何配置和认证：计量、按分支/固定点归因以及引导收据都基于本地数据运行。连接跟踪器/git 主机可以升级收据；任何带有 MCP 服务器的跟踪器都可以替换进来（适配器）。

如果我的公司不分配代币，我可以用这个做绩效评估吗？ 是的——这就是 perf-review 预设。代币推介是账本的一个输出，而非其目的。

我的数据隐私吗？ 本地 JSONL 位于你的主目录下；唯一的网络调用是你授权的 MCP 调用，范围仅限于你自己的项目。

为什么它不会将我与其他团队成员比较？ 故事点在不同人之间不可比较，抓取同事数据会被视为监视，而且你自己的轨迹本身就是更强的证据。（方法论 §6）

我如何向经理证明 AI 支出的合理性？ 运行 sync，然后说 "build my token pitch"。带上那一页纸；保留账本以待后续问题。

贡献

欢迎提交 Issue 和 PR——请参见 CONTRIBUTING.md、路线图 和标记为 good first receipt 的 Issue。其他跟踪器的适配器配置是最受欢迎的贡献。请阅读 行为准则；安全报告通过 SECURITY.md 提交。

许可证

MIT