SauceNAO 图片搜索

kokkoro-plugin-saucenao 使用 SauceNAO 搜索图片来源，并通过 QQ Markdown 消息展示结果。

IMPORTANT

使用 SauceNAO API 前，需要先申请 API Key，并完成环境变量配置。

安装

在 Kokkoro 项目目录中安装插件：

bun add kokkoro-plugin-saucenao

安装完成后，重新启动项目，Kokkoro 会自动加载插件。

搜索图片来源

发送 /搜图 指令时附带图片，或引用包含图片的消息回复该指令。

单次搜索仅处理一张图片。检测到多张图片时，插件选取首张图片，并在结果标题下方显示提示。以下示例仅展示首条搜索结果：

聊天记录

Yuki

/搜图

可可萝

SauceNAO 搜图结果

检测到消息中包含多张图片，已选取首张图片进行识别。

---

1. 猫耳コッコロちゃん

• 相似度：98.3%
• 平台：Pixiv Images

查看来源

消息中没有图片、接口请求失败或没有搜索结果时，机器人会回复对应的错误信息。

快捷方式

「搜图」与 /搜图 的用法相同。在普通群消息中使用快捷方式，需要开启「获取群内全部消息」权限。

配置

使用插件前，需要从 SauceNAO 获取 API Key，并写入项目根目录的 .env：

SAUCENAO_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SAUCENAO_NUMRES=3
SAUCENAO_SIMILARITY_THRESHOLD=50

• SAUCENAO_API_KEY：SauceNAO API Key，必须填写。
• SAUCENAO_NUMRES：返回的搜索结果数量，默认值为 3。
• SAUCENAO_SIMILARITY_THRESHOLD：显示 SauceNAO 缩略图所需的最低相似度，默认值为 50。低于该数值时，插件会用表情包替换缩略图，避免展示不相关的图片。

修改 .env 后，需要重新启动项目。