mirror of
https://github.com/dptech-corp/Uni-Lab-OS.git
synced 2026-02-04 13:25:13 +00:00
2a5ddd611d
Workbench example, adjust log level, and ci check (#220) * TestLatency Return Value Example & gitignore update * Adjust log level & Add workbench virtual example & Add not action decorator & Add check_mode & * Add CI Check Fix/workstation yb revision (#217) * Revert log change & update registry * Revert opcua client & move electrolyte node Workstation yb merge dev ready 260113 (#216) * feat(bioyond): 添加计算实验设计功能，支持化合物配比和滴定比例参数 * feat(bioyond): 添加测量小瓶功能，支持基本参数配置 * feat(bioyond): 添加测量小瓶配置，支持新设备参数 * feat(bioyond): 更新仓库布局和尺寸，支持竖向排列的测量小瓶和试剂存放堆栈 * feat(bioyond): 优化任务创建流程，确保无论成功与否都清理任务队列以避免重复累积 * feat(bioyond): 添加设置反应器温度功能，支持温度范围和异常处理 * feat(bioyond): 调整反应器位置配置，统一坐标格式 * feat(bioyond): 添加调度器启动功能，支持任务队列执行并处理异常 * feat(bioyond): 优化调度器启动功能，添加异常处理并更新相关配置 * feat(opcua): 增强节点ID解析兼容性和数据类型处理 改进节点ID解析逻辑以支持多种格式，包括字符串和数字标识符 添加数据类型转换处理，确保写入值时类型匹配 优化错误提示信息，便于调试节点连接问题 * feat(registry): 新增后处理站的设备配置文件 添加后处理站的YAML配置文件，包含动作映射、状态类型和设备描述 * 添加调度器启动功能，合并物料参数配置，优化物料参数处理逻辑 * 添加从 Bioyond 系统自动同步工作流序列的功能，并更新相关配置 * fix：兼容 BioyondReactionStation 中 workflow_sequence 被重写为 property * fix:同步工作流序列 * feat: remove commented workflow synchronization from `reaction_station.py`. * 添加时间约束功能及相关配置 * fix：自动更新物料缓存功能，添加物料时更新缓存并在删除时移除缓存项 * fix：在添加物料时处理字符串和字典返回值，确保正确更新缓存 * fix：更新奔曜错误处理报送为物料变更报送，调整日志记录和响应消息 * feat：添加实验报告简化功能，去除冗余信息并保留关键信息 * feat: 添加任务状态事件发布功能，监控并报告任务运行、超时、完成和错误状态 * fix: 修复添加物料时数据格式错误 * Refactor bioyond_dispensing_station and reaction_station_bioyond YAML configurations - Removed redundant action value mappings from bioyond_dispensing_station. - Updated goal properties in bioyond_dispensing_station to use enums for target_stack and other parameters. - Changed data types for end_point and start_point in reaction_station_bioyond to use string enums (Start, End). - Simplified descriptions and updated measurement units from μL to mL where applicable. - Removed unused commands from reaction_station_bioyond to streamline the configuration. * fix：Change the material unit from μL to mL * fix：refresh_material_cache * feat: 动态获取工作流步骤ID，优化工作流配置 * feat: 添加清空服务端所有非核心工作流功能 * fix：修复Bottle类的序列化和反序列化方法 * feat：增强材料缓存更新逻辑，支持处理返回数据中的详细信息 * Add debug log * feat(workstation): update bioyond config migration and coin cell material search logic - Migrate bioyond_cell config to JSON structure and remove global variable dependencies - Implement material search confirmation dialog auto-handling - Add documentation: 20260113_物料搜寻确认弹窗自动处理功能.md and 20260113_配置迁移修改总结.md * Refactor module paths for Bioyond devices in YAML configuration files - Updated the module path for BioyondDispensingStation in bioyond_dispensing_station.yaml to reflect the new directory structure. - Updated the module path for BioyondReactionStation and BioyondReactor in reaction_station_bioyond.yaml to align with the revised organization of the codebase. * fix: WareHouse 的不可哈希类型错误，优化父节点去重逻辑 * refactor: Move config from module to instance initialization * fix: 修正 reaction_station 目录名拼写错误 * feat: Integrate material search logic and cleanup deprecated files - Update coin_cell_assembly.py with material search dialog handling - Update YB_warehouses.py with latest warehouse configurations - Remove outdated documentation and test data files * Refactor: Use instance attributes for action names and workflow step IDs * refactor: Split tipbox storage into left and right warehouses * refactor: Merge tipbox storage left and right into single warehouse --------- Co-authored-by: ZiWei <131428629+ZiWei09@users.noreply.github.com> Co-authored-by: Andy6M <xieqiming1132@qq.com> fix: WareHouse 的不可哈希类型错误，优化父节点去重逻辑 fix parent_uuid fetch when bind_parent_id == node_name 物料更新也是用父节点进行报送 Add None conversion for tube rack etc. Add set_liquid example. Add create_resource and test_resource example. Add restart. Temp allow action message. Add no_update_feedback option. Create session_id by edge. bump version to 0.10.15 temp cancel update req
125 lines
4.3 KiB
Markdown
125 lines
4.3 KiB
Markdown
<div align="center">
|
||
<img src="docs/logo.png" alt="Uni-Lab Logo" width="200"/>
|
||
</div>
|
||
|
||
# Uni-Lab-OS
|
||
|
||
<!-- Language switcher -->
|
||
|
||
[English](README.md) | **中文**
|
||
|
||
[](https://github.com/deepmodeling/Uni-Lab-OS/stargazers)
|
||
[](https://github.com/deepmodeling/Uni-Lab-OS/network/members)
|
||
[](https://github.com/deepmodeling/Uni-Lab-OS/issues)
|
||
[](https://github.com/deepmodeling/Uni-Lab-OS/blob/main/LICENSE)
|
||
|
||
Uni-Lab-OS 是一个用于实验室自动化的综合平台，旨在连接和控制各种实验设备，实现实验流程的自动化和标准化。
|
||
|
||
## 核心特点
|
||
|
||
- 多设备集成管理
|
||
- 自动化实验流程
|
||
- 云端连接能力
|
||
- 灵活的配置系统
|
||
- 支持多种实验协议
|
||
|
||
## 文档
|
||
|
||
详细文档可在以下位置找到:
|
||
|
||
- [在线文档](https://deepmodeling.github.io/Uni-Lab-OS/)
|
||
|
||
## 快速开始
|
||
|
||
### 1. 配置 Conda 环境
|
||
|
||
Uni-Lab-OS 建议使用 `mamba` 管理环境。根据您的需求选择合适的安装包：
|
||
|
||
| 安装包 | 适用场景 | 包含内容 |
|
||
|--------|----------|----------|
|
||
| `unilabos` | **推荐大多数用户** | 完整安装包，开箱即用 |
|
||
| `unilabos-env` | 开发者（可编辑安装） | 仅环境依赖，通过 pip 安装 unilabos |
|
||
| `unilabos-full` | 仿真/可视化 | unilabos + ROS2 桌面版 + Gazebo + MoveIt |
|
||
|
||
```bash
|
||
# 创建新环境
|
||
mamba create -n unilab python=3.11.14
|
||
mamba activate unilab
|
||
|
||
# 方案 A：标准安装（推荐大多数用户）
|
||
mamba install uni-lab::unilabos -c robostack-staging -c conda-forge
|
||
|
||
# 方案 B：开发者环境（可编辑模式开发）
|
||
mamba install uni-lab::unilabos-env -c robostack-staging -c conda-forge
|
||
# 然后安装 unilabos 和依赖：
|
||
git clone https://github.com/deepmodeling/Uni-Lab-OS.git && cd Uni-Lab-OS
|
||
pip install -e .
|
||
uv pip install -r unilabos/utils/requirements.txt
|
||
|
||
# 方案 C：完整安装（仿真/可视化）
|
||
mamba install uni-lab::unilabos-full -c robostack-staging -c conda-forge
|
||
```
|
||
|
||
**如何选择？**
|
||
- **unilabos**：标准安装，适用于生产部署和日常使用（推荐）
|
||
- **unilabos-env**：开发者使用，支持 `pip install -e .` 可编辑模式，可修改源代码
|
||
- **unilabos-full**：需要仿真（Gazebo）、可视化（rviz2）或 Jupyter Notebook
|
||
|
||
### 2. 克隆仓库（可选，供开发者使用）
|
||
|
||
```bash
|
||
# 克隆仓库（仅开发或查看示例时需要）
|
||
git clone https://github.com/deepmodeling/Uni-Lab-OS.git
|
||
cd Uni-Lab-OS
|
||
```
|
||
|
||
3. 启动 Uni-Lab 系统
|
||
|
||
请见[文档-启动样例](https://deepmodeling.github.io/Uni-Lab-OS/boot_examples/index.html)
|
||
|
||
4. 最佳实践
|
||
|
||
请见[最佳实践指南](https://deepmodeling.github.io/Uni-Lab-OS/user_guide/best_practice.html)
|
||
|
||
## 消息格式
|
||
|
||
Uni-Lab-OS 使用预构建的 `unilabos_msgs` 进行系统通信。您可以在 [GitHub Releases](https://github.com/deepmodeling/Uni-Lab-OS/releases) 页面找到已构建的版本。
|
||
|
||
## 引用
|
||
|
||
如果您在学术研究中使用 [Uni-Lab-OS](https://arxiv.org/abs/2512.21766)，请引用：
|
||
|
||
```bibtex
|
||
@article{gao2025unilabos,
|
||
title = {UniLabOS: An AI-Native Operating System for Autonomous Laboratories},
|
||
doi = {10.48550/arXiv.2512.21766},
|
||
publisher = {arXiv},
|
||
author = {Gao, Jing and Chang, Junhan and Que, Haohui and Xiong, Yanfei and
|
||
Zhang, Shixiang and Qi, Xianwei and Liu, Zhen and Wang, Jun-Jie and
|
||
Ding, Qianjun and Li, Xinyu and Pan, Ziwei and Xie, Qiming and
|
||
Yan, Zhuang and Yan, Junchi and Zhang, Linfeng},
|
||
year = {2025}
|
||
}
|
||
```
|
||
|
||
## 许可证
|
||
|
||
本项目采用双许可证结构：
|
||
|
||
- **主框架**：GPL-3.0 - 详见 [LICENSE](LICENSE)
|
||
- **设备驱动** (`unilabos/devices/`)：深势科技专有许可证
|
||
|
||
完整许可证说明请参阅 [NOTICE](NOTICE)。
|
||
|
||
## 项目统计
|
||
|
||
### Stars 趋势
|
||
|
||
<a href="https://star-history.com/#dptech-corp/Uni-Lab-OS&Date">
|
||
<img src="https://api.star-history.com/svg?repos=dptech-corp/Uni-Lab-OS&type=Date" alt="Star History Chart" width="600">
|
||
</a>
|
||
|
||
## 联系我们
|
||
|
||
- GitHub Issues: [https://github.com/deepmodeling/Uni-Lab-OS/issues](https://github.com/deepmodeling/Uni-Lab-OS/issues)
|