# Capabilities

目录编号表示建议研究顺序，不代表运行时依赖关系，也不代表每个目录都是
`opengeos/geoai` 内置能力。

## 基于 opengeos/geoai 的能力分层

| 层级 | 含义 | 当前工作区示例 |
| --- | --- | --- |
| A：直接能力 | `geoai-py` 已有模块或文档直接覆盖 | 目标检测、分割、分类、变化检测、影像处理/导出 |
| B：生态组合 | 以 `geoai-py` 为核心，再组合地理计算或业务库 | 空间测量、成果质检、灾害统计、部分三维分析 |
| C：产品业务能力 | 主要由现有产品后端、规则和数据服务实现 | 风险规则、航线规划、集群调度、GeoLLM、知识图谱、模型治理 |

判断一个方向是否属于 GeoAI 项目，要看它是否处理地理空间数据并调用 AI 或
空间分析；判断它是否是 `geoai-py` 的能力，则必须以该仓库当前源码和文档为准。

## 实现边界与项目阶段是两个维度

项目需求不能直接拿 A/B/C 当作业务分类。A/B/C 只说明某个结果由哪一层实现：

| 项目阶段 | 典型结果 | 常见实现边界 |
| --- | --- | --- |
| 模型观察 | 框、类别、掩膜、变化栅格、异常分数 | A 或 B |
| 空间与测量 | 相交、距离、面积、长度、位移、覆盖比例 | B；若只是消费结果的服务也可能是 C |
| 事件候选 | 疑似未戴安全帽、疑似堵塞、疑似边坡变化 | C |
| 平台动作 | 告警、喊话、工单、复飞、任务调度 | C |

同一个目录如果横跨多个边界，README 必须逐段说明。例如 `12-quality-control-refly`
中的质量指标计算可属于 B，而自动复飞建议和任务下发属于 C，不能用一个总标签掩盖差异。

## 项目类别不是任意标签

“人员、安全帽、沟道、堵塞物、裂缝、矿浆渗漏”等类别只有在模型权重、类别映射、
输入传感器和标注规范一致时才能成为可运行选项。控制台应选择登记过的任务预设，
不能把用户填写的任意名称交给不支持该类别的通用模型。

- 安全帽优先建模为人员与安全帽的检测/实例及关联；`03-attribute-classification`
  只作为人员裁剪图上的可选二次分类，不替代安全帽目标和关联真值。
- 排洪沟需要沟道/箱涵口与堵塞物的项目掩膜；当前 `02-semantic-mapping` 颜色基线
  仅验证栅格到矢量的数据流，不代表已经支持排洪沟类别。
- RGB 水色或浑浊只能作为异常观察，不能直接输出“矿浆渗漏已确认”。

当前 `geoai-py 0.42.0` 的直接能力目录见
[`GEOAI_PY_DIRECT_CAPABILITIES.md`](./GEOAI_PY_DIRECT_CAPABILITIES.md)。该目录区分
了库可以直接承接的模型产出、需要额外依赖或空间规则的组合能力，以及必须由产品
后端实现的业务能力。

官方依据：

- https://github.com/opengeos/geoai
- https://pypi.org/project/geoai-py/

每个能力目录至少包含：

- `README.md`: 目标、输入、输出和完成标准。
- `requirements.txt`: 公共依赖之外的专属依赖。

开始实现时再增加 `src/`、`tests/`、`examples/` 和 `configs/`，避免初期产生大量空目录。