dsh-web-search-clinepass

为什么必须改配置而不只是装插件

ctx.web 的供应商选择是「显式 id 优先」：@deepseek-ai/dsh-base 把 web 那一行写死为 searchProvider: deepseek-official，所以仅仅注册一个新供应商是不会被选中的。 本插件打包成一个 bundle（dsh.bundle.patch），它的 cordis.patch.yml 同时做两件事：

- id: web
  config:
    searchProvider: clinepass
    fetchProvider: http          # patch 会整体替换 config，所以这行必须重述

- insert:
    - id: web-search-clinepass
      name: 'dsh-web-search-clinepass'
      config: {}

内置的 web-search-deepseek 仍然挂着（不再是选中项），需要时可以随时切回去。

配置

设置命名空间：web-search-clinepass（会出现在 Web 的「设置 → 插件配置」里，可热改）。

字段	默认	说明
enabled	true	关掉后本供应商报告为不可用。
tool	vercel:perplexity_search	发给网关的供应商端搜索工具 id（4 选 1）。按每次检索计费；提示词里的搜索次数上限只是建议，本格式没有硬上限，模型可能检索更多次。
provider / model	空（跟随会话）	钉死路由与模型，不再跟随 UI 选择。
baseURL / api / apiKeyEnv / apiKey	空	钉死端点与凭据。
headers	空	额外请求头，合并优先级：llm-pi-ai 这里没有「把搜索记录写进会话日志」的开关：DSH 会因此拒绝加载整份会话，原因见《为什么不再写会话日志事件》。

绝大多数情况什么都不用配：会话模型是 clinepass 这类 OpenAI 兼容网关时，路由信息全部来自 llm-pi-ai.providers.（api / baseURL / apiKeyEnv）——0.1.5 通过 settings.get('llm-pi-ai') 读， 0.1.7 通过 settings.describe() 读（见《0.3.1 修的那个坑》）。