Hudson-Junior-Wang/dsh-search-switcher

dsh-search-switcher

DeepSeek Harness 插件

一个用于 DeepSeek Harness 输入栏的紧凑型网页搜索引擎切换器。它直接渲染在模型选择器的左侧，无需打开设置或输入斜杠命令即可更改首选引擎。

中文：在 DeepSeek Harness 输入栏的模型切换器左侧提供搜索引擎热切换下拉菜单，无需打开设置或输入命令。

功能特性

- 通过 conversation.input.right 在模型选择器旁提供输入栏控件。
- 可滚动的引擎列表，并标记当前引擎。
- 通过回环桥接读取和写入 free-search.provider 设置。
- 支持 dsh-free-search 提供的十种引擎：
- DuckDuckGo HTML
- DuckDuckGo Lite
- Bing
- AnySearch AI
- SearXNG
- Exa
- Tavily
- Keenable
- Perplexity
- DeepSeek Official
- 使用 Harness 主题变量。
- 完整的键盘支持：方向键可从触发器打开菜单并在引擎之间移动，Home/End 跳转到第一个/最后一个条目，Enter/Space 激活，Escape 关闭并将焦点返回触发器。

要求

- 带有 Node.js 20 或更高版本的 DeepSeek Harness Web 配置文件。
- dsh-free-search >=0.4.7，它负责设置桥接和搜索提供程序。

该切换器仅更改首选提供程序。它不会绕过提供程序身份验证、API 密钥要求或网络限制。

与 dsh-free-search 0.4.22 的兼容性

dsh-free-search 0.4.22 通过 SettingsProvider.installSection() 方法注册其设置命名空间，而该方法仅存在于 @deepseek-ai/dsh-settings >= 0.1.2-alpha.2 中。在较旧的 harness 运行时上（DSH Desktop 0.7.1 捆绑的是 0.1.2-alpha.1；任何 alpha.2 之前的 dsh），该注册会抛出异常并被 Cordis 捕获，因此 free-search 命名空间永远不会暴露：设置桥接对 /describe 的响应中 namespaces 列表为空，对 /mutate 的响应为 settings-not-exposed。此时切换器无法读取或写入提供程序——自 v0.3.0 起，菜单会显示该确切诊断信息，而不是通用的“切换失败”。

| dsh-free-search | Harness dsh-settings = 0.1.2-alpha.2 |
| --- | --- | --- |
| = 0.1.2-alpha.2 的版本（首选——dsh-free-search 0.4.22 可直接使用）。
2. 在旧版运行时上，在本地修补已安装的 dsh-free-search 0.4.22：将其 sctx.settings.installSection(...) 代码块替换为导出的 installSettingsSection(ctx, ...) 辅助函数（语义完全相同，旧版运行时中已存在）。确切的两行差异在 DDDMUC/dsh-free-search 上的错误报告中——请在那里报告，以便上游发布一个同时兼容两种运行时的版本。
3. 或者将 dsh-free-search 固定为 0.4.21 或更早版本，同时继续使用旧版运行时。

受限网络使用场景

海外大学和校园网络通常会屏蔽 api.deepseek.com，这会导致 DeepSeek Official 提供程序不可用，而测试框架的其余部分仍能正常工作。此切换器的存在是为了让你可以一键回退到 Bing、DuckDuckGo、SearXNG 或其他可访问的提供程序——无需设置页面，也无需手动编辑提供程序。

截图

模型选择器旁边的触发器，以及打开的引擎菜单：

触发器

引擎菜单

安装

使用 Harness 插件 CLI：

dsh plugin --profile web add https://github.com/Hudson-Junior-Wang/dsh-search-switcher.git

如果你的 CLI 将 profile 用作当前默认值，则以下命令等效：

dsh plugin add https://github.com/Hudson-Junior-Wang/dsh-search-switcher.git

如果尚未安装 dsh-free-search，也请一并安装：

dsh plugin --profile web add https://github.com/DDDMUC/dsh-free-search.git

然后重启 Harness 主机或重新加载 Web UI。在活动对话中，新控件会立即出现在模型选择器的左侧。

手动安装 profile

将该包添加到 profile 依赖项中，并将 dsh-search-switcher 添加到 dsh.profile.bundles。该包的 cordis.patch.yml 会自动加载其入口。

如果 profile 中已包含手动插入的 dsh-search-switcher 条目，请在使用 dsh plugin add 之前移除该手动补丁；否则同一个加载器条目可能会被注册两次。

开发

npm test          # bundle smoke test (manifest, patch, syntax)
npm run check     # node --check on both lib files

客户端 bundle 有意设计为自包含的 ModuleLoader bundle，因此可以由 Harness 客户端模块系统直接提供，而无需单独的构建步骤。

许可证

MIT