前言¶
在 DeepSeek Harness (DSH) 的插件生態中,通用的網絡搜索插件通常僅執行關鍵詞檢索。當用戶在開發特定項目(例如編寫 Rust CLI)時,通用的搜索結果往往包含大量無關信息,而非用戶需要的特定技術文檔或解決方案。dsh-context-aware-search 旨在解決這一痛點,它通過讀取會話上下文來重寫查詢,提升搜索結果的相關性。
插件簡介¶
這是一個 DeepSeek Harness (DSH) 插件,由用戶 helibeiqi 維護。它的核心作用是將 web_search 接口從簡單的“關鍵詞轟炸”轉變爲“上下文感知的研究助手”。它讀取當前會話,重寫查詢,對搜索結果進行重新排序並標記可信度,同時支持一鍵源總結。
核心能力¶
該插件提供以下主要功能:
- 上下文感知查詢重寫:讀取會話中最近 N 條消息,提取當前正在使用的語言、框架或庫,對原始查詢進行擴展(例如將
await 報錯擴展爲Python asyncio await 常見錯誤 解決方案)。 - 結果重新排序:使用 TF-IDF 算法對結果進行打分,根據查詢與上下文的相似度對結果進行重排,確保最相關的結果排在前面。
- 一鍵源總結:提供
web_summarize工具,自動抓取指定 URL 或搜索結果的前 N 條鏈接,生成包含關鍵點、關鍵數據和源鏈接的結構化 Markdown 摘要。 - 源可信度標籤:根據域名規則(如
.edu、.gov、官方文檔)對每個結果標記high(高)、medium(中)、low(低)可信度。 - 多後端自動故障轉移:支持 DuckDuckGo、Bing 和 SearXNG,並具備自動回退機制。
- 零配置:默認情況下使用 DuckDuckGo,無需 API Key 即可啓動。
安裝與啓用¶
安裝前請確認 DeepSeek Harness 版本爲 0.1.0-rc.6,因爲插件與該運行時版本進行了綁定。
安裝命令如下:
dsh-context-aware-search@0.1.1
注意:嚴禁安裝 @latest。該插件是基於 DeepSeek Harness 0.1.0-rc.6 構建的,版本不匹配可能導致搜索和抓取功能異常。
使用方法¶
在對話中直接使用搜索指令即可,插件會自動處理上下文重寫和結果排序。
示例 1:搜索並總結¶
web_summarize query="Rust error handling best practices" topN=3
示例 2:總結特定文檔¶
web_summarize url="https://doc.rust-lang.org/book/ch09-00-error-handling.html"
工作流程¶
- 插件讀取最近
contextWindow條消息(默認爲 8 條)。 - 分析上下文中的技術棧,重寫原始查詢。
- 調用多個後端進行搜索(DuckDuckGo -> Bing -> SearXNG)。
- 使用 TF-IDF 對結果進行重新排序並標記可信度。
- 返回包含重寫查詢說明、結果排名表(含可信度標籤)的 Markdown 內容。
注意事項¶
- 依賴環境:該插件依賴 DeepSeek npm 註冊表,需要相應的訪問權限。
- 算法限制:重排序功能不依賴嵌入模型,僅使用 TF-IDF 進行關鍵詞提取和評分。
- 技術棧:僅使用 TypeScript 和平臺原生的
fetch,無外部模型依賴,運行輕量。
總結¶
dsh-context-aware-search 通過引入會話上下文,顯著提升了網絡搜索在技術場景下的精準度。它適合需要在對話流中持續獲取特定領域信息(如編程文檔、技術博客)的開發者。更多詳情可參考 插件目錄 或 GitHub 倉庫。