跳转至

术语表

English

这一页写给所有读者。它把 Wiki 里用到的每个术语,对应到架构设计文档里的中文说法、英文版 Wiki 的说法,以及代码里的标识符。

标识符在哪里查:数据模型在 archive/models.py,服务之间的契约在 ports.py,状态名在 workflow/states.py。

项目

术语 English 代码中 含义
DiAGRI DiAGRI growbridge 下的子包,包括 agents/、workflow/、control/、executor/、observer/、archive/、research/ 等 整个项目:面向植物生长研究的 AI Agent 平台。它设计实验,在种植设备上执行已批准的方案,留下记录,分析结果并出报告。
GrowBridge GrowBridge 软件包和命令 growbridge;transport.py、service.py、store.py、api.py、mcp_server.py、web/ DiAGRI 的设备桥接部分:通过蓝牙读取并控制 Spider Farmer AC5。它可以单独运行。
DiAGRI 模式 DiAGRI mode auto_research = true 程序运行整个平台。桥接部分自带的写入路由和写入工具会被拒绝,所有对设备的写入都经过控制服务。
仅桥接模式 bridge-only mode auto_research = false(默认) 程序只运行 GrowBridge:控制台、本地 HTTP 接口和 MCP 工具。

研究流程

术语 English 代码中 含义
研究轮次 research round RoundState 从研究目标到报告交付归档的一次完整推进。
系列 series ResearchProtocol.rounds、.blocks、.allocations 设计需要跨轮重复时,协议登记的那一组轮次。例如单顶帐篷里先后做不同处理。
阶段 stage StageState、StageRuntime 运行单定义的执行区段,例如育苗期或处理期。
生长期 growth period 无 作物自身的发育期。它不是阶段。
变量目录 variable catalog Catalog、packaged_catalog() 协议、测量、快照和留出集共同使用的标准变量 ID 清单(含单位、方法、允许范围)。只追加;见变量目录。
研究协议 research protocol ResearchProtocol 问题与假设、处理和对照、实验单位、分配方式、随机化种子、主要终点和分析约定。按版本保留。
运行单 run sheet RunSheet 一个阶段的可执行方案,也是操作员审批的对象。任何修改都生成新版本。
审批 approval Approval 操作员对运行单或其他请求做出的、留有记录的决定。
研究任务 research task ResearchTask、TaskState、TaskBoard 交给模型角色的一项工作。它有自己的状态机和调用预算。
人工作业 manual task ManualTask 运行单里由人动手完成的工作,例如灌溉。
暂停、停止、中止 pause, stop, abort StageState.PAUSED、StageState.STOPPED、RoundState.ABORTED 暂停后可以续跑。停止结束一个阶段。中止结束整轮。三者都留下归档记录。

控制与安全

术语 English 代码中 含义
通道 channel Channel AC5 上一路可控的输出:light(灯)、exhaust(排风)、fan(循环风扇)、pump(水泵)。
通道归属 channel ownership Ownership 每个通道由谁控制。设备自管(device):AC5 自己定时,DiAGRI 只读。主机控制(host):由执行 Agent 写入。
写入权与编号 write right and its number WriteRight、RightKind、right_number 控制服务登记的写设备资格。每次授予都带一个新编号,编号作废后不能再写。
阶段写入权 stage write right RightKind.STAGE 阶段执行期间由自动控制使用。
人工写入权 manual write right RightKind.MANUAL 人工接管期间由操作员持有。
养护写入权 care write right RightKind.CARE 只执行已批准运行单里的养护规则。
保护规则的写入权 protection write right RightKind.PROTECTION 属于单独审批的安全配置。
恢复编号 recovery number recovery_number()、bump_recovery() 从备份恢复或更换写入主机后加一。此前的写入权、审批和会话全部失效。
写入主机 write host register_host()、host_registered() 登记为可以写设备的那一台机器。其他机器的写入会被拒绝,拒绝码是 host_unregistered。
定时动作 timed action TimedAction 运行单里按时间执行的档位变化。
反馈规则 feedback rule FeedbackRule 运行单里的规则:传感器读数持续越过阈值时改变某个通道,读数恢复后释放。
养护规则 care rule CareRule 运行单里的规则:在阶段暂停、阶段之间和结束后维持基础条件,例如按原日程开关灯。
保护规则 protection rule ProtectionRule、SafetyConfig 安全配置里只朝降低风险方向的动作,只写主机控制的通道。它不随阶段写入权一起撤销。
动作账本 action ledger ActionRecord、ActionState 每一次写入的记录:计划值、触发证据、请求编号、写入权编号、操作者、下发与回读时间、确认值。
回读 read-back read_state()、differences() 写入之后或定期读取设备状态,并和预期值比较。
结果未知 result unknown ActionState.UNKNOWN、StageEventKind.RESULT_UNKNOWN 一次写入的效果无法通过回读确认。
待核对 recovery check StageState.RECOVERY_CHECK 设备状态或在途动作的结果未知。普通写入被阻止。连接有效时,保护规则和关泵仍可执行。
关泵联锁 pump interlock interlocked()、pump_off() 关泵未得到确认期间,普通写入被拒绝(拒绝码 interlock),执行 Agent 持续尝试关泵。
人工接管、交还 manual takeover, handback StageState.MANUAL、handover() 操作员从自动阶段手里接过写入,之后再交还。
旧传输停止确认 old-write-stop confirmation WriteTransport.halt()、confirm_transport_stopped() 证明此前的写入通路已经不能再写。超时不算确认。
入口 entry Entry 请求是从哪个监听端口进来的。局域网入口(lan):在现场。覆盖网络入口(overlay):经覆盖网络远程访问。开泵(灌溉)只在局域网入口提供,关泵在两个入口都可以。
拒绝 denial Denied(code) 权限或控制检查的一次拒绝,带一个机器可读的拒绝码。见拒绝码与事件类型。
阶段事件 stage event StageEvent、StageEventKind 执行 Agent 向工作流服务报告的事件。同一个事件 ID 最多推进阶段一次。

