geod-agent
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Fail
- spawnSync — Synchronous process spawning in apps/geod-agent-desktop/scripts/prepare-release.mjs
- process.env — Environment variable access in apps/geod-agent-desktop/scripts/prepare-release.mjs
- process.env — Environment variable access in apps/geod-agent-desktop/src-tauri/codex-host.mjs
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Open-source AI GIS desktop agent: conversational data downloads, local processing, 2D/3D maps, Skills and MCP.

GeoD Agent
用对话配置图源、组织任务,把地理数据带回工作区。
AI 对话 · 本机下载与处理 · 二维 / 三维地图 · Skill / MCP 扩展
官网 · 下载 Windows 正式版 · 观看实录 · 反馈问题 · English

当前浅色开发版实拍。下载版本与开发中的改进分别标注。
GeoD Agent 是独立的 Windows 桌面应用。描述区域、数据类型和用途,核对图源、范围与输出参数,由你的电脑完成下载、拼接、裁剪和文件核验。模型负责理解需求与组织工具调用;影像瓦片不经 GeoD 模型服务器中转。
真实操作演示
从空白会话开始,通过 AI 对话配置图源、准备 MCP 接入、确认输出参数、下载影像、查看成果并创建定时任务。中文配音与字幕;思考与等待加速呈现。视频为当前开发版实录,功能以实际安装版本为准。
版本状态
| 版本 | 状态 | 入口 |
|---|---|---|
| 0.2.3 | Windows x64 公开测试版 | 下载安装包 · 版本说明 |
| 0.2.4 | Windows x64 正式版 | 下载安装包 · 版本说明 |
| 0.2.5 | Windows x64 正式版 | CDN 下载安装包 · 版本说明 |
当前正式版为 0.2.5,增加紧凑对话记录、中文输入改进、可恢复任务清理、启动首屏及组件更新,修正 Responses 多轮兼容。源代码以 MIT 许可证公开,可接入自己的模型渠道;GitHub 发行资源作为备用下载。旧版首次升级仍使用完整包,后续可复用未变化的运行环境。具体验证范围见版本说明。
对话能做什么
| 配置图源 | 组织任务 | 扩展能力 |
|---|---|---|
| 添加预设与自定义图源,核对可用状态 | 确认范围、坐标系和输出,查看进度与成果 | 接入 MCP、安装 Skill,配置模型渠道 |
| “添加 Esri World Imagery,命名为项目影像。” | “沿这条路线 1 公里范围下载影像,输出 EPSG:4326。” | “帮我接入高德 MCP。” |
体验额度: 登录并领取 20,000 Credits,限量 100 名。数据源 Key 在应用本机表单配置。
开始使用
- 安装当前正式版,使用 GeoD 账号在浏览器完成授权。
- 配置数据图源。需要 Key / Token 的服务,在应用本机表单填写。
- 描述需求,附上范围文件,或在地图上绘制边界。
- 核对计划中的图源、范围、精度、格式、坐标系、预算与保存位置,然后执行。
- 在任务区查看状态,加载成果到地图,打开成果目录并检查文件清单。
例如:
下载这份项目边界内的影像,输出 GeoTIFF,坐标系用 EPSG:4490。
查看这个区域的历史影像版本,让我先选择年份和时期。
加载三维成果,从南侧斜看建筑,然后切回二维地图。
参数不明确时先询问;明确要求不再询问时,在已授权范围内推进。待回答的选择卡保留在会话中;已确认参数可用于当前任务,只有明确指定才保存为会话默认。更改缩放等级时沿用原计划中已确认的坐标系。
数据工作流
| 数据 | 主要能力 | 成果 |
|---|---|---|
| 影像 | XYZ / WMTS / ArcGIS ImageServer,注记合成,范围下载、拼接与裁剪 | GeoTIFF、MBTiles、PNG / JPEG、GeoPackage、原始瓦片 |
| DEM | Terrarium 解码,Float32 米制高程与 NoData | 高程 GeoTIFF |
| 历史影像 | Esri Wayback 目录、版本选择与区域元数据 | 历史影像与元数据 |
| 矢量 | OSM 要素、MVT / PBF,按范围筛选 | GeoJSON、GeoPackage、PBF、MBTiles |
| 三维 | URL / Cesium Ion / 认证服务,资源递归收集、离线核验与定位 | 3D Tiles 资源包与完整性清单 |
历史版本发布日期不等于拍摄日期。矢量范围筛选保留完整相交几何,3D Tiles 保留整块模型。图源连接成功不等于获得下载许可;覆盖、精度与授权需逐项核对。
从已有范围开始
地图矩形、多边形、行政边界与书签可直接用于任务。文件支持 GeoJSON、SHP / ZIP、GeoPackage、KML / KMZ、GML、FlatGeobuf、空间 SQLite 和 CSV WKT / EWKT;也可通过数据库或在线要素服务读取区域。所需格式引擎按需安装。
图源提供预设与自定义连接,支持已适配服务的查询参数认证、Bearer Token 和请求头。天地图等图源需要用户自己的有效凭据;密钥保存在本机凭据库,模型读取配置摘要。
一个工作区,连接对话、地图与成果

