show、view、clean 与 migrate;应用代码不需要也不能解析其中的实现细节。
一个 Run 发布后不会修改。重新运行、自动沿用或人工采用都会形成新的 Run,因此历史结果仍可被明确查看和比较。
Record 保存什么
Record 保存每次运行的范围、每个预期位置是否有结果,以及结果实际来自哪个 Attempt。它还保存 NiceEval 收集的断言、诊断、事件、用量、文件变化和来源信息,以便之后在同一份历史结果上查看。 这些事实由 NiceEval 写入并验证。应用、Adapter 和 Plugin 没有通用接口去添加任意持久数据、注册自定义数据族或改写历史结果。需要新的长期能力时,应使用已有的 NiceEval API,或让 NiceEval 提供相应支持。从选择到报告
查看或生成报告时,数据沿一条固定链路前进:--run 的命令选择仍匹配当前项目的结果;使用 locator 或 --run 可以查看明确的历史结果。Sample 保留完整分母,并标出 included、not-recorded、core-invalid 与 excluded,但它不会把底层结果读取能力交给页面。
Analysis 只在某个 Measure 或领域视图实际需要时取得相应事实,并将结果关闭为可显示的值。Report 可以呈现这些值,却不能更改历史结果、扩大选择范围或再次读取原始数据。
版本与维护
NiceEval 负责识别已支持的结果格式。需要迁移时运行niceeval migrate;无法安全解释的历史数据会在依赖它的查看内容中明确显示问题,而不是被猜成空值或零值。
写入没有完成的结果不会进入查看范围。可以运行 niceeval clean 清理这类未完成的残留,再重新运行受影响的评估。