mirror of
https://github.com/deepmodeling/Uni-Lab-OS
synced 2026-03-24 13:19:14 +00:00
22 lines
935 B
Markdown
22 lines
935 B
Markdown
# Uni-Lab-OS AI Agent 指南
|
||
|
||
## 设备接入
|
||
|
||
当用户要求添加/接入新设备时，读取 `docs/ai_guides/add_device.md` 并按其流程执行。
|
||
该指南完全自包含，包含物模型模板、现有设备接口快照、常见错误和验证清单。
|
||
|
||
## 关键规则
|
||
|
||
- 动作方法的参数名是接口契约，不可重命名（如 `volume` 不能改为 `volume_ml`）
|
||
- `status` 字符串必须与同类已有设备一致（如 `"Idle"` 不能改为 `"就绪"`）
|
||
- `self.data` 必须在 `__init__` 中预填充所有属性字段
|
||
- 异步方法中使用 `await self._ros_node.sleep()`，禁止 `time.sleep()` 和 `asyncio.sleep()`
|
||
|
||
## 项目结构
|
||
|
||
- 设备驱动：`unilabos/devices/<category>/<device_name>.py`
|
||
- 设备注册表：`unilabos/registry/devices/<device_name>.yaml`
|
||
- 实验图文件：`unilabos/test/experiments/*.json`
|
||
- 人类开发文档：`docs/developer_guide/`
|
||
- AI 专用指南：`docs/ai_guides/`
|