返回目錄

dsh-tool-web-enhanced

精選清單收錄維護狀態: 活躍

yurzi/dsh-tool-web-enhanced

按會話切換 web_search 和 web_fetch 後端,支援 DeepSeek、Exa、Firecrawl、Tavily、TinyFish、模型搜尋和帶私網白名單的本地抓取。

前往 GitHub專案首頁
$ dsh plugin add dsh-tool-web-enhanced

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README 中的設定行加入你的 profile / patch 設定,然後重啟即可。

查看安裝教學

9

星數

0

Fork

TypeScript

語言

MIT

授權條款

2026-10-21

建立於

2026-11-20

最近推送

README

Q 版 DeepSeek 鲸鱼娘一手拿放大镜、一手取来网页卡片,左侧标题 Web Enhanced

DSH Tool Web Enhanced

为 DeepSeek Harness 的 web_search 与 web_fetch 提供可切换的后端,每个会话分别选择搜索与抓取连接。

npm CI License: MIT DSH Node.js

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”);需要处理的一侧(缺密钥、设置无效、所选连接被移除等)带一个警示点。

输入框的连接菜单:搜索面板列出关闭、DeepSeek Messages、DeepSeek Search API、会话模型、Exa、Firecrawl、Tavily、Tinyfish 等连接及其访问方式,底部是搜索与抓取的切换标签

菜单底部的标签在搜索与抓取之间切换。每个面板顶部写当前连接及其来源(本会话、来自父会话、该模型上次的选择、默认连接)和“设置”按钮;下面是“关闭”、已启用的连接(说明行写访问方式与接收方,如“无需密钥 · 查询会发送给 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 页打开本组合包(“增强网页工具”),其下的“增强网页搜索”“增强网页获取”两行各有一个设置页;菜单与概览上的“设置”也打开这里。

增强网页获取的设置页:默认连接、是否在输入框菜单显示、各连接的启用开关与访问方式;展开的 Firecrawl 写明 URL 会发送给 Firecrawl 及其缓存说明

  • 增强工具:一个开关,打开即同意 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 里的密钥和会话的选择不受影响。

配置文法、各字段的限制与例子见功能设计 · 配置文档。

内置连接

在 GitHub 閱讀完整 README →

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。