| | |
|---|
| | | # GeoAI Workbench |
|---|
| | | |
|---|
| | | GeoAI 多能力实验与产品验证工作区。每个能力都有独立目录、依赖声明和 |
|---|
| | | 输入/输出约定；通用依赖、共享数据、模型权重和运行结果由根目录统一管理。 |
|---|
| | | 本工作区以 [opengeos/geoai](https://github.com/opengeos/geoai) 的 `geoai-py` |
|---|
| | | 为 GeoAI 工作流基础，围绕无人机和遥感数据做实验与产品验证。这里的“GeoAI |
|---|
| | | 能力”分为三层：`geoai-py` 直接提供的功能、基于它的底层地理/AI生态组合出的 |
|---|
| | | 能力、以及需要由现有产品后端和业务规则实现的产品能力。后两类不能表述为 |
|---|
| | | `geoai-py` 内置功能。 |
|---|
| | | |
|---|
| | | ## 目录 |
|---|
| | | |
|---|
| | | ```text |
|---|
| | | geoai-workbench/ |
|---|
| | | |-- apps/ # 本地实验控制台等独立界面 |
|---|
| | | |-- capabilities/ # 一个能力一个目录 |
|---|
| | | |-- requirements/ # 跨能力共享的 Python 依赖 |
|---|
| | | |-- scripts/ # 环境初始化和检查脚本 |
|---|
| | |
|---|
| | | |
|---|
| | | ## 环境策略 |
|---|
| | | |
|---|
| | | - `geoai-py` 的包名是 `geoai-py`，导入名通常是 `geoai`，不是一个叫 `geoai` |
|---|
| | | 的操作系统或独立运行时。它要求 Python 3.12 或更高版本；本工作区固定使用 |
|---|
| | | Python 3.12 以兼容 PyTorch 和地理库。 |
|---|
| | | - 推荐 Python 3.11 或 3.12。当前电脑的 Python 3.13 可运行部分能力，但地理和 |
|---|
| | | 深度学习包的兼容性可能不完整。 |
|---|
| | | - 根目录 `.venv` 用于轻量能力和公共开发工具。 |
|---|
| | |
|---|
| | | powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\check-environment.ps1 |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | 优先从 `06-spatial-reasoning`、`01-object-detection`、 |
|---|
| | | ## 本地实验控制台 |
|---|
| | | |
|---|
| | | 控制台是本工作区内部的只读展示界面，独立于现有无人机产品。它读取 |
|---|
| | | `shared/outputs/` 中已有的实验结果，方便直接查看标注影像、轨迹图、事件和运行 |
|---|
| | | 元数据；不会上传数据、调用外部接口或启动能力脚本。 |
|---|
| | | |
|---|
| | | ```powershell |
|---|
| | | 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` 和规划工作簿中的“能力映射”工作表。 |
|---|
| | | |
|---|
| | | ## 新对话继续工作 |
|---|
| | | |
|---|
| | | 新建 Codex 对话时，把工作目录选择为本项目根目录，然后使用个人 Skill |
|---|
| | | `$geoai-capability-builder`。它会先读取 `AGENTS.md` 和 `PROJECT_CONTEXT.md`， |
|---|
| | | 无需复制此前的长对话。可直接参考根目录的 `新对话启动说明.txt`。 |
|---|
