kokkoro-plugin-saucenao 2.0.1 → 2.0.2

package/README.md

@@ -2,6 +2,9 @@
 
 SauceNAO 图片搜索，查找动漫、漫画、插画等图片的来源。
 
+> [!IMPORTANT]
+> 使用 SauceNAO API 前，需要先[申请 API Key](https://saucenao.com/user.php?page=search-api)，并完成[环境变量配置](#环境变量)。
+
 ## 安装
 
 ```shell
@@ -18,12 +21,26 @@ bun add kokkoro-plugin-saucenao
 
 ## 快捷方式
 
-发送「搜图」时附带图片，也会返回搜索结果。群聊需要开启「获取群内全部消息」权限。
+发送「搜图」时附带图片，也会返回搜索结果。要让普通群消息触发快捷方式，需要开启「获取群内全部消息」权限。
 
 ```text
 搜图
 ```
 
+## API
+
+其他插件可以从 `service` 入口导入 `fetchImageSources()` 搜索图片来源，再从 `util` 入口导入 `createMarkdown()` 生成 QQ Markdown：
+
+```typescript
+import { fetchImageSources } from 'kokkoro-plugin-saucenao/service';
+import { createMarkdown } from 'kokkoro-plugin-saucenao/util';
+
+const { results } = await fetchImageSources('https://example.com/image.jpg');
+const markdown = await createMarkdown(results);
+```
+
+`fetchImageSources()` 返回 SauceNAO 的完整响应，可通过第二个参数传入日志记录器，记录完整请求参数和接口响应。`service` 入口同时导出 `SauceNao` 和 `ImageSource` 类型。
+
 ## 环境变量
 
 使用插件前，需要在项目根目录的 `.env` 文件中填写 [SauceNAO API Key](https://saucenao.com/user.php?page=search-api)。
@@ -37,17 +54,3 @@ SAUCENAO_SIMILARITY_THRESHOLD=50
 `SAUCENAO_NUMRES` 表示返回结果数量，默认值为 `3`。
 
 `SAUCENAO_SIMILARITY_THRESHOLD` 表示显示原缩略图的最低相似度，默认值为 `50`。低于该数值时，插件会使用表情包替换缩略图，避免搜出奇怪的图社死。
-
-## API
-
-其他插件可以从 `service` 入口导入 `fetchImageSources()` 搜索图片来源，再从 `util` 入口导入 `createMarkdown()` 生成 QQ Markdown：
-
-```typescript
-import { fetchImageSources } from 'kokkoro-plugin-saucenao/service';
-import { createMarkdown } from 'kokkoro-plugin-saucenao/util';
-
-const { results } = await fetchImageSources('https://example.com/image.jpg');
-const markdown = await createMarkdown(results);
-```
-
-`fetchImageSources()` 返回 SauceNAO 的完整响应。`service` 入口同时导出 `SauceNao` 和 `ImageSource` 类型。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokkoro-plugin-saucenao",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "SauceNAO 图片搜索，查找动漫、漫画、插画等图片的来源。",
   "keywords": [
     "bot",

package/src/index.ts

@@ -1,6 +1,6 @@
 import { useCommand, useLogger } from '@kokkoro/core';
 
-import { fetchImageSources, SAUCENAO_API } from './service';
+import { fetchImageSources } from './service';
 import { createMarkdown } from './util';
 
 const logger = useLogger();
@@ -12,16 +12,9 @@ export default () => {
     if (!image?.url) {
       throw new Error('请在指令中附带需要搜索的图片');
     }
-    logger.debug('发送 SauceNAO 请求', {
-      method: 'POST',
-      url: SAUCENAO_API,
-      payload: { url: image.url },
-    });
-
-    const result = await fetchImageSources(image.url);
+    const result = await fetchImageSources(image.url, logger);
     const { results } = result;
 
-    logger.debug('收到 SauceNAO 响应', result);
     logger.info('已找到图片来源', { count: results.length });
 
     await context.reply({

package/src/service.ts

@@ -1,3 +1,5 @@
+import { type Logger } from '@kokkoro/core';
+
 /**
  * SauceNAO JSON API 搜索响应。
  *
@@ -23,7 +25,7 @@ export interface SauceNao {
     /** 请求失败时返回的错误信息。 */
     readonly message?: string;
     /** `numres` 请求的结果数量。 */
-    readonly results_requested: string;
+    readonly results_requested: number;
     /** 参与搜索的索引状态，以索引编号为键。 */
     readonly index: Readonly<
       Record<
@@ -115,24 +117,33 @@ export interface ImageSource {
   };
 }
 
-const { SAUCENAO_API_KEY, SAUCENAO_NUMRES = 3 } = import.meta.env;
+const { SAUCENAO_API_KEY, SAUCENAO_NUMRES = '3' } = import.meta.env;
 /** SauceNAO JSON API 的请求地址。 */
 export const SAUCENAO_API = 'https://saucenao.com/search.php';
 
 /** 使用 SauceNAO 搜索图片来源，并返回完整的接口响应。 */
-export async function fetchImageSources(image: string): Promise<SauceNao> {
+export async function fetchImageSources(url: string, logger?: Logger): Promise<SauceNao> {
   if (!SAUCENAO_API_KEY) {
     throw new Error('未配置 SAUCENAO_API_KEY 环境变量');
   }
-  const form = new FormData();
+  const endpoint = new URL(SAUCENAO_API);
+  const payload = {
+    api_key: SAUCENAO_API_KEY,
+    output_type: '2',
+    numres: SAUCENAO_NUMRES,
+    db: '999',
+    url,
+  };
+  const params = new URLSearchParams(payload);
 
-  form.set('api_key', SAUCENAO_API_KEY);
-  form.set('output_type', '2');
-  form.set('numres', String(SAUCENAO_NUMRES));
-  form.set('db', '999');
-  form.set('url', image);
+  endpoint.search = params.toString();
+  logger?.debug('发送 SauceNAO 请求', {
+    method: 'GET',
+    url: SAUCENAO_API,
+    payload,
+  });
 
-  const response = await fetch(SAUCENAO_API, { method: 'POST', body: form });
+  const response = await fetch(endpoint);
 
   if (!response.ok) {
     throw new Error(`接口请求失败，状态码 ${response.status}`);
@@ -140,6 +151,8 @@ export async function fetchImageSources(image: string): Promise<SauceNao> {
   const result = <SauceNao>await response.json();
   const { header, results } = result;
 
+  logger?.debug('收到 SauceNAO 响应', result);
+
   if (header.status !== 0) {
     throw new Error(header.message ?? `SauceNAO 搜索失败，状态码 ${header.status}`);
   }

package/src/util.ts

@@ -36,11 +36,11 @@ export async function createMarkdown(results: readonly ImageSource[]): Promise<s
       const platform = getPlatform(indexName);
       const title = getTitle(data) || platform;
       const url = getUrl(data);
-      const lines = ['### 标题', `- ${title}`, '### 平台', `- ${platform}`, '### 相似度', `- ${similarity}%`];
+      const lines = [`### ${index + 1}. ${title}`, `- 相似度：${similarity}%`, `- 平台：${platform}`];
 
       if (thumbnail) {
         if (Number(similarity) < similarityThreshold) {
-          lines.push('### 缩略图', `![缩略图 #168px #142px](${LOW_SIMILARITY_THUMBNAIL})`);
+          lines.push('', `![缩略图 #168px #142px](${LOW_SIMILARITY_THUMBNAIL})`);
         } else {
           const response = await fetch(thumbnail);
 
@@ -49,20 +49,16 @@ export async function createMarkdown(results: readonly ImageSource[]): Promise<s
           }
           const { height, width } = await new Image(await response.blob()).metadata();
 
-          lines.push('### 缩略图', `![缩略图 #${width}px #${height}px](${thumbnail})`);
+          lines.push('', `![缩略图 #${width}px #${height}px](${thumbnail})`);
         }
       }
 
       if (url) {
-        lines.push(`[查看来源](${url})`);
-      }
-
-      if (index < results.length - 1) {
-        lines.push('***');
+        lines.push('', `[查看来源](${url})`);
       }
       return lines.join('\n');
     }),
   );
 
-  return ['## SauceNAO 搜图结果', '***', ...content].join('\n\n');
+  return ['## SauceNAO 搜图结果', ...content].join('\n***\n');
 }