dji-wpmllisted
Install: claude install-skill wsadexq/refactored-system
# DJI WPML 航线文件
WPML(WayPoint Markup Language)是大疆基于 KML 2.2 扩展的航线文件格式标准,航线文件一律以 `.kmz` 后缀归档(ZIP 格式)。本技能帮助你按已整理的规则生成、解析和修改航线文件,并用校验脚本检查已覆盖的结构与字段;脚本不覆盖全部规则、资源引用或机型兼容性,正式开发仍须以对应官方文档为准。
## 安装后的路径与文档定位
- 从已加载技能的实际目录读取 `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 与来源说明基准后,再读取对应官方章节。未核对时不声称是最新或固定版本。
- 缺少官方文档时可依据现有笔记解释和运行离线校验,明确说明来源及覆盖��围;无法核实的字段或兼容性请用户提供官方目录,不猜测、不自动联网下载。
## 何时使用
- 生成新的航线文件(航点飞行 / 建图航拍 / 倾斜摄影 / 航带飞行 / 目标检测巡逻)
- 解析或修改已有的 `template.kml` / `waylines.wpml`
- 打包或解包 `.kmz` 归档
- 校验航线文件是否合法、能否被 DJI Pilot 2 / 司空 2 正确解析
## 基础知识
### 文件结构
一个标准 WPML `.kmz` 解压后包含:
| 文件/目录 | 名称 | 职责 |
|---|---|---|
| `template.kml` | 模板文件 | 定义业务属性,方便用户快速调整编辑(测区、重叠率、模板参数) |
| `waylines.wpml` | 执行文件 | 定义明确的飞行与负载动作指令,由软件依据模板参数演算生成,供无人机执行 |
| `res/` | 资源目录 | 航线所需辅助资源(精准复拍参考照片 / 目标检测区域 / 仿地 DSM 高程) |
航线名称即文件名(`new_waypoints.kmz` 的航线名是 `new_waypoints`)。**内部各文件/文件夹命名必须遵循此规范,否则航线文件读取失败。**
### XML 头部与命名空间(两个文件都必须)
```xml
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2" xmlns:wpml="http://www.dji.com/wpmz/1.0.2">
```
### 两种高度体系(最���易出错,务必分清)
- **template.kml 用 `wpml:heightMode` + `wpml:height`**(编辑体系):`EGM96`(海拔高)/ `relativeToStartPoint`(相对起飞点)/ `aboveGroundLevel`(