zimai233/dsh-image-search

dsh-image-search

多引擎反向图片搜索聚合器，为 DeepSeek Harness 而生。

Multi-engine reverse image search aggregator for DeepSeek Harness.

把一张公网图片 URL，一键转成 Google Lens / 百度识图 / Yandex / TinEye / Bing 视觉搜索 / 搜狗识图 / SauceNAO / IQDB / Ascii2d 的搜索链接——纯 URL 构造，零网络请求，零依赖。

Turn one public image URL into search links for Google Lens / Baidu / Yandex / TinEye / Bing Visual Search / Sogou / SauceNAO / IQDB / Ascii2d — pure URL construction, zero network calls, zero dependencies.

为什么需要它 / Why

视觉生态里已经有 OCR 和 UI 还原，但没有插件做多引擎反向图片搜索聚合——没有任何东西能把 Google Lens / 百度 / Yandex / TinEye / SauceNAO / IQDB / Ascii2d 一次配齐。

The vision ecosystem has OCR and UI restoration, but nobody aggregates multi-engine reverse image search — nothing puts Google Lens / Baidu / Yandex / TinEye / SauceNAO / IQDB / Ascii2d together in one call. This plugin is the aggregation wedge: 一次提交，全网溯源。

特性 / Features

- image_search_urls — 返回 JSON 数组 [{ id, name, group, url }]，每个引擎一条搜索链接。可按 engines（逗号分隔 id）或 group（通用 / 插画/动漫）过滤。
- image_search_engines — 返回按分组归类的全部 9 个引擎（含模板与是否编码），用于发现引擎 id。
- image_search_best — 返回人类可读的 Markdown 摘要：一行总览 + 每个引擎一条可点击链接。
- 纯 URL 构造，不发起任何实际抓取请求——安全、零依赖、可离线运行。
- 零构建步骤——纯 ESM，发布即运行时代码。无 prepare 脚本，无需构建权限。

安装 / Install

from npm
dsh plugin --profile myprofile add dsh-image-search

from GitHub (lock the commit for supply-chain hygiene)
dsh plugin --profile myprofile add github:zimai233/dsh-image-search#

用法 / Usage

用自然语言让 agent 执行：

"帮我用这张图搜一下源头：https://example.com/img.png —— 先列出所有引擎的搜索链接"

Agent 会调用 image_search_urls：

{
"imageUrl": "https://example.com/img.png"
}

返回示例（截取）：

[
{ "id": "google", "name": "Google Lens", "group": "通用", "url": "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fexample.com%2Fimg.png" },
{ "id": "saucenao", "name": "SauceNAO", "group": "插画/动漫", "url": "https://saucenao.com/search.php?url=https://example.com/img.png" }
]

也可以限定引擎 / 分组：

{
"imageUrl": "https://example.com/img.png",
"engines": "google,saucenao",
"group": "插画/动漫"
}

工具参考 / Tool Reference

| Tool | 参数 Parameters | 返回 Returns |
|---|---|---|
| image_search_urls | imageUrl (required), engines?, group? | JSON 数组 [{ id, name, group, url }] |
| image_search_engines | — | 按 group 分组的 JSON，含模板与 encode 标志 |
| image_search_best | imageUrl (required), engines? | Markdown：总览行 + 每个引擎一条链接 |

引擎表 / Engines

| id | name | group | encode |
|---|---|---|---|
| google | Google Lens | 通用 | ✓ |
| baidu | 百度识图 | 通用 | ✓ |
| yandex | Yandex | 通用 | ✓ |
| tineye | TinEye | 通用 | ✓ |
| bing | Bing 视觉搜索 | 通用 | ✓ |
| sogou | 搜狗识图 | 通用 | ✓ |
| saucenao | SauceNAO | 插画/动漫 | ✗ |
| iqdb | IQDB | 插画/动漫 | ✗ |
| ascii2d | Ascii2d | 插画/动漫 | ✗ |

encode 为 true 的引擎走 query-string 参数（图片 URL 需 encodeURIComponent 编码）；为 false 的引擎走路径式参数（需原样 URL）。
开发 / Development

npm install
npm test          # node:test 直接跑纯核心函数 buildEngineUrls / groupEngines
npm run pack      # dry-run publish (pnpm pack equivalent)

许可证 / License

MIT