dsh-search-tools：DeepSeek Harness 的可插拔搜索与抓取后端

它是做什么的？

Search Tools 是 DeepSeek Harness（DSH）的网页搜索与正文抓取插件，把搜索和抓取后端从 DSH 核心中解耦出来。它解决默认后端不合用的问题：已有自建 SearXNG、需要走代理、或希望抓取结果是干净正文而非整页 HTML 的用户，都能在 Web 设置页自行选择后端并测试连接。插件向 DSH 注册稳定的 provider id，切换后端不会改变 DSH 的搜索配置，还额外提供一次调用完成「搜索 + 抓取前 N 条正文」的研究工具。

核心功能

• 稳定 provider：搜索与抓取各注册一个永不随后端变化的 provider id，换后端无需重启或重新注册。
• SearXNG 搜索 adapter：支持多实例、顺序/轮询、故障转移、JSON/HTML、GET/POST、Bearer/Basic 认证、代理、缓存、分页与域名过滤。
• Readability 抓取 adapter：复用 DSH 安全 HTTP，用 Readability 提取正文，提取失败可回退原文。
• web_research 研究工具：一次调用完成搜索、按并发抓取前 N 页、按页/总预算截断，并返回来源与正文。
• Web 设置页：概览、搜索、抓取、研究、诊断五个页签，含实例卡、内联测试、正文 reader、预算条、字段级错误与缓存清理。
• 凭据隔离与接管：搜索 token 写入 DSH credentials，不落 YAML、不进日志；可选让内置搜索/抓取走本插件，关闭时恢复原 provider。

怎么使用这个插件？

在 DSH Web GUI 的插件页启用后，打开「设置 → 搜索工具」，设置页出现即说明 Host 与浏览器两半都已加载。在搜索页签填入 SearXNG 实例地址并做内联连接测试，在抓取页签确认 Readability 抓取参数，需要时在概览页开启接管，让内置 web_search / web_fetch 使用本插件。模型侧可直接调用 web_research 获取页面正文；诊断页签可查看版本、配置路径、运行状态与缓存统计。注意内网地址会被 DSH 的 SSRF 防护拒绝，且插件不执行页面 JavaScript。

报错怎么排查？

搜索测试不通时，先在设置页检查实例地址与认证方式，确认 SearXNG 实例可访问，再逐项核对字段级错误提示。若内置搜索指向不存在的 provider，通常是接管仍开启时卸载了插件，按官方说明重装或手动恢复原搜索 provider 即可。抓取失败时确认目标为公网 http(s) 页面，内网地址会被 SSRF 防护拒绝；正文提取失败可回退原文。