agentacct

一个本地优先的编码 agent 工作账本。它读各家客户端本来就会写的会话文件——Claude Code 的 JSONL 记录、Codex 的 SQLite 状态与 rollout、Hermes 的状态库、OpenCode 的会话汇总、OpenClaw 的 JSONL、DeepSeek Harness 的压缩日志、Kimi Code 按请求写的用量事件——同时通过 MCP 与宿主钩子记下 agent 自报做过的事，然后用真实的会话 id 把两边接起来，并给每一个接合处标上置信度。一个任务最后变成一张回执：参与的会话、记录下来的结果、带退出码的检查、活动时间线、token，以及用 ≈ 画出来的成本估计——因为那是按价目表算的估计，不是账单。什么都不出本机：不要账号、没有遥测、不存 provider 密钥，也不会去接管它没有亲手启动的 agent。它以一个 Python 命令行与终端界面加一个已签名的 macOS 应用交付，八个客户端各有强弱公开可查的接入路径。

谁做的这个仓库挂在 GitHub 账号 mikehasa 名下，提交历史里有 484 次提交中的 210 次算在他头上；第二个账号 FZ2000 落地 159 次，另外三个人各一到三次，还有 110 次提交根本没有关联账号。元数据里没有出现真名，而 homepage 字段指向 https://trytofu.ai，那个页面的标题是「Tofu puts your AI-built app online in 10 minutes」，讲的是另一个产品。

1. 01

   两个月、42 个版本，以及第一周里的两次改名

   仓库建于 2026-07-24，第二天就发了 0.1.0：一个本地优先的账本，从本地会话文件里导入客户端自报的 token，通过 MCP 记下工作上下文，用置信度把两边接起来，画在一个本地面板上。六十八天之后，changelog 里已经有 42 个版本段落，最后一节停在 2026-09-30 的 0.12.9；提交历史有 484 次提交——210 次算在所有者名下，159 次属于第二位贡献者，110 次没有关联账号，另有五次分散在三个人身上。键盘前并不只有一双手：79 条提交带共同作者尾注，其中 74 条点名了某个 Claude 模型，最大的一群是那 59 条写着「Claude Fable 5.1」的。这个项目在第一周里还给自己改过两次名。0.5.0 把 MCP 工具从 sentinel_* 改成 agentacct_*，把 Python 包从 agent_chronicle 改成 agentacct；0.5.1 把 AGENTACCT_* 定为主要的环境变量前缀，同时宣布旧名字永久继续接受。留下来的痕迹是项目级存储目录——它到今天还叫 .agent-sentinel/state。

2. 02

   工作步骤是 agent 自己写下来的，而证据压过措辞

   agentacct 不会盯着一个 agent 去猜它干了什么；步骤记录是 agent 自己写的。通过 MCP，agentacct_record_section 把一段工作以 started 打开，中途补 checkpoint，最后以 completed、blocked 或 handed_off 关闭；测试运行这类机器检查另有记录，并带上退出码；而装进客户端的钩子桥只补工具活动的节拍和工作目录下的相对文件元数据，绝不包含提示词、回复、思考或工具正文。一次检查算不算数，取决于它是怎么被观察到的，而不是 agent 怎么措辞——像「tests passed」这样的文字永远不会被解析成一个通过——而一个做完的任务只会渲染成 Reported（agent 自己说的）或 Verified（要求有一次晚于最后一次改动、且通过的检查）。还有两条尚未合并的 pull request 在把这份契约勒得更紧。编号 324 那一条，想让 progress 备注在段落以 completed 或 handed off 关闭时变成必填，长度 20 到 260 个字符，且最后一句必须以六个固定词之一开头，被拒绝时还会打印一个改好的示例调用；编号 335 那一条，则想把 agent 自己的说法——目标、最新的进展备注、下一步——放到被统计的指标之上，并标为 Agent reported。每一处与用量的接合都会带上 exact、high、medium 或 low，而继承来的会话 id 永远不会是 exact。

3. 03

   七种本地格式、一本账，以及一个不报 token 的客户端

   token 的真相只来自各家客户端自己写下的文件，而它们写下的形状各不相同。Claude Code 从它 projects 目录下的 JSONL 记录里读；Codex 从 state_5.sqlite 加上 rollout JSONL 里读，而那里的原始输入本来就包含命中缓存的输入，所以导入器会减掉自报的缓存读与缓存写、归一出一个非缓存数字，并且拒绝把推理 token 再加一次——因为它本来就是输出的一部分。Hermes 来自 state.db 里的会话行；OpenCode 来自原生 opencode.db 的按会话汇总，实在没有数据库时退回导出的 JSON 事件流；OpenClaw 来自 JSONL 里的助手行；DeepSeek Harness 来自 ~/.dsh 下 Zstandard 压缩的会话日志，那里记了 token 却完全不记成本；Kimi Code 则来自 session_index.jsonl 索引加上每个会话 wire 流里按请求写的 usage.record 事件——那些是增量、从来不是累计值，所以导入器把它们加起来。Cursor 是那个刻意的例外：它的主库 state.vscdb 只给出 composer 身份、时间戳和子节点链接，而一个拿不到的 token 数字就保持「不可用」，不会变成零。支持的强度按能力而不是按 logo 公布——会话发现、用量导入、机械采集、MCP 语义、模型归属、缓存读、缓存写、一键安装各评各的——另外还有五个 agent 只列在路线图上，背后什么都没有。

