[Feature] 支持 获取真实的ACUs 计费

[zhonxinya]

想要什么功能 / What feature?

Devin 官方支持 ACUs 计费，可以接入获取真实的用量吗？

替代方案 / Alternatives considered

No response

最小验收标准 / Minimum acceptance criteria

No response

是否愿意提 PR / Willing to submit a PR?

• 我想自己实现 / I'd like to implement this myself

[dwgx]

可以接,而且比想象的近 —— 上游一直在给这个数据,解码器也早就写好了,缺的是最后一环接线。这一轮已经接上了,但有一部分我这边没法验证,需要说清楚。

现状:数据在,消费者是零个

committed_acu_cost 是上游 GetChatMessage 响应里的一个字段,和 credit_cost / committed_credit_cost 同族。src/devin-connect.js 在 finish 事件上一直会带上它:

usage:   { ... }
billing: { credit_cost, committed_credit_cost, committed_acu_cost, ... }   ← 一直都有

但它到不了任何地方。逐层查下来是四段断链,而且每一段单独修都没有可观测效果:

devin-connect.js        finish 事件带 billing              ✅ 一直有
devin-connect-openai.js 适配层解构 finish,不转发 billing   ❌ 死在这里
chat.js                 5 个 recordAccountSpend 调用点      ❌ 全都不传 creditCost
auth.js                 recordAccountSpend({ creditCost })  ✅ 参数早就有,永远收到默认 0
dashboard               `credits > 0` 才渲染那一行           ✅ 会渲染,但永远是 0

也就是说 Dashboard 里那个"消耗额度"的条件渲染,在结构上只可能不显示 —— 不是没做,是最后一环没接。

这一轮接上了什么

三处:

1. devin-connect-openai.js 流式与非流式两条路径都透传 billing(顺带修了一个自己引入的:rescue 重试时上一次尝试的计费会被算进这一次,attempt_reset 要一并清掉)
2. connect 的 4 个 recordAccountSpend 调用点传 creditCost(第 5 个是 Cascade 路径,不动)
3. 顺带把 #1.13.1.21 那张逐模型 credit 费率表也接上了 —— 那是 [Feature] 如何快速配置只使用免费模型 #235 的核心,fetchUserStatus 此前没传 catalog,所以费率表停在未配对的裸浮点数组

实测 per-account 累计:

recordAccountSpend(key, usage, { creditCost: 2.5 })
recordAccountSpend(key, usage, { creditCost: 1.25 })
→ totalSpend = { requests: 2, totalTokens: 30, creditCost: 3.75 }

我这边验不了的部分 —— 这条要你或者有付费号的人帮忙

ACU 的 tag 号没有校准。 当前默认只有两个是校准确认过的:

DEFAULT_BILLING_TAGS = 'cache_read_tokens=5,cache_write_tokens=4'
                        ↑ 这两个 paid-verified
credit_cost / committed_credit_cost / committed_acu_cost
                        ↑ 只有声明顺序推测,tag 号未验证

所以接线虽然完成了,但在没有显式配置的部署上,billing 里压根不会有 committed_acu_cost 这个字段 —— 解码器不知道去第几个 tag 取它。要真的看到 ACU 数字,得先校准:

DEVIN_CONNECT_BILLING_TAGS="credit_cost=6,committed_credit_cost=7,committed_acu_cost=8"

那三个数字是当前的推测值。校准要一个付费 token跑一次真实请求,把 DEVIN_CONNECT_DEBUG_META 的 dump 和账单对一下。我本机账号池是空的(data/accounts.json = []),这一轮全部验证都是进程内的、零上游调用,所以这条我没法自己确认。

如果你有付费号,方便的话跑一次:

DEVIN_CONNECT_DEBUG_META=1 npm run calibrate:devin

把输出里 billing 相关的 tag 编号贴出来就行(不要贴 token)。有了真实 tag 号,ACU 就是开箱可见的,不需要再改代码。

一条纪律,顺便说明为什么不走"没数据就当免费"

这条和 #235 是同一个坑的两面:字段缺失绝不能静默放宽。免费账号可能压根不带费率表(它在 plan 子消息里),那种情况必须回落到保守白名单,而不是当成免费 —— 后者烧的是用户的付费配额,正是 #235 那位踩的坑的放大版。所以实现里钉了几条:

