--- title: "DSH 内置网页搜索与抓取配置指南" seo_title: "DeepSeek Harness 网页搜索配置：DSH Search 与 Fetch API 教程" description: "按 DeepSeek Harness 0.2.1-rc.2 固定来源说明 DSH 内置 Search 与 Fetch API 的开关、账号与 API Key、接口地址、结果数量、验证和关闭方法，区分 Messages 搜索与第三方插件。" canonical: https://52dsh.com/tutorials/dsh-web-search-fetch-guide/ authors: ["52DSH 编辑部"] audience: ["需要内置网页检索的用户","需要区分聊天与搜索认证的用户"] outcomes: ["选择正确搜索协议并保存配置","区分搜索结果与网页抓取","根据错误阶段排查和停止"] prerequisites: ["已主动选择 0.2.1-rc.2 并准备隔离测试环境","已确认 Profile、模型路由和适用的账号或 API Key"] difficulty: intermediate estimated_action_time: null next_steps: {"success":["/tutorials/deepseek-harness-model-provider/","/tutorials/dsh-headless-guide/"],"failure":["/errors/dsh-missing-credential-401/","/tutorials/dsh-update-uninstall/"]} published_at: 2026-10-19 updated_at: 2026-10-19 verified_on: 2026-10-19 maintenance_status: community verification_level: source_reviewed risk_level: medium dsh_version: 0.2.1-rc.2 plugin_id: null tutorial_kind: null related_plugin_url: null --- # DSH 内置网页搜索与抓取配置指南 按 DeepSeek Harness 0.2.1-rc.2 固定来源说明 DSH 内置 Search 与 Fetch API 的开关、账号与 API Key、接口地址、结果数量、验证和关闭方法，区分 Messages 搜索与第三方插件。 DeepSeek Harness（DSH）0.2.1-rc.2 可在**插件 → 官方 → 网页搜索**中打开**启用新版 Web 搜索 API**并保存，同时选择 DeepSeek Search 与 Fetch API。随附配置默认关闭这个开关，继续使用 Messages 搜索和本地 HTTP 抓取；只改表单而未保存不会生效。 本文锁定 `0.2.1-rc.2`（提交 `687f282e8625c6b8d11ff58211a90524be2e4317`），2026-10-19 核对官方文档与相关实现，未登录账号、执行 DSH 或调用真实搜索。本站默认安装仍是 `0.2.0-rc.2`，试用前先看[版本选择与备份](/tutorials/dsh-update-uninstall/#021-rc2试用前检查凭据与搜索)，不要把下列开关与字段套到旧版或第三方插件上。 ## 先选择搜索与抓取路径 | 路径 | 搜索与抓取方式 | 怎样选择 | |---|---|---| | 内置 Messages 搜索 | `deepseek-official` 搜索经辅助 Messages 请求获取来源；默认抓取为本地 HTTP | 保留原配置时使用，端点与聊天配置独立 | | 内置 Search/Fetch API | `deepseek-search-api` 返回结构化来源，`deepseek-fetch-api` 返回网页 Markdown | 在 rc.2 主动开启并保存；两项一起切换 | | 第三方插件 | 按各插件与引擎的协议、账号和设置运行 | 多引擎需求可看 [Web Search Pro](/tutorials/anweat-dsh-web-search-pro-install-config/)、[AnySearch](/tutorials/anysearch-team-anysearch-dsh-install-config/)、[ModSearch](/tutorials/liustack-modsearch-install-config/)；它们保留各自版本边界 | 上述两种内置搜索都可经 `web_search` 调用，不能仅凭工具名判断底层服务。第三方插件还可能提供独立工具，按对应教程确认。先记下 DSH 精确版本、Profile、当前选择的提供方与脱敏域名，再修改配置。 ## 配置前先确认认证与数据范围 使用 `deepseek-account` 路由的会话，在账号集成授权所解析端点时，可由账号服务提供令牌；其他调用使用 API Key。登录聊天账号不代表任意网关都能收到账号授权，也不等于所有搜索调用都不需要 Key。 API Key 通常通过 `DEEPSEEK_API_KEY` 引用解析。rc.2 挂载本地存储时，已保存值优先于启动环境，再回退项目与 Home 的 .env；具体检查和旧版区别见[模型与凭据配置](/tutorials/deepseek-harness-model-provider/#021-rc2先分清已保存密钥与启动环境)。不要将 Key 写进提示词、截图、版本库或 YAML 字面配置。 搜索会向所选提供方发送查询；新版 API 默认还可能发送触发搜索的最近用户问题片段，空白折叠后最长 128 个字符。抓取会发送目标 URL；URL 中的查询参数也可能含秘密。只用无敏感公开资料验证，私有页面、客户内容或带登录令牌的地址不要直接交给外部服务。 ## 打开开关并保存 1. 进入**插件 → 官方 → 网页搜索**，确认当前运行的是 rc.2 的 Web 界面。只有 Host 同时提供 `web` 与 `web-deepseek-api` 设置命名空间时，才显示新版开关；入口缺失先核对版本、Profile 和加载能力。 2. 打开**启用新版 Web 搜索 API**。界面会从 Messages 的次数限制切换为 Search API 的结果条数，显示当前协议的基础地址。 3. 需要 API Key 时在该页填写，密钥通过凭据服务保存。已保存密钥不会回显，每次加载输入框都为空；留空保存保留已有密钥。输入框是否可写以当前提供的凭据能力为准，不能通过留空来删除旧 Key。 4. 核对地址、条数并点击**保存**。设置页先保存提供方配置，再保存选择；任何部分失败都不能当成切换完成，先处理诊断并重新检查当前配置。 5. 下次操作才使用保存后的选择。离开未保存页面会丢弃草稿；无效字段或保存失败时开关可能暂时不可切换，先修正仍可见的错误。 依据：[固定搜索设置页](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/client/ui-settings-web-search/README.zh.md)。保存成功只能证明配置已提交，不能代替真实请求验证。 ## 地址和结果数量怎样填写 | 配置 | rc.2 默认值或范围 | 注意事项 | |---|---|---| | Search/Fetch 的 `baseURL` | `https://api.deepseek.com/v1/tools` | 含完整部署前缀，不含 `/search` 或 `/fetch` 操作名 | | Messages 的 `baseURL` | `https://api.deepseek.com/anthropic/v1` | 程序追加 `/messages`；不等同于新 API 地址 | | Search 的 `count` | 1–50 的整数，默认 10 | 每次搜索结果数；工具请求中更小的 `maxResults` 优先，不是搜索次数 | | Messages 的 `maxUses` | 默认 5 | 单次辅助 Messages 请求允许的搜索次数，不是 Search 的结果条数 | | API Key 引用 `apiKeyEnv` | `DEEPSEEK_API_KEY` | 由当前认证链按引用解析；不要把变量名误填为 Key 值 | 默认新版请求会去往 `https://api.deepseek.com/v1/tools/search` 和 `https://api.deepseek.com/v1/tools/fetch`。自建服务只有明确支持该协议时才填写其完整前缀，不要让程序重复拼接操作名，也不要因聊天可用就把聊天 Base URL 复制过来。 高级部署字段 `sendOriginalQuestion` 默认 true；不希望附带用户问题片段时，维护者可按[提供方配置说明](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/web/web-deepseek-api/README.zh.md)设置为 false。该字段不属于本页三个常规表单字段，不虚构一个界面开关。调整提供方设置时保留其他有效配置，先做匹配备份。 ## 用两个最小任务检查 以下为读者可执行的验证任务和文档支持的预期观察项，本站未执行，不能作为运行实测结果。 ### 搜索公开资料 发送“搜索 Python 官方文档中 pathlib 的说明，列出来源 URL，并区分来源内容与推断”。确认实际调用了搜索工具，返回来源 URL、标题以及可用的摘要或日期，再人工打开官方来源核对。没有日期或摘要不一定失败；返回空来源数组也可能是成功的空结果。仅得到一段模型回答不足以证明搜索已发生。 ### 抓取公开网页 发送“抓取 https://example.com/ 的网页正文，摘录一段可核对的正文，不访问其他页面”。确认使用 Fetch 提供方，返回与目标可对应的 Markdown，再人工核对内容。rc.2 提供方只把 API 的正文映射为工具结果，不单独透出 API 的标题字段，不能把模型补写的标题当作抓取成功证据。该 API 不报告目标最终重定向 URL；返回的请求 URL 不能证明目标从未重定向，失败状态也不等于目标网页原始状态。 每次记录版本、Profile、提供方、脱敏请求域名、时间、结果类型或错误码。不要在验证记录里保存请求头、完整 Key 或私人页面正文。 ## 失败时先按阶段判断 | 现象 | 检查方向 | |---|---| | `WEB_PROVIDER_CREDENTIAL_MISSING` | 账号条件或 API Key 引用未解析，先查认证链 | | `WEB_PROVIDER_ERROR`，HTTP 401 | 按实际账号或 Key 路由处理；账号请求依提示重新登录，其余检查 Key 与目标服务 | | 地址、协议、响应格式或传输错误 | 检查当前协议与完整前缀；错误不一定来自凭据 | | `WEB_ABORTED` | 调用已取消，先确认停止原因 | | 空搜索结果 | 先换明确的公开查询，不把空结果当成认证失败 | | HTTP 429 或超时 | 看账号和目标服务限制及网络；不连续自动重试，也不通过更换 Key 假定限制解除 | 新版提供方不会自动重试或回退到别的提供方。完整排查入口见[MISSING_CREDENTIAL、模型与搜索 401](/errors/dsh-missing-credential-401/#021-rc2升级后先检查凭据来源与搜索协议)；Web 可用而 Headless 不可用时，见[Headless 认证差异](/tutorials/dsh-headless-guide/#021-rc2headless-凭据与显式恢复)。 ## 服务条件与停止方法 Search/Fetch 是外部服务。计费、调用限制与开放条件以[DeepSeek 官方指南](https://api-docs.deepseek.com/zh-cn/guides/search)为准，并按请求日期核对；本页不承诺免费、无限额度或持续可用。结果条数设置不应被当作价格开关。 不继续使用新版时，关闭开关并保存，再检查有效选择。开关选择 Messages 搜索与本地 HTTP 抓取：目标与部署组合值一致时清除对应覆盖，沿用该默认值；若部署默认本身就是新 API，则写入这两项旧选择。不要把关闭开关理解为恢复任意自定义提供方。两种协议分别保留地址设置；关闭开关不会同时删除 API Key，也不保证当前已运行的调用已取消。 停止本次任务后，只撤销确属测试新增且未被其他模型或工具共用的凭据引用；共享 Key 先核对依赖，外部服务端的密钥撤销与本地清理分开处理。不删除整个 DSH Home 或全部凭据文件。 ## 固定来源与下一步 配置行为依据[搜索设置说明](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/client/ui-settings-web-search/README.zh.md)、[Search/Fetch 提供方](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/web/web-deepseek-api/README.zh.md)与[Messages 提供方](https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/web/web-search-deepseek/README.zh.md)，都锁定本文完整提交。版本选择回到[更新与回退](/tutorials/dsh-update-uninstall/)，准备 Provider 和认证回到[模型配置](/tutorials/deepseek-harness-model-provider/)，失败时按[错误阶段排查](/errors/dsh-missing-credential-401/)。 ## 原始来源 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.2 - https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/client/ui-settings-web-search/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/web/web-deepseek-api/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/web/web-search-deepseek/README.zh.md - https://github.com/deepseek-ai/deepseek-harness/blob/687f282e8625c6b8d11ff58211a90524be2e4317/packages/credentials/credentials-local/README.zh.md - https://api-docs.deepseek.com/zh-cn/guides/search