会话联网搜索 YDT-china/dsh-web-search-session

dsh-web-search-session

DSH 自带的联网搜索按官方 token 额度计费。即便已经自配网关，这部分调用仍会走官方通道，费用在不知不觉中累积——本插件正是为解决这一点而做。

它让联网搜索跟随当前会话所选模型：先由会话模型把问题改写为检索词（该次调用同样计入 dsh-cost-meter 账本并归入本会话），再通过自建检索后端取回真实网页来源。

特性

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

安装

dsh plugin add dsh-web-search-session

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

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

快速开始

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

配置

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

| 字段 | 类型 | 默认 | 说明 |
| backend | string | none | 检索后端：none / searxng / tavily / brave |
| endpoint | string | '' | 后端基址；留空时使用该后端默认端点 |
| apiKeyEnv | string | '' | 密钥引用名；留空时使用该后端默认名 |
| sessionPlanning | boolean | true | 是否用会话模型改写检索词 |
| noRoute | string | official | 无路由或检索失败时：official / raw / error |
| providerId | string | session | 本插件注册的提供方 id，须与 web.searchProvider 一致 |
| officialProviderId | string | deepseek-official | 回退时委派的官方提供方 id |
| maxQueries | number | 3 | 单次请求最多调用后端几次，范围 1–20 |
| maxResults | number | 8 | 返回来源条数上限，最大 20 |
| planMaxTokens | number | 512 | 检索词改写的输出 token 上限 |
| planTimeoutMs | number | 20000 | 检索词改写超时（毫秒） |
| searchTimeoutMs | number | 20000 | 单次后端检索超时（毫秒） |
| debug | boolean | false | 输出检索词与来源数量的调试日志 |

随包提供的 cordis.patch.yml 已预设 backend: searxng、endpoint: http://127.0.0.1:8888。
上表「默认」列是插件 schema 的缺省值；未加载该 patch 时以缺省值为准。

后端

| 后端 | 默认端点 | 密钥变量 |
| searxng | http://127.0.0.1:8888 | 不需要 |
| tavily | https://api.tavily.com | TAVILY_API_KEY |
| brave | https://api.search.brave.com | BRAVE_API_KEY |

凭据

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

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()）

文档

- 开发与内部机制
- 故障排查

许可

MIT