标识	引擎	密钥	说明
`anysearch`	AnySearch	不需要	默认引擎，安装后即可匿名使用
`bing`	Bing HTML 搜索	不需要	公共网页接口，可能受到限流或页面变更影响
`duckduckgo`	DuckDuckGo HTML 搜索	不需要	公共网页接口，可能受到限流或页面变更影响
`tavily`	Tavily Search API	`TAVILY_API_KEY`	支持完整搜索参数
`exa`	Exa Search API	`EXA_API_KEY`	支持完整搜索参数

默认兜底顺序为：当前选中的引擎，然后是其余引擎。没有配置密钥的 Tavily/Exa 会自动跳过。

安装

发布到 npm 后，在 DSH 的目标 profile 中安装：

dsh plugin --profile web add dshsearch-multi

也可以从 Git 仓库、本地目录或压缩包安装：

dsh plugin --profile web add github:<user>/dshsearch-multi
dsh plugin --profile web add https://github.com/<user>/dshsearch-multi.git
dsh plugin --profile web add C:\path\to\dshsearch-multi
dsh plugin --profile web add dshsearch-multi-1.0.2.tgz

安装后，插件会将 DSH 的：

web.searchProvider 设置为 dshsearch-multi
web.fetchProvider 设置为 dshsearch-multi-fetch

设置入口兼容 DSH 新旧 Host：新版本使用 dshsearch-multi namespace，并按 keyed slot 契约注册卡片；旧版本若只暴露 web-search-multi，插件会自动使用兼容 namespace。升级后建议打开“设置 → 插件 → 插件配置”确认“网页搜索”卡片可见，并刷新页面验证配置仍然存在。

快速试用：

dsh plugin --profile test add <上面的任意来源>
dsh --profile test --port 4000

然后打开 http://127.0.0.1:4000，进入“设置 → 插件”。

配置

在 DSH Web 中配置

打开“设置 → 插件 → 插件配置”，找到 网页搜索 卡片即可配置：

优先搜索引擎
最大结果数
Tavily/Exa 的 API Key 和接口地址
查询意图模式
Tavily 和 Exa 的高级检索参数

API Key 会通过 DSH 凭据服务保存，不会回传到浏览器。

使用 settings.yaml

配置文件位于：%USERPROFILE%\.dsh\settings.yaml。配置节点为插件自己的 dshsearch-multi：

dshsearch-multi:
  provider: anysearch        # anysearch | bing | duckduckgo | tavily | exa
  intentMode: auto           # auto | manual
  maxResults: 5
  anysearchBaseURL: https://api.anysearch.com/mcp
  tavilyBaseURL: https://api.tavily.com
  exaBaseURL: https://api.exa.ai

  tavilySearchDepth: basic   # basic | advanced
  tavilyTopic: general       # general | news | finance
  tavilyDays: 0
  tavilyIncludeAnswer: false
  tavilyIncludeImages: false
  tavilyIncludeRawContent: false
  tavilyIncludeDomains: []
  tavilyExcludeDomains: []

  exaType: auto              # auto | neural | keyword
  exaCategory: ""
  exaStartPublishedDate: ""
  exaEndPublishedDate: ""
  exaIncludeDomains: []
  exaExcludeDomains: []
  exaUseAutoprompt: false
  exaMaxTextCharacters: 1000 # 0 表示不提取正文

配置 API Key

推荐在 DSH Web 设置卡片中填写，也可以写入 %USERPROFILE%\.dsh\.credentials.yaml：

TAVILY_API_KEY: tlv-...
EXA_API_KEY: ...

不要将密钥提交到 Git 仓库。AnySearch 没有配置入口，也不需要配置密钥。

查询意图模式

intentMode 默认为 auto。插件使用正则和关键词进行确定性分类，不依赖 LLM：

finance：股票代码、股价、财报、估值等财经查询。
news：新闻、最新消息、发布、报道等查询。
academic：论文、期刊、研究、预印本等学术查询。
code：GitHub、仓库、源码、npm 等代码查询。
weather：天气、气温、降水、台风等气象查询。
video：视频、电影、影视、直播等视频查询。
shopping：购物、优惠、折扣、价格等购物查询。
sports：比分、比赛、足球、篮球等体育查询。
travel：旅游、酒店、机票、攻略等旅行查询。
long-natural-language：较长的问题或对比型问题，会提高 Tavily 检索深度。
general：其他查询，完全使用当前配置。

