ScienceOL 文档
  • 简体中文

      • OpenSDL Hub

      OpenSDL Hub 是虚拟实验室资产的公共目录。你可以搜索资产、查看模型预览和版本，再复制详情页的 lab pull 命令取回原始资产包。当前可访问的 Test 目录为 hub.test.sciol.ac.cn，UAT 目录为 hub.uat.sciol.ac.cn，浏览和公共资产拉取均无需登录。

      首次使用时，先安装 lab CLI，再按 Quick Start 完成一次拉取、校验和离线复用。

      三者如何协同

      组件职责
      OpenSDL定义 asset.yaml、OCI 资产包、验证规则与设备运行接口
      lab CLI验证、打包、检查、推送、拉取，以及本机缓存和目录物化
      OpenSDL Hub独立托管公共目录、版本、预览和发布准入；资产字节由 OCI Registry 分发
      LiyanLabs查询远程 Hub，在仿真界面选择可视模型，通过选定的 Desktop / Runner 操作设备

      Hub 网页地址和 Registry 地址是两个入口。网页/API 使用 hub.test.sciol.ac.cn 或 hub.uat.sciol.ac.cn；详情页生成的 pull_reference 使用 hub.sciol.ac.cn OCI Registry。使用时保留完整引用，不要把网页主机手工改成 Registry 地址。

      发布环境

      当前 Test 服务为 hub.test.sciol.ac.cn。main 的检查通过后，CI 构建不可变 API/Web 镜像、执行迁移、部署 Test，并生成验收后的镜像证明。UAT 为 hub.uat.sciol.ac.cn，只能从这份精确证明手动晋级；它使用独立数据库，但复用相同的 API/Web digest。生产没有自动上线目标。

      版本与发布

      已发布版本不可覆盖，资产包用 @sha256:... 标识具体内容。固定 digest 可以让不同机器拉取同一份字节；浏览器 GLB 预览与包内的 glTF / OpenUSD 源资产用途不同。

      发布流程包括准备并验证资产、lab pack、lab push、上传预览，以及 Hub 发布准入。lab push 只上传 Registry；进入公共目录还需要发布流程的其余步骤和独立的写入凭据。公共浏览与拉取不会授予发布权限。

      当前使用边界

      lab pull --output 将包还原成可以交给下游工具的本地目录。它不会自动创建仿真或设备实例。LiyanLabs 的 set_asset 保存可视模型引用，并由界面加载预览；物理模型装配和仿真运行需要对应运行时另行接入。

      公开 CLI 已具备资产打包、分发、缓存和校验能力。本地资产管理进一步提供清单、标签、删除和安全 GC；运行实例提供可运行 kinematic 包的创建、启停、重启与移除。在下一版包含快捷命令的安装包发布前，可按安装页从源码安装；公共拉取不需要账号，发布仍需要独立的写入凭据。