# @haatlabs-core/provider-image-search 中文文档

规范地址：https://npmcn.com/package/%40haatlabs-core/provider-image-search/

版本：0\.18\.5
npm 元数据更新时间：2026-11-13T18:17:09.793Z
中文译文更新时间：2026-11-17T18:11:45.721Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40haatlabs-core/provider-image-search
原文对照：https://npmcn.com/package/%40haatlabs-core/provider-image-search/?lang=original
项目主页：https://haatlabs.shop/docs/packages/provider-image-search/
源码仓库：https://github.com/Haatlabs/haatlabs-platform

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：150 kB，70 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：3 个
- 首次发布：2026-10-22T23:23:40.425Z
- 最新版本发布：2026-11-13T18:17:09.546Z
- 近 30 天下载量：4657（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

通过 SearXNG 、 Brave 或 SerpApi 在一个SearchProvider 后面进行图像和网络搜索 .

## 安装

```sh
npm install @haatlabs-core/provider-image-search
```

也可以使用：`pnpm add @haatlabs-core/provider-image-search`、`yarn add @haatlabs-core/provider-image-search`、`bun add @haatlabs-core/provider-image-search`

## README

# @haatlabs-core/ 提供者- 图像搜索

**`@haatlabs-core/provider-image-search/contracts`** (0.12.1) (中文(简体) ) `IMAGE_SEARCH_ERRORS`, (中文(简体) ), `SearchErrorCode`, (中文(简体) ), `createSearchError` 编辑 `SearchError` 类型,没有节点 : 一个项目的合同,它的页面装入, 从这里导入, 永远不根, 这是为节点.

## 安装

```
pnpm add @haatlabs-core/provider-image-search
```

## 它会做什么

通过SearXNG(直接或通过服务网关),勇于或 SerpApi,并通过 SearXNG 搜索网页,后面一个 `SearchProvider` 接口. `createImageSearchProvider(config, deps)` 财务报告和审定财务报表 `createWebSearchProvider` 将提供者包入 限速门、断路器和重试(`protect`@haatlabs-core/professors),并带有 `deps.cache` 在一个 `cachedCall` 门外的地层,所以一个命中 花费没有符号.

## 选项

`config`数字 : `provider` (单位:千美元)`'searxng' | 'brave' | 'serpapi'`, (中文(简体) ), `timeoutMs`,而供应商的 `searxngBaseUrl` 财务报告和审定财务报表 `gatewayKey`, (中文(简体) ), `braveApiKey` 或者说 `serpApiKey` (名称没有钥匙,它 施工失败). `deps`数字 : `fetch`, (中文(简体) ), `limiter` 财务报告和审定财务报表 `rateLimit` (大门), `sleep`, (中文(简体) ), `now`,以及 `cache` (单位:千美元)`{ store, ttlMs, onEvent }`页:1 `null` 存储每次计算。 每个 搜索选中 `SearchOptions`数字 : `limit`, (中文(简体) ), `safeSearch` (0-2), (单位:千美元), `language`, (中文(简体) ), `signal`, (中文(简体) ), `call`。 。 。 .

## 错误

`SEARCH_PROVIDER_ERROR` (503) 有一条信息说失败了:429,5xx,没有答案,一个时间 一个不是JSON的身体是短暂的 `retryAfterMs` 从复试后, 秒 或日期,最多5分钟); 401或403是永久的,指定要检查的内容; 任何其他 地位是永久的。 SerpApi的"Google没有返回任何结果"是没有结果的;任何其他 SerpApi错误是一个瞬态"SerpApi无法运行搜索",它的文本没有传递. A 类 电话员的流产被重新推为他们的。 查询或限制差是核心 `VALIDATION_FAILED`。 。 。 . 项目分布 `IMAGE_SEARCH_ERRORS` 输入 `defineErrors`。 。 。 .

## 门户和最后期限

`call` (级别、优先权、, `deadlineMs`进入网关 `gatewayKey`中,第4级 没有背景。 每个供应商的时间限制是 `timeoutMs`,或 `call.deadlineMs` 在那更早的时候`localTimeoutMs`)),而网关被赋予了这个限度,永远不再存在. 期限是每次尝试的:重试再次开始;通过 `signal` 对于硬性限制 整个搜索。 通过网关,拒绝就意味着 `UpstreamStatusError` 联合国 原因 : `isGatewayRefusal(error)` 对401和403的网关来说是真实的 只有它自己的 `bad_request` 400是一个合同错误.

与 `deps.cache`,查找已运行的相同搜索等待答案 (cachedCall的单飞),再次寻找最高 `waitMs` (10 s) 在搜索之前 自己来 等待不会结束在呼叫者身上 `signal`: 一旦中止搜索答案 结束了,所以 `waitMs` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}就那么迟了 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我还没说.

## 固定设备

`@haatlabs-core/provider-image-search/fixtures`数字 : `searchFixtures.searxngImages` 记录于 (一) 安全XNG; `braveImages` 财务报告和审定财务报表 `serpApiImages` 以 Brave 和 SerpApi 的形状写 文档,没有记录,直到所有者用试用钥匙记录它们.

## 测试

`pnpm --filter @haatlabs-core/provider-image-search test` (单位,固定装置上)和 `test:int` (集装箱中真正的SearXNG;需要多克克). 现场测试,有老板的 `BRAVE_API_KEY` 财务报告和审定财务报表 `SERPAPI_API_KEY`运行 `pnpm exec vitest run --config vitest.real.config.ts` 并且没有钥匙就跳过.

## 托管服务

没有自己的搜索引擎, `provider: 'haatlabs'` 与 `haatlabsApiKey` (你的电话) RapidAPI密钥)通过RapidAPI上的Haatlabs API搜索. 拒绝是 `SEARCH_PROVIDER_ERROR`,与 API 一样短暂,与 API 错误 (单位:千美元)`SERVICE_QUOTA_EXCEEDED`, (中文(简体) ), `SERVICE_KEY_REFUSED`作为它的事业。 见 `@haatlabs-core/services` 财务报告和审定财务报表 [https://haatlabs.shop/docs/服务/](https://haatlabs.shop/docs/services/)

## 常见问题

### @haatlabs-core/provider-image-search 是什么？

通过 SearXNG 、 Brave 或 SerpApi 在一个SearchProvider 后面进行图像和网络搜索 \.

### 如何安装 @haatlabs-core/provider-image-search？

在项目目录运行 npm install @haatlabs-core/provider-image-search，或使用 pnpm add / yarn add / bun add。

### @haatlabs-core/provider-image-search 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @haatlabs-core/provider-image-search 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @haatlabs-core/provider-image-search 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @haatlabs-core/provider-image-search 可以商用吗？

@haatlabs-core/provider-image-search 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @haatlabs-core/provider-image-search 的下载量有多少？

根据 npm 官方下载统计，@haatlabs-core/provider-image-search 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,657 次，日均约 155 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @haatlabs-core/provider-image-search 还在维护吗？

最新版本 0\.18\.5 发布于 2026/11/14（4 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/10/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

