DSH 内置网页搜索与抓取配置指南

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，试用前先看版本选择与备份，不要把下列开关与字段套到旧版或第三方插件上。

先选择搜索与抓取路径

上述两种内置搜索都可经 web_search 调用，不能仅凭工具名判断底层服务。第三方插件还可能提供独立工具，按对应教程确认。先记下 DSH 精确版本、Profile、当前选择的提供方与脱敏域名，再修改配置。

配置前先确认认证与数据范围

使用 deepseek-account 路由的会话，在账号集成授权所解析端点时，可由账号服务提供令牌；其他调用使用 API Key。登录聊天账号不代表任意网关都能收到账号授权，也不等于所有搜索调用都不需要 Key。

API Key 通常通过 DEEPSEEK_API_KEY 引用解析。rc.2 挂载本地存储时，已保存值优先于启动环境，再回退项目与 Home 的 .env；具体检查和旧版区别见模型与凭据配置。不要将 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://api.deepseek.com/v1/tools/search 和 https://api.deepseek.com/v1/tools/fetch。自建服务只有明确支持该协议时才填写其完整前缀，不要让程序重复拼接操作名，也不要因聊天可用就把聊天 Base URL 复制过来。

高级部署字段 sendOriginalQuestion 默认 true；不希望附带用户问题片段时，维护者可按提供方配置说明 ↗（外部链接，在新标签页打开）设置为 false。该字段不属于本页三个常规表单字段，不虚构一个界面开关。调整提供方设置时保留其他有效配置，先做匹配备份。

用两个最小任务检查

以下为读者可执行的验证任务和文档支持的预期观察项，本站未执行，不能作为运行实测结果。

搜索公开资料

发送“搜索 Python 官方文档中 pathlib 的说明，列出来源 URL，并区分来源内容与推断”。确认实际调用了搜索工具，返回来源 URL、标题以及可用的摘要或日期，再人工打开官方来源核对。没有日期或摘要不一定失败；返回空来源数组也可能是成功的空结果。仅得到一段模型回答不足以证明搜索已发生。

抓取公开网页

发送“抓取 https://example.com/ ↗（外部链接，在新标签页打开） 的网页正文，摘录一段可核对的正文，不访问其他页面”。确认使用 Fetch 提供方，返回与目标可对应的 Markdown，再人工核对内容。rc.2 提供方只把 API 的正文映射为工具结果，不单独透出 API 的标题字段，不能把模型补写的标题当作抓取成功证据。该 API 不报告目标最终重定向 URL；返回的请求 URL 不能证明目标从未重定向，失败状态也不等于目标网页原始状态。

每次记录版本、Profile、提供方、脱敏请求域名、时间、结果类型或错误码。不要在验证记录里保存请求头、完整 Key 或私人页面正文。

失败时先按阶段判断

新版提供方不会自动重试或回退到别的提供方。完整排查入口见MISSING_CREDENTIAL、模型与搜索 401；Web 可用而 Headless 不可用时，见Headless 认证差异。

服务条件与停止方法

Search/Fetch 是外部服务。计费、调用限制与开放条件以DeepSeek 官方指南 ↗（外部链接，在新标签页打开）为准，并按请求日期核对；本页不承诺免费、无限额度或持续可用。结果条数设置不应被当作价格开关。

不继续使用新版时，关闭开关并保存，再检查有效选择。开关选择 Messages 搜索与本地 HTTP 抓取：目标与部署组合值一致时清除对应覆盖，沿用该默认值；若部署默认本身就是新 API，则写入这两项旧选择。不要把关闭开关理解为恢复任意自定义提供方。两种协议分别保留地址设置；关闭开关不会同时删除 API Key，也不保证当前已运行的调用已取消。

停止本次任务后，只撤销确属测试新增且未被其他模型或工具共用的凭据引用；共享 Key 先核对依赖，外部服务端的密钥撤销与本地清理分开处理。不删除整个 DSH Home 或全部凭据文件。

固定来源与下一步

配置行为依据搜索设置说明 ↗（外部链接，在新标签页打开）、Search/Fetch 提供方 ↗（外部链接，在新标签页打开）与Messages 提供方 ↗（外部链接，在新标签页打开），都锁定本文完整提交。版本选择回到更新与回退，准备 Provider 和认证回到模型配置，失败时按错误阶段排查。