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，無需手工編輯配置文件。

配置項寫在 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`	輸出檢索詞與來源數量的調試日誌

密鑰不寫入插件或設置文件，按以下優先級解析：

缺少憑據屬確定性配置錯誤，不會靜默回退官方提供方。

Node.js >= 20
DSH >= 0.1.7-rc.2（該版本起內置 @deepseek-ai/schemastery >= 3.18.3，設置項的即時生效依賴其 .volatile()）