v0.12.3 — HostLink 默认运行

UniLabOS 0.12.3 — HostLink 默认运行

默认安装不再要求 ROS。微后端、Host/Slave、普通 Python 设备驱动、工作流、物料流转、异常处理和实时日志均可使用 HostLink。

安装只分三档

档位	用途
默认 unilabos	无 ROS 的完整应用运行环境
ros2 / unilabos-ros2	显式增加 ROS 运行能力
full / unilabos-full	运行、内置驱动 Python SDK、文档、测试、开发与 ROS 桌面工具

不再发布 unilabos-env。已有环境不会自动卸载或迁移；推荐另建 Python 3.12 环境。
pip 的 [ros2] / [full] 声明 Python 依赖，原生 ROS、DDS、RViz 和消息 typesupport 仍由 Conda/RoboStack 提供。
硬件厂商的系统驱动、专有 SDK 和许可证仍按设备包说明准备。

推荐安装

下载与平台匹配的 wheelhouse ZIP，解压后使用 Python 3.12 执行：

python install_wheel_release.py

安装入口会验证 SHA256、新建独立环境并离线安装全部默认依赖，随后实际创建 Opentrons 96 孔板并检查 CLI。
Linux x64、Windows x64、macOS Intel 和 Apple Silicon 使用各自的发行包。

Conda 默认安装：

mamba create -n unilab --override-channels -c uni-lab -c conda-forge "unilabos=0.12.3"
conda activate unilab
unilab --disable-browser

完整 Python 开发环境：

python scripts/dev_install.py --extras full
# 已有发行包时追加 --wheelhouse <解压目录>/wheelhouse

full 的公共 Python 扩展依赖需联网获取；默认 wheelhouse 只承诺默认运行环境的完整离线安装。

兼容性与发布说明

• PLR 和 NumPy 2 修正版 Opentrons shared-data 作为配套 wheel 提供，不上传公开 PyPI。
• Opentrons 是 PLR 的直接前置依赖，只安装 PLR 也会正确安装所需物料数据。
• 不含 ROS 的环境无需安装 unilabos_msgs 或执行 colcon build；ROS 用户继续选择 Jazzy/Humble，并显式指定 --backend ros2。
• MoveIt、RViz、原生 ROS Topic/TF/DDS 及 ROS 高频图像流仍需要原生 ROS 环境。
• 设备完成物料和服务初始化后才进入可调度能力快照，避免启动时出现空 Site/物料竞态。
• 文档生成内容保留在构建目录，不再改写开发者指南的 Markdown。
• 框架和内置设备驱动继续遵循各自原有许可证，本次为官方发行，不变更授权条款。

完整命令和平台边界见安装指南。