KairOS / DRONE AGENT / 02
代理通过局域网提供移动端优先的配置 Web 应用，通过 SSH 提供只读状态面板。这两个界面、Mission Control 和 Android 交接入口读取同一状态对象，使操作员看到一致的信息。
LOCAL首选路径
01共享状态对象
05访问界面
READ-ONLY终端模式
本页内容 +
01
配置 Web 应用
统一的移动端优先配置流程
Web 应用由代理自身提供，可通过手机、平板或笔记本打开。基本本地场景无需互联网或云端账户。向导从设备识别引导至向 Mission Control 交接连接。
识别
设备名称、角色、板卡配置、代理版本和整体接入进度。
MAVLink
飞控状态、固件、串口路径、波特率、心跳和 WebSocket URL。
视频
相机或接收器、WHEP URL、录制、码率、格式和链路状态。
网络
热点、LAN、USB 网络共享、mDNS、以太网、Wi-Fi 客户端和蜂窝调制解调器。
远程访问
可选的云隧道令牌、隧道状态和已发布 URL。
系统
服务、日志、版本、支持摘要和需确认的恢复操作。
02
状态面板
终端刻意不修改实时配置
kairos 命令打开精简面板，显示角色、版本、飞控、视频、链路和云端状态，以及本地配置 URL。变更通过提供明确字段和确认步骤的 Web 应用执行。这种只读方式可降低远程支持中误发命令的风险。
textKairOS 目标状态面板
kairos
KairOS Drone Agent · drone · v0.1.0-dev
─────────────────────────────────────
FC connected ArduPilot 4.5
Video streaming 1080p30 H.264
Link healthy -51 dBm
Cloud local mode relay off
─────────────────────────────────────
Setup http://<board-ip>:8080KairOS 目标接口：只有相应组件发布后，命令才可执行。
| 命令 | 用途 |
|---|---|
| kairos | 打开只读面板并显示本地 URL |
| kairos status | 精简显示配置、MAVLink、视频、网络和服务 |
| kairos status --json | 返回供脚本和支持使用的状态负载 |
| kairos update | 检查并安装已发布的 KairOS 版本 |
| kairos uninstall | 从系统中移除 KairOS 代理 |
03
优先本地路径
五种访问路径，云端居次
| 地址 | 用途 |
|---|---|
| http://<board-ip>:8080 | 通过 LAN 访问配置 Web 应用和状态 |
| http://<hostname>.local:8080 | 同一网络中的 mDNS |
| http://192.168.4.1:8080 | 外部网络配置前使用代理热点 |
| ws://<board-ip>:8765 | 原始 MAVLink WebSocket 中继 |
| http://<board-ip>:8889/<cam>/whep | 通过 WHEP 提供 WebRTC 视频 |
首选路径为板卡 IP、USB 网络共享或热点。mDNS 方便，但依赖客户端操作系统和本地网络。云隧道仅用于远程访问；本地模式下中继关闭属于正常状态，并非故障。
04
唯一可信来源
所有界面共用一个状态对象
- 配置 Web 应用显示完整接入流程和允许的变更。
- CLI 提供安全的只读摘要以及支持用 JSON。
- Mission Control 在添加和诊断节点时使用相同字段。
- Android 或其他交接入口打开同一本地 URL，不创建独立配置。
- 支持摘要整合版本、配置、服务、网络、MAVLink 和视频信息，不泄露机密。
