集成 Skill

2026-10-16

什么是司空集成 Skill

司空集成 Skill（FH2 Integration Skill） 是一个面向 AI 编码助手的领域知识包。安装后，当您向 AI 助手提出与司空 2 集成相关的需求时，AI 将依据一套经过验证的方法论进行回答，避免凭记忆猜测或编造接口。支持 Claude Code、Cursor、OpenCode、Trae、通义灵码等主流编码助手。

📦 下载司空集成 Skill 包
最新版本：v1.3.0-rc · 支持 Claude Code / Cursor / OpenCode / Trae / 通义灵码 等
立即下载

Skill 覆盖 DFR 应急响应 与 巡检巡逻 两类主流集成工作流，包含知识库、Demo 参考实现、评估用例等完整资源。

它解决什么问题

没有 Skill装了 Skill
AI 可能编造不存在的 API 端点强制反幻觉：不确定就说不确定，并指向官方文档核验
公有云与私有化接口混用先确认部署形态，严格区分 API 边界
应急出警做法套到日常巡检先确认场景，两类工作流分别设计
官方文档分散，不知从何查起按能力域整理的选型表 + 需求↔端点匹配
生成的代码缺安全护栏内置验签、幂等、权限、审计等最低要求

集成 Skill 不替您写业务代码，而是保证 AI 在司空 2 这个领域里不乱说、不越界、不漏安全项。

谁该怎么用

不懂二次开发的用户

目标： 先了解司空 2 能做什么。

直接用大白话向 AI 助手提问即可，Skill 会按能力菜单进行介绍，再通过多轮对话理出适合您业务的方案。

示例提问： 我们想用无人机做园区安防，司空 2 大概能提供哪些能力？

略懂开发、需要快速演示

目标： 快速跑一个 Demo 展示。

使用 Skill 内附的可运行 Demo，填入司空 2 组织密钥即可体验完整流程。

示例提问： 我想快速跑个 Demo 给领导看，怎么开始？

资深开发者

目标： 需求映射到具体接口，直接改代码。

让 AI 助手把需求映射到具体端点，产出匹配表后即可着手编码。

示例提问： 我要做直播接入，帮我看哪些端点能对上，缺口在哪里。

安装与环境推荐

将下载后的 fh2-integration-skill/ 目录放到 AI 编码助手的技能目录，或将其内容配置为项目级规则文件即可，无需额外依赖。安装后直接提问司空 2 / DFR / 巡检相关问题即可自动触发。

编码工具

编码工具加载方式
Claude Code放入 ~/.claude/skills/fh2-integration-skill/
OpenCode放入 ~/.config/opencode/skills/fh2-integration-skill/
Cursor将 adapters/cursor-rules.md 内容复制为 .cursor/rules/fh2-integration.mdc
Trae / 通义灵码配置为项目规则或挂载为项目知识库

各工具的规则文件路径随版本变化，请以官方文档为准。核心原则是让 SKILL.md 与 references/ 成为 AI 的常驻上下文。

模型推荐

本 Skill 是一套较长的行为约束与知识库，对模型的长上下文理解与指令遵循能力有要求。推荐以下模型：

模型厂商
DeepSeek V4 Pro 及以上深度求索
Qwen 3.8 Max阿里云
Claude Opus 5Anthropic
GPT-5.6 SolOpenAI

注意

模型能力不改变 Skill 的安全边界。 无论使用哪个模型，Skill 都会强制执行反幻觉约束与两道确认门。若发现某模型频繁跳过追问或编造端点，建议更换指令遵循能力更强的模型。

可选：挂载 OpenAPI MCP

如果您的环境接入了司空 2 / Apifox 的 OpenAPI MCP，本 Skill 将优先通过 MCP 读取真实端点与结构来完成需求匹配与代码修改，而不是让您自行翻查文档。未挂载 MCP 时会回退到官方文档链接。两种情况下都不会编造端点。

核心机制：两道门

这是本 Skill 最重要的设计。AI 助手在给出任何 API 建议之前，必须依次通过两道确认门。

第一道 · 部署 Gate

确认司空 2 的部署形态：公有云 / 私有化 / AIO 一体机

不同部署形态的 API 范围与认证模型并不相同，此步骤决定后续接口选型的边界。

第二道 · 场景 Gate

确认您要集成的工作流类别：DFR 应急响应 / 巡检巡逻 / 两者兼有

不同场景对应的接口选型、数据流与安全关注点差异明显。

