Repolode
Oldcircle

Oldcircle/geo-sleuth

一个 Agent Skill,结合 OpenStreetMap、地形天际线、卫星影像和街景,推断照片的拍摄地点并给出推理过程。

Star
6,422
Fork
790
未关闭 Issue
20
最近提交
3天前

这是什么?

geo-sleuth 是一个面向 AI 编程代理的照片定位技能。给定一张照片后,代理会运行一组 Python 脚本,读取 EXIF 信息和画面中的文字,在 OpenStreetMap 上搜索候选地点,并把照片中的山脊线与每个候选点根据高程数据计算出的天际线进行比对。卫星图块和街景图片会用 CLIP、DINOv2 与 SIFT 匹配排序,最终输出带误差半径的相机位置、朝向和证据图。

该技能适用于没有明显地标的照片,例如只有桥梁、输电线、山脉或街道树木的场景。脚本负责排序候选项,模型只在前几名中做判断。每个结论都需要指向实际运行过的命令及其生成的文件。仓库中还列出了两个案例照片的基准测试和盲测复跑结果。

它以标准 Agent Skill 的形式安装,即包含 SKILL.md 和脚本的文件夹,可用于 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 和 GitHub Copilot。运行需要 Python 3.10+、uv,并需安装 Chrome 或 Playwright Chromium 以进行以图搜图。

核心功能

  • 01基于 OpenStreetMap 的铁路桥、输电线等要素筛选候选地点。
  • 02将照片中的山脊线与高程计算出的天际线比对,并求解相机的小角度横滚。
  • 03利用阴影和太阳方位推断朝向与纬度范围。
  • 04用 CLIP、DINOv2 与 SIFT 对卫星图块和街景进行排序匹配。
  • 05输出带误差半径的相机坐标、朝向和证据图。
  • 06以标准 Agent Skill 形式运行于六种主流编程代理。

适用场景

  • 为没有 GPS 信息、也没有可读标识的照片做 OSINT 调查定位。
  • 借助可追溯的推理过程练习 GeoGuessr 类地理猜谜。
  • 在获得授权的前提下,确认风景或基础设施照片的拍摄地点。
  • 研究地形、卫星影像与地图数据如何结合用于图像定位。

快速上手

  1. 1

    使用 npx 安装该技能并选择你的智能体

    npx skills add Oldcircle/geo-sleuth
  2. 2

    首次使用时,让智能体运行技能 scripts 文件夹中的 doctor.py,并解决所有失败的检查项

  3. 3

    给智能体一张照片,并请它找出拍摄地点

使用前须知

  • 需要 Python 3.10 或更高版本,并且首次使用时需要进行环境检查。
  • 完整运行可能很慢;文档中的一个案例端到端耗时约 72 分钟。

收录于专题

标签

常见问题

geo-sleuth 是什么?
一个 Agent Skill,结合 OpenStreetMap、地形天际线、卫星影像和街景,推断照片的拍摄地点并给出推理过程。 geo-sleuth 是一个面向 AI 编程代理的照片定位技能。给定一张照片后,代理会运行一组 Python 脚本,读取 EXIF 信息和画面中的文字,在 OpenStreetMap 上搜索候选地点,并把照片中的山脊线与每个候选点根据高程数据计算出的天际线进行比对。卫星图块和街景图片会用 CLIP、DINOv2 与 SIFT 匹配排序,最终输出带误差半径的相机位置、朝向和证据图。
geo-sleuth 可以免费使用吗?用的什么许可证?
geo-sleuth 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
geo-sleuth 还在维护吗?
活跃维护中。geo-sleuth 最近一次提交是在 2026年11月5日。
geo-sleuth 适合用来做什么?
为没有 GPS 信息、也没有可读标识的照片做 OSINT 调查定位。 借助可追溯的推理过程练习 GeoGuessr 类地理猜谜。 在获得授权的前提下,确认风景或基础设施照片的拍摄地点。 研究地形、卫星影像与地图数据如何结合用于图像定位。
geo-sleuth 怎么安装和运行?
使用 npx 安装该技能并选择你的智能体: npx skills add Oldcircle/geo-sleuth 首次使用时,让智能体运行技能 scripts 文件夹中的 doctor.py,并解决所有失败的检查项 给智能体一张照片,并请它找出拍摄地点
在哪里获取 geo-sleuth?
源代码和安装说明在 GitHub 上:https://github.com/Oldcircle/geo-sleuth

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目