Uni-Lab-OS/AGENTS.md

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/