# 实验与数据 (/docs/subsystems/experiments)

## 它解决什么问题 [#它解决什么问题]

实验计划、现场记录、仪器文件和分析表格经常分散保存。本模块将它们关联到一次真实实验，支持后续比较、复现和模型更新。

## 核心对象 [#核心对象]

| 对象 | 内容 |
| --- | --- |
| 实验计划版本 | 目的、步骤、目标条件、变量、判定标准 |
| 样品与批次 | 来源、制备或取样记录、相关分析 |
| 实验 Run | 执行人员、设备、时间、实际条件与计划引用 |
| 偏差与观察 | 临时改动、中断、异常现象及原因 |
| 原始数据集 | 文件、测量值、单位、仪器和方法信息 |
| 分析版本 | 数据筛选、处理步骤、脚本、结果与适用范围 |

Run 表示一次实际执行。同一计划可以对应多次 Run，包括重复实验和未完成的实验。

## 内部结构建议 [#内部结构建议]

```text
实验计划 → 执行记录 → 原始数据接收 → 数据校验
                                      ↓
                 分析任务与版本 → 可引用的分析结果
```

计划编辑器、现场记录入口、文件导入适配器和数据查看器共享实验对象。通用脚本可以在隔离的分析执行环境运行；工程模型拟合和仿真通过计算模块协作。

实验模块保存分析的业务版本和数据选择，执行器返回日志及产物；两者通过任务引用关联。

## 计划和事实怎样分开 [#计划和事实怎样分开]

计划条件与实际条件分别记录。临时改变步骤时保存当时发生的改动，不能只修改计划后让历史看起来完全符合要求。

原始文件保留内容校验值。清洗、剔除数据和单位转换生成派生版本，并说明原因。仪器校准或分析方法信息可以作为相关附件和结构化引用。

## 数据回流怎样推动研究 [#数据回流怎样推动研究]

数据被确认可用于指定分析后，发布可分析事件。研究模块检查它验证的假设；计算模块在明确的数据选择上拟合或比较模型。

“已上传”“通过格式检查”“可用于某项分析”和“足以支持结论”分别表达，避免把数据接收等同于研究验证。

## Agent 与人的作用 [#agent-与人的作用]

Agent 提取实验表格、提示缺项、对比计划与实际、准备分析。实验人员确认现场事实，研究人员判断有效范围与异常数据处理方式。

## 异常怎么处理 [#异常怎么处理]

重复文件通过校验值识别，是否关联到多个实验由记录关系决定。单位不明、时间错位、样品批次不一致时暂停相关自动分析，保留原文件并生成待处理事项。

外部现场断网记录与离线同步是后续候选能力；第一版是否需要，由执行场景决定。

## 独立产品与首期验证 [#独立产品与首期验证]

可成为面向研发团队的 AI 实验工作台，支持结构化导出及原始文件打包。首期选一种常用实验，验证一次计划修改、一次现场偏差、一个原始文件导入和一次分析复现。

仪器格式、移动端记录、完整样品库存管理和多实验室协作范围待试点确定。