研究流程与产物谱系
Lineage 页面回答两个不同问题:研究是怎样推进的,以及某个结果究竟从哪些输入和决策产生。
Research Flow 与 Full Provenance
- Research Flow 是默认的语义化视图,突出实验、数据、模型、证据、声明、假设、验证和报告。一次实验产生的多个技术产物默认折叠在实验节点下。
- Full Provenance 显示完整产物图,适合审计 source、logs、intermediate outputs 等技术关系。
- 在 Research Flow 中打开 Show Technical Provenance,可以把技术节点加入语义流程而不切换到完整视图。
右键带 N artifacts 标记的 Experiment 节点可展开/折叠该组;工具栏也能一次展开或折叠所有实验产物。大图会自动切换到更快的分层布局,并在节点过多时隐藏 edge label 或 minimap,以保持可用性。
导航与选择
画布支持平移、滚轮缩放、Fit View、缩略图和背景点击清除选择。节点不能被拖动或手工连线,因为布局和关系来自 Runtime 的权威投影。
选中节点后:
- 紫色路径突出所有上游来源;
- 绿色路径突出所有下游结果;
- 其他关系淡化;
- 右侧 Lineage relationships 列出直接 source 与 downstream 节点,可以逐级跳转。
主要语义节点包括 Configuration/Physics Input、Dataset、Source Code、Model、Predictions、Evaluation、Analysis、Scientific Report、Evidence、Claim、Hypothesis、Verification Plan/Result、Experiment 和 Decision。边会标明 PRODUCED、DERIVED_FROM、INFORMED_BY、GOVERNED_BY 等关系。
检查产物
选择带 Artifact ID 的节点后,Runtime 会先校验元数据与 SHA-256,然后显示:
- 完整 ID、类型、hash、创建时间、创建者、大小;
- parents、children、相关 jobs 和 metrics;
- 清理后的 JSON metadata;
- 可见的不可变内容。
Python、JSON、YAML、文本、日志和 Markdown 以文本/代码形式打开;CSV/TSV 显示表格预览(最多前 50 行);Model/Checkpoint 和未知二进制类型只显示元数据,并可通过 content 链接导出原始字节。CSV 预览是轻量显示,不处理带引号中含逗号的复杂 CSV;正式解析应下载产物后使用数据工具。
Evaluator-private 产物不会进入浏览器、Ask、timeline 或 lineage。普通用户不能通过猜测 Artifact ID 绕过这条边界。
Decision 节点
Decision 没有文件内容。检查器显示事件记录的摘要和时间,并把它标为 event-backed node。这样可以从一个模型或报告追溯到影响它的研究动作,而不是把“决策”伪装成文件。
导出图
当前视图可导出四种格式:
- JSON:节点和边的机器可读投影;
- DOT:供 Graphviz 或其他图工具使用;
- SVG:与当前折叠、选择和主题一致的可缩放图;
- PNG:适合文档或演示文稿。
导出的是当前 Research Flow 或 Full Provenance 视图;折叠状态也会反映在结果中。桌面端会弹出保存位置,Web 模式使用浏览器下载。
一个实用审计顺序
- 在 Control Room 的 Reports 或 Metrics 中确认目标结果。
- 进入 Research Flow,选中报告、评价或最终模型。
- 沿紫色上游检查数据、source、experiment 和 decision。
- 检查每个关键产物的 SHA-256 与 parent IDs。
- 沿绿色下游确认它被哪些评价、声明或报告使用。
- 需要归档图时导出 SVG;需要程序处理时导出 JSON。
谱系图是读模型,不是另一份科学事实数据库。重新打开页面时,系统会从事件和 ArtifactStore 重新构建它。