角色与服务

术语 English 代码中 含义
操作员 operator Actor(kind="operator")、Operators 通过认证的人。只有操作员可以审批、接管和灌溉。
模型角色 model role RoleModel、ROLES 由语言模型驱动的 Agent。它读数据、交草稿,没有任何设备或阶段控制工具。
编排 Agent orchestrator 角色 orchestrator 用户目标的统一入口。创建研究任务,并交给其他模型角色。
计划 Agent planner 角色 planner 设计实验,起草研究协议和运行单。
研究 Agent researcher 角色 researcher 查文献、读数据、跑分析,交付结论。
执行 Agent executor ExecutorEngine 确定性程序,执行已批准的运行单。从不调用模型。
监察 Agent auditor 角色 auditor 读取阶段记录并与运行单对照的模型角色。它只能提出建议性的 audit_finding 告警。
阶段检查 stage checks StageChecks,告警 task_missed、measurement_missing、measurement_outside_window 挂在观察者 tick 上的确定性检查:人工任务过了截止时间仍无记录、测量任务已完成却没有测量、测量的时间会让快照把它排除。只发警告,从不暂停阶段。
冻结读数 frozen reading FrozenWatch、frozen_reading 告警 传感器的数值在超过门槛的时间里完全不变。它会在档案里开一个冻结时段并发出告警;只有阶段的规则依赖该传感器时,才会暂停正在执行的阶段。
观察与通知 Agent observer and notifier Observer 确定性程序,负责指标、日报、告警和通知。从不调用模型。
工作流服务 workflow service WorkflowService 轮次、阶段和任务状态的唯一所有者。
控制服务 control service ControlService 所有 BLE 写入的唯一关口。
项目档案 project archive Archive 记录的所有者:样本、动作、快照和产物。
计算服务(远程计算) compute service ComputeService 为准备提交到 CSC 的作业预留额度并跟踪状态。serve 只在配置齐全时才启动它;远端调用没有对 CSC 验证过。
工作台 workbench create_workbench(),路由在 /wb 下 操作员使用的 HTTP 接口:/wb 下的一组 JSON 路由。/workbench 的操作员控制台就是它的网页。
控制台 dashboard growbridge dashboard,文件在 web/ 下 GrowBridge 的本地网页。在 DiAGRI 模式下,它的控制操作会被拒绝,只用来看数据。
运行时 runtime Runtime 在一个进程里把所有服务装配起来。

数据与科研

术语 English 代码中 含义
实验单位 experimental unit Allocation.unit 处理实际施加在什么上面。由 AC5 控制的处理(例如光照)作用于整顶帐篷。
独立重复 independent replicate 无 接受同一处理的另一个实验单位,或同一单位的另一轮。
区组 block Allocation.block 相互比较的一组轮次。
主要终点 primary endpoint AnalysisPlan.primary_endpoint 确认性分析针对的那一个结果指标,实验开始前就固定下来。
锁定变量 locked variable 无 协议规定在各处理之间保持一致的环境变量。这是架构文档里的概念,代码里没有单独的字段。
证据卡 evidence card EvidenceCard 一个设定值的来源记录:引用出处、它支持的论断、数值与单位,以及是否经过复核。既没有证据卡、也没有用户输入的设定值会得到 no_evidence 提示,但运行单不会因此被拦下。
训练数据集 training dataset growbridge export-dataset 由一个冻结快照导出的 CSV 表和 Croissant 描述,用于模型训练。见训练数据集导出。
数据快照 data snapshot Snapshot、snapshot.freeze() 一次分析所用数据的冻结副本,可以校验。
留出数据 holdout data HoldoutRegistry 模型开发前登记、只用于正式评估的数据。
确认性、探索性 confirmatory, exploratory ConfirmatoryRunner、classify() 确认性分析只跑一次,脚本和快照都事先冻结。其余分析都是探索性的。
如实降级 honest downgrade classify() 缺少独立重复、缺失过多,或者处理和时间分不开时,降低结论的等级。

观察

术语 English 代码中 含义
日报 daily report render_daily_report()、ReportStore 每天一次的汇总:读数、动作和未解决的问题。
告警 alert AlertBook 需要关注的状况,持续跟踪直到解决。
心跳 heartbeat ExternalMonitor、HeartbeatChannel 定期发给外部监控的信号。信号中断本身就会触发报警。

状态值

状态值会出现在接口、数据库和日志里。中文标签取自 workflow/states.py 里的 LABELS。

轮次状态(RoundState) 中文
designing 设计中
stage_review 阶段待审
stage_running 阶段进行中
data_verification 数据核验
analysis 研究分析
delivered 已交付归档
aborted 已中止归档
阶段状态(StageState) 中文
pending_review 待审
running 执行中
paused 已暂停
manual 人工接管
recovery_check 恢复待核对
ended 已结束
stopped 已停止
任务状态(TaskState) 中文
in_progress 进行中
remote_queued 远程排队
computing 计算中
fetching 产物回收
reconcile 待对账
needs_attention 待处理
needs_review 待复核
done 完成
ended 已结束
动作状态(ActionState) 中文
pending 待发送
maybe_sent 可能已发送
confirmed 已回读确认
unknown 结果未知
failed 失败
void 作废

另见


页面最近一次对照代码核对是在 2026-11-11。DiAGRI 模式目前只在模拟的 AC5 上测试过,见状态与已知限制。修改页面之前,请先读编写约定。