AI线索管理模块-需求规格

版本：v1.0 | 日期：2026-06-03 | 编写人：[姓名已隐藏] | 状态：初稿

1. 背景与目标

1.1 背景

当前无人机APP在虚拟座舱飞行模式下，已具备AI实时识别能力（如建筑物、裸土、防尘网、坑塘等目标检测）。识别结果在飞行过程中以实时线索面板形式展示（置信度、截图缩略图、鹰眼定位等），数据已实时写入数据库。

核心问题：虚拟座舱内的AI线索面板是任务维度的视图——仅展示当前正在执行任务的线索。一旦任务结束退出虚拟座舱，用户就没有入口再回溯查看这些线索了（包括当前任务的和其他历史任务的）。需要新增一个独立的线索管理模块，提供跨任务、跨时间范围的统一查询入口。

1.2 目标

1.3 适用范围

• 项目甲项目无人机APP（Android端）
• 涉及AI识别的场景：航摄任务、正射影像任务
• 识别目标类别：建筑物、裸土、防尘网、坑塘等（可扩展）

2. 业务流程

┌──────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  创建/执行任务 │ ──▶ │ 虚拟座舱飞行中     │ ──▶ │  任务结束        │
│  (航摄/正射)  │     │  AI实时识别       │     │  退出座舱        │
└──────────────┘     └──────────────────┘     └────────┬────────┘
       │                     │                        │
       │                     ▼                        │
       │           ┌──────────────────┐               │
       │           │  AI线索实时写入DB  │               │
       │           │  座舱内面板展示     │               │
       │           │  (仅当前任务可见)   │               │
       │           └──────────────────┘               │
       │                                                │
       │                       ◀────────────────────────┘
       │                       任务结束后座舱面板不可访问
       │
       ▼
┌─────────────────┐
│  AI线索管理模块    │  ← 新增独立入口（底部Tab）
│  - 跨任务汇总查看  │    不受"当前任务"限制
│  - 列表/地图浏览   │
│  - 筛选/搜索      │
│  - 线索详情查看    │
│  - 导出/处置流转   │
└─────────────────┘

核心规则：

• 实时阶段（虚拟座舱内）：AI引擎持续检测 → 实时写入数据库 → 座舱右侧线索面板查询当前任务的线索 + 鹰眼地图打点
• 关键约束：座舱内的线索面板是任务作用域视图，只能看到task_id = 当前任务ID的线索，任务结束退出后该入口关闭
• 访问阶段（线索管理模块）：用户通过底部「AI线索」Tab进入，可查看所有任务的历史线索，支持跨任务筛选聚合

3. 功能需求

3.1 模块总览

3.1.1 入口位置

3.1.2 页面布局（参考截图）

┌─────────────────────────────────────────────────────────┐
│  AI线索管理                           [跨任务汇总]   [×] │
├─────────────────────────────────────────────────────────┤
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐                    │
│  │线索总数│ │今日新增│ │航线任务│ │正射影像│  ← 统计卡片     │
│  │ 128  │ │  18  │ │  68  │ │  60  │                    │
│  └──────┘ └──────┘ └──────┘ └──────┘                    │
├─────────────────────────────────────────────────────────┤
│  任务类型:[全部任务 ▼]    类型:[全部类型 ▼]               │
│  时间:[开始日期 ~ 结束日期]  🔍[请输入线索名称]            │
│                              [重置]  [筛选]              │
├─────────────────────────────────────────────────────────┤
│  ┌────┐ 坑塘      11:31:02  2025-05-12  航摄任务   92%  │
│  │缩略│ ○ 监测世荣·马A                                   │
│  └────┘                                                 │
│  ┌────┐ 建筑物    11:31:48  2025-05-12  正射影像任务 90%  │
│  │缩略│ ○ 日常巡检B                                       │
│  └────┘                                                 │
│  ...                                                    │
│                        [查看更多线索 ▶]                   │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────────────┐  ┌────────┐                    │
│  │                     │  │ 工具   │                    │
│  │    地图区域          │  │ 查询   │                    │
│  │  (线索空间分布)      │  │ ▲     │                    │
│  │                     │  │ 定位   │                    │
│  │                     │  │ 图层   │                    │
│  └─────────────────────┘  └────────┘                    │
└─────────────────────────────────────────────────────────┘

