From f67d43a43f6c3e58922e3c2f457dd9caafebfc67 Mon Sep 17 00:00:00 2001 From: shuishen <1109946754@qq.com> Date: Fri, 14 Aug 2026 14:20:22 +0800 Subject: [PATCH] feat:具体能力实现处理 --- README.md | 44 +++++++++++++++++++++++++++++++++++++++++--- 1 files changed, 41 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cde9d01..f63c1dc 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,16 @@ # 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/ # 环境初始化和检查脚本 @@ -20,6 +24,9 @@ ## 环境策略 +- `geoai-py` 的包名是 `geoai-py`，导入名通常是 `geoai`，不是一个叫 `geoai` + 的操作系统或独立运行时。它要求 Python 3.12 或更高版本；本工作区固定使用 + Python 3.12 以兼容 PyTorch 和地理库。 - 推荐 Python 3.11 或 3.12。当前电脑的 Python 3.13 可运行部分能力，但地理和 深度学习包的兼容性可能不完整。 - 根目录 `.venv` 用于轻量能力和公共开发工具。 @@ -41,5 +48,36 @@ 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`。 -- Gitblit v1.9.3