Developer 指南

当你要修改 UniLab 本身时使用本章节:运行时契约、后端能力、任务 owner、 算法、测试或贡献流程。

架构概览

运行时模型、分层所有权、config-first 规则与验证标准。

架构概览
Registry

Bootstrap 导入、env 注册与运行时构造。

Registry Bootstrap
Env 契约

NpEnvState、reset/step 形状、observation 分组与 wrapper 预期。

Env 契约
Backend 契约

SimBackend 边界与可选能力(capability)模式。

Backend 能力契约
任务 owner 契约

Hydra owner YAML 身份与后端选择规则。

任务 owner config 契约
域随机化契约

DR provider 的 init、reset、interval 与后端能力边界。

Domain Randomization 契约

扩展

新任务

添加 env config、注册、owner YAML 与测试。

扩展 UniLab:新任务
新后端

添加 SimBackend 实现并显式声明能力支持。

扩展 UniLab:新后端
新算法

添加配置、runner 代码与脚本层组装,且不改动 env 契约。

扩展 UniLab:新算法
新地形

扩展地形生成,同时将资源访问保持在冷路径上。

扩展 UniLab:新地形

贡献者工作流