前言¶
在 DeepSeek Harness（DSH）里，智能体常用内置的 web_search 做联网检索。多个后端可以并存，但优先级、API 密钥和各家参数往往分散在环境变量或不同插件里，改顺序或换源时要动配置、重启或查文档。维护者 Breeze-04 的 dsh-search-order 属于社区目录中的「联网工具」类插件：在 DSH 设置里用可视化面板管理 web_search 的搜索源列表、从上到下的尝试顺序，以及各源的密钥与端点；某一源失败时自动尝试下一个。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-search-order 是 DSH 官方 web_search 工具的可视化配置面板。你在界面里增删、拖拽排序搜索源，用齿轮按钮填写各源的 API key、endpoint 和专有参数；改动即时保存，下一次搜索即生效。内置源包括 DeepSeek 官方搜索、DeepSeek Messages、Exa、Tavily、Perplexity、Brave Search；已安装的其他搜索类插件提供的源也可以加入列表。插件当前版本为 0.1.0，采用 MIT 许可证；GitHub 仓库：https://github.com/Breeze-04/dsh-search-order，目录页：https://www.skillhub.cn/plugins/Breeze-04/dsh-search-order。
核心功能¶
顺序与失败切换¶
在面板中把搜索源按优先级从上到下排列。执行 web_search 时按序调用；当前源失败则自动尝试列表中的下一个。默认顺序为 DeepSeek 官方搜索 → DeepSeek Messages（可在面板中修改）。
密钥与参数¶
各源通过面板内的齿轮配置 API key、endpoint 及源特有参数。密钥由 DSH 的 credential store 管理；也支持各源对应的环境变量。DeepSeek Messages 可使用 DSH 账号登录，无需单独填 key。
DeepSeek 官方搜索的文本深度¶
对 DeepSeek 官方搜索可选取返回文本深度：
- Default：短摘要片段
- +summary：较长摘要
- +content：页面正文
扩展其他插件源¶
除上述六种内置源外，可将本机已安装的其他搜索插件所注册的源加入同一列表，与内置源一起排序与 fallback。
安装与启用¶
环境要求（来自仓库说明）：DSH 版本 >=0.2.0-rc.1 且 <0.3.0，且 dsh、pnpm 已在 PATH 中。该插件面向 web profile 客户端注入设置界面。
从 GitHub 直接安装：
dsh plugin --profile web add github:Breeze-04/dsh-search-order
若使用本地解压目录或 checkout 路径（勿在介绍流程中依赖 git clone 作为读者必做步骤），可改为：
dsh plugin --profile web add <absolute-path-to-plugin-directory>
安装完成后，在 DSH 中打开 Settings → Plugins → dsh-search-order 即可进入配置面板。
典型用法¶
- 打开 Settings → Plugins → dsh-search-order。
- 添加需要的搜索源，并从上到下拖成期望的优先级顺序。
- 点击每个源旁的齿轮，填写该源的 key、endpoint 及参数（未配置的源可能在运行时失败并被跳过）。
- 若使用 DeepSeek 官方搜索，在对应项中选择 Default、+summary 或 +content。
- 保存后无需额外步骤；下一次 Agent 调用
web_search即按新顺序与配置执行。
API 密钥优先走 DSH 凭证存储；与文档一致的环境变量方式仍可用作补充。
适用场景与注意¶
适合谁： 需要在 DSH 里统一编排多个联网搜索后端、希望失败自动换源、且不想手改多份环境变量的开发者与 Agent 配置者。
运行与信任： 插件随 DSH 进程以当前用户权限运行，会参与 web_search 的路由与密钥读写。安装前建议在 GitHub 查看源码与 MIT 许可证，确认 credential 用法符合你的安全策略。
版本边界： package.json 中 engines.dsh 限定为 >=0.2.0-rc.1 <0.3.0，升级 DSH 大版本前请核对插件是否仍兼容。
生态说明： DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录由社区维护，与 DeepSeek / 幻方无官方从属关系，本文所述安装命令与能力均以仓库 README 为准。
结尾¶
dsh-search-order 把 DSH 原生 web_search 的多源搜索收敛到一个可排序、可配密钥的设置面板，并内置 DeepSeek 官方搜索到 Brave 等常见后端及失败切换逻辑。需要试用或查看更新时，可访问目录页 https://www.skillhub.cn/plugins/Breeze-04/dsh-search-order 与仓库 https://github.com/Breeze-04/dsh-search-order。