3.2 功能点详细设计

3.2.1 F01 — 统计概览区（顶部卡片）

交互说明：

• 卡片可点击，点击后自动填充对应筛选条件
• 数字变化带动画过渡效果
• 「跨任务汇总」标签：表示当前视图为全任务聚合视角

3.2.2 F02 — 筛选条件区

交互说明：

• 点击「重置」清空所有筛选项恢复默认
• 点击「筛选」触发查询，结果刷新列表+地图点位
• 筛选条件变化时实时更新顶部统计卡数字

3.2.3 F03 — 线索列表区

每条线索卡片包含以下信息：

交互说明：

• 点击线索卡片 → 进入线索详情页（F05）
• 列表支持上拉加载更多（分页）
• 底部固定「查看更多线索」按钮，点击加载下一页

3.2.4 F04 — 地图展示区

图层选项建议：

• 卫星底图（默认）
• 矢量底图
• 线索热力图（可选）

3.2.5 F05 — 线索详情页

点击单条线索后进入详情，需展示：

3.2.6 F06 — 虚拟座舱实时线索面板（已有能力，需确认持久化对接）

当前虚拟座舱已有的实时线索面板能力（数据已走数据库，但视图受限于当前任务作用域）：

现状问题：

• 座舱线索面板的查询是任务隔离的——只能看到正在执行的这个任务的线索
• 任务结束退出座舱后，该面板入口关闭，用户再无途径查看任何历史线索
• 已入库的线索数据本身没有丢失，只是缺少一个跨任务的统一查询UI

本次新增要求（新增独立的AI线索管理模块，与座舱面板共用同一套数据库）：

• 新增底部Tab「AI线索」入口，查询范围不受单个任务限制
• 座舱面板的写入逻辑不变（已实时写DB），新增模块直接复用已有数据
• 建议任务结束时触发一次数据完整性校验，确保飞行中产生的所有线索均已落库

4. 数据模型

4.1 核心实体关系

┌─────────────┐       ┌──────────────┐       ┌─────────────┐
│   Task      │ 1   N │    Clue      │ N   1 │ ClueType    │
│  (任务)     │──────▶│   (线索)     │──────▶│ (线索类型)   │
└─────────────┘       └──────────────┘       └─────────────┘
       │                     │
       │                     │
       │ 1                 N │
       ▼                     ▼
┌─────────────┐       ┌──────────────┐
│  Device     │       │  ClueImage   │
│  (设备)     │       │ (线索图片)    │
└─────────────┘       └──────────────┘

4.2 线索表（ai_clue）字段设计

4.3 线索类型表（ai_clue_type）

4.4 与现有任务表的关联方式

-- 线索通过 task_id 关联到现有任务表
-- 假设现有任务表为 flight_task 或类似表名
-- 关键关联字段：
ALTER TABLE ai_clue ADD CONSTRAINT fk_clue_task 
    FOREIGN KEY (task_id) REFERENCES flight_task(id);

5. 接口设计

5.1 接口清单

5.2 关键接口详解

API-01 线索列表

GET /api/v1/clues/list

Query Params:
  task_type?     -- Integer  任务类型（1=航摄 2=正射影像，不传=全部）
  clue_type_id?  -- Integer  线索类型ID（不传=全部）
  start_date?    -- Date     开始日期（格式 yyyy-MM-dd）
  end_date?      -- Date     结束日期
  keyword?       -- String   关键词搜索（模糊匹配线索名称）
  page?          -- Integer  页码（默认1）
  page_size?     -- Integer  每页条数（默认20）