4. 04

   那个钱数从哪来，以及它不是什么东西

   金额是估计，而且被当成估计标出来。token 是 client_reported，从客户端自己的会话存储里读出来。成本是 estimated_from_tokens：把那些 token 乘上项目本地保存的 LiteLLM 公开、由社区维护的模型价目表快照，画成 ≈$；而 ~$ 表示一个已知不完整的部分合计。内置价目表刻意做得很小，到 gpt-5.5 就停了；任何价目行都没覆盖的模型 id 会停在成本未知，而不是去拿一个相邻价格凑数；缓存读的价是输入的 0.1 倍，缓存写按输入价；另外有三个别名把客户端自己的路由名映射到表上——claude-code 对 anthropic，codex 对 openai，DeepSeek Harness 的 deepseek-official 对 deepseek。快照一过七天就自己刷新，尽力而为，失败后一小时内不再重试，于是网络不可达永远不会挡住一次导入。文档对「这个数字不是什么」写得毫不含糊：订阅用户并不按 token 付费，所以这个估计不是他们实际付的钱，而且它根本没有账单接口。已存的用量行也不会自愈，因为一次扫描只会给现在有价目行覆盖的行重新定价——这就是为什么有一个补丁专门加了一条命令来解释某行为什么没有成本，也是为什么某个 Codex 模型缺一条价格会单独发一个版本。

5. 05

   作者自己那台机器：22.8 GB 的证据，和一套先失败后写下的发版流程

   作者就是在写它的那台机器上用它，那些数字直接留在 changelog 里。只追加的证据 spool 涨到过 22.8 GB，而由它建出来的投影只有 277 MB，抽样显示其中约 94% 的字节是剪枝之后留下的死影子行。一次经过校验的冷压缩在编号 328 落地，但难的是证明它安全：在一个被剪枝过的存储上，「与线上投影完全相等」永远不可能成立，而从零重放那三百万行 spool 的速度大约是每秒 137 行——差不多六个小时。于是那道闸门改成了包含性证明，之后还得学会把离线窗口期间实时用量通道写进来的行排除在外。修好之后，作者那台机器的存储从 21.24 GiB 变成 131.7 MiB。同一种维护也出现在测试里：编号 340 重新校准了一个显示门槛，它已经从「低于 15%」漂到 3,592 个不重复工作标题里的 22.4%；编号 342 追的则是一个只因为两天夹具跨了不同日历日、而周粒度以周一为锚才出现的失败。发版用的 pull request 必须写明 macOS 磁盘镜像是要重建还是可以沿用，因为这个应用里嵌了一份冻结的 Python 命令行——这条规矩是在它失败之后写下的：连续四个版本发出去时根本没有磁盘镜像，下一个版本存在的主要意义就是把镜像补回来。

6. 06

   它承认自己做不到的事，以及外面那一小圈回响

   agentacct 自称早期 alpha，并把局限写在能被查验的地方。它不去扫描或接管自己没有启动的 agent，不复制提示词、回复、思考或对话记录，不保存 provider 密钥，也不提供托管服务；Windows 只能通过 WSL 使用，那个已签名的 macOS 应用是给不想装 Python 的人准备的。覆盖矩阵承认同一个客户端可以同时拥有一条已被验证的用量通道和一条实验性的采集通道，而它确实如此：Kimi Code 的钩子桥已经在真实桌面会话里触发过——五个会话、64 条 payload——但还没有任何一次真实会话被观察到把记录下来的段落绑到自己会话 id 上；Cursor 只能证明会话存在，对 token 一无所知；OpenClaw 的路由元数据也还没接进来。日期维度是整个会话总量归到某个活动日，API 把这一点作为限制暴露出来，而不是假装能做到按天拆分。仓库里留着整套纸面痕迹：用量限额改版下 100 个编号评审文件，旁边还有批评与综合文档；动画计划里一份 215 KB 的场景矩阵；以及一份自带审计脚本的数据质量计划。外界的注意力小而具体——一位贡献者的可读性清理（changelog 里点名致谢）、另一个账号修掉一个过期导出文件的问题，以及一条主动找上门的接入请求：编号 349，来自 MemCode 的创始人，问要不要接受一个导入记忆保存与召回元数据的可选导入器，并承诺绝不摄入记忆正文、提示词、凭据或源码文件。