Skip to content

nnrp-1-preview4 能力列表

本页对应 nnrp-conformance/protocol/nnrp-1-preview4/。Preview4 的重点是运行时编排:控制帧、运行时对象、缓存引用、IPC/WebSocket 传输,以及线路级互通测试。

这些 token 只应写入 conformance/nnrp-1-preview4.capabilities.json。声明某个 token 意味着实现接受由它选中的 mandatory 用例,以及下方列出的组合要求。

Mandatory 控制能力

Token层级状态范围组合要求含义
control.cancel_abortL1mandatory通常与 control.result_drop_reasoncontrol.trace_context 同时声明。按操作标识取消或中止任务,并输出类型化终态。
control.result_drop_reasonL1mandatory / experimental会被取消、截止时间、supersede 与迟到结果路径复用。标记结果被丢弃的原因,包括取消、中止、过期、被替换等状态。
control.trace_contextL1mandatory通常与 control.cancel_abortcontrol.result_drop_reason 同时声明。保留端到端 trace context,用于分段计时和问题定位。
control.priority_updateL1mandatory通常与 control.deadline_expirecontrol.result_drop_reason 同时声明。动态调整操作优先级,让调度器重新排序未完成工作。
control.deadline_expireL1mandatory通常与 control.priority_updatecontrol.result_drop_reason 同时声明。声明任务截止时间或过期时间,避免继续执行失效任务。
control.progress_partialL1mandatory通常与 control.credit_backpressure 同时声明。在终态前返回进度和部分结果。
control.credit_backpressureL1mandatory通常与 control.progress_partial 同时声明。用 credit update 与 backpressure 表达可接受的并发和数据量。
control.capability_costsL1mandatory在能力协商中声明成本、偏好、限制与降级元数据。

运行时对象与缓存能力

Token层级状态范围组合要求含义
object.lifecycleL1mandatory会与 object.costobject.ownershipobject.delta 组合出现。声明运行时对象、在操作中引用对象,并显式释放所有权。
object.costL1mandatory通常与 object.lifecycleobject.ownership 同时声明。为运行时对象声明计算、显存、带宽或生命周期成本。
object.ownershipL1mandatory通常与 object.lifecycleobject.cost 同时声明。固定对象所有权转移、释放和失效语义。
object.deltaL1mandatory通常与 object.lifecycle 同时声明。发送对象补丁或 delta,避免重复传输完整运行时对象。
cache.referenceL1optional在身份与失效语义清晰的路径使用 cache reference、miss 和 invalidation。

调度与降级能力

Token层级状态范围组合要求含义
control.route_execution_hintL1optional携带路由与执行 hint,供 runtime 或 subagent 调度使用,避免退回重包装格式。
control.degrade_profileL1optional通常与 control.budget_update 同时声明。在会话中协商更便宜的执行 profile。
control.budget_updateL1optional通常与 control.degrade_profile 同时声明。更新 compute、token、memory 或 bandwidth budget。
control.supersedeL1experimental通常与 control.result_drop_reason 同时声明。用新操作替换过期操作,并保留 trace 连续性与迟到结果可丢弃语义。
control.retry_afterL1experimental区分可重试压力与终止失败,并携带 retry-after 时间。

线路级一致性测试

Preview4 还提供独立的线路级目标声明,用于让 runner 直接扮演客户端、服务端或代理。这不是 adapter 内部单测,而是在线路边界验证帧顺序、终态、传输绑定与证据输出。

需要同时创建协议能力声明和线路级目标声明时,可以使用 能力声明生成器

NNRP Documentation