mcpField
D
drone-cv-expert

drone-cv-expert

github.com/curiositech开发257246 次安装2 天前更新
代码仓库

关于 drone-cv-expert

drone-cv-expert 是面向自主飞行平台机器人与计算机视觉的技术技能。它帮助工程师根据导航、感知、传感器融合和硬件约束选择方案,并强调分阶段测试与飞行安全。

主要功能

  1. 01飞行控制与路径规划指导
  2. 02SLAM 和传感器融合方案
  3. 03目标检测与跟踪方法
  4. 04边缘部署与硬件集成
  5. 05安全检查和仿真指导

适用场景

  1. 01为无 GPS 飞行选择导航方法
  2. 02设计机载目标检测流程
  3. 03选择无人机定位的传感器融合方案
  4. 04规划仿真和分阶段飞行测试

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/curiositech/some_claude_skills --skill drone-cv-expert

安装后在 Claude Code 中输入/drone-cv-expert确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CHANGELOG.md
.claude-plugin/
plugin.json
references/
sensor-fusion-ekf.md
object-detection-tracking.md
navigation-algorithms.md

详细介绍

无人机计算机视觉专家

专注于机器人、无人机系统以及自主飞行平台的计算机视觉。

决策树:何时使用此技能

User mentions drones or UAVs?
├─ YES → Is it about inspection/detection of specific things (fire, roof damage, thermal)?
│        ├─ YES → Use drone-inspection-specialist
│        └─ NO → Is it about flight control, navigation, or general CV?
│                ├─ YES → Use THIS SKILL (drone-cv-expert)
│                └─ NO → Is it about GPU rendering/shaders?
│                        ├─ YES → Use metal-shader-expert
│                        └─ NO → Use THIS SKILL as default drone skill
└─ NO → Is it general object detection without drone context?
        ├─ YES → Use clip-aware-embeddings or other CV skill
        └─ NO → Probably not a drone question

核心能力

飞行控制与导航
  • PID 调参:位置、速度、姿态控制回路
  • SLAM:ORB-SLAM、LSD-SLAM、视觉惯性里程计(VIO)
  • 路径规划:A*、RRT、RRT*、Dijkstra、势场法
  • 传感器融合:EKF、UKF、互补滤波器
  • 无 GPS 导航:AprilTags、视觉里程计、LiDAR SLAM
计算机视觉
  • 目标检测:YOLO(v5/v8/v10)、EfficientDet、SSD
  • 跟踪:ByteTrack、DeepSORT、SORT、光流
  • 边缘部署:TensorRT、ONNX、OpenVINO 优化
  • 3D 视觉:立体深度、点云、运动恢复结构
硬件集成
  • 飞控:Pixhawk、Ardupilot、PX4、DJI
  • 协议:MAVLink、DroneKit、MAVSDK
  • 边缘计算:Jetson(Nano/Xavier/Orin)、Coral TPU
  • 传感器:IMU、GPS、气压计、LiDAR、深度相机

应避免的反模式

1. “仅仿真综合征”

错误做法:只在 Gazebo/AirSim 中测试,然后直接部署到真实无人机。 正确做法:仿真 → 台架测试 → 系留飞行 → 受控环境 → 实地测试。

2. “过度使用 EKF”

错误做法:互补滤波器足以胜任时仍使用扩展卡尔曼滤波器。 正确做法:根据需求匹配滤波器复杂度:

  • 互补滤波器:基本稳定,仅姿态
  • EKF:多传感器融合,GPS+IMU+气压计
  • UKF:高度非线性系统、激烈机动
3. “最高分辨率假设”

错误做法:处理 4K、30fps 的帧,并期望达到实时性能。 正确做法:根据高度和速度权衡分辨率:

高度速度分辨率FPS原因
<30m慢1920x108030需要细节
30-100m中等1280x72030折中
>100m快640x48060优先考虑速度
4. “单线程处理”

错误做法:在一个循环中依次执行检测 → 跟踪 → 控制。 正确做法:采用流水线并行:

Thread 1: Camera capture (async)
Thread 2: Object detection (GPU)
Thread 3: Tracking + state estimation
Thread 4: Control commands
5. “信任 GPS”

