Home / wsadexq / refactored-system · cloud-api/SKILL.md · GitHub

cloud-api skillA

cloud-api is agent-read markdown (skill) from wsadexq/refactored-system: 处理大疆上云 API(DJI Cloud API)的接入、解析、调试与问题定位。当用户提到"大疆上云""Cloud API""云平台对接""大疆机场上云""Pilot 上云""MQTT 设备接入""物模型""HMS 告警""机场直播""OSD 数据""DRC 指飞""航线任务下发""设备拓扑""固件升级"等涉及大疆行业设备(机场/DJI Pilot 2/遥控器/无人机)与第三方云平台通信的场景时使用。.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# 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 推送(地图元素/态势感知)
└── 对象存储      ← 航线文件/媒体文件存储

设备端
…

Read the whole file at its exact version.

How to install

Latest version
mdr add wsadexq/refactored-system/cloud-api@git:20260920.b942812
Exact content
mdr add wsadexq/refactored-system/cloud-api@sha256:9b1db15aab3fec2b

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_tqicbxboevr7dvtk.svg)](https://markdownregistry.com/a/art_tqicbxboevr7dvtk)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.b942812 latest2026-09-20 b942812 9,797 BA view · diff
git:20260817.6e4b6ba2026-08-17 6e4b6ba 7,752 BA view · diff
git:20260817.df9e35f2026-08-17 df9e35f 5,565 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9797 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wsadexq/refactored-system · 5 stars · license NOASSERTION · pushed 2026-09-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tqicbxboevr7dvtk
GET https://markdownregistry.com/api/v1/resolve?ref=wsadexq/refactored-system/cloud-api
GET https://markdownregistry.com/api/v1/blob/9b1db15aab3fec2ba3a3c12ec525c80ebbde94acff42f1a3025bd85681e4b1a3

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from wsadexq/refactored-system

dji-wpml skill
wsadexq/refactored-system · dji-wpml/SKILL.md · 处理大疆 WPML 航线文件(template.kml / waylines.wpml / .kmz 归档)的生成、解析、修改与校验。当用户提到"大疆航线文件""DJI wayline""WPML""KMZ…
git:20260920.b942812 · audit A · 5 stars

Every file in wsadexq/refactored-system

Browse by kind, by grade A, or by owner.