UAgentOS Real-World Device Harness

UAgentOS Real-World Device Harness 是一套让 Agent 使用真实设备能力的开源原型。项目把嵌入式开发板、传感器、视觉模型、通知通道和音频设备表示为可发现、可调用、可验证的节点能力，使 Agent 能够完成从现实观测到用户反馈的闭环。

项目入口

入口	内容
项目网站	查看完整架构、运行实例与提交材料
演示视频（清晰原片）	demo/UAgentOS.mp4，完整约 5 分钟现场演示

网站与演示视频是本项目的主要展示入口，建议先访问网站，再观看仓库中的清晰原片。

下载提示：演示视频 demo/UAgentOS.mp4 作为普通 Git 文件随仓库提交，不使用 Git LFS。评委直接点击 GitLink 的“下载 ZIP”即可获得完整视频；若下载到 133 字节的旧指针文件，请切换到最新 master 提交后重新下载。

本仓库包含一个完整演示：XiUOS/K210 视觉节点在端侧运行 YOLOv2/KPU；目标成立时发布检测事件与对应触发帧；UAgentOS 组织事件并生成自然语言；Gemini-S1/OpenVela 工具提供环境读取、设备状态、时间校准、QQ 图文和音频播报能力。

核心抽象

• 节点：现实设备或数字服务的可寻址实体，保存身份、连接、状态和能力集合。
• 能力：节点内部可观察或可执行的功能，使用结构化输入和结果契约描述。
• 观测：带来源、时间和有效状态的现实证据。
• 动作结果：明确区分已送达、已排队和失败，避免把工具调用等同于物理执行完成。
• Harness：负责发现、注册、健康检查、调度和结果验证；Agent 核心可替换。

目录

xiuos-edge-vision/    XiUOS/K210 摄像、YOLOv2/KPU、LCD 与事件上报 overlay
uagentos-runtime/     视觉入口、事件路由、证据绑定、QQ 与音频适配
openvela-gemini-s1/   Gemini-S1/OpenVela 原生 C 工具、Skill、构建与校时脚本
docs/                 架构与流程图

三类可验证场景

1. 基础对话：OpenVela Agent 处理普通自然语言，不强制调用硬件。
2. 环境问答：Gemini-S1 读取板载温湿度、光照和接近传感器；可继续请求音频播报。
3. 综合监控：XiUOS 视觉节点检测到目标，事件与图片进入 Agent，gemini_qq_notify 发送 QQ 图文，音频工具请求现场播报。

快速开始

1. 按 xiuos-edge-vision/README.md 将 overlay 应用到 XiUOS 工程，填写本地网络配置并构建固件。
2. 按 uagentos-runtime/README.md 配置视觉入口、QQ 与模型服务环境变量。
3. 按 openvela-gemini-s1/README.md 将 Gemini-S1 工具接入 OpenVela packages_ai_agent 并构建镜像。
4. 将设备接入同一局域网，依次核验 LCD 检测框、事件与触发帧、Agent 记录、QQ 图文和音频执行状态。

配置与隐私

仓库不包含真实热点密码、QQ 密钥、模型 API Key、个人账号标识或身份图片。所有凭据通过环境变量、板端本地配置或示例配置副本提供。任何公开部署都应再次执行密钥扫描。

许可证

项目新增代码采用 Apache License 2.0。XiUOS overlay 基于 XiUOS 上游代码，适用其目录内保留的木兰宽松许可证第 2 版；OpenVela packages_ai_agent 扩展保留上游 Apache-2.0 LICENSE 与 NOTICE。使用或分发时应同时遵守对应上游许可证。