2026-10-06 本机实际成果:昌平区影像,704 张瓦片,按行政边界裁剪后加载到地图。截图中的对话属于当时的验证记录。
- 任务管理: 下载、生成成果、核验分别显示状态;支持暂停、取消、恢复和缓存补漏。0.2.4 增加生成成果期间的持续反馈,默认不压缩,可直接打开成果目录。
- 多个区域: 合并范围或按区域拆分计划,批量查看与管理任务。
- 定时任务: 保存下载或 AI 指令模板,查看运行记录;是否自动执行取决于当前权限。退出窗口与停止后台是不同操作,定时运行需要本机后台继续运行。
- 持久化: 工作区、会话、选择卡、任务账本与图源缩略图缓存在本机保存。
- 地图: 内置 OpenLayers / Cesium 工具用于视野、图层、对象、底图与二维 / 三维切换。
- 会话: 中英文界面、独立登录页、头像与昵称同步,执行过程可展开、停止和继续。超长思考限制高度;未完成轮次明确标记。

当前浅色开发版实拍:本机已下载的 Cesium 官方 3D Tiles 样例,可在同一工作区切换二维 / 三维。
0.2.4:GIS 按需安装
基础安装包移除 Java、Tika、Apache POI 和本地 OCR,GIS 原生依赖拆成五项技能,已下载的依赖共享复用:
| 技能 | 用途 |
|---|---|
| 多格式范围导入 | 检查图层、读取边界及坐标系 |
| 矢量转换 | 格式转换与重投影 |
| 矢量分析 | 裁剪、缓冲与几何简化 |
| 栅格检查 | 坐标系、波段、范围与基本统计 |
| 栅格转换 | 格式转换、重投影、压缩、COG 与金字塔 |
任务缺少所需技能时,显示安装提示,用户确认后下载并继续。支持离线组件目录;下载与解包文件按固定版本和 SHA-256 校验。基础包仍可使用 WGS84 GeoJSON、手绘范围、行政边界和瓦片下载拼接。
移除 OCR 后,扫描文档不会被自动当成已识别文本。旧 DOC / XLS / PPT 请先另存为现代格式。视觉模型的支持取决于所选渠道,扫描 PDF 自动拆页输入仍待完善。此前精简包的体积测量见记录,不代表本次最终安装包大小。
模型与扩展
- 模型渠道: GeoD 托管服务、自有 Key 和兼容中转网关;支持已适配的 OpenAI、Anthropic 与 Google 原生协议。不同渠道的模型、工具和视觉能力需实际验证。
- Credits: 模型用量依据实际收据记录与结算。新用户登录后自动赠送 20,000 Credits,限前 100 个符合条件的账号,每个账号仅赠送一次;已有余额记录的账号不参与,名额用完即止。支付宝月套餐提供 ¥9 / 10,000 Credits、¥19 / 20,000 Credits、¥49 / 50,000 Credits,手动续费,已到账额度不随套餐周期结束清零。也可配置自己的模型渠道,不扣 GeoD Credits,API 费用由对应服务商结算。
- Skill: 搜索目录、检查链接或导入本地包,保留指令、脚本与资料。安装 Skill 不代表其所有外部依赖都可用。
- MCP: HTTP / stdio 工具接入,认证请求头与浏览器 OAuth。首次启用确认与工作区文件权限分别管理;连接后列出真实工具与状态。
- 可选 RTK: 对部分成功的本机命令输出做摘要,降低进入模型的冗余文本。原始执行记录保留;不改变命令、权限或退出码,也不承诺固定的 Token 或费用节省比例。
大段坐标、路线和矢量几何通过本机文件引用传递,模型优先读取范围、要素数与必要摘要。模型自己的思考文本与工具返回是不同来源,两者保留可追溯记录。
执行与数据边界
模型请求会发送任务描述及必要的工具信息到所选模型服务。图源凭据、下载瓦片和成果文件由本机管理;工作区写入、外部连接器启用和具体下载计划分别受权限检查。成果检查记录实际文件、大小、哈希与缺失覆盖,模型说“完成”不能代替任务状态和文件核验。
GeoD Agent 与旧 GeoD 桌面端 / CLI / MCP、GeoD Global 分别维护。当前运行时没有指向旧仓库的路径依赖。
开发与验证
欢迎提交 Issue 或 Pull Request。请先说明场景与预期结果;Bug 反馈附版本号、复现步骤和脱敏日志。
展开项目结构与验证文档| 目录 | 内容 |
|---|---|
apps/geod-agent-desktop |
React / Tauri 桌面应用、场景桥接与本机执行 |
crates/geod-core |
格网、下载与成果处理 |
crates/geod-task-engine |
确定性计划、批准与 SQLite 任务账本 |
crates/geod-vector |
矢量工作流 |
services/geod-agent-model-gateway |
模型协议、账号用量与托管网关 |
contracts |
有版本的任务与工具合同 |
docs/implementation |
真实验证证据、限制和恢复记录 |
固定运行时准备与启动说明见独立开发入口。前端使用 Vite 热更新;发布准备会校验固定版本运行时与许可证。不要把测试图源、模拟任务或本地预览当成线上验收。
文档导航
反馈时请附上版本、图源类型、任务状态与脱敏日志;不要在会话或 Issue 中粘贴 Key、Token、密码或私钥。
相关项目与许可证
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found
