2.4 KiB
2.4 KiB
quota_observe协议
字符串使用连续hex字节,空写-;数值为十进制。每个顶层命令输出一行JSON数组。多行参数不单独输出。parent编码为present parent_hex:present=0要求parent_hex为-并传null;present=1传字节串(空字符串也原样传给API)。有效命令正常exit0;行协议格式错误exit2。
L text_hex调用parse_cpu_max,输出["L",error,limit,input_unchanged];输出先放旧值观察失败全清空。F numerator denominator调用reduced(参数满足规格04),输出["F",[n,d]]。K left_n left_d right_n right_d调用compare_fraction(参数满足规格04),输出["K",comparison]。C count后跟count行N id_hex parent_present parent_hex cpu_max_hex。保存原始NodeInput并调用compile_tree,输出先放一个旧节点;输出["C",error,tree,input_unchanged]。成功则保存独立initial Tree并重建当前bank的Store,失败保持旧Store/initial不变;原始输入始终保存本次C参数供A使用。Q target_hex查询当前Store;E target_hex对最近成功C的initial Tree调用evaluate;A target_hex对最近C的原始输入调用analyze。都输出[command,query,input_unchanged]。U count后跟count行D operation id_hex parent_present parent_hex cpu_max_hex,operation按整数转枚举。调用Store.apply,输出["U",error,snapshot,input_unchanged]。S输出当前快照["S",snapshot];H保存当前快照并输出["H",snapshot];J输出先前保存值["J",held];O输出不随Store变更的initial Tree,格式["O",tree]。B bank把当前Store已提交Tree独立复制到指定bank(0/1/2),不切换当前bank。目标bank的initial与Store来自这份Tree、revision重置0、held清空;供A使用的raw由该Tree的Limit规范十进制渲染生成。输出["B",bank,snapshot]。此操作验证多个Store由同一Tree构造仍独立。V bank切换0/1/2中的一个独立bank,输出["V",snapshot];每个bank初始空Tree/Store、revision0,原始输入与held均空。
limit为[unlimited,quota,period],tree为按id排好序的[[id,parent或null,limit]...];snapshot为[revision,tree];query为[error,finite,[numerator,denominator],path,limiting]。error none=0/invalid=1。input_unchanged只是调用前后原输入逐字段不变的布尔观察,子进程不做断言;期望由父判据计算。JSON空白不额外限制,字节字符串用\u00XX转义。