4.6 KiB
原始观察器行协议 v1
仅数字和命令字。一个命令一行,token以ASCII空白分隔,不能有多余字段。所有整数为无前导加号的十进制,signed字段允许负号;按下列C++接口类型完整解析,超类型范围为语法错误。命令行为空或首token以#开头时忽略;C/B之后的payload行不能空白或注释。命令处理到EOF正常退出0;语法/解析错误或payload不完整退出2、stderr非空,之前已经输出的记录保留。
公共值的JSON表示
- State:
[id,parent,initial,enter_tag,leave_tag]。 - Transition:
[id,source,event,required,forbidden,priority,kind,target,target_mode,action_tag]。 - StateInfo:
[state,path,children,initial_leaf];Analysis:[[state_info...],[transition...]]。 - Memory:
[composite,child];Snapshot:[configured,root,[active...],[memory...]],configured为JSON布尔。 - Record:
[phase,state,tag];Selection:[found,transition],found为布尔;Step:[selection,boundary,[record...]]。 - RawEvent:
[event,flags],仅供输入不变观察;输出数组完全按实际API返回值打印,不排序或修补。
每条输出是一行JSON数组,以下true/false标志均由调用前后实际序列化值相等得到,不是行为期望或判据。before是调用前snapshot的冻结值;before_unchanged另比较保存的Snapshot对象在调用后是否仍与这个值相同。R/Q/D/B的after来自调用完成后的新snapshot。观察器从两个默认Machine、四个默认保存Snapshot及Chart{}开始,当前bank=0。
命令及载入
C root state_count transition_count,root为uint32,state_count=0..65、transition_count=0..513。随后恰state_count行N id parent initial enter_tag leave_tag,五字段uint32;再恰transition_count行T id source event required forbidden priority kind target target_mode action_tag。T中required/forbidden为uint64、priority为int64,其他uint32。完整载入后只替换公共原始Chart,输出["C"],不验证库级语义,不修改Machine。65/513等边界允许把库级超限结构完整传入。U bank,bank=0/1,选择Machine并输出["U",bank],不改变任一Machine或原始Chart。Y destination,destination=0/1,先用当前Machine的copy constructor构造临时副本,再copy assign至destination,输出["Y",destination,before,destination_snapshot,before_unchanged]。当前bank不切换,复制后按主合同H11/H29/H30独立;destination等于当前bank也合法。源未配置时复制未配置值。V调用validate_chart,输出["V",status,input_unchanged]。A调用analyze_chart,输出["A",status,analysis,input_unchanged]。output预置非空值:states中一项StateInfo,State为[60000,0,0,1,2]、path=[60000]、children=[60001]、initial_leaf=60002;transitions为下一节dirty Selection的transition一项。R用当前原始Chart reset当前Machine,输出["R",status,before,after,trace,chart_unchanged,before_unchanged]。trace预置一项[1,60000,60001]。Q event flags调用select,D event flags调用dispatch。event按uint32、flags按uint64完整解析,256及4294967296不会被提前截断。分别输出["Q",status,before,after,selection,event_unchanged,before_unchanged]和["D",status,before,after,step,event_unchanged,before_unchanged]。B count,count=0..129,随后恰count行E event flags,类型同Q。调用dispatch_many,输出["B",status,before,after,[step...],events_unchanged,before_unchanged]。库级128上限由库决定,129仍可完整传入;合法前缀可另以较短B或单个D独立观察。P输出["P",current_snapshot]。K slot将当前snapshot保存到slot=0..3,输出["K",slot,snapshot];O slot输出["O",slot,saved_snapshot],不重新读取Machine。四个保存槽跨bank共享,但保存的是各次独立Snapshot值,未写槽仍为Snapshot{}。
预置旧输出
Q的Selection预置为[true,[60000,60001,250,7,9,-17,1,60002,1,60003]]。D的Step预置为[dirty_selection,60004,[[1,60005,60006]]];B的输出预置为只含这个dirty Step的一项vector。这些值只用于观察成功覆盖/失败清空,不构造候选输入Chart,也不由观察器判断它们是否应保留。
C只替换原始Chart;R之前的Machine仍拥有上一次成功reset的Chart。Q/D/B不读当前原始Chart。A/V/R的input_unchanged比较原始Chart全字段,Q/D的event_unchanged及B的events_unchanged比较原始字段/次序;snapshot只观察机器,不把任何expected值传入库。stdout无额外提示;stderr可写诊断,评分不将任意诊断字节当stdout协议。