← ClaudeAtlas

cloud-apilisted

处理大疆上云 API(DJI Cloud API)的接入、解析、调试与问题定位。当用户提到"大疆上云""Cloud API""云平台对接""大疆机场上云""Pilot 上云""MQTT 设备接入""物模型""HMS 告警""机场直播""OSD 数据""DRC 指飞""航线任务下发""设备拓扑""固件升级"等涉及大疆行业设备(机场/DJI Pilot 2/遥控器/无人机)与第三方云平台通信的场景时使用。
wsadexq/refactored-system · ★ 10 · DevOps & Infrastructure · score 61
Install: claude install-skill wsadexq/refactored-system
# DJI 上云 API 大疆上云 API 是基于大疆行业版无人机(机场、DJI Pilot 2、遥控器、负载)对外提供的云平台接入接口,采用"端-边-云"架构:**无人机不能直接上云**,必须通过网关设备(大疆机场或遥控器)间接接入。 - 网关设备(机场 / 遥控器)→ 第三方云平台,通信协议为 MQTT / HTTPS / WebSocket - 网关注册登录时会上报飞机与负载的能力(物模型) - 本技能只处理云平台侧接入与解析,不涉及飞控底层 ## 安装后的路径与文档定位 - 从已加载技能的实际目录读取 `reference/`,并使用该目录下脚本的绝对路径执行命令;任务当前目录不一定是技能目录。 - 安装版自带 `KNOWLEDGE_SOURCES.md`、`THIRD_PARTY_NOTICES.md` 与 `INSTALLATION.md`;源码模式的这些文件在仓库根目录。不要假设安装版父目录仍是源码仓库。 - 深度查询前,运行安装版 `scripts/locate_dji_docs.py`(源码模式用仓库根目录的同名脚本)。用户明确提供路径时传 `--docs-root`;否则依次检查 `DJI_CLOUD_API_DOCS` 和任务当前目录的 `docs/Cloud-API-Doc`。明确配置无效时停止回退并报告。 - 定位成功仅证明路径存在;核对官方目录 Git HEAD 与来源说明基准后,再读取对应官方章节。未核对时不声称是最新或固定版本。 - 缺少官方文档时可依据现有笔记解释和运行离线校验,明确说明来源及覆盖范围;无法核实的字段或兼容性请用户提供官方目录,不猜测、不自动联网下载。 ## 何时使用 - 部署大疆上云服务端(MQTT 网关 / HTTPS / WebSocket / 对象存储) - 解析设备上报的物模型数据(OSD 属性 / 事件 / 服务响应) - 向设备下发指令(航线任务 / 直播 / 媒体 / 固件升级 / HMS 查询) - 排查设备上下线、拓扑更新、订阅不到数据、错误码等问题 - 区分两种场景:**Dock-to-Cloud**(机场上云,无人值守)与 **Pilot-to-Cloud**(遥控器 + DJI Pilot 2 上云,有人操作) ## 基础架构 ``` 第三方云平台(你的服务端) ├── MQTT 网关 ← 设备长连接,收发属性/服务/事件/上下线(Broker) ├── HTTPS 服务 ← 短连接接口(航线管理/媒体管理/地图元素/态势感知) ├── WebSocket 服务 ← 服务端向 Pilot/Web 推送(地图元素/态势感知) └── 对象存储 ← 航线文件/媒体文件存储 设备端 ├── 大疆机场(Dock) → MQTT/HTTPS 上云(Dock-to-Cloud) ├── 遥控器 + DJI Pilot 2 → MQTT/HTTPS/WebSocket/JSBridge 上云(Pilot-to-Cloud) └── 无人机/负载 → 不直接上云,由网关代理上报 ``` ## 通信协议速查 | 协议 | 用途 | 关键点 | |---|---|---| | MQTT | 设备长连接,属性/服务/事件/上下线/DRC | Topic 前缀 `sys/`(基础)与 `thing/`(物模型),字段按具体 Topic/接口要求携带 `tid`/`bid`/`method`/`data`/`timestamp` |