# 瑶岗仙二期矿山巡检算法方案

本目录以《瑶岗仙二期项目算法需求与 GeoAI 能力匹配分析报告》为需求来源。项目方案
组合 `capabilities/` 中的原子能力、空间计算和业务规则，输出供平台展示与人工复核的
事件候选；这里不复制模型实现，也不直接控制无人机或派发工单。

结构化映射见 [`requirements-map.json`](./requirements-map.json)。报告原始 8 项中，
“排洪沟巡查”和“排洪沟堵塞识别”共用同一设施、样本、模型和严重度规则，因此规范化
为 **7 个方案域**，不重复建设两套能力。

## 两套分类不能混用

| 分类维度 | 回答的问题 | 示例 |
| --- | --- | --- |
| A/B/C 实现边界 | 结果由 `geoai-py` 直接产生、生态组合产生，还是产品服务产生？ | 分割掩膜=A；面积与多期统计=B；告警与工单=C |
| 项目处理阶段 | 当前结果属于模型观察、空间计算、事件候选，还是平台动作？ | `person`、围栏相交、疑似闯入、喊话 |
| P1/P2/P3 优先级 | 在数据、传感器、规则齐备程度下，先验证什么？ | 排洪沟=P1；索道近景缺陷=P3 |
| readiness 成熟度 | 现在能运行到哪一步，还缺什么证据？ | `partial`、`blocked_by_data` |

A/B/C 不表示准确率或成熟度。技术上属于 A 类的接口，如果没有项目模型、权重和真值，
仍然可能处于 `blocked`；技术契合度高也不等于可以优先上线。

## 规范化需求映射

| 方案域 | 原始需求 | 主要原子能力 | 优先级 | 当前判断 |
| --- | --- | --- | --- | --- |
| 人员与个体防护 | 人员安全识别 | `01` 检测 + 可选 `03` 裁剪分类 + `06/07` | P1 | 已有人候选 Demo；无安全帽模型、关联真值和区域规则 |
| 爆破警戒热成像 | 爆破警戒热成像巡查 | 热成像人员检测 + `06/07` | P1-条件就绪 | 无热成像样本和警戒区，不能复用 RGB 模型后直接验收 |
| 排洪沟与箱涵堵塞 | 排洪沟巡查、排洪沟堵塞识别 | `02` 分割 + `01` 检测 + `00/04/07` | P1 | 通用颜色分割流程已通；项目类别、模型和真值未完成 |
| 边坡变化与形变 | 边坡监测 | `00` 变化 + `05` 三维 + `04/09` | P2 | 先修正重复需求描述，补同尺度多期数据和工程精度 |
| 竖井设施巡查 | 竖井堵塞及损坏识别 | `01/02/09` + `04/05` | P2 | 先界定井口、拦网、栈道、井壁等检测部位 |
| 索道部件巡查 | 索道安全感知 | `01/02/09` + `04/05/13` | P3 | 全景航拍不支持断丝结论；先确定部件和近景采集方案 |
| 尾矿库异常筛查 | 尾矿库矿浆渗漏识别 | `02/03/00/09` + 可选 `08` | P3 | RGB 颜色异常不等于渗漏，需多光谱/热成像和现场证据 |

## 统一结果分层

```text
采集数据
  -> 模型观察 observations：person、helmet、blockage_mask、surface_change
  -> 空间与测量 analysis：围栏相交、面积、长度、覆盖比例、位移
  -> 事件候选 events：疑似未戴安全帽、疑似堵塞、疑似边坡变化
  -> 平台动作 actions：告警、喊话、工单、复飞、任务调度
```

- `observations` 只能陈述模型看到了什么，不直接写“违规”“事故”或“渗漏已确认”。
- `analysis` 必须记录 CRS、单位、阈值和计算方法；普通 JPEG 只能报告像素坐标/面积。
- `events` 必须给出命中规则、证据工件和人工复核状态。
- `actions` 属于产品权限、审计和安全责任范围，不在原子能力 Demo 中自动执行。

## 类别选择规则

控制台的“类别选择”应是**任务预设**，而不是允许任意填写类别名称。每个可选任务必须
绑定模型/算法版本、类别表、输入传感器、标注规范、许可证和验收状态。没有模型和真值的
项目类别可以登记为 `planned`，但不能伪装成可运行选项。

当前优先任务预设：

| 任务预设 | 最低类别 | 输出类型 | 状态 |
| --- | --- | --- | --- |
| `person_ppe_rgb` | person、helmet | 框/实例与关联关系 | 人员 partial；安全帽 planned |
| `person_thermal_guard` | thermal_person | 框/热点区域 | blocked_by_data |
| `drainage_blockage` | channel、culvert_inlet、blockage_material、blockage | 多类掩膜、图斑 | planned；通用颜色基线不等同于该任务 |
| `slope_change` | stable、surface_change、collapse_candidate、crack_region | 多期变化栅格/图斑 | existing product only / local planned |
| `tailings_anomaly` | water_or_slurry_region、spectral_anomaly | 掩膜、变化与异常分数 | blocked_by_evidence |

## 阶段门槛

1. **G0 需求可验收**：目标对象、传感器、拍摄距离/GSD、区域和业务阈值明确。
2. **G1 数据可评估**：有正常、异常、困难、纯负样本和独立测试集，来源与许可已记录。
3. **G2 原子能力通过**：固定输入可重复运行，输出结构化，报告漏报、误报、耗时和限制。
4. **G3 方案事件通过**：空间计算、严重度规则与人工复核一致，不把模型观察当最终结论。
5. **G4 产品闭环评审**：权限、审计、性能、告警、工单和无人机动作经过产品与安全评审。

当前只保留两个试点目录：`01-person-safety` 和 `02-drainage-blockage`。其余方案在满足
G0/G1 前只登记在需求映射中，不创建空模型目录，也不承诺精度或上线时间。