通过两道门后

Skill 才开始为您提供：架构设计 → 接口映射 → 实施计划 → 安全护栏 → 测试计划。

为什么 AI 会「先反问您」而不是直接给答案

这是刻意设计的。部署形态不同，可用的 API 完全不同；场景不同，该选的接口也不同。Skill 被明确禁止从 Token 格式、URL、域名、区域等线索去推断部署形态——猜错的代价是给您一套跑不通的方案。

两类场景的差异

维度DFR / 应急巡检 / 巡逻
触发源外部告警、CAD 接处警计划、定时、周期
时效秒级应急常态周期
主接口自动派遣工作流航线 + 计划任务
数据流重点实时直播、人工接管采集 → 分析 → 共享
后处理现场处置、证据归档AI / VLM 缺陷识别、三维重建

能力范围

DFR / 应急响应

  • CAD、告警系统 → 司空 2 出警派遣中间件
  • 无人机直播接入 VMS / 指挥中心大屏
  • 遥测数据接入 GIS / PSIM 态势平台
  • 媒体与证据归档管道

巡检 / 巡逻

  • 航线上传、同步到司空 2 航线库、计划任务下发
  • 巡检媒体 → AI / VLM 缺陷分析 → 第三方平台
  • 三维重建 / 点云成果同步

通用能力

  • Event API 回调接收与处理
  • FlightHub Sync / OpenAPI / MQTT Bridge 接口选型
  • 公有云与私有化的 API 边界核对
  • 将司空 2 能力接入已有平台（适配层设计）
  • 实施计划、测试计划、安全护栏

如何提问

无需特殊语法，正常描述需求即可。以下示例可直接复用：

能力咨询：

我们想用无人机做变电站巡检，司空 2 能提供哪些能力？帮我理一个方案。

DFR 集成设计：

我们用司空 2 公有云，帮我设计一个 CAD 告警到出警派遣的中间件。

巡检集成设计：

我们是私有化部署，设计一个变电站定时热成像巡检的任务下发中间件。

对接已有系统：

我们已经有一套运维平台，想把司空 2 能力接进去，而不是再上一套独立系统。

接口映射：

我要做直播接入，帮我看看哪些端点能对上，产出一个需求↔端点匹配表。

提问技巧

如果您已经知道部署形态和场景，在第一句就说明（例如「我们是私有化部署，做巡检」），可以跳过两道门的追问，直接进入方案设计阶段。

配套 Demo

Skill 内附一个可运行的司空 2 公有云集成参考实现，位于 examples/dfr-public-cloud-demo/。

页面功能对应能力
项目地图点选目标下发出警自动派遣工作流
MQTT 信息订阅无人机遥测遥测转发
巡检航线上传航线并同步到司空 2 航线库FlightHub Sync 外部桶
Event API 信息接收并展示回调消息Event API
S3 存储桶媒体与证据文件管理对象存储
配置设置填写全部连接参数—

快速启动

后端：

cd examples/dfr-public-cloud-demo/backend
npm install && npm start        # 默认 http://localhost:3000

前端（另开一个终端）：

cd examples/dfr-public-cloud-demo/frontend
npm install && npm run serve

详细步骤参见 Demo 目录内的 QUICKSTART.md，上云部署参见 deploy/README.md。

本地即可试用真实接处警

只要有司空 2 组织密钥，本机 localhost 即可下发真实出警派遣——无需云服务器、无需公网 IP、无需内网穿透。派遣是纯出站请求（浏览器 → 本地后端 → 司空云），穿 NAT 无障碍。这是从"看文档"到"看机场开舱"最快的一条路径。

本地可用性对照

功能流量方向纯本地是否可用
出警派遣您 → 司空云✅ 可用
Event API 回调司空云 → 您❌ 需公网入口
MQTT 遥测司空云 → 您的 broker❌ 需公网入口
航线同步司空云 → 您的 S3 桶❌ 需公网入口

后三项需要司空 2 主动连入您的机器，可通过 ngrok / cpolar 等内网穿透工具解锁。

⚠️ 派遣会驱动真实设备

这不是模拟——机场会真实开舱、无人机会起飞。下发前请确认空域合规、现场有人监护，并优先使用测试机场。

试用前的准备

  • 组织密钥：司空 2 → 我的组织 → 组织设置 → OpenAPI → 复制密钥
  • 项目 UUID：调用「获取组织下的项目列表」接口获取
  • （可选）MinIO / S3、MQTT broker、推流服务器