错误做法:假设 GPS 始终准确且可用。 正确做法:使用多源位置估计:

  • GPS:室外精度为 2-5m,室内不可用
  • 视觉里程计:漂移为 0.1-1%,受光照影响
  • AprilTags:在部署位置可达到厘米级精度
  • IMU:仅适用于短期,漂移会不断累积
6. “一个模型适用于所有场景”

错误做法:在所有场景中使用同一个 YOLO 模型。 正确做法:根据约束选择模型:

约束模型备注
对延迟要求严格YOLOv8n推理耗时 6ms
均衡YOLOv8s15ms,精度更高
优先考虑精度YOLOv8x50ms,mAP 最高
边缘设备YOLOv8n + TensorRTJetson 上耗时 3ms

问题解决框架

1. 约束分析
  • 算力:使用什么硬件?(Jetson Nano = 约 5 TOPS,Xavier = 32 TOPS)
  • 功耗:电池容量是多少?对飞行时间有何影响?
  • 延迟:控制回路频率是多少?检测响应时间是多少?
  • 重量:载荷能力如何?重心在哪里?
  • 环境:室内还是室外?GPS 是否可用?光照条件如何?
2. 算法选择矩阵
问题经典方法深度学习适用场景
特征跟踪KLT 光流FlowNet经典方法:实时、算力有限。深度学习:鲁棒性好,但需要更多算力
目标检测HOG+SVMYOLO/SSD经典方法:简单目标、无 GPU。深度学习:复杂目标、有 GPU
SLAMORB-SLAMDROID-SLAM经典方法:成熟、易调试。深度学习:在具有挑战性的场景中效果更好
路径规划A*、RRT基于 RL经典方法:已知环境。深度学习:复杂、动态环境
3. 安全检查清单
  • 已测试急停开关,并确保其易于访问
  • 已配置地理围栏
  • 已设置返航高度
  • 已定义低电量时的操作
  • 已定义信号丢失时的操作
  • 螺旋桨保护罩(如适用)
  • 飞行前完成传感器校准
  • 已检查天气状况

快速参考表

MAVLink 消息类型
消息用途频率
HEARTBEAT连接状态正常1 Hz
ATTITUDE横滚/俯仰/偏航10-100 Hz
LOCAL_POSITION_NED位置10-50 Hz
GPS_RAW_INT原始 GPS 数据1-10 Hz
SET_POSITION_TARGET命令按需
卡尔曼滤波器调优
矩阵高值低值
Q(过程噪声)更信任测量值更信任模型
R(测量噪声)更信任模型更信任测量值
P(初始协方差)初始状态不确定初始状态确定
常见坐标系
坐标系原点轴用途
NED起飞点北-东-下导航
ENU起飞点东-北-上ROS 标准
Body无人机重心前-右-下控制
Camera镜头中心右-下-前视觉

参考文件

详细实现见 references/:

  • navigation-algorithms.md - SLAM、路径规划、定位
  • sensor-fusion-ekf.md - 卡尔曼滤波器、多传感器融合
  • object-detection-tracking.md - YOLO、ByteTrack、光流

仿真工具

工具优势劣势最适合
GazeboROS 集成、物理仿真图形质量ROS 开发
AirSim照片级真实感、侧重计算机视觉以 Windows 为主视觉算法
Webots多机器人、易于使用针对无人机的特性较少集群仿真
MATLAB/Simulink控制设计非实时控制器调优

新兴技术(2024-2025)

  • 事件相机:1μs 时间分辨率,无运动模糊
  • 神经形态计算:Loihi 2 实现超低功耗推理
  • 4D 雷达:速度 + 3D 位置,可在各种天气条件下工作
  • 集群自主性:去中心化协同、涌现行为
  • 基础模型:SAM、CLIP 实现零样本检测

集成点

  • drone-inspection-specialist:领域特定检测(火灾、损坏、热成像)
  • metal-shader-expert:GPU 加速视觉处理、自定义着色器
  • collage-layout-expert:报告生成、视觉排版

核心原则:在无人机系统中,可靠性比性能更重要。一个永不崩溃、准确率为 95% 的系统,胜过一个准确率为 99% 但会不可预测地失效的系统。务必准备备用方案。

评论

支持 Markdown