# 账单文字提取与独立检查

`bill-v1` 把一份账单文字交给 `bill-extract-v1` 提取商家、金额、币种，再把原文和完整提取结果交给 `bill-check-v1`。两个服务分别报价、分别结算；买方复用原任务编号和付款记录，通知及恢复沿用持久队列。

2026-10-11，经负责人批准新测试额度，账单专用服务已在 gamehk 发布；[profile](https://agenavo.xyz/api/bills/v1/profile)提供本轮获准服务。两个内部真实模型目标完成提取、独立检查和分别结算，正常目标通过，歧义目标正确返回 `CHECK_FAILED`。现有 CSV 和文档服务仍使用各自原有资料及权限。详见[真实验收记录](bill-live-verification-2026-10-11.md)；后续新轮额度仍需明确批准。

## 提交示例

向目标 MCP 的 `submit_goal` 提交：

```json
{
  "job": {
    "version": 1,
    "jobId": "bill.example.001",
    "workflow": "bill-v1",
    "objective": "提取账单商家、金额和币种，再检查每项原文证据。",
    "document": "在星河咖啡消费CNY 128.50。"
  }
}
```

账单固定三个字段，不接受 `fields` 或任意服务选择。省略 `workflow` 的旧任务继续按原文档规则执行，其输入哈希、模型请求和任务编号保持原绑定。

可用 `goal_status` 查询阶段，`goal_result` 读取交付，`goal_events` 读取终态或暂停通知，`ack_goal_event` 确认相应通知。后三项使用原 `jobId`，通知额外绑定 `consumer`。查询不调用模型，也不签署交易。终态结果包括真实记录的 `paidMinor`、`refundedMinor` 和交易引用；交易引用本身只属于 `protocol-metadata-only`，链上真实性需单独审计。

## 支持范围和原文证据

当前 grammar-v1 支持限定的账单格式：

- 商家行：`Merchant:`、`Vendor:`、`Store:`、`商家：`、`店铺：`。
- 合计行：`Total:`、`Amount due:`、`Total paid:`、`合计：`、`总计：`、`应付金额：`、`实付：`。
- 币种行：`Currency:`、`币种：`、`货币：`。
- 简单句：`在星河咖啡消费CNY 128.50。` 或 `Paid USD 8.50 at Cafe.`。

金额仅接受非负十进制，最多两位小数和合法三位千分分组，输出为带两位小数的字符串。支持 CNY、USD、EUR、GBP、JPY 及协议列出的明确别名。单独的 `$`、`¥` 或 `￥` 不足以决定币种，不能据此猜 USD、CNY 或 JPY。小计和税额不直接当作合计。

每个字段返回 `found`、`missing`、`ambiguous` 或 `unsupported`，并附全部受限候选的证据。候选证据包含 `start`、`end`、`text`；位置从零开始，按 Unicode 字符计数，末端不包含在区间内。原始换行、emoji 和 Unicode 保持原样，JavaScript 应使用 `Array.from(document).slice(start,end).join('')`，Python 使用 `document[start:end]`。证据文字必须恰好等于原文对应区间。

缺失、冲突或不支持的值返回 `null`，外层 `needsReview` 为 `true`。同一值重复出现可保留多项出处；相互矛盾的金额不会强选其中一个。独立检查重新核对任务编号、文档及交付哈希、字段、归一化值、区间和复核标记。

正确的否决报告完成了检查服务的工作，因此检查费用正常支付；父目标返回 `BUSINESS_FAILED / CHECK_FAILED`，保留实际费用。错误的交付由结算检查拒绝，按原托管退款流程处理。退款不清零累计消费权限。

这是受限账单文字原型，暂不处理 PDF、图片、OCR、任意收据语义或自动记账决策。输入上限 16 KiB、128 行、每行 1 KiB、商家值 256 字节、每字段最多 16 个候选；超限拒绝，不能静默截断。

## 验证和独立发布

2026-10-05 开发验证的跨语言 fixture 覆盖中英文句子、CRLF、emoji、缺失、币种歧义、冲突金额、非法金额和伪造证据。合成买方和隔离 Hardhat EVM 测试验证分别付费、错误证据退款、正确否决付费和重放零增量；这些本地测试与后续真实模型任务分别记录。

2026-10-11 实际发布使用独立账单账户、买方和供应方权限，服务资料位于 `/api/bills`，内部 API 固定监听 `127.0.0.1:8796`。沿用原模型池和缓存，不建立替代计数池，不更改旧任务、旧账户或旧会话上限。

本轮已授权模型累计上限 56、独立买方四次购买与 1.2 ATUSD 合计额度、单次 0.4 ATUSD，账户铸造 2 ATUSD 测试储备。两个父目标各用 7 次买方决定，供应方共 4 次调用，实际新增 18 次；共享计数 `35→53/56`。11 笔 setup 加 12 笔任务交易共 23 笔接受交易经独立核验，实付 1.2 ATUSD、退款零、账户余 0.8 ATUSD。买方购买次数和累计付款额度已用完，余额不自动恢复这些权限。

实际 `SIGTERM` 后恢复、重复提交、通知确认及目标 MCP 读取均保留原编号、签名日志和缓存；终态重放新增交易和模型调用为零。目标 MCP 将正确否决结果返回为 `BUSINESS_FAILED`、退出码 2、`isError:true`，仍保留已支付检查费。尚未完成独立外部开发者试用、物理断网和跨日验证；单主机测试链不代表去中心化公众网络，有限文字规则不证明任意财务任务正确。全部资产仅为测试用途，无赎回价值。