自动模式会在配置值上应用上述分类提示。例如财经查询会将 Tavily 主题设为 finance，代码/天气/视频/购物/体育/旅行查询会将 Exa 类别分别设为 github/weather forecast/video/product/sports/travel。

如果需要严格使用手动配置，可设置：

dshsearch-multi:
  intentMode: manual

AnySearch 的能力目录会在当前 DSH 进程中按地址和领域缓存，每个领域只发现一次。

网页抓取

web.fetch(url) 使用以下顺序获取网页正文，第一个成功的来源优先：

AnySearch extract，无需配置密钥。
Tavily /extract，需要 TAVILY_API_KEY。
Exa /contents，需要 EXA_API_KEY。
直接请求网页并将 HTML 转换为文本。

直接抓取会跟随重定向、移除脚本和样式，并保留链接地址；正文最多返回 50,000 个字符。PDF、图片、音视频和压缩包等二进制内容会返回 WEB_UNSUPPORTED_CONTENT_TYPE。

命令行工具

插件附带 dshsearch-multi 命令，用于管理独立的本地配置文件：

dshsearch-multi config show
dshsearch-multi config set provider anysearch
dshsearch-multi config set maxResults 5
dshsearch-multi config set tavily.apiKey YOUR_TAVILY_API_KEY
dshsearch-multi config set exa.baseURL https://api.exa.ai
dshsearch-multi config path
dshsearch-multi config reset

配置文件默认位于 %USERPROFILE%\.dsh\dshsearch-multi.json，文件权限会尽量限制为仅所有者可读写。config show 不会打印密钥内容。

注意：CLI 配置文件是独立的便捷配置。正在运行的 dsh web 读取的是 DSH 的 dshsearch-multi 设置节点，而不是这个 JSON 文件。插件会同时注册 dshsearch-multi 和旧版兼容的 web-search-multi namespace，并优先使用前者；如果当前 Host 只暴露旧 namespace，浏览器端设置卡片会自动回退到旧 namespace。若两个 namespace 都未暴露，设置卡片仍无法通过远程设置 API 读写，此时需要升级 DSH Host 或由宿主提供第三方 settings 暴露能力。

安装后排障

如果“设置 → 插件 → 插件配置”中没有“网页搜索”卡片：

确认插件安装在当前正在运行的 profile，而不是其他 profile。
重启 DSH Web 或刷新页面，让客户端重新加载插件 bundle。
新版 Host 应暴露 dshsearch-multi；旧版 Host 只暴露 web-search-multi 时，插件会自动使用兼容 namespace。
如果两个 namespace 都不可见，请升级 DSH Host。插件自身不能修改 Host 的 settings 暴露策略。

如果搜索可用但设置卡片不可见，可先在 %USERPROFILE%\\.dsh\\settings.yaml 中配置 dshsearch-multi，或使用测试 profile 验证安装：

dsh plugin --profile test add dshsearch-multi
dsh --profile test --port 4000

开发与发布

项目使用 Node.js ESM。安装依赖后执行：

pnpm install
pnpm run check
pnpm run pack:check
node test/test-intent-engine.mjs
node test/test-fetch-provider.mjs

test-intent-engine.mjs 默认只运行离线测试；需要真实 AnySearch 域目录探测时，显式设置 $env:DSH_LIVE_TESTS = "1"。Tavily 和 Exa 的真实 API 测试仅在对应凭据已配置时运行。

其中：

check 检查 JSON、YAML、服务端入口、CLI 和浏览器端入口的基本语法。
pack:check 使用 npm 的发布文件白名单生成压缩包，并检查包内容。

修改后建议先在测试 profile 中安装本地目录或 .tgz，确认 DSH Web 设置卡片和搜索/抓取链路正常，再发布到 npm。发布前建议执行 npm pack --dry-run，确认压缩包只包含发布白名单中的运行文件。普通第三方插件能注册自己的 settings namespace，但当前 DSH Host 是否向浏览器暴露该 namespace 由 Host 的显式策略决定；插件不能通过自身代码把 namespace 加入 Host 白名单。

限制

Bing 和 DuckDuckGo 使用公共 HTML 页面，不是稳定的官方 API，可能被限流、触发验证或改变页面结构。
AnySearch 的 extract 和直接抓取均有正文长度上限，且不支持 PDF 等二进制内容。
Tavily 和 Exa 的实时接口验证需要对应 API Key；未配置时相关测试会跳过。
DSH 当前版本的设置页对白名单外的第三方 namespace 不提供远程读写；若要在设置页显示本插件，需要 Host 版本提供第三方设置暴露机制，或由宿主显式加入 dshsearch-multi。