⚠️ Demo 是教学级，不是生产级

Demo 为降低理解成本，刻意省略了部分生产必需项（如 Event API 验签、数据库存储）。直接用于生产是不安全的。 请务必阅读 Demo 目录下的 LIMITATIONS.md，其中列出了全部已知局限和生产化清单。

关于地图

Demo 会根据浏览器语言自动选择底图（中文用户用高德，其他用谷歌）。所有底图都会提示坐标系偏移风险——地图位置不等于无人机实飞位置，请以机场位置为基准。此外，Demo 使用的谷歌瓦片是非官方接口，仅供演示，生产环境须换用官方 API。

安全边界

Skill 内置了一批强制约束，理解这些能帮您更好地判断 AI 输出的可信度。

AI 会主动停下来的情况

触发条件需要您确认的内容
部署形态未知公有云 / 私有化 / AIO
认证模式不明Token / OAuth / SSO，以及哪些是占位符
涉及飞控、派遣、载荷、设备配置授权环境、人工介入、安全评审路径
要操作真实客户系统明确授权与目标环境
端点未在文档中确认请到官方文档核验

绝对不会做的事

  • 编造端点、请求字段、事件类型、MQTT topic
  • 混用公有云与私有化的 API
  • 给公有云推荐仅私有化支持的能力
  • 把 AI 识别结果当作可直接执行的处置依据
  • 省略人在回路、地理围栏等飞行安全约束

如果 AI 说「我无法确认这个能力」

这不是能力不足，而是设计如此。相比编一个看起来合理但跑不通的端点，明确告知不确定并指向官方文档，对您更有价值。

目录结构

fh2-integration-skill/
├── SKILL.md                    Skill 入口：工作流、检查点、输出模板
├── README.md / README.zh-CN.md 项目说明（中英双语）
├── references/                 知识库（12 篇 + 中文导读）
│   ├── README.zh-CN.md             中文导读索引，建议从这里看起
│   ├── api-guardrails.md           安全底线与反幻觉规则（优先级最高）
│   ├── capability-overview.md      能力总览菜单（面向非开发者）
│   ├── scenario-dfr-vs-inspection.md  场景决策
│   ├── dfr-integration-architecture.md       DFR 架构与选型
│   ├── inspection-integration-architecture.md 巡检架构与选型
│   ├── integrate-with-existing-system.md     对接已有平台
│   ├── middleware-patterns.md      9 种中间件设计模式
│   ├── demo-localization.md        多语言与本地化
│   └── ...                         部署边界、API 能力全景、来源溯源
├── adapters/                   Claude Code / Cursor 适配指南
├── evals/                      14 条质量评估用例
└── examples/
    └── dfr-public-cloud-demo/  可运行的参考实现

想了解知识库细节，可打开 references/README.zh-CN.md，其中说明了每个文件讲什么、什么时候会被用到。

常见问题

Q：为什么 AI 总是先反问，不直接给答案？

因为部署形态和场景会根本性地改变可用接口。这是 Skill 的核心设计，不是啰嗦。您可以在第一句就说明这两点，即可跳过追问。

Q：Skill 里的知识文件是英文的，能翻译吗？

面向人的文档（README、使用指南、评估手册、Demo 文档）都提供中文版。SKILL.md 和 references/ 是给 AI 读取的行为约束文件，刻意保持英文——英文指令的遵循精度更高，且避免中英不同步产生冲突规则。需要理解某个文件时，直接让 AI 用中文为您讲解即可。

Q：AI 给的端点能直接用吗？

不能直接用于生产。 Skill 会标注哪些内容需要核验。请务必对照官方 Apifox 文档确认确切的请求体、响应字段和权限要求后再上生产。

Q：Demo 能改成我们自己的系统吗？

可以，但建议将其作为适配层骨架而非成品。参考 Demo 目录下的 ARCHITECTURE.md，其中列有各模块与知识库的映射关系，以及从演示到生产需要补齐的项。

Q：私有化部署也能用这个 Skill 吗？

可以。Skill 同时覆盖公有云与私有化 / AIO，并会严格区分两者的接口边界。但需注意配套 Demo 是按公有云编写的，私有化的接口面更广、认证方式可能不同，不要直接照搬 Demo 代码。

司空集成 Skill 是集成设计辅助工具，不能替代大疆官方文档、客户安全评审、法律评审、航空审批或生产验证。

Last Updated: