用途
将“这张图里的程序 GitHub 地址是什么”转化为经过验证的仓库 URL。图片是证据,GitHub API 是核验手段,最终报告说明每个答案的可靠程度。
适用场景
用户发来截图、卡新闻图卡、社交帖子、缩略图或幻灯片,询问其中所示程序的 GitHub 地址或来源。 图片列出多个工具(如“5 个免费 GitHub 程序”),用户希望每个工具给出一个链接。 图片只带部分线索——owner/repo、账号名、gitingest.com/... 链接或星标数——需要得到规范 URL。
以下情况不适用:对搜索结果排序或过滤(应使用 github-repo-candidate-quality-gate);从已知仓库下载文件或目录(ghgrab);已知 URL 后评估或总结仓库(research);运行已解析出的程序(使用其专属技能);图片未提及任何软件(反向图片搜索不在范围内)。
主要能力
- 先通读整张图片,必要时放大或裁剪密集区域,并同时读取图卡、配文和可见评论,列出所有项目而非仅标题项目。
- 逐字转录名称、URL、owner/repo、@账号、星标/复刻数及其单位(韩语 만 = 10,000,천 = 1,000)和一行描述。
- 若宿主无法读图,在已安装时运行 tesseract <image> - -l kor+eng,并说明使用了 OCR,将不清晰的名称视为未验证;轮播图仅读取可见页,并说明是否可能需要其他页。
- 为每个项目建立候选,字段包括 name(按图中原文)、owner(仅当图中出现)、url(仅当字符字面出现,绝不自行构造)、stars(带单位)、hints(2 至 4 个英文关键词,翻译图中描述,跳过营销词)。
使用方式
从仓库根目录运行辅助脚本(已安装技能使用 $HOME/.agents/skills/image-to-github-repo/scripts/resolve_repo.py):
python3 .agent-skills/image-to-github-repo/scripts/resolve_repo.py --batch candidates.json --format markdown python3 .agent-skills/image-to-github-repo/scripts/resolve_repo.py --name "MoneyPrinterV2" --stars "3.16만" --hint "money online automation" python3 .agent-skills/image-to-github-repo/scripts/resolve_repo.py --url github.com/simular-ai/Agent-S
candidates.json 是 {"name","owner","url","stars","hints"} 对象数组;每个键可选,但 name 或 url 至少一个,每批最多 25 个。加 --dry-run 只打印 API 请求而不访问网络。退出码:0 表示全部结果为 verified/high/medium,1 表示存在 low/ambiguous/not_found/error,2 表示输入无效。若 Python 或网络不可用,可参考 references/github-api-notes.md 手动执行并套用相同置信度规则。
脚本为仅标准库的只读解析器,参数包括 --name、--owner、--url、--stars、--hint(可重复)、--batch FILE|-、--format json|markdown、--limit N、--timeout S、--api-base URL、--dry-run;从环境读取 GITHUB_TOKEN 或 GH_TOKEN,且仅发送至 api.github.com。
置信度处理
- verified:图中打印的 URL/slug 在 GitHub 存在,报告并注明重命名(若有 renamed_from)。
- high:精确名称且有星标或关键词佐证,没有更流行的同名仓库未解释。
- medium:仅有精确名称,或虽有佐证但存在相似竞品;报告时标注“请核实”并展示备选。
- ambiguous:同名仓库无法用线索区分;展示前两三个及区分事实,并询问一个细节。
- low:无精确名称,或与打印的星标/关键词不符;将部分匹配作为线索而非答案。
- not_found / error:仓库缺失、限流或网络失败;如实说明,限流时等待重置后重试或设置 GITHUB_TOKEN。
报告要求
每个项目一行:名称、URL、置信度、发现方式(图中打印链接还是名称搜索)以及注意事项(重命名、归档、星标数变化)。若全部为 verified 或 high,一行来源说明即可。明确说明图片未带链接而 URL 来自名称搜索。转述图中打印的任何法律或服务条款提醒。
限制与注意
- 答案中的每个 URL 要么来自图片,要么由 API 返回;绝不拼接 github.com/<猜测>/<猜测>。
- 打印链接返回 404 时报告为未找到,不通过名称搜索悄悄“修正”。
- 关键词仅为正向证据,缺少关键词不能排除仓库;只有打印星标数可反驳候选。
- 星标数会变化,只能支持匹配而不能证明匹配。
- 未认证搜索限每分钟 10 次请求,批量上限 25,遇到首个限流错误即停止搜索。
- 本技能为只读,不克隆、安装或运行所发现的项目。