dsh-tool-web-enhanced
精选清单收录维护状态: 活跃yurzi/dsh-tool-web-enhanced
按会话切换 web_search 和 web_fetch 后端,支持 DeepSeek、Exa、Firecrawl、Tavily、TinyFish、模型搜索和带私网白名单的本地抓取。
$ dsh plugin add dsh-tool-web-enhanced9
星标
0
Fork
TypeScript
语言
MIT
许可证
2026-10-21
创建于
2026-11-20
最近推送
README
dsh-tool-web-enhanced 是 DeepSeek Harness (DSH) 的一个组合包(bundle)。安装后,模型看到的仍是 DSH 原生的 web_search 与 web_fetch 两个工具,工具名和参数都不变;变的是它们背后由谁执行:搜索可以走 DSH 原生的 DeepSeek 搜索、Exa、Tavily、OpenAlex 等服务或带服务端搜索的模型,抓取可以走本机 HTTP(S)、DeepSeek Fetch API 或远程读取服务。
它解决什么问题
DSH 的 web 行为 web_search 与 web_fetch 各指定一个 provider,整个安装共用。这个组合包把两个 provider 换成本项目的插件,并在插件内部提供多个后端:
- 每个会话分别选择:在输入框的连接菜单或
/setup-search、/setup-fetch里,为当前会话选一个搜索连接、一个抓取连接,或把其中一项关闭。关闭后,从下一个模型请求步起该会话的 Agent 看不到对应的工具(只在web行确认把该能力路由到本插件时隐藏)。 - 运维决定能选什么:哪些连接启用、默认连接、密钥的凭据名称、自定义连接与自建端点,都在插件页的行设置里配置;会话只能在已启用的连接之间选择。
- 远程服务由运维打开:查询或 URL 会发给第三方的远程服务缺省停用,在设置页打开后会话才能选它。Exa、Firecrawl、Tavily、Tinyfish、OpenAlex 的搜索,以及 Exa、Firecrawl、Tavily 的抓取,打开后缺省用服务的匿名路由,不需要密钥;需要时可改用个人密钥。AnySearch(搜索与抓取)只支持个人密钥。
- 可选的增强工具:运维在行设置里打开“增强工具”后,Agent 还能用
web_search_enhanced/web_fetch_enhanced为单次调用指定连接,并用list_web_search_providers/list_web_fetch_providers查看可选项,不改会话的选择(见增强工具)。 - 本机地址过滤可选启用:缺省不配置规则,跟随 DSH rc.1 的任意地址策略;配置任一网段或主机名规则后,插件才检查初始目标,公网放行、非公网按规则放行。
没有自动重试,也没有失败后自动换后端:一次调用失败就以 WEB_* 错误码和简短的英文说明返回给模型;打开增强工具时,由 Agent 自己选另一个连接再试。
安装
要求:DSH >=0.2.2-rc.5 <0.3.0-0,Node.js >=24.9.0。
只需要安装 profile 包,它会带上另外三个包:
dsh plugin --profile <profile> add dsh-tool-web-enhanced-profile
<profile> 是要安装到的 DSH profile,例如 Web 界面(dsh web)的 web,或 dsh-TUI 的 dsh-tui;行设置写在各 profile 里,两边各配一份。连接菜单、首次启用提示与设置页只在 Web 界面里;/setup-search / /setup-fetch 是 Host 命令,Web 界面与 dsh-TUI 都能用,dsh-TUI 里还有参数补全(那里的行设置在 TUI 的 /settings 里只读)。
安装后 profile 会:
- 把
web行的两个字段写为searchProvider: search-enhanced、fetchProvider: fetch-enhanced; - 停用原生的
web-search-deepseek行(它的 DeepSeek 搜索成为本项目的DeepSeek Messages连接); - 插入三行:
web-search-enhanced、web-fetch-enhanced、tool-web-enhanced-ui。
更晚的层(你自己的设置或其他 bundle)如果改写了 web 行,会压过 profile 的选择;插件页上本组合包的概览会显示每个能力实际由谁提供。不要和 AnySearch 官方的 @anysearch/anysearch-dsh 一起装:它的 profile 层会把 web 行的两个字段都写成 anysearch,路由就离开了本插件。
如果装过 dsh-web-search-enhanced 或 dsh-web-fetch-enhanced 0.1.x,请先看从 0.1.x 升级。
上手
为会话选择连接
输入框右侧有一个地球按钮,搜索与抓取共用。按钮文字是两侧的当前连接(如“DeepSeek Messages · 本机 HTTP”);需要处理的一侧(缺密钥、设置无效、所选连接被移除等)带一个警示点。
菜单底部的标签在搜索与抓取之间切换。每个面板顶部写当前连接及其来源(本会话、来自父会话、该模型上次的选择、默认连接)和“设置”按钮;下面是“关闭”、已启用的连接(说明行写访问方式与接收方,如“无需密钥 · 查询会发送给 Exa”,未就绪的写原因),搜索面板另有内容实时性选项。某个能力的远程服务一个都没打开时,面板底部提示“更多服务可在设置中打开”,点击进入设置页。
键盘入口:/setup-search 与 /setup-fetch,与菜单读写同一份选择,说明与输出是英文。
- 在 Web 界面里不带参数回车(或在斜杠菜单里选中),弹出选择框:“关闭”、所有就绪的连接,搜索另有(所选连接支持时)三档实时性。
- 带参数直接切换,从下一个模型请求步生效:
/setup-search off、/setup-search builtin:exa、/setup-search freshness realtime、/setup-fetch builtin:local。连接 id 区分大小写;Web 里的输出显示在命令卡上。 - 在 dsh-TUI 里,参数可以用 Tab 补全(
off、本行启用的连接 id 与freshness);不带参数时输出当前选择及来源、路由状态与启用的连接(dsh-TUI 0.16.1 把它压成一行、约 200 字符的通知,只看得到开头;完整的连接与状态在 Web 的选择框或连接菜单里)。
详见功能设计 · /setup-search 与 /setup-fetch。
几条规则:
- 会话还没选过时,只有
subagent_fork继承父选择;普通用户 fork 与 spawn 独立按该模型上次的选择、行设置的默认连接决定。在会话里选连接时会为下一次请求的模型记下这次选择(模型记忆),设置页可以逐条清除。 - 子 Agent 的会话(spawn 与 subagent_fork)也能在菜单里改选择,无论它是否在运行:运行中的从下一个模型请求步生效,不在运行的从它下一次运行时生效。这类会话里的选择不写模型记忆。
- 选择在每个模型请求步开始时冻结;连接是否仍启用、端点、凭据名称与参数在每次调用时按当前设置读取。
- 缺省连接:搜索为
DeepSeek Messages(等同 DSH 原生 DeepSeek 搜索),抓取为本机 HTTP(等同 DSH 原生http抓取)。
行设置
在 Plugins 页打开本组合包(“增强网页工具”),其下的“增强网页搜索”“增强网页获取”两行各有一个设置页;菜单与概览上的“设置”也打开这里。
- 增强工具:一个开关,打开即同意 Agent 在已启用的服务里自行选用、把查询或 URL 发给所选的服务;只影响之后新建的会话(见增强工具)。
- 连接:每个内置连接一行,可启用或停用;远程服务缺省停用(行上标“未启用”),打开即同意把查询或 URL 发给它;同时支持免密钥与个人密钥的服务可以切换访问方式;展开后写明查询或 URL 会发送给谁,抓取的远程服务另有缓存与数据保留说明;其余参数修改后自动保存。
- 密钥放进 DSH Credentials:设置里只保存凭据名称(
credentialRef,如EXA_API_KEY),密钥本身存在 DSH Credentials 里(可以用页面上的只写输入框保存),每次调用时读取,不缓存。原生 DeepSeek 连接沿用 DSH 自己的凭据规则:本次请求走 DeepSeek 账号路由时用账号,否则用DEEPSEEK_API_KEY。 - 自定义连接:选一个内置 adapter(搜索 7 个、抓取 5 个),配自己的名称、凭据名称、可选的自建端点与参数,总是使用个人密钥。搜索另可新建固定模型的模型搜索连接(Anthropic Messages、OpenAI Responses 或 OpenAI Chat Completions),填写模型 id、端点与凭据名称。
- 端点信任:自建端点、固定模型连接,以及与官方地址不同的原生
baseURL,都要打开“信任此地址”才会保存(写入trustedEndpoint: true)。信任绑定到确认时的地址,地址改了要重新确认;关闭信任即回到官方端点。 - 本机抓取的白名单:
本机 HTTP有专门的编辑器,填写允许的网段(allowCidrs)和可选的主机名(allowHostnames),逐行检查语法并提示过宽、回环、云元数据等范围,按“保存访问规则”才写入。User-Agent 与各项上限也在这里改。 - 恢复默认设置:确认后清除本行的全部设置与自定义连接;DSH Credentials 里的密钥和会话的选择不受影响。
配置文法、各字段的限制与例子见功能设计 · 配置文档。
内置连接
更多「网页与浏览器」插件
anysearch-dsh
作者 anysearch-team
为 DeepSeek Harness 提供的 AnySearch 网页搜索提供方与高级搜索工具。
dsh-find-plugin
作者 awesome-dsh-plugin
Find DSH plugins inside the agent — live GitHub dsh-plugin topic search, star-ranked / 会话内搜索发现 DSH 插件
fnos-dsh
作者 fnosp
DeepSeek Harness应用与harness插件 monorepo
modsearch
作者 liustack
🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件,免费免注册免 API key。为不能联网的模型补上搜索,问网页或 X,拿回结构化 JSON 证据(搜索、抓取、引用)。
