Web 搜索与网络检索服务配置
在软件工程开发中，大语言模型的知识库截止到训练时间。在遇到最新发布的开源库（如 React 19、Next.js 15 等 API 变更）或时效性 Bug 时，智能体通过 Web 搜索（联网检索） 可以主动查阅最新官方文档与 GitHub Issue，从而写出绝对准确的代码。
Piwin 提供了极为开放和自由的网络检索配置，你可以根据自身对搜索质量、响应速度与稳定性的要求自由搭配。
1. 为什么需要灵活配置 Web 搜索？
- 模型内置搜索 vs 独立检索工具：部分云端模型自带联网能力，但返回内容不可控或被模型厂商截断；
- AI 定制化清洗：专为 Agent 设计的搜索引擎（如 Tavily）返回的数据去除了广告、导航栏与无效 HTML 标签，信息密度更高，Token 占用更少；
- 免费与高质量并存：你可以选择每月提供免费额度的商业服务商，或者配置由逆向技术得到的专用高效 Key。
2. 搜索提供商推荐与配置方法
打开客户端 「设置」➔「网络检索 (Web Search)」：
选项 A：Devin 官方 OAuth (最推荐，一键自动打通) 完全免费 极速高质量
不需要自己去抓包找 Token！在客户端「设置 ➔ OAuth 登录」点击 Devin 完成浏览器授权，系统即可自动获取并配置好搜索能力：
- 核心亮点：一键授权后，不仅可以直接享受高质量 Web 搜索，还可以直接驱动 Code Search 语义代码检索，双料功能即刻点亮；
- 极简配置：进入客户端「设置 ➔ OAuth 登录」点击 Devin 登录即可；如果习惯手动填入 Token 也同样支持，详见：Devin 授权与 Token 指引；
- 开源 MCP 项目：底层兼容开源生态 mimimaster/windsurf-search-mcp。
选项 B：Tavily Search API 每月 1000 次免费 专为 AI 设计
Tavily 是目前最受主流智能体欢迎的搜索引擎，返回的结果经过专业的数据清洗与精简。
- 免费额度：注册即享每月 1000 次 免费请求，个人日常编码完全够用；
- 获取步骤：
- 访问 Tavily 官网 (tavily.com) 注册账号；
- 登录控制台后复制
API Key（格式形如tvly-*********）； - 在 Piwin 搜索设置中选择 Tavily 并填入 Key 保存。
选项 C：Brave Search API 开发者免费额度
Brave 提供了完全独立的全球网页索引库，注重隐私且搜索质量出众。
- 免费额度：提供 Free Tier 每月免费查询额度；
- 获取步骤：访问 Brave Search API Portal (brave.com/search/api/) 注册开发者账号并获取 API Token。
选项 D：SearXNG 本地自建 完全本地化
如果你希望彻底避免数据外流，可以在本地或 NAS 上自建开源元搜索引擎 SearXNG，并在 Piwin 中填入你自建服务的 Base URL。
选项 E：smart-search 智能路由
这属于究极方案了，详细看L站佬友的文章，支持使用Jev自动路由选择合适的web_search，这属于高端玩法了，对搜索质量要求很高的同志可以选择这个，多种渠道的web_search自动路由，这是佬友的文章：https://linux.do/t/topic/2920995
选项 F：模型内置搜索（OpenAI / Anthropic / Gemini / xAI）
「模型内置搜索」不会把厂商搜索塞进主对话请求。主模型调用 web_search 工具时，Host 按一条链顺序尝试：厂商原生搜索 → 已启用搜索源 → DuckDuckGo 兜底，成功即停。真实引用留在工具卡与会话记录。
- 开启方式：在「模型」里给模型勾选「模型内置搜索」。拉取或添加模型时，支持内置搜索的模型会默认勾选并推断请求方式：官方 OpenAI / Anthropic / Gemini / xAI 按地址识别，CLIProxyAPI 这类自建网关按模型名识别（
gemini-*、grok-*、claude-*、gpt-*）；已有模型不会被改动；也可手动选 OpenAI Responses / OpenAI Chat 搜索模型 / xAI Responses / Anthropic / Gemini。请求方式与通道的日常 Chat API 无关：Completions 通道上的 GPT-4o 仍可走 Responsesweb_search。 - 费用：每次原生搜索多一次模型调用。可在「网络检索」里指定一个更便宜的已标记模型作为搜索代理，避免主模型双倍计费。
- 顺序：「内置优先」先原生再搜索源再 DuckDuckGo；「外部优先」先搜索源再原生再 DuckDuckGo；「仅内置」不走搜索源也不兜底。不会换模型重放整段对话。
- Gemini：工具卡中会原样展示 Google Search Suggestions（Google 接地条款要求），点击直接在系统浏览器打开 Google 结果页。仅支持 API Key，不支持 Vertex / OAuth。
- 经网关接入的 Gemini（如 CLIProxyAPI）：OpenAI 协议表达不了 Gemini 的
googleSearch，网关也会丢掉接地来源。在该模型的编辑面板把「请求协议」改为 Google Gemini 即可：同一个服务商、同一个 Key，该模型改发<网关>/v1beta/...（/v1会自动换掉），对话和内置搜索都走 Gemini 原生格式，其他模型不受影响。详见 ADR 0079。 - 订阅套餐：Grok 订阅（OAuth）走
api.x.ai，同步模型目录时新出现的 Grok 聊天模型会自动打标。其他订阅（ChatGPT Codex、Claude Code 等）没有 Host 可直接调用的搜索入口，即使手动打标也不会被当作内置搜索，直接走搜索源 / DuckDuckGo。 - 拿不到结果时：原生搜索既没有来源也没有简报（如 Codex / WebSocket 通道拿不到响应体）时，视为这一步失败，继续走下一步，不会把空结果交给模型，也不会编造链接。
- 失败信息：整条链都失败时，工具卡会列出每一步的原因（例如
native:xai/grok-4.7: …; duckduckgo: …202），不再只显示最后一步。 - OpenRouter 等透传网关不会自动打标，不算原生搜索执行器。