103 lines
3.2 KiB
Markdown
103 lines
3.2 KiB
Markdown
|
---
|
|||
|
|
title: 添加网络搜索引擎
|
|||
|
|
tags: [集成扩展, 搜索, 网络搜索, Provider]
|
|||
|
|
aliases: [网络搜索, WebSearch, 搜索引擎扩展]
|
|||
|
|
source: 添加新的网络搜索引擎.md
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 添加新的网络搜索引擎
|
|||
|
|
|
|||
|
|
本文档说明如何在 WeKnora 中添加一个新的网络搜索引擎类型（如 Brave Search、Searx 等）。
|
|||
|
|
|
|||
|
|
## 架构概述
|
|||
|
|
|
|||
|
|
搜索引擎的 API 端点**硬编码**在代码中，不向用户暴露 BaseURL，从源头消除 SSRF 风险。
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
internal/types/web_search_provider.go # 实体定义 + Provider 类型元数据
|
|||
|
|
internal/infrastructure/web_search/ # Provider 实现（bing/google/duckduckgo/tavily）
|
|||
|
|
internal/container/container.go # DI 注册
|
|||
|
|
internal/types/interfaces/web_search.go # WebSearchProvider 接口
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> 类似的扩展开发模式参见 [集成向量数据库](../集成扩展/集成向量数据库.md)
|
|||
|
|
|
|||
|
|
## 步骤
|
|||
|
|
|
|||
|
|
以添加 **Brave Search** 为例：
|
|||
|
|
|
|||
|
|
### 1. 注册类型常量
|
|||
|
|
|
|||
|
|
在 `internal/types/web_search_provider.go` 中添加：
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
WebSearchProviderTypeBrave WebSearchProviderType = "brave"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 添加类型元数据
|
|||
|
|
|
|||
|
|
在 `GetWebSearchProviderTypes()` 中添加：
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
{
|
|||
|
|
ID: "brave", Name: "Brave Search", Free: false,
|
|||
|
|
RequiresAPIKey: true, Description: "Brave Search API",
|
|||
|
|
DocsURL: "https://brave.com/search/api/",
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 创建 Provider 实现
|
|||
|
|
|
|||
|
|
新建 `internal/infrastructure/web_search/brave.go`：
|
|||
|
|
|
|||
|
|
- 构造函数签名：`func(types.WebSearchProviderParameters) (interfaces.WebSearchProvider, error)`
|
|||
|
|
- API 端点**硬编码**为常量
|
|||
|
|
- 实现 `interfaces.WebSearchProvider` 接口：`Name()` 和 `Search()`
|
|||
|
|
|
|||
|
|
### 4. 添加参数校验
|
|||
|
|
|
|||
|
|
在 `isValidProviderType()` 中添加新类型。
|
|||
|
|
|
|||
|
|
### 5. DI 注册
|
|||
|
|
|
|||
|
|
在 `registerWebSearchProviders` 中注册。
|
|||
|
|
|
|||
|
|
### 6. 验证
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
go build ./...
|
|||
|
|
# 调用 API 验证
|
|||
|
|
curl http://localhost:8080/api/v1/web-search-providers/types
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 需要额外参数的情况
|
|||
|
|
|
|||
|
|
如果新引擎需要 API Key 以外的参数：
|
|||
|
|
|
|||
|
|
- **方式一**：使用 `WebSearchProviderParameters.ExtraConfig` 字段
|
|||
|
|
- **方式二**：在 `WebSearchProviderParameters` 中添加专用字段
|
|||
|
|
|
|||
|
|
## 文件变更清单
|
|||
|
|
|
|||
|
|
| 文件 | 操作 |
|
|||
|
|
|------|------|
|
|||
|
|
| `internal/types/web_search_provider.go` | 添加常量 + 类型元数据 |
|
|||
|
|
| `internal/infrastructure/web_search/brave.go` | **新建** Provider 实现 |
|
|||
|
|
| `internal/application/service/web_search_provider.go` | `isValidProviderType` 加新类型 |
|
|||
|
|
| `internal/container/container.go` | `registerWebSearchProviders` 注册 |
|
|||
|
|
|
|||
|
|
## 相关主题
|
|||
|
|
|
|||
|
|
- [集成向量数据库](../集成扩展/集成向量数据库.md) — 同类扩展开发模式（接口实现 + 注册 + DI）
|
|||
|
|
- [MCP功能使用说明](../核心功能/MCP功能使用说明.md) — MCP 也可集成搜索工具
|
|||
|
|
- [常见问题](../运维排障/常见问题.md) — SSRF 白名单配置
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 反向链接
|
|||
|
|
|
|||
|
|
- [Home](../Home.md) — Wiki 首页导航
|
|||
|
|
- [集成向量数据库](../集成扩展/集成向量数据库.md) — 同类扩展开发模式
|
|||
|
|
- [MCP功能使用说明](../核心功能/MCP功能使用说明.md) — MCP 搜索工具与网络搜索引擎互补
|
|||
|
|
- [版本路线图](../项目概述/版本路线图.md) — 路线图中的社区组件扩展方向
|