Response:
{
  "code": 0,
  "data": {
    "total": 128,
    "page": 1,
    "page_size": 20,
    "list": [
      {
        "id": "CL202605120001",
        "task_id": "TK202605120001",
        "task_name": "某县市日常巡检-A",
        "task_type": 1,
        "task_type_name": "航摄任务",
        "clue_type_name": "坑塘",
        "confidence": 92.00,
        "detect_time": "2025-05-12 11:31:02",
        "image_url": "https://.../clue_xxx.jpg",
        "crop_image_url": "https://.../crop_xxx.jpg",
        "operator_name": "监测世荣·马A",
        "status": 0,
        "[坐标已隐藏]
        "[坐标已隐藏]
      }
    ]
  }
}

API-02 线索统计概览

GET /api/v1/clues/stats

Query Params: （同API-01的筛选条件）

Response:
{
  "code": 0,
  "data": {
    "total_count": 128,
    "today_count": 18,
    "flight_task_count": 68,
    "ortho_task_count": 60
  }
}

API-05 写入线索（虚拟座舱实时调用，已有接口）

此接口为座舱实时识别时调用的写入接口，已在线运行。新增的线索管理模块（API-01~04）直接读取该接口写入的数据即可。此处列出仅作完整性参考。

POST /api/v1/clues/create

Body:
{
  "task_id": "TK202605120001",
  "task_name": "某县市日常巡检-A",
  "task_type": 1,
  "clue_type_id": 4,
  "clue_type_name": "坑塘",
  "confidence": 92.00,
  "[坐标已隐藏]
  "[坐标已隐藏]
  "altitude": 45.5,
  "detect_time": "2025-05-12T11:31:02",
  "image_url": "https://.../detect_001.jpg",
  "device_id": "DJIM3TD_001",
  "operator_id": "U10086",
  "operator_name": "马A",
  "flight_params": {
    "altitude_agl": 120.5,
    "altitude_rel": 170.1,
    "distance_start": 3231.0,
    "horizontal_speed": 15.0,
    "gimbal_pitch": -68,
    "heading": 180
  }
}

批量写入接口（任务结束时调用，一次性同步剩余未落库线索）：

POST /api/v1/clues/batch-create
Body: { "clues": [ { ... }, { ... }, ... ], "task_id": "xxx" }

6. 非功能性需求

6.1 性能要求

6.2 存储估算

6.3 离线策略（适用于座舱实时写入链路）

考虑到无人机作业场景可能存在弱网/无网络环境，座舱侧的线索写入需做离线兜底：

说明：本节描述的是数据生产端（虚拟座舱）的离线策略。新增的线索管理模块是数据消费端（读取/查询），在有网络环境下正常访问服务端API即可。

7. 界面原型要点（基于截图还原）

7.1 配色规范

7.2 底部Tab栏结构

[现场遍检] [离线地图] [AI线索★] [无人机] [个人中心]
                         ↑ 当前选中态

7.3 虚拟座舱右侧工具栏顺序（从上到下）

┌──────┐
│ AI识别 │
│  航迹  │
│  搜索  │
│  操控  │
│  任务  │
│ AI线索 │  ← 本次重点（已有UI，需打通数据持久化）
│  更多… │
└──────┘

8. 待确认事项（Q&A）

9. 版本规划建议

V1.0（MVP）

• 线索基础CRUD（列表/详情/筛选/统计）
• 虚拟座舱实时线索 → 服务端持久化链路打通
• 地图点位展示+聚合+联动
• 任务绑定关联（线索 ↔ 任务 一对多）
• 离线缓存+自动同步机制
• 底部Tab入口

V1.1（迭代）

• 线索人工标注修正（改类型/调置信度）
• 线索转工单流转
• 线索导出报告（Excel/PDF）
• 烛力图/密度分析视图
• Web端管理后台复用

10. 附录

附录A：名词解释

附录B：参考文档

• 《某采集平台无人机管理服务平台-二次开发接口文档》
• 《大疆机场2产品介绍》
• 《高点视频AI识别技术方案》
• 某县市项目甲体系相关需求文档

本文档基于截图UI原型及业务描述编写，待评审后进入开发排期。