dsh-tool-web-enhanced
In a curated listMaintenance: Activeyurzi/dsh-tool-web-enhanced
Switchable web_search and web_fetch backends for DeepSeek Harness, chosen per session: native DeepSeek, Exa, Firecrawl, Tavily, Tinyfish, model search, and local fetch with a private-network allowlist
$ dsh plugin add dsh-tool-web-enhancedInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work9
stars
0
forks
TypeScript
Language
MIT
License
2026-10-21
Created
2026-11-20
Last push
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 里的密钥和会话的选择不受影响。
配置文法、各字段的限制与例子见功能设计 · 配置文档。
内置连接
More in Web & Browser
anysearch-dsh
by anysearch-team
AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)
dsh-find-plugin
by awesome-dsh-plugin
In-agent plugin discovery: live GitHub repository search scoped to the official `dsh-plugin` topic, star-ranked; every result comes with a ready-to-run `dsh plugin add` command.
fnos-dsh
by fnosp
Multi-source web search and fetch failover for DeepSeek Harness sessions: takes over the session searchProvider and fetchProvider seams and tries configured sources in a chosen order — TinyFish, Tavily and the official search as a fallback that always participates and can be repositioned but not removed. Multiple API keys per platform are spread round-robin, usage snapshots drive pre-flight exclusion of exhausted accounts, and per-request timeouts plus same-platform retry control failover granularity. Web fetching runs local HTTP first, then falls back to TinyFish Fetch server-side rendering and Tavily Extract, so pages still load when local egress is blocked by proxy or DNS policies. A per-platform panel shows key usage and plan limits. Install from npm with `dsh plugin --profile web add @tnnevol/dsh-failover-search`.
modsearch
by liustack
Web/X 搜索与抓取桥:为纯文本 coding agent 提供结构化 JSON 证据(search/fetch/citations),引擎可选 Antigravity CLI(免 key)/带 key 引擎/X(Grok Build 登录态)。
