dsh-web-search-session：使用会话模型与自建检索后端路由 DSH 联网搜索

DSH 自带的联网搜索按官方 token 额度计费。即便已经自配网关，这部分调用仍会走官方通道，费用在不知不觉中累积。该插件通过让联网搜索跟随当前会话所选模型（该次调用同样计入 dsh-cost-meter 账本并归入本会话），并配合自建检索后端取回真实网页来源，来解决这一问题。

安装¶

使用官方命令安装：

dsh plugin add dsh-web-search-session

安装后重启 DSH。插件通过 bundle patch 把 web 行的 searchProvider 切换为 session。

如果需要从源码安装，在具备 plugin_manager 工具的会话中，对插件目录执行 install_bundle，target 填目录绝对路径。安装会写入当前 profile 并应用 patch，无需手工编辑配置文件。

功能特性¶

• 会话路由：改写检索词时使用当前会话的 provider/model，而非固定模型。
• 自建检索：支持 SearXNG（免密钥，推荐）、Tavily、Brave，端点与密钥均可配置。
• 可控回退：无路由或检索失败时，按 noRoute 选择回退官方提供方、用原始问题检索或直接报错。
• 凭据隔离：密钥仅通过凭据服务或环境变量引用，不写入插件与设置文件。
• 可视化配置：在「插件」页直接配置地址、密钥与调用次数。

配置说明¶

配置项写在 profile 的 cordis.patch.yml 中；标有「界面」的项也可在插件页直接修改。

后端与密钥¶

凭据解析优先级¶

密钥不写入插件或设置文件，按以下优先级解析：

1. 凭据服务，引用名取 apiKeyEnv，留空时取该后端的默认名；
2. 同名环境变量。

缺少凭据属确定性配置错误，不会静默回退官方提供方。

工作原理¶

1. 读取当前会话的 provider/model 路由。
2. 由该模型把用户问题改写为若干检索词，受 sessionPlanning 与 maxQueries 约束。
3. 并发调用所选后端，按 URL 去重后返回不超过 maxResults 条来源。
4. 任一步骤失败时按 noRoute 处理。

兼容性要求¶

• Node.js >= 20
• DSH >= 0.1.7-rc.2（该版本起内置 @deepseek-ai/schemastery >= 3.18.3，设置项的即时生效依赖其 .volatile()）

快速开始示例¶

1. 准备一个 SearXNG 实例，确认 http://<host>:8888/search?q=test&format=json 返回 JSON。
2. 打开「插件 → 已安装 → dsh-web-search-session」，把平台地址指向该实例。
3. 正常发起一次联网搜索。