API 与接口页的职责,是把 Qi OS 从系统架构概念进一步落到开发者到底怎么接入。这一组内容不该停留在目录说明,而要明确三类边界:系统调用边界、Agent Runtime 边界、设备抽象边界。
结合当前蓝图,Qi OS 的接口体系可以概括为三层:System API 承接 syscall、文件、进程、网络与命名空间;Agent API 承接任务提交、上下文、工具调用与结果回写;Device API 承接 HAL、驱动、总线与控制端点。
当这三层接口被讲清楚之后,技术访客就能判断自己是以应用开发者、Agent 集成者还是设备/机器人集成者的身份进入 Qi OS。