Uni-Lab-Project / XUSE

厦门大学固态实验工站（XUSE）领域设备包。仓库根同时是 Python distribution root 和 Uni-Lab-OS workspace root；本分支只构建一个 distribution xuse-solid-lab，唯一顶层 import package 是 xuse_solid_lab。

基于 Uni-Lab-OS product/durable-scheduler-kernel-v2 的 workspace 合同，结构对齐 Uni-Lab-SZLab：唯一 OPC UA 连接由 xuse_plc 持有，机械臂与工艺工位通过 UnifiedPLCGatewayMixin 复用。握手语义沿用旧 XUSEDevice 与 xuse_variables.csv。

目录合同

Uni-Lab-Project/
├── pyproject.toml
├── package.yaml
├── xuse_solid_lab/
│   ├── common/                 # PLC gateway、握手原语、常量
│   ├── devices/<device_id>/    # @device 驱动
│   ├── resources/              # 物料 / 仓库 / Deck
│   └── workflows/              # @workflow_definition
├── deployment/graphs/
└── tests/

设备

设备 ID	职责
xuse_plc	唯一 OPC UA 连接，加载全量 CSV
xuse_robot	机械臂 1/2/3 取放
xuse_station	整站 / 真空箱体初始化与状态
xuse_open_can	开盖 / 关盖
xuse_add_sample	加粉与参数下发
xuse_add_bead	加珠
xuse_ball_mill	球磨与工艺参数
xuse_sieve	过筛
xuse_scrape_powder	刮粉
xuse_muffle_furnace	马弗炉 1–6 烧结与温控程序
xuse_crucible_transfer	小/大坩埚搬运机构

启动

unilab --workspace <本仓库根>

本地 OPC UA 仿真：

1. 在 Uni-Lab-Sim 启动 plc-sim server --csv data/xuse_variables.csv
2. 再启动 plc-sim xuse-handshake
3. 使用 deployment/graphs/xuse-plc-sim-local.json

默认 NodeId 前缀为 ns=4;s=uniab|，仿真端点为 opc.tcp://127.0.0.1:4855/xuse_sim/。