NEXT-02 · uumi 真实接入
实例核查、三次真实文本调用、用量关联及后续计费边界
本文保留最初协议探针的交付范围。后续已完成 真实 Chat 与 Core 扣费增量，当前计费进展以该记录为准。
2026-09-20 完成真实实例审计与 Edge → uumi → 既有渠道 的三次有限调用，并通过独立网关消费日志核对用量。用户已明确授权本次真实接入；没有迁移客户、改变渠道价格、重启应用或切换生产入口。
这是 NEXT-02 的交付。Core 真实计费、常驻服务环境、生产容量仍归 NEXT-04–07，不能用本次协议成功代替。
运行实体与选择
| 主机 | 观测到的 uumi 容器 | 运行状态 |
|---|---|---|
| ow-main | 4 | 全部健康，本次选第 1 个实例直连 |
| oceanway2 | 2 | 全部健康，管理与日志查询在此核对 |
| oceanway3 | 2 | 全部健康 |
| pic-vps | 1 | 健康；同机另有独立 upstream 应用，未混为 uumi |
| oceanway | 0 | 当前没有 uumi 容器，不能沿用旧部署文档的数量 |
9 个 uumi 实例具有相同镜像 new-api:uumi-tos-native-70c9f3849ed4，实际镜像 ID 为 sha256:8c10b404b0bd7145a92b8045705f8054bcc8a5eb962809eb36010b2c43b4af4f。运行配置观测到 relay/stream/header 超时均为 1800 秒；本次探针独立限制 60 秒总超时、30 秒空闲超时，没有改变生产配置。
ow-main 的 HAProxy 配置仍有 10 个后端，实际 8 个 UP、旧 oceanway 两个 DOWN；后端整体 UP。pic-vps 实例未列入这组池。本次通过 SSH 转发直达健康应用端口，未经过公网 TLS/Caddy/负载均衡，不能宣称公共入口全链路验收。
现有 gateways/oceanway-text-gateway 部署目标是独立 upstream，不是本次 uumi。uumi 的外部源码目录 /Users/wangzihao/Projects/new-api-api-oceanway 有部署记录与代码，但 Git worktree 指针失效；其文件已记录哈希，仅作为静态参考，不能证明与运行镜像同版。Core/Edge 固定参考 385d2df 保持不变。本次以镜像 ID 固定实际运行版本，未修复或更换网关仓库。
真实调用结果
同一模型 claude-haiku-4-5，固定短提示，每次 max_tokens=16，专属临时 Key、固定渠道 124，无自动重试；首次失败即停。调用发生于 2026-09-20 15:24（北京时间）。
| 场景 | HTTP / 终态 | 最终输入 / 输出 | 网关消费日志 | 网关 quota |
|---|---|---|---|---|
| OpenAI Chat JSON | 200 / complete | 11 / 4 | 5419305 | 19 |
| OpenAI Chat SSE，include_usage | 200 / complete，6 事件 | 11 / 4 | 5419320 | 19 |
| Anthropic Messages SSE | 200 / complete，7 事件 | 11 / 4 | 5419330 | 19 |
三次 Edge request_id 均关联到独立的 X-Oneapi-Request-Id，再按网关 request_id 精确查询消费日志；校验 token_id、模型、渠道、流式标志和最终输入输出一致。网关还记录 upstream_request_id，但本次没有继续查询供应商原始账单。
总计 57 quota，测试 Key 从 10000 剩余 9943。配置读到 QuotaPerUnit=500000，它是现网计量换算参数，不能作为新平台的人民币充值比例；网关 quota 也不能直接当成 OceanWay 客户价格或供应成本。RetryTimes=0、消费日志开启；日志存储保留期限未证实，性能指标的 retention_days 不等于消费日志保留期。
临时 Key 归属于既有管理员账户，只有本次模型白名单、有限 quota 和两小时有效期。测试结束通过管理 API 禁用，确认 status=2；本地 0600 密钥文件删除，SSH tunnel 关闭。管理凭据仅在远端进程内使用，未记录到文件或输出。正式环境仍须建立独立服务账户与最小权限的日志查询接口。
协议与恢复能力矩阵
| 能力 | 证据级别与结论 | 下一步 |
|---|---|---|
| Chat 普通 / SSE | 本次模型真实通过；OpenAI 请求交由 uumi 转换，上游 Anthropic 用量可见 | NEXT-05 定义真实计量 profile |
| Messages SSE | 本次模型真实通过；原始 Anthropic 请求透传，初始与最终用量可区分 | NEXT-07 接入客户计费 |
| Messages 普通 | 路由/本地回放有证据，本轮没有真实调用 | 按模型补实测 |
| Responses | 本地回放及静态路由存在，实际模型支持与真实用量未确认 | NEXT-07 单独验证 |
| Gemini 原生 | 本地回放及静态路由存在；query Key 剥离后由服务 Key 转发，真实模型未验证 | NEXT-07 单独验证 |
| 错误、取消、缺 usage、断流 | Edge 本地回归覆盖；本轮真实供应仅测成功路径 | NEXT-05/06 故障矩阵 |
| 请求关联与用量查询 | 响应头 ID + 管理日志 API 实际可查，三笔计量一致 | 持久绑定 operation/attempt，并收敛权限 |
| 文本去重、重放 | 未取得网关幂等执行保证；媒体专用幂等不能外推 | 发送未知时核对或人工处理，禁止盲目重发 |
| 查询保留期 / 最终性 SLA | 尚未确认 | 网关与 Worker 明确保存、可见性和恢复窗口 |
| 预算硬上界 | 请求 max_tokens 与 Key quota 是控制措施，未证明覆盖所有供应成本 | Core/Contracts 明确可信上界及超界处理 |
只对本次模型与渠道得出真实可用结论；没有批量探测海量模型。后续模型采用相同逐项能力分级，未经实测保持待验。
已实现与必须补差
Edge 新增默认关闭、显式启用的 cmd/uumi-probe：不监听公共地址，只执行三次固定请求并输出结构化观察。请求经过真实 Edge Handler，上游走真实 HTTP/SSH，客户端侧是进程内 ResponseRecorder。生产 cmd/server 未开放业务路由，capture-chat-v1 仍只用于合成计量。
Observation 新增可选 gateway_request_id，只接收单一、合法、非 hop-by-hop 的 uumi 请求 ID，用于审计关联；不冒充 Core 的执行权或最终账务回执。增加重复头、非法头、过长头与 Connection 指定头的测试，以及探针默认关闭与凭据/模型限制测试。Go 1.25.1 全仓 race、vet、build 和 diff 检查通过；没有改动 Go 依赖、Core 数据或跨仓公开结算契约。
真实用量暴露的具体差异：
- Chat 的
completion_tokens=4，但同一响应兼容字段output_tokens=0，原始billing_usage.claude_usage.output_tokens=4。须按 semantic/source 选择权威字段，不能任取字段或重复累计。 - Messages 初始
output_tokens=1，最终为 4，不能相加。缓存创建、缓存命中、推理等维度本次都是零，非零时还需真实验证。 - 三次成功日志可关联，不等于发送前已有持久网关执行 ID。响应头丢失、进程崩溃后的查询恢复尚未闭环。
- 网关现有价格倍率不直接成为客户售价。新 Core 仍独立维护零售/企业价格快照和账务；后续基于完整用量结算。
后续确认：完整透传、网关标准计费、平台客户定价
用户提出：完整用量经 uumi 提供，标准计价也集中在 uumi；新平台只管理客户实际折扣价格。用户随后明确请求应完整透传、uumi 返回应包含足够计费信息，职责方向已确认，尚未修改现网配置或实现新结算契约。 现行定义见网关边界。
| 归属 | 建议职责 |
|---|---|
| uumi | 供应协议转换、完整计量及来源语义、模型标准价、标准费用明细、价格版本与最终计费回执 |
| Edge | 透传客户协议，关联请求并传递可信回执；不维护供应计量公式或另一套模型价格 |
| Core | 客户身份/Key、折扣及企业协议价、钱包和预算、保存标准价与客户价快照、最终结算和异常核对 |
普通折扣可按“uumi 标准金额 × 客户有效折扣”计算，客户专属规则按客户/模型设置；若企业要求固定单价覆盖，则 Core 按回执计费项与客户单价计算，不能假装所有协议价都能用统一折扣表达。充值赠送属于钱包入账规则，须和消费折扣分开。
现有 quota 已包含 group_ratio 等倍率，本次日志即为 1.25，因此不能把 quota 原样命名为标准费用，再叠加客户优惠。应由专用服务计费配置或独立回执输出优惠前标准金额，保留完整计费项和精度；不要修改既有 uumi 企业客户的价格。网关对内额度扣减只是供应接入侧账务，OceanWay 客户钱包仍只有 Core 一个写入方。
这要求后续提供可查询的最小权限回执：平台 operation/attempt 关联、gateway_request_id、final 状态、完整计费数量/明细、标准价版本及生效快照、金额单位/精度、标准总额。预留前也需可获取且可固定的报价/上界；执行期间改价和超预留有明确处理。金额需来自受认证的服务接口，不能信任客户端传回的 usage。原始协议 usage 可保留用于核对，Core 不重复解析各供应商协议来计费。
本次只证明原始 usage 与网关日志可获取；标准费用回执、报价快照和 operation 持久绑定尚未实现。上述方向约束 NEXT-03/05 的契约与商业规则实现，不将它标成现有能力，也不调整当前合成 profile。
交付与下一项
本机证据：coordination/handoffs/NEXT-02/ 的实例清单、池健康、选定配置、探针结果、日志核对、源码哈希与完成记录。可随 Edge 仓交接的脱敏运行证据位于 platform/oceanway-api-edge/docs/evidence/NEXT-02/，复验说明为 docs/uumi-probe.md。
本轮代码和文档保留在本地工作树，未提交、推送或部署；源码哈希已保存，NEXT-01 固定提交继续可复现。下一项为 NEXT-03：确定首发商业规则，尚未启动；NEXT-04/05 分别解决持久服务环境与真实客户计费。离线后端清理、uumi 源码工作树归属恢复已记录为后续维护问题，没有在本次探针中修改生产配置。