在 DeepSeek Harness (DSH) 的开发场景中,智能体获取实时信息通常面临两个痛点:一是依赖 LLM 自主调用搜索工具,由于缺乏显式约束,模型容易产生幻觉或因知识截止而给出错误信息;二是标准代理流程需要经过多步推理,导致响应延迟高且消耗大量 Token。dsh-web-search-button 插件旨在解决这一问题。它将 DeepSeek 的内置 ctx.web 搜索服务直接暴露在对话输入栏,通过按钮或斜杠命令触发,实现零 LLM 开销的极速网页搜索。
插件定位¶
这是一个由 swenbo1-web 维护的联网工具类插件,专为 DeepSeek Harness (DSH) Desktop 设计。它提供直接网页搜索按钮和 /search 斜杠命令,让用户在对话输入栏直接调用宿主级搜索服务,绕过 LLM 的多步推理过程,将网页搜索结果(含标题、摘要、日期和源链接)以 Markdown 格式直接注入会话。
核心能力¶
- 零 LLM 开销:搜索结果直接由宿主服务返回,不经过模型生成,消耗 0 Token。
- 双重调用模式:支持在输入栏点击 🌐 按钮触发,也支持输入
/search <keyword>并回车触发。 - 原生 UI 集成:挂载在
conversation.input.left插槽,使用官方--dsw-*设计令牌,支持深色/浅色模式切换。 - 自动生命周期管理:基于 Cordis Scope 机制,插件重新加载或禁用时自动卸载,防止内存泄漏。
安装步骤¶
安装需要将代码克隆到本地磁盘,并通过目录连接注册到 DSH 的 Web 配置文件中。
- 克隆代码到本地目录
git clone https://github.com/swenbo1-web/dsh-web-search-button.git D:/deepseek/dsh-web-search-button
- 创建目录连接
在 PowerShell 中运行以下命令,将插件目录连接到 DSH 的 Web 配置文件目录:
New-Item -ItemType Junction -Path "$env:APPDATA\dsh-desktop\harness\profiles\web\node_modules\dsh-web-search-button" -Target "D:\deepseek\dsh-web-search-button"
- 声明依赖
打开%APPDATA%\dsh-desktop\harness\profiles\web\package.json,在dependencies和dsh.profile.bundles中声明插件:
{
"dependencies": {
"dsh-web-search-button": "link:D:/deepseek/dsh-web-search-button"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-web-search-button"
]
}
}
}
- 重启并刷新
保存配置文件后,重启 DSH Desktop 应用。
使用方法¶
安装完成后,可以通过以下两种方式触发搜索:
- 斜杠命令:在对话输入栏输入
/search <keyword>并按回车键。 - 按钮触发:点击输入栏左侧的 🌐 Web Search 按钮。按钮会自动读取当前输入框的草稿内容作为搜索关键词。
注意事项¶
- 运行环境:该插件以当前 DSH 进程的权限运行,需要 DSH Desktop 激活配置文件(Web Profile)处于启用状态。
- 性能表现:搜索执行时间约为 1 秒,不会占用 LLM Token 额度。
- 安全与合规:插件采用 MIT 许可证。在使用前,建议检查源码以确保符合当前的安全合规要求。