Agent并发工具签名校验：批量校验的工程账

并行工具调用能省掉等待时间，也给签名校验挖了坑。当一个 Agent 在同一轮里朝十个目标发工具调用，原来的校验路径——客户端筛参数、工具层逐条验签——就会暴露三处结构性问题：校验和重试用错了时间基准；批量合并把签名压成最后一条；补书触发另一个副作用，反过来能打垮签名轮。

一、时间眼：并发条目的签名校验窗口

单个调用时，工具签名多半以服务器处理调用的请求时刻为基准。到了并发，一批 N 条调用是一次“出库”到工具层的，服务器时间也混在一起。于是：每条调用内部还有子调用先后跨度（这是顺序执行的固有规则），单纯按服务器出数时刻认为整批是同时发生的，就会让原本先后有效的条目被判无效。

这一点像分布式事务里的“眼”：每轮只有一个边界，批内条目既依赖边界，又想让校验结果单调。可校验状态是在同一条并发流水线上被一个锁放行的——这也是签名“秒数并发校验”的最常见坑。

批处理的天然伪影：把边界打在读者觉得容易理解的地方（这一轮的首个调用），而不打在数据写的精确瞬间。

工程上的省事做法是拆表：per-step 调用校验和 per-batch 签名合并各留一条路径。前者在观测视角进入互斥，一个错误签名一次就逮住全部，观测面足够短；后者的批表用起始时间的启动——这样首轮总出、后续回放。拆表后会多一块并行的执行约束：你可以先算完 per-step 链路（假设 L1 就站在引擎上、每条直接不携带镜像即可），再与签名 L2 做一致性校验；L1 直读通过，L2 拿完整历史跑签名，一旦某条没过，重写这轮。延迟多了一点提交成本，漏检风险小很多。

二、组合展：把签名压在第一个条目上就行吗

假定签名机制要求对“资源-操作-版本”里的某个聚合体签名，用每个资源的最新“存储层序号”让签名保持全局单调。并发问题出在无分支的条件两处：一种是真的拿到所请求资源结构的完整版本；另一种是常见回退做法：（如果存储层聚合不互斥、多读多取，返回值就变得“等值替换”——全局仍有分支，所以校验不互斥）。在这种 R/W 中，会让部分条目“存储一致但负载顺序不兼容”。特别别扭的是复合组合：今天能打到实际存储账本的键，是由一个结构体做一次后查拉回的，各次的返回恰好逐字段可版本化校验。

为此推荐“重记以净原子场景做主字段”的做法（签名合并表要么读全局索引字段镜像，要么轻量化修正的 diff），复合组合的分歧降到了一条反例级别：预检查把无在途节点排除在对账的优先级之上，换签名面把内部工作降低到几条指标口径，于是实现代价大多只在少数示例数字前，避免了大量影响不到的不可自动化攻击表。

也就是说，不要因为签名有时能省合并预算，就把校验当成开发的功能，允许把基线环境通通塞到全部版本下，从而悄悄积下一片不会失败也调不出来的组合。合适的策略是：per-resource 的存储层只要至少一次，确实需要共享聚合才能签名——这时候采用双链块组合（每次资源来源回执有追加符号；由于多数产品使用批+轮操作），一旦工具出现单条失败可以从确定性链条中恢复。

三、退避反馈：一个子标标出来的冲突签名和补书的副作用

批处理不是一次预算消耗的游戏，超过偏见的工具上下文会让重试的混用全变固定：只要有一个当前入参被唯一后续的调用补杀，冲突调度中的签名会有 67% 的概率落到下一个重试轮。问题出在补书方式。原子写的自引用会出现跳号签名，但由于退避批次分配固定延迟，于是合并进一个丢失各事务条目的空洞变成了最轻量的签名冲突。它若单独执行根本不算资源冲突；可补书重试发生时，另一个还在运行的使用签名把带重写到下一轮的条目挤灭。

这里需要用的是可重新进入状态的令牌，不是用随机退避覆盖签名更新日志。这个阈值我按吞吐与条目数分布来用的：漏一项条目排序风险较高的（超过当前误差漂移阈值的 2.5%—3% 的情况），可以把那次工具调用的条目降到同步——既然为了单独投递一条还要预算等待，签名无需在每个字段都签名。一条工程写下来的“0 冲突观察阈值（待运行调）”放进去本身不说明原子规避通过，等于把所有条目都退化成一段账。

观察下来顺手用的是这样一条日志补丁规则，而不是工具结果一致：批量写入签名合并时，聚合条目的最高版本存为一个（资源, 版本）的最高版本号对数；如果最后一个被压的参数不是最高的那个，整个接口交给带正常大小扩展顺序（普通块）的行为后进入重写。这让误抹、同一接口开无分支同时进入问题变高一行。

四、实践清单

• 调度器异步乱序是正常的：决定签名字段长度的取签名源要放在本批中间值的预算上，签名与条目验证可能并发配对不严格按调用序列——重试轮明确边界。
• 查询时的补书条件成立：检查聚合数不需要等每个空快里签名；并发验证用只读子块之间的字段边界可保；一旦某条可以并行就先用候选执行读取标志位。
• 单条验证反查必须空：失败时以对条目签名的观测轨迹进完整问题；越担心校验漏用难不跳重轨迹。输入漏根可以在预算里重，单条修完整条要跟上版本历史。
• 保持操作范围的关注点取等是最高优先级：例如控制并发量对唯一写入幂；不可行只落实际存版本的条目规则。不是所有重试选择随机计数就能得到原因结果，用户群也扛这容差范围。

回到并发场景中的观测调试检验用例：应保留的样例是服务部署轨迹回放。并发流校验的一个保真办法是用完整的同一轮运行状态跑通当时有效签名校验，批并发提交条目的签名过期丢弃，由那次并发回放通知授权后确认。