本机未安装四个产品（2026-09-25 盘点 not_found，~/.cline 等候选路径不存在；
real_verify 四例 discovered_roots=0 的结果为依据）。按用户指示以固定源码/官方文档
级依据实现，合成测试通过；真实数据验收后置（安装后经 discover 自动发现，
real_verify 入口复验）。适配器与测试数据均明确标注所用文档或源码依据。
元信息
| 项目 |
内容 |
| 日期 |
2026-09-25 |
| 执行环境 |
Windows 11 x64；rustc 1.98.0 |
| 代码 revision |
未提交工作树（M3/M4 批次之后 + 本次） |
| 设计依据 |
adapters.md（A03/A08/A24/A09 固定源码版本）；V03/V07/V12/V17/V30 |
| 执行方式 |
三个并行子代理因 API 限额中断（2026-09-25 21:33），适配器目录已完整（5 文件/个）且编译通过；主会话补齐测试、examples、内联缺陷修复并集成 |
实现与依据
Cline（A03，固定源码 dcf8c3c）
- usage 记录：type=“say” 且 say ∈ {api_req_started, deleted_api_reqs,
subagent_usage} 消息的
text JSON（tokensIn/tokensOut/cacheWrites/
cacheReads/cost 逐字段可选）；四桶互斥，input_total=in+cw+cr 派生；
“compaction” 估算不入账；任务目录 tasks/<任务 id>/ui_messages.json（整写数组）。
- 主会话修复（子代理未跑到的内联测试暴露）：
request 键补入已知键集合
（A03 文档记载字段）；map_cost 补负值/非有限拒绝（与 parse 口径一致）。
- 格式测试（3）：合成 contract 完整采集流程（3 调用 input 475/total 530 人工核算）+
重复读取不重复入库；能力声明含文档级标注；缺口场景部分可用。
DSH（A08，固定 token-meter README 46a7f68）
- 折叠规则：final 样本替换同 attempt 流式值；retry-started 结束替换范围并
新开计费 attempt；attempt/step 边界定稿末样本；occurred_at 用观察时间
（README 无逐事件时间）；pressure/contextBreaks 估算不计账。
- 格式测试（4）：contract（2 计费 attempt input 140/total 158，含一次
流式→final 替换 + retry）；replacement 场景（3 attempt input 195/total 208）；
非用量词汇不产请求；能力标注“合成假设”。
- 保存路径与行序列化未文档化：JSONL 行形状为合成假设（能力声明如实标注）。
Hermes（A24，固定源码 ef70b36）
- session_model_usage 是模型/路由/任务累计表（非逐请求）：映射为来源区间
汇总（UsageObservation/区间聚合），api_call_count 不拆成 model_call，
跨日 first_seen/last_seen 不把累计全放最后一天（V03 Hermes 行）；
辅助 task 累计与主会话累计互斥求和。
- 格式测试（8，子代理完成、主会话修类型/断言两处）：basic 累计、跨日、
辅助互斥、v20 回填/压缩继承、能力 evidence_level=doc-level。
- 测试数据：projection.json → SQLite 重建（schema DDL 随提取数据保存）。
OpenClaw（A09，官方文档）
- 文档只给出存储位置形状（
~/.openclaw/agents/<id>/agent/openclaw-agent.sqlite
与旧 sessions/ 归档），未文档化表级/条目级 schema ⇒ 运行时库与旧归档均
unknown_format fail closed（诊断 reason 注明待真实样本），不读表、不猜字段、
不产零值；归档按迁移输入降级（官方 doctor –fix 迁移路径）。
- 格式测试（3）：运行时库 fail-closed + 重复读取不重复入库；归档不入账（占位数值 1200+300
等明确不计）；能力声明如实。layout.json → 临时目录重建（sqlite/json/jsonl）。
命令与结果（主会话集成后）
| # |
命令（cwd） |
退出码 |
结果摘要 |
| 1 |
cargo test -p llm-usage-core |
0 |
全绿（新增 cline 3 + dsh 4 + openclaw 3 + hermes 8 + 内联若干；verify 53 个测试二进制） |
| 2 |
cargo run --example real_verify_{cline,dsh,hermes,openclaw} |
0 |
四例 discovered_roots=0（not_found 核验结果；无数据目录） |
| 3 |
npm run verify |
0 |
lint 0、clippy/fmt 干净、前端构建不变 |
| 4 |
APPDATA=<临时> cargo run -p llm-usage-m0 -- --headless |
0 |
14 适配器注册；7 实例 27,158 事件（与上批一致量级，活文件微增） |
过程缺陷与修复
| 处 |
问题 |
修法 |
| scanner.rs |
适配器注册表两次被外部改写回旧内容（编辑器/工具回写旧缓冲；探针定位：app 零发现 vs 探针 7 根） |
重新接线并以断言式脚本验证；新增 examples/discover_probe.rs 诊断工具（按 app 同一上下文逐适配器打印发现根） |
| cline 内联测试 |
“request” 未入已知键集合；map_cost 不拒负值 |
补键集合 + 非有限/负值拒绝（口径与 parse 一致） |
| hermes_contract |
元组类型第 4 位误标不可空；evidence_level 断言过严 |
改可空类型；前缀断言 |
OpenCode / MiMo Code / Zoo Code（2026-09-26 第二批，A17/A14/A19）
- OpenCode（固定源码 0027387）：逐次数据可得——part 表
data.type="step-finish"
部件携带 tokens{input(未缓存),output,reasoning,cache{read,write}}+cost；语义经
projector/publish-llm-event 逐字证实（inclusive inputTokens=in+cr+cw、
total=五字段和）；session.tokens_* 仅对账（本实现 matched）；message.data
turn 聚合不读防双计；逐调用精确时间/模型切换序待 event 层（observed_at 口径）。
- MiMo Code（456678b）：与 OpenCode 同形；
message.agent_id 互斥指纹；
session 无累计列；MIMOCODE_HOME/data 路径；不从 fork 推兼容（双向 fail closed）。
- Zoo Code（f780647）：Roo 血统整写 ui_messages.json；LIFO 配对合并
（finish 覆盖 start、无配对丢弃）；condense_context.cost 计上游 totalCost
（辅助调用、token 未知）；tokensIn 含缓存（与 opencode 家族相反）。
- 家族共享模块
adapters/opencode_family.rs（OpenCode+MiMo 共享 step-finish
扫描核心，产品身份注入）；格式测试 16 个 + 模块单测 12 个绿。
- 跨产品碰撞发现与修复：kilo 数据目录存在同形
opencode-rc.db，首版
discover 曾误识别为 OpenCode 库（14 事件对账 matched 证实同形）；修复为按
数据目录名收敛（仅 opencode/mimocode 目录或 MIMOCODE_HOME data 直接子级），
修复后 not_found 与盘点一致，负向测试覆盖，capability 记录碰撞风险。
未完成项
| 项 |
状态 |
后续 |
| 七产品真实数据验收 |
后置（本机 not_found） |
安装后 real_verify 复验 + 脱敏测试数据 补取；逐 session.version 升 known_version |
验证产物
- 适配器：
adapters/{cline,dsh,hermes,openclaw}/；
- 测试：
tests/{cline,dsh,openclaw,opencode,mimo_code,zoo}_contract.rs、tests/hermes_contract.rs；
- 测试数据：
tests/fixtures/{cline,dsh,hermes,openclaw}/（合成 + 期望文档）；
- examples：
real_verify_{cline,dsh,hermes,openclaw,opencode,mimo_code,zoo}.rs、discover_probe.rs。
