GeoAI Workbench

本工作区以 opengeos/geoai 的 geoai-py
为 GeoAI 工作流基础，围绕无人机和遥感数据做实验与产品验证。这里的“GeoAI
能力”分为三层：geoai-py 直接提供的功能、基于它的底层地理/AI生态组合出的
能力、以及需要由现有产品后端和业务规则实现的产品能力。后两类不能表述为
geoai-py 内置功能。

目录

geoai-workbench/
|-- apps/             # 本地实验控制台等独立界面
|-- capabilities/     # 一个能力一个目录
|-- solutions/        # 多能力组合的项目算法方案
|-- requirements/     # 跨能力共享的 Python 依赖
|-- scripts/          # 环境初始化和检查脚本
|-- shared/           # 数据、模型、配置和输出
|-- src/geoai_common/ # 可复用 Python 代码
|-- tests/            # 公共模块测试
|-- .env.example
|-- .gitignore
`-- pyproject.toml

环境策略

• geoai-py 的包名是 geoai-py，导入名通常是 geoai，不是一个叫 geoai
  的操作系统或独立运行时。它要求 Python 3.12 或更高版本；本工作区固定使用
  Python 3.12 以兼容 PyTorch 和地理库。
• 推荐 Python 3.11 或 3.12。当前电脑的 Python 3.13 可运行部分能力，但地理和
  深度学习包的兼容性可能不完整。
• 根目录 .venv 用于轻量能力和公共开发工具。
• 每个能力的 requirements.txt 引用 requirements/base.txt，并只声明该能力
  的额外依赖。
• 出现版本冲突或 CUDA/原生库要求时，为该能力创建 .venvs/<能力名> 独立环境。
• 数据、模型权重和输出不提交 Git，也不复制进各能力目录。

快速开始

# 公共开发环境
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup.ps1

# 某个能力的隔离环境（自动创建到 .venvs/）
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup.ps1 -Capability 06-spatial-reasoning

# 仅检查当前电脑是否满足基础环境
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\check-environment.ps1

本地实验控制台

控制台是本工作区内部的独立本地实验工作台，不与现有无人机产品连接。它提供
“新建运行、案例库、结果工作区”三段式体验：在允许的能力页面中，可以上传
受限文件类型、调用固定的本地能力脚本，并查看地图、影像对比、事件、结构化
结果和运行元数据。每次运行都会创建新的目录，不覆盖原始数据或既有输出。

控制台只监听本机回环地址；服务端不接受任意命令或路径，只调用固定虚拟环境和
固定能力脚本。接入或修改控制台时使用 $geoai-workbench-console。

py -3.12 .\scripts\serve_workbench_console.py

浏览器访问 http://127.0.0.1:6173。默认端口为 6173，仅监听本机；其他可用的
6xxx 端口可以通过 --port 指定。界面说明见
apps/workbench-console/README.md。

优先从 01-object-detection、02-semantic-mapping、
07-risk-rule-engine 和 12-quality-control-refly 开始。

能力边界

• 直接能力：目标检测、语义/实例分割、影像分类、变化检测、遥感数据下载与
  预处理、地理结果导出与可视化等，具体以 geoai-py 当前版本文档和源码为准。
• 组合能力：空间测量、质量检测、灾害统计等，需要 geoai-py 加 Rasterio、
  GeoPandas、Shapely、PyTorch 或其他专用库。
• 产品能力：空间规则、风险评分、航线规划、集群调度、工单闭环、GeoLLM、
  知识图谱和模型治理，不是 geoai-py 单独提供的功能，需要产品服务实现。

完整映射见 capabilities/README.md 和规划工作簿中的“能力映射”工作表。

项目算法方案层

capabilities/ 维护可独立验证的原子能力；solutions/ 维护面向业务场景的组合
算法方案。一个方案可以引用检测、分割、变化、测量和风险规则等多个能力，但不重复
复制模型代码。当前已建立 solutions/mining-inspection/，优先准备人员安全识别和
排洪沟堵塞识别两个试点骨架。

新对话继续工作

新建 Codex 对话时，把工作目录选择为本项目根目录，然后使用个人 Skill
$geoai-capability-builder。能力需要上传、地图、图像对比或直观结果工作区时，
同时使用 $geoai-workbench-console。两者都会以 AGENTS.md 和
PROJECT_CONTEXT.md 为准，无需复制此前的长对话；可直接参考根目录的
新对话启动说明.txt。