smart-image-scraper-mcp 2.13.1 → 2.13.3

package/README.md

@@ -1,40 +1,68 @@
-# 全网智能图片抓取 MCP 服务器
+# Smart Image Scraper MCP
 
 [![npm version](https://img.shields.io/npm/v/smart-image-scraper-mcp.svg)](https://www.npmjs.com/package/smart-image-scraper-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-基于 Node.js 和 Model Context Protocol (MCP) 开发的**高性能**智能图片抓取工具。让 AI 客户端（如 Claude Desktop、Windsurf）能够通过自然语言指令，实现全网图片资源的搜索、验证、下载与本地化管理。
+基于 Node.js 和 Model Context Protocol (MCP) 开发的**全网智能图片抓取工具**。让 AI 客户端（如 Claude Desktop、Windsurf、Cursor）能够通过自然语言指令，实现全网图片资源的搜索、验证、下载与本地化管理。
+
+> 🌐 支持 Bing / Google 双搜索引擎 | 🖼️ 三种运行模式 | 📁 自定义保存路径 | 🛡️ 防盗链智能处理
 
 ## ✨ 核心特性
 
-### 🚀 高性能架构 (v2.8.0)
-- **多请求并行**：同时处理 5 个 MCP 请求
-- **并行翻页搜索**：同时获取多页结果，速度提升 5x
-- **HTTP 连接池**：Keep-Alive 复用 TCP 连接
-- **智能缓存**：LRU 缓存减少重复请求
-- **请求队列管理**：自动资源释放，防止内存泄漏
-
-### 📷 双模式运行
-- **`link` 模式**：快速返回图片直链（默认跳过 HTTP 验证）
-- **`download` 模式**：下载到本地，自动按质量排序
-
-### 🎯 高级功能
-- **批量处理**：逗号分隔多关键词批量搜索
-- **尺寸过滤**：small/medium/large/wallpaper
-- **宽高比过滤**：wide（横屏）/tall（竖屏）/square（正方形）
-- **尺寸统一**：下载后自动裁剪/缩放到指定尺寸
-- **质量控制**：三种质量模式（fast/balanced/high）
+### � 三种运行模式
+- **`link` 模式**：搜索并返回验证过的图片直链列表，适合只需要 URL 的场景
+- **`download` 模式**：搜索并下载图片到本地，自动按质量排序优先高清
+- **`both` 模式** *(v2.13 新增)*：同时返回链接列表和下载文件，适合需要链接备份的场景
+
+### � 自定义保存路径 *(v2.13 新增)*
+- **`savePath` 参数**：指定图片保存的绝对路径
+- 不指定时默认保存到 MCP 服务器项目下的 `images/` 目录
+- 支持 `download` 和 `both` 模式
+
+### 🛡️ 防盗链智能处理 *(v2.13 新增)*
+- **`filterHotlink` 参数**：控制是否过滤防盗链图片，默认开启
+- 开启时自动过滤无法在浏览器直接打开的防盗链链接
+- 关闭时返回更多结果，下载模式会自动添加 Referer 头绕过防盗链
+
+### 🎯 高级搜索功能
+- **批量处理**：逗号分隔多关键词批量搜索（如 `"猫,狗,鸟"`）
+- **尺寸过滤**：`small` / `medium` / `large` / `wallpaper`
+- **宽高比过滤**：`wide`（横屏）/ `tall`（竖屏）/ `square`（正方形）
+- **尺寸统一**：下载后自动裁剪/缩放到指定尺寸（支持预设如 `desktop_1080p`）
+- **质量控制**：`fast`（跳过验证）/ `balanced`（验证有效性）/ `high`（验证+按质量排序）
 - **文件大小过滤**：按最小文件大小筛选高质量图片
 
+### 🚀 高性能架构
+- **智能缓存**：LRU 缓存减少重复搜索请求
+- **并发控制**：下载/验证并发数可配置，防止资源耗尽
+- **超时保护**：多层超时机制（连接/下载/全局），防止请求挂起
+- **资源自动释放**：每次请求后自动清理，支持长时间连续调用
+- **日志限流**：stderr 输出限流保护，避免高频调用时阻塞 MCP 通信
+
 ## 安装
 
-### 方式一：npm 全局安装（推荐）
+### 方式一：npx 直接使用（推荐）
+
+无需安装，在 MCP 客户端配置中直接使用：
+
+```json
+{
+  "mcpServers": {
+    "smart-image-scraper": {
+      "command": "npx",
+      "args": ["-y", "smart-image-scraper-mcp"]
+    }
+  }
+}
+```
+
+### 方式二：npm 全局安装
 
 ```bash
 npm install -g smart-image-scraper-mcp
 ```
 
-### 方式二：本地开发
+### 方式三：本地开发
 
 ```bash
 git clone https://github.com/your-repo/smart-image-scraper-mcp.git
@@ -46,7 +74,7 @@ npm install
 
 ### 1. 配置 MCP 客户端
 
-**Windsurf 配置** (`~/.codeium/windsurf/mcp_config.json`):
+**Windsurf** (`~/.codeium/windsurf/mcp_config.json`):
 
 ```json
 {
@@ -59,7 +87,7 @@ npm install
 }
 ```
 
-**Claude Desktop 配置** (`claude_desktop_config.json`):
+**Claude Desktop** (`claude_desktop_config.json`):
 
 ```json
 {
@@ -75,106 +103,114 @@ npm install
 }
 ```
 
+**Cursor** (MCP 设置中添加):
+
+```json
+{
+  "mcpServers": {
+    "smart-image-scraper": {
+      "command": "npx",
+      "args": ["-y", "smart-image-scraper-mcp"]
+    }
+  }
+}
+```
+
 ### 2. 重启客户端
 
-配置完成后重启 Windsurf 或 Claude Desktop。
+配置完成后重启你的 AI 客户端。
 
 ### 3. 开始使用
 
-直接用自然语言描述需求：
-- "帮我搜索 10 张猫咪图片"
-- "下载 20 张高清风景壁纸"
-- "找一些人物头像图片"
+直接用自然语言描述需求即可：
 
-> ⚠️ **重要限制**：同一会话中连续调用不要超过 5 次！需要多种类型图片时，使用批量查询（逗号分隔关键词）。
+- "帮我搜索 10 张猫咪图片的链接"
+- "下载 5 张高清风景壁纸到 D:/photos"
+- "搜索并下载 3 张日落图片，同时保留链接"
+- "找一些 1080p 的电脑壁纸"
 
-## Tool Schema
+> ⚠️ **提示**：同一会话中连续调用建议不超过 5 次。需要多种类型图片时，使用批量查询（逗号分隔关键词），如 `"猫,狗,鸟"`。
 
-### smart_scraper
+## 参数说明
 
-全网智能图片抓取工具。
+### smart_scraper
 
-**输入参数**：
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|:----:|--------|------|
+| `query` | string | ✅ | - | 搜索关键词，多个用英文逗号分隔 |
+| `mode` | string | ✅ | - | 运行模式：`link` / `download` / `both` |
+| `count` | number | ❌ | `10` | 每个关键词获取的图片数量（1-100） |
+| `source` | string | ❌ | `bing` | 搜索引擎：`bing` / `google` |
+| `size` | string | ❌ | `all` | 图片尺寸：`all` / `small` / `medium` / `large` / `wallpaper` |
+| `aspect` | string | ❌ | `all` | 宽高比：`all` / `wide` / `tall` / `square` |
+| `quality` | string | ❌ | `balanced` | 质量模式：`fast` / `balanced` / `high` |
+| `minFileSize` | string | ❌ | `any` | 最小文件大小：`any` / `50kb` / `100kb` / `200kb` / `500kb` / `1mb` |
+| `safeSearch` | string | ❌ | `moderate` | 安全搜索：`off` / `moderate` / `strict` |
+| `savePath` | string | ❌ | `images/` | 自定义保存路径（绝对路径），仅 `download` / `both` 模式有效 |
+| `filterHotlink` | boolean | ❌ | `true` | 是否过滤防盗链图片 |
+| `targetSize` | string | ❌ | - | 目标尺寸，如 `1920x1080` 或预设名 `desktop_1080p` |
+| `fit` | string | ❌ | `cover` | 尺寸适应模式：`cover`（裁剪填充）/ `contain`（留白）/ `fill`（拉伸） |
+
+### 预设尺寸名称
+
+| 类别 | 预设名 | 尺寸 |
+|------|--------|------|
+| 电脑壁纸 | `desktop_1080p` | 1920×1080 |
+| 电脑壁纸 | `desktop_2k` | 2560×1440 |
+| 电脑壁纸 | `desktop_4k` | 3840×2160 |
+| 手机壁纸 | `mobile_hd` | 1080×1920 |
+| 手机壁纸 | `mobile_2k` | 1440×2560 |
+| 正方形 | `square_1080` | 1080×1080 |
+| 正方形 | `square_512` | 512×512 |
+| 社交媒体 | `instagram` | 1080×1080 |
+| 社交媒体 | `twitter` | 1200×675 |
+| 社交媒体 | `facebook` | 1200×630 |
+
+## 使用示例
+
+### 基础用法
+
+```jsonc
+// 搜索图片链接
+{ "query": "可爱的猫咪", "mode": "link", "count": 5 }
+
+// 下载图片到本地
+{ "query": "风景壁纸", "mode": "download", "count": 10 }
+
+// 搜索并下载（同时返回链接和文件）
+{ "query": "日落", "mode": "both", "count": 5 }
+```
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `query` | string | ✅ | 搜索关键词，多个关键词用逗号分隔 |
-| `mode` | string | ✅ | 运行模式：`link` 或 `download` |
-| `count` | number | ❌ | 每个关键词获取的图片数量，默认 10 |
-| `source` | string | ❌ | 搜索源，支持 `bing` 和 `google`，默认 `bing` |
-| `size` | string | ❌ | 图片尺寸：`all`, `small`, `medium`, `large`, `wallpaper`，默认 `all` |
-| `aspect` | string | ❌ | 宽高比：`all`, `wide`, `tall`, `square`，默认 `all` |
-| `quality` | string | ❌ | 质量模式：`fast`, `balanced`, `high`，默认 `balanced` |
-| `minFileSize` | string | ❌ | 最小文件大小：`any`, `50kb`, `100kb`, `200kb`, `500kb`, `1mb`，默认 `any` |
-| `safeSearch` | string | ❌ | 安全搜索：`off`, `moderate`, `strict`，默认 `moderate` |
+### 自定义保存路径
 
-**使用示例**：
+```jsonc
+// 下载到指定目录
+{ "query": "猫", "mode": "download", "count": 5, "savePath": "D:/my/photos" }
 
+// both 模式 + 自定义路径
+{ "query": "风景", "mode": "both", "count": 5, "savePath": "D:/wallpapers" }
 ```
-// 链接模式 - 获取猫咪图片链接
-{
-  "query": "可爱的猫咪",
-  "mode": "link",
-  "count": 5
-}
 
-// 下载模式 - 批量下载多种动物图片
-{
-  "query": "猫,狗,鸟",
-  "mode": "download",
-  "count": 10
-}
+### 高级用法
 
-// 高级用法 - 使用 Google 搜索大尺寸壁纸
-{
-  "query": "赛博朋克城市",
-  "mode": "download",
-  "count": 20,
-  "source": "google",
-  "size": "wallpaper",
-  "safeSearch": "strict"
-}
+```jsonc
+// 批量下载多类图片
+{ "query": "猫,狗,兔子", "mode": "download", "count": 5 }
 
-// 高质量模式 - 获取验证过的高清图片
-{
-  "query": "风景",
-  "mode": "link",
-  "count": 10,
-  "size": "large",
-  "quality": "high",
-  "minFileSize": "100kb"
-}
-```
+// 高质量大图
+{ "query": "风景", "mode": "link", "count": 10, "size": "large", "quality": "high", "minFileSize": "100kb" }
 
-## 架构设计
+// 电脑壁纸（横屏 + 统一尺寸）
+{ "query": "自然风光", "mode": "download", "count": 10, "aspect": "wide", "targetSize": "desktop_1080p" }
 
-```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                         MCP Server (index.js)                            │
-│  - 版本号从 package.json 动态读取                                        │
-│  - 优雅关闭和资源清理                                                    │
-└─────────────────────────────────────────────────────────────────────────┘
-                                    ↓
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    RequestQueue (requestQueue.js)                        │
-│  - 最大并发: 5 个请求                                                    │
-│  - 请求超时: 60 秒                                                       │
-│  - 队列超时: 30 秒                                                       │
-│  - 自动资源释放                                                          │
-└─────────────────────────────────────────────────────────────────────────┘
-                                    ↓
-┌─────────────────────────────────────────────────────────────────────────┐
-│                    Orchestrator (orchestrator.js)                        │
-│  - 关键词并发: 3 个/请求                                                 │
-│  - 智能缓存集成                                                          │
-│  - 快速模式/完整验证模式                                                 │
-└─────────────────────────────────────────────────────────────────────────┘
-                                    ↓
-┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
-│   BingScraper    │  │  GoogleScraper   │  │  LinkValidator   │
-│  - 并行翻页(5页) │  │  - 并行翻页(5页) │  │  - 并发验证(30)  │
-│  - 最小延迟 50ms │  │  - 最小延迟 50ms │  │  - 超时 1.5s     │
-└──────────────────┘  └──────────────────┘  └──────────────────┘
+// 手机壁纸（竖屏）
+{ "query": "动漫", "mode": "download", "count": 10, "aspect": "tall", "targetSize": "mobile_hd" }
+
+// 关闭防盗链过滤（获取更多结果）
+{ "query": "猫咪", "mode": "link", "count": 10, "filterHotlink": false }
+
+// Google 搜索 + 安全过滤
+{ "query": "赛博朋克城市", "mode": "download", "count": 20, "source": "google", "size": "wallpaper", "safeSearch": "strict" }
 ```
 
 ## 项目结构
@@ -182,136 +218,103 @@ npm install
 ```
 smart-image-scraper-mcp/
 ├── src/
-│   ├── index.js                    # MCP 服务器入口
+│   ├── index.js                    # MCP 服务器入口 & Tool Schema 定义
 │   ├── config/
-│   │   └── index.js                # 配置模块
+│   │   └── index.js                # 配置模块（环境变量、默认值）
 │   ├── infrastructure/
-│   │   ├── httpClient.js           # HTTP 客户端（连接池）
+│   │   ├── httpClient.js           # HTTP 客户端（超时、重试）
 │   │   ├── requestQueue.js         # 请求队列管理
 │   │   ├── cache.js                # LRU 缓存
-│   │   ├── metrics.js              # 性能指标
+│   │   ├── metrics.js              # 性能指标收集
 │   │   ├── healthCheck.js          # 健康检查
 │   │   ├── gracefulShutdown.js     # 优雅关闭
 │   │   ├── rateLimiter.js          # 速率限制
-│   │   ├── logger.js               # 日志模块
-│   │   ├── retry.js                # 重试机制
-│   │   ├── errors.js               # 错误分类
+│   │   ├── logger.js               # 日志模块（限流保护）
+│   │   ├── retry.js                # 指数退避重试
+│   │   ├── errors.js               # 错误分类体系
 │   │   └── proxy.js                # 代理支持
 │   ├── providers/
-│   │   ├── baseScraper.js          # 抽象基类
-│   │   ├── bingScraper.js          # Bing 搜索（并行翻页）
-│   │   ├── googleScraper.js        # Google 搜索（并行翻页）
-│   │   └── index.js                # 提供者索引
+│   │   ├── baseScraper.js          # 搜索引擎抽象基类
+│   │   ├── bingScraper.js          # Bing 图片搜索
+│   │   ├── googleScraper.js        # Google 图片搜索
+│   │   └── index.js                # 搜索引擎工厂
 │   └── services/
-│       ├── orchestrator.js         # 任务编排器
-│       ├── linkValidator.js        # 链接验证器
-│       ├── fileManager.js          # 文件管理器
-│       ├── imageProcessor.js       # 图片处理器
+│       ├── orchestrator.js         # 任务编排器（核心调度）
+│       ├── linkValidator.js        # 链接验证 & 防盗链检测
+│       ├── fileManager.js          # 文件下载 & 存储管理
+│       ├── imageProcessor.js       # 图片裁剪/缩放处理
 │       └── index.js                # 服务索引
-├── images/                         # 图片存储目录
+├── images/                         # 默认图片存储目录
 ├── package.json
+├── LICENSE
 └── README.md
 ```
 
 ## 技术栈
 
-- **Runtime**: Node.js >= 18.x
-- **MCP SDK**: @modelcontextprotocol/sdk
-- **HTTP Client**: axios
-- **HTML Parser**: cheerio
-- **Concurrency**: p-limit
-- **File System**: fs-extra
-
-## 生产级功能
-
-### 🔄 请求队列管理
-- 最大并发 5 个请求
-- 队列最大 20 个等待
-- 请求超时 60 秒
-- 队列等待超时 30 秒
-- 自动资源释放
-
-### 📊 性能指标
-- 请求成功率统计
-- 缓存命中率统计
-- 响应时间统计（平均值、P95）
-- 错误分类统计
-
-### 💾 智能缓存
-- LRU 缓存实现
-- 搜索结果缓存（5分钟 TTL）
-- 统一缓存键策略
-- 自动过期清理
-
-### ⚡ 高性能优化
-- HTTP 连接池（Keep-Alive）
-- 并行翻页搜索（5页同时）
-- 极速验证（1.5秒超时）
-- 最小请求延迟（50ms）
-
-### 🛡️ 错误处理
-- 统一错误码体系
-- 错误分类（网络/搜索/下载/验证）
-- 自动重试机制（指数退避）
-
-### 🔒 优雅关闭
-- 信号处理（SIGINT/SIGTERM）
-- 活跃操作追踪
-- 资源清理
+| 技术 | 用途 |
+|------|------|
+| Node.js >= 18.x | 运行时 |
+| @modelcontextprotocol/sdk | MCP 协议通信 |
+| axios | HTTP 请求 |
+| cheerio | HTML 解析 |
+| p-limit | 并发控制 |
+| fs-extra | 文件系统操作 |
+| sharp *(可选)* | 图片尺寸处理 |
+| uuid | 唯一文件名生成 |
 
 ## 环境变量配置
 
 | 变量名 | 说明 | 默认值 |
 |--------|------|--------|
 | `SAVE_ROOT` | 图片下载根目录 | `./images` |
-| `LOG_LEVEL` | 日志级别 (DEBUG/INFO/WARN/ERROR) | `INFO` |
+| `LOG_LEVEL` | 日志级别 (`DEBUG` / `INFO` / `WARN` / `ERROR`) | `WARN` |
 | `LOG_FILE` | 日志文件路径 | 无 |
-| `LOG_FORMAT` | 日志格式 (json/text) | `text` |
-| `MAX_KEYWORD_CONCURRENCY` | 关键词并发数 | `2` |
-| `MAX_DOWNLOAD_CONCURRENCY` | 下载并发数 | `5` |
+| `LOG_FORMAT` | 日志格式 (`json` / `text`) | `text` |
+| `MAX_DOWNLOAD_CONCURRENCY` | 下载并发数 | `10` |
 | `MAX_VALIDATE_CONCURRENCY` | 验证并发数 | `10` |
-| `GLOBAL_TIMEOUT` | 全局超时（毫秒） | `300000` |
-| `HTTP_PROXY` / `HTTPS_PROXY` | 代理服务器 | 无 |
-
-## 运行测试
-
-```bash
-npm test
-```
+| `HTTP_PROXY` / `HTTPS_PROXY` | 代理服务器地址 | 无 |
 
 ## 版本历史
 
 | 版本 | 日期 | 主要更新 |
 |------|------|----------|
-| 2.8.0 | 2026-02 | 添加熔断机制：30秒全局超时、快速失败返回、降低搜索超时至8秒 |
-| 2.7.0 | 2026-02 | 新增质量控制：quality 参数（fast/balanced/high）、minFileSize 文件大小过滤 |
-| 2.4.0 | 2026-02 | 修复所有分析问题：超时策略统一、缓存键一致、版本号动态读取 |
-| 2.3.0 | 2026-02 | 性能优化：HTTP 连接池、并行翻页搜索、内存泄漏修复 |
-| 2.2.0 | 2026-02 | 请求队列管理系统、自动资源释放 |
-| 2.1.0 | 2026-02 | 极速模式、快速验证、更高并发 |
-| 2.0.0 | 2026-02 | 高性能并发模型、多请求并行 |
-| 1.0.0 | 2026-01 | 初始版本 |
-
-## 注意事项
-
-1. 请遵守目标网站的使用条款和 robots.txt
-2. 建议适度使用，避免频繁请求
-3. 下载的图片仅供个人学习使用
-4. 首次请求可能较慢（需要建立连接池）
+| **2.13.x** | 2026-02 | ✨ **新增 `both` 模式**（同时返回链接+下载文件）、**自定义保存路径** `savePath`、**防盗链过滤开关** `filterHotlink`；stderr 日志限流优化 |
+| 2.12.x | 2026-02 | 🛡️ 防盗链检测与过滤、连续调用稳定性修复（stderr 限流、资源释放、超时加固） |
+| 2.11.x | 2026-02 | 🔧 AbortSignal 传播修复、下载超时加固、HTTP keepAlive 关闭 |
+| 2.8.0 | 2026-02 | ⚡ 熔断机制：全局超时、快速失败返回 |
+| 2.7.0 | 2026-02 | 🎯 质量控制：`quality` 参数、`minFileSize` 文件大小过滤 |
+| 2.4.0 | 2026-02 | 🔄 超时策略统一、缓存键一致、版本号动态读取 |
+| 2.3.0 | 2026-02 | 🚀 HTTP 连接池、并行翻页搜索、内存泄漏修复 |
+| 2.0.0 | 2026-02 | 🏗️ 高性能并发模型重构 |
+| 1.0.0 | 2026-01 | 🎉 初始版本 |
 
 ## 常见问题
 
 ### Q: 搜索返回 0 张图片？
-A: 检查网络连接，或尝试更换搜索源（bing → google）
+**A:** 检查网络连接，或尝试更换搜索源（`bing` → `google`）。部分关键词在特定搜索引擎上结果较少。
 
 ### Q: 下载速度慢？
-A: 可以设置 `HTTP_PROXY` 环境变量使用代理
+**A:** 可以设置 `HTTP_PROXY` 环境变量使用代理，或使用 `quality: "fast"` 跳过验证步骤。
+
+### Q: 连续调用多次后无响应？
+**A:** 建议：
+1. 使用**批量查询**：`"猫,狗,鸟"` 一次获取多个关键词
+2. 单次会话中调用不超过 **5 次**
+3. 如遇卡住，重启 MCP 服务器即可恢复
+
+### Q: 下载的图片打不开？
+**A:** 部分网站有防盗链保护。可以尝试设置 `filterHotlink: false` 获取更多源，或使用 `quality: "balanced"` 以上模式自动验证图片有效性。
+
+### Q: 如何保存到指定目录？
+**A:** 使用 `savePath` 参数指定绝对路径，如 `"savePath": "D:/my/photos"`。仅在 `download` 和 `both` 模式下生效。
 
-### Q: Windsurf 中连续调用多次后卡住？
-A: 这是 Windsurf MCP 客户端的已知限制。建议：
-1. **使用批量查询**：`"skiing,ice skating,snowmobile"` 一次获取多个关键词
-2. **开新会话**：每3次调用后开一个新的聊天会话
-3. 等待 Windsurf 官方修复
+## 注意事项
+
+1. 请遵守目标网站的使用条款和 robots.txt
+2. 建议适度使用，避免短时间内大量请求
+3. 下载的图片版权归原作者所有，仅供个人学习研究使用
+4. 首次运行时 npx 需要下载依赖，可能需要等待几秒
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "smart-image-scraper-mcp",
-  "version": "2.13.1",
-  "description": "全网智能图片抓取 MCP 服务器 - 支持 Bing/Google 图片搜索、验证和下载",
+  "version": "2.13.3",
+  "description": "全网智能图片抓取 MCP 服务器 - 支持 Bing/Google 搜索、三种模式(link/download/both)、自定义保存路径、防盗链处理、质量控制、尺寸统一",
   "main": "src/index.js",
   "type": "module",
   "bin": {
@@ -17,10 +17,16 @@
     "mcp",
     "model-context-protocol",
     "image-scraper",
+    "image-downloader",
     "bing-images",
     "google-images",
     "ai-tools",
-    "claude"
+    "claude",
+    "windsurf",
+    "cursor",
+    "mcp-server",
+    "image-search",
+    "batch-download"
   ],
   "author": "",
   "license": "MIT",

package/src/infrastructure/logger.js

@@ -138,19 +138,17 @@ class Logger {
 
     const formatted = this._format(level, message, data);
     
-    // 输出到 stderr（带限流：每秒最多 20 条，防止高频调用时 stderr 缓冲区堆积阻塞事件循环）
-    if (level >= LogLevel.WARN) {
+    // 输出到 stderr（带限流：每秒最多 5 条 ERROR 级别，防止 stderr 缓冲区堆积阻塞事件循环）
+    if (level >= LogLevel.ERROR) {
       const now = Date.now();
       if (now - this._stderrWindowStart > 1000) {
-        // 新的1秒窗口
         this._stderrWindowStart = now;
         this._stderrWindowCount = 0;
       }
-      if (this._stderrWindowCount < 20) {
+      if (this._stderrWindowCount < 5) {
         this._stderrWindowCount++;
         process.stderr.write(formatted + '\n');
       }
-      // 超出限流的日志静默丢弃，不阻塞
     }
     
     // 输出到文件（异步写入，避免阻塞事件循环）