• 未配对(数组形态)的费率表一律忽略 —— catalog 取失败时那些浮点数没有 selector 可归属,按位置猜会把任意模型标成免费
• 只有严格 rate === 0 判免费,极小非零仍然计费
• 无表时返回 null 而不是空集合 —— "不知道"和"没有免费的"必须区别处理
• 与静态白名单取并集而非替换

验收标准

你这条 issue 没填验收标准,我按下面这个理解在做,不对的话说一声:

1. Dashboard 的账号详情能看到该账号的累计 credit 消耗(接线已完成,等 tag 校准)
2. 逐请求的 ACU/credit 成本能被记录,而不是只有 token 数
3. 缺数据时显示"未知"而不是显示 0 或猜一个数

第 3 条是我加的 —— 显示一个假的 0 比不显示更糟。

会随 v3.9.8 一起发。#235 / #234 是同源,一起处理。

[dwgx]

更正上面那条回复里两处会误导人的地方。

1. 那张断链图把 committed_acu_cost 画成"一直有",自相矛盾

我上面写:

devin-connect.js        finish 事件带 billing              ✅ 一直有

这句不准确,而且和我在同一条回复后半段说的话矛盾。准确的说法是:

devin-connect.js 一直会在 finish 事件上带 billing 这个对象,但对象里只包含 tag 已
校准的字段。默认只有两个:

DEFAULT_BILLING_TAGS = 'cache_read_tokens=5,cache_write_tokens=4'

所以在没有显式配置 DEVIN_CONNECT_BILLING_TAGS 的部署上,billing 里压根不会出现
committed_acu_cost —— 解码器不知道去第几个 tag 取它。图里那个 ✅ 应该读成"通道一直在",
而不是"ACU 数据一直在"。

后半段"我这边验不了的部分"那节说的才是对的:接线已完成,但 ACU 要真的显示出来,得先有人用
付费 token 校准 tag 号。两句话我应该写成一致的。

2. 门禁数字写错了

上面写"会随 v3.9.8 一起发",这条是对的 —— 接线确实随 v3.9.8 发布了。但我在 #235/#234 的同批
回复里引用的门禁数字是错的(3245/3195)。在 tag 上重测的权威值:

v3.9.6 = 3119
v3.9.8 = 3246     ← 本 issue 的接线随这版发布
v3.9.9 = 3264

v3.9.7 从未打 tag(折进 v3.9.8 发的),所以不存在"v3.9.7 基线"这个说法。

仍然需要的东西没变

DEVIN_CONNECT_BILLING_TAGS="credit_cost=6,committed_credit_cost=7,committed_acu_cost=8"
里那三个数字仍是推测值。有付费号的话跑一次:

DEVIN_CONNECT_DEBUG_META=1 npm run calibrate:devin

把 billing 相关的 tag 编号贴出来就行(不要贴 token)。有了真实 tag 号,ACU 开箱可见,
不用改代码。

[dwgx]

#239 能做的接线已经在 master（28b4851），默认仍然关。

解码器现在能读 varint / fixed64 / fixed32。acuCost 和 credit 分列，不会加在一起。默认 map 只有已校准的 cache tag：cache_read_tokens=5,cache_write_tokens=4。

要看 ACU 自己开：

DEVIN_CONNECT_BILLING_TAGS=cache_read_tokens=5,cache_write_tokens=4,committed_acu_cost=^22

^22 是顶层 tag 22。这条身份还没被仓库里的真帧钉死（测试自己写 22 再解 22 只证明 codec）。默认开错 tag 会把数写进 accounts.json，所以默认关。有付费号的抓一帧 DEVIN_CONNECT_DEBUG_META=1 的终帧顶层 #22 kind/preview，加上同一时刻官方周期 ACU，就可以谈默认开。

#256 还开着，等这条证据。这条 issue 不关。

[dwgx]

v3.9.24 已打 tag。接线在版本里，默认仍关。opt-in 写法见上一条。这条 issue 等真帧钉死 ^22 再关。

#256 作者实习结束、付费号没了，给不了终帧。剩下能对账的是这条的原报告。要谈默认开，仍要（不要贴 token）：

1. DEVIN_CONNECT_DEBUG_META=1 的付费终帧，顶层 #22 的 wire type / preview
2. 同一时刻官方周期 billed_acus

acuCost 和 credit 仍然禁止相加。