dsh-web-search-enhanced

🌟 核心价值：直接使用模型供应商自身提供的联网搜索

传统智能体方案通常需要额外购买和配置第三方搜索引擎 API（如 Tavily、Bing Search API、Google CSE 等），不仅流程繁琐，还带来了额外的账单与调用延迟。

dsh-web-search-enhanced 让你可以直接调用模型供应商（如 DeepSeek、Anthropic Claude、OpenAI 等）自身原生集成的服务端联网搜索功能：

• 🚫 告别额外依赖：无需申请或维护独立的搜索引擎 API Key，直接复用你现有的大模型 API 凭据。
• 💰 极致降低成本：依托各大模型供应商原生提供的高性价比或免费搜索能力，大幅节约外部检索成本。
• 🎯 深度原生优化：充分利用厂商针对大模型特别调优的网页抓取、实时索引、正文解析与引用标注体系，检索质量更高、响应更迅速。
• 🔄 保持原生体验：模型端保持原生 web_search 工具签名与交互体验不变，无缝支持 Anthropic Messages、OpenAI Responses API 及 OpenAI Chat Completions 三大主流上游协议，并提供 Web 可视化配置面板。

---

🚀 快速上手与配置

方式一：Web 界面可视化配置（推荐）

1. 打开 DeepSeek Harness Web 界面（默认 http://127.0.0.1:3080）。
2. 点击左侧/顶部导航栏的 设置 (Settings) → 插件 (Plugins)。
3. 找到 Web Search Enhanced (插件配置) 卡片。
4. 根据需要选择模型路由、API 协议、接口地址 (Base URL) 与 模型标识 (Model ID)。
5. 在 API Key 输入框中输入对应的模型供应商 API 密钥（输入后仅用于安全保存，保存成功后输入框自动清空，不留明文痕迹）。
6. 点击 保存 (Save) 即可实时生效，无需重启！

---

方式二：环境变量与配置文件配置

如果你使用 Headless 模式或希望通过环境配置初始化：

1. 设置 API Key 环境变量（默认变量名为 WEB_SEARCH_ENHANCED_API）：

   export WEB_SEARCH_ENHANCED_API="sk-your-api-key-here"
   

2. 在 cordis.yml 中声明配置（可选）：

   - id: web-search-enhanced
     name: dsh-web-search-enhanced
     config:
       modelMode: configured
       protocol: anthropic-messages
       baseURL: https://api.deepseek.com/anthropic/v1
       model: deepseek-v4-flash
       apiKeyEnv: WEB_SEARCH_ENHANCED_API
       maxTokens: 4096
   

---

方式一：Web 界面可视化配置（推荐）

1. 打开 DeepSeek Harness Web 界面（默认 http://127.0.0.1:3080）。
2. 点击左侧/顶部导航栏的 设置 (Settings) → 插件 (Plugins)。
3. 找到 Web Search Enhanced (插件配置) 卡片。
4. 根据需要选择模型路由、API 协议、接口地址 (Base URL) 与 模型标识 (Model ID)。
5. 在 API Key 输入框中输入对应的模型供应商 API 密钥（输入后仅用于安全保存，保存成功后输入框自动清空，不留明文痕迹）。
6. 点击 保存 (Save) 即可实时生效，无需重启！

---

方式二：环境变量与配置文件配置

如果你使用 Headless 模式或希望通过环境配置初始化：

1. 设置 API Key 环境变量（默认变量名为 WEB_SEARCH_ENHANCED_API）：

   export WEB_SEARCH_ENHANCED_API="sk-your-api-key-here"
   

2. 在 cordis.yml 中声明配置（可选）：

   - id: web-search-enhanced
     name: dsh-web-search-enhanced
     config:
       modelMode: configured
       protocol: anthropic-messages
       baseURL: https://api.deepseek.com/anthropic/v1
       model: deepseek-v4-flash
       apiKeyEnv: WEB_SEARCH_ENHANCED_API
       maxTokens: 4096
   

---

💡 常用场景配置示例

你可以直接参考以下常见场景的配置参数，轻松接入各厂商自身提供的原生搜索功能：

1. DeepSeek 官方搜索（默认推荐）

使用 DeepSeek 官方兼容 Anthropic 协议的服务端搜索，速度快且成本极低：

• 模型路由 (modelMode): 固定配置 (configured)
• API 协议 (protocol): Anthropic Messages v1
• 接口地址 (baseURL): https://api.deepseek.com/anthropic/v1
• 模型标识 (model): deepseek-v4-flash
• API Key: 填入你的 DeepSeek API Key

