## 目标与基线 现有 Usage 为 input/output/total 三字段;#207 修复额外修复调用漏统计。本单补缓存命中、缓存写入、推理等供应商可提供明细及其包含关系,不重建预算系统。 ARGI Core `76d44429fdaa6a69320e21a1cb77119d0889d792` / Extensions `495414b76a37aca4d7c1022d973a8e5b9a7e92e6`;AgentScope Java 参考 `7976a20d7c59f535737f2df1b16a2bc24051575a`。本单来自源码/文档对照,是能力建设建议,不是已复现的生产 BUG 或已完成的功能。 参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/agentscope-core/src/main/java/io/agentscope/core/model/ChatUsage.java 建议阶段:后续增强。 ## 范围与验收 - [ ] 评估可选细分维度和来源标识,保留旧三字段语义及 unknown,不能把缺失明细当精确零或强迫供应商都提供。 - [ ] 明确哪些维度是 input/output 的子集、哪些是独立消耗,归集不能再次加到总数;区分累计快照与增量事件。 - [ ] 主调用、修复、重试、fallback、子 Agent、服务端工具的记录按稳定调用身份去重并区分范围,已计入子结果的 usage 不重复累加。 - [ ] 缓存命中不等同免费,不在框架写死价格或从文本猜测收费;#127 与配额适配消费该事实但仍拥有预算/限额逻辑。 - [ ] 覆盖部分未知字段、互相矛盾的供应商统计、流式重复快照、多次调用和序列化兼容;提供适配器映射及可查询诊断。 ## 关联与实现边界 #127、#137、#207、#236;agentic-ai-java/argi-extensions#18。价格结算与供应商账单核对不在本单范围。 复用已有定义、运行身份、日志、预算、授权及存储契约,不新建竞争的数据权威来源。独立 Agent/Workflow 不依赖 Graph/Loop;第三方协议、客户端 SDK 与外部后端留可选适配侧,Core 不导入 AgentScope SDK 或 Extensions。逻辑职责不自动对应新增 Maven 模块。先以模型无关/参考后端验证,再按范围给出真实服务或跨实例证据。破坏性变更需比较兼容方案,说明收益、消费者影响、目标版本与迁移/回滚;不因参考项目采用某设计而机械照搬。
Activity