文档范围与其他资料

本网站说明如何在 Web 控制台中选择资源、提交和排查任务，以及完成日常管理操作。RLark 项目资料提供部署、架构、API、SDK 和设备接入说明；RLinf 项目资料提供算法和 Hydra 配置。把这些资料用于具体环境前，先确认版本、权限、资源和安全流程与目标环境一致。

在本站完成控制台任务

需要在浏览器中完成以下操作时，从本站相应指南开始：

• 登录控制台并找到集群、节点、任务、工作流和存储；
• 准备 RLinf 任务，创建 Job，查看 Worker、日志和运行结果；
• 使用对象存储、文件浏览、SSH 和 WebTerminal；
• 管理节点调度、网络域和存储类；
• 处理常见的登录、任务、Ray 和存储问题；
• 把 RLinf 工作负载映射为 RLark Job，并为真机任务核对安全条件。

RLark 为 RLinf 等训练程序提供运行所需的平台能力，包括计算资源选择、Worker 部署、Ray 启动、网络、存储和状态查看。算法和 Hydra 配置随 RLinf 工作负载提供；数据和模型通过镜像或存储挂载接入，训练输出写入任务指定的存储位置。

为当前环境准备输入和运行条件

创建 Job 前，把工作负载输入和环境条件分别记录到以下资料中：

• 启动清单：固定代码来源、镜像 digest、Hydra 配置、数据与模型版本、运行命令、checkpoint、输出位置和业务验收信号。
• 部署参数：从平台管理员取得目标环境、版本、节点选择、资源、存储、网络、权限、维护窗口和支持方式。

真机任务还需要完成现场安全审批，确认设备独占、动作限制、急停、断能和恢复流程，再把已验证的设备入口与资源要求写入启动清单和部署参数。

使用与任务匹配的项目资料

下面的 RLark 链接指向源码仓库的 main 分支。排查或维护已部署环境时，请改用与该环境相同的 Git tag 或 commit。RLinf 工作负载也应固定自己的代码来源和 commit。

部署 RLark

选择要部署的 RLark 版本后，请使用该 Git tag 或 commit 中的中文部署指南。如果只是了解最新代码，可以查看 main 分支中的 RLark 部署指南（简体中文）；实际部署时，请先在 GitHub 中切换到选定版本。

安装完成后，按照安装结果提供的访问方式和初始登录信息打开控制台。供团队长期使用时，还需要按组织要求配置域名、TLS、网络入口和访问权限。

安装、升级、卸载和数据平面接入会改变平台运行状态。执行这些操作时，应使用目标发行版本附带且已经验证的资料，以及当前环境的运行手册。没有这些资料时，请联系平台负责人，不要仅凭 main 分支中的示例操作生产环境。

了解 RLark 技术架构

阅读 RLark 技术架构（简体中文），可以进一步了解控制面、数据平面、资源协调和跨集群网络。

使用 API 和自动化

按自动化目标选择对应资料：

你的目标	建议阅读	说明
查看 REST API 请求示例	API 调用样例（简体中文）	用于开发和已获授权的自动化接入。
调用存储接口	Storage API 说明（简体中文）	多集群存储类、文件操作和 PVC 挂载的接口说明。
获取可供工具读取的接口定义	OpenAPI 文件	机器可读的接口定义，不包含当前环境的访问地址、凭据或授权。

这些接口资料描述对应代码版本提供的能力。开始自动化前，还需要平台管理员提供匹配版本的地址、认证方式、授权范围和支持方式。具体要求见API 与 CLI。

准备 RLinf 工作负载

使用 RLinf 中文文档选择算法、模型、运行后端和 Hydra 配置，并准备代码、依赖、数据与运行命令。把已经验证的 RLinf 输入固定到启动清单后，再按RLark 与 RLinf映射角色、资源、挂载和运行入口。

接入机器人和摄像头

按设备接口或开发语言选择对应资料：

你的目标	建议阅读	说明
了解 embodied-runtime	embodied-runtime 说明（简体中文）	设备资源、控制器、命令行工具和运行方式。
查看机器人和摄像头接口	embodied-runtime gRPC API（简体中文）	gRPC 服务、HTTP 网关和字段说明。
在 Python 程序中调用设备	Python SDK 源码用法（简体中文）	RobotClient 和 CameraClient 的源码用法；接入前先确认安装来源和目标版本。该资料不能证明已有可公开安装的软件包。
在 Go 程序中调用设备	Go SDK 源码用法（简体中文）	gRPC stub 和连接辅助包的源码用法；接入前先确认模块来源和目标版本。

完成设备软件接入后，还需要按现场流程确认安全审批、设备独占、动作限制、急停和恢复条件。准备真机任务前，请先阅读真实机器人任务的安全要求。

遇到内容不一致时

先确认当前环境使用的 RLark 版本，再对照同一 Git tag 或 commit 中的源码和文档。如果控制台行为、源码资料和平台管理员提供的说明不一致，请停止相关操作，记录环境、页面、资源名称和发生时间，再请平台管理员确认。

项目资料可以用来了解对应版本的架构、API、SDK 和接入方式。执行实际部署、接入或运维操作前，请先取得当前环境的运行手册和平台管理员确认。