---

2. Anthropic 官方 Claude 联网搜索

直接调用 Claude 官方 Messages API 原生内置的 web_search 服务端搜索能力：

• 模型路由 (modelMode): 固定配置 (configured)
• API 协议 (protocol): Anthropic Messages v1
• 接口地址 (baseURL): https://api.anthropic.com/v1
• 模型标识 (model): claude-3-7-sonnet-20250219 或 claude-3-5-sonnet-20241022
• 内部搜索标识符 (toolIdentifier): 留空（默认使用 web_search_20250305）
• API Key: 填入你的 Anthropic API Key

---

3. OpenAI Responses API

使用 OpenAI 官方 Responses API 内置的原生联网搜索工具：

• 模型路由 (modelMode): 固定配置 (configured)
• API 协议 (protocol): OpenAI Responses API
• 接口地址 (baseURL): https://api.openai.com/v1
• 模型标识 (model): gpt-4o
• 搜索上下文大小 (searchContextSize): 中 (medium)（可选 low / medium / high）
• API Key: 填入你的 OpenAI API Key

---

4. OpenAI Chat Completions 专用搜索模型 / 兼容中转网关

使用 OpenAI 官方搜索模型（如 gpt-4o-search）或各类第三方兼容网关（如 OneAPI、NewAPI、OpenRouter 等）提供的原生搜索支持：

• 模型路由 (modelMode): 固定配置 (configured)
• API 协议 (protocol): OpenAI Chat Completions API
• 接口地址 (baseURL): https://api.openai.com/v1（或中转网关地址，如 https://api.your-proxy.com/v1）
• 模型标识 (model): 目标搜索模型标识（如 gpt-4o-search）
• Chat 搜索能力 (chatSearchMode): 官方专用搜索模型 (search-model)（若网关使用自定义字段可切换为 vendor-options）
• API Key: 填入网关或官方 API Key

---

5. 跟随当前会话模型（自动继承厂商搜索）

让搜索自动使用当前 Agent 会话正在对话的模型供应商与协议：

• 模型路由 (modelMode): 当前会话模型 (current-session)
• 兜底搜索模型 (fallbackModel): deepseek-v4-flash（当当前模型不支持搜索协议或未解析到凭据时自动平滑回退）
• API 协议 / 接口地址 / API Key: 自动跟随当前会话的 LLM 路由配置

---

⚙️ 详细配置参数表

参数名	对应 Web 界面	默认值	可选值 / 格式	说明
modelMode	模型路由	configured	configured (固定配置)
current-session (跟随当前会话)	决定搜索使用固定的独立模型，还是跟随当前会话的模型与协议。
protocol	API 协议	anthropic-messages	anthropic-messages
openai-responses
openai-chat-completions	固定路由或兜底路由使用的上游 HTTP 协议。
baseURL	接口基础地址	https://api.deepseek.com/anthropic/v1	绝对 HTTP(S) URL	上游接口的基础 URL。若末尾未包含协议端点后缀，插件会自动补全。
model	模型标识	deepseek-v4-flash	字符串	固定路由使用的模型 ID，或无会话模型时的默认模型。
fallbackModel	兜底搜索模型	留空（默认同 model）	字符串	仅跟随模式：当无法解析当前会话路由时所采用的兜底模型。
apiKeyEnv	API Key 环境变量	WEB_SEARCH_ENHANCED_API	环境变量名	读取 API Key 的凭据引用名称。
apiKey	API Key	无	字符串（密钥）	Web 设置界面提供的一次性保存输入框，安全存入 DSH 凭据中心后自动清空。
toolIdentifier	内部搜索标识符	依协议自动推导	字符串	上游搜索工具/选项字段名。留空时自动适配官方默认名称。
maxTokens	最大输出 Token	4096	正整数	单次搜索请求的最大输出 Token 数。
maxUses	最大搜索次数	5	正整数	仅 Anthropic 协议：单次请求允许服务端调用的最大搜索次数。
apiVersion	Anthropic API 版本	2023-06-01	字符串	仅 Anthropic 协议：写入 anthropic-version 请求头的版本标识。
chatSearchMode	Chat 搜索能力	search-model	search-model
vendor-options	仅 Chat 协议：官方专用搜索模型模式，或第三方网关自定义选项字段模式。
searchContextSize	搜索上下文大小	上游默认	low / medium / high	仅 OpenAI 协议：搜索上下文预算大小。

---