在 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 許可證。在使用前,建議檢查源碼以確保符合當前的安全合規要求。