前言¶
在 DSH 裏做智能體或日常對話，聯網檢索往往是標配：既要拿到可讀的正文，又要避免廣告鏈接混進上下文，還要在「快速答疑」和「像瀏覽器一樣翻結果」之間切換。直接用通用搜索引擎或單一摘要工具，通常只能覆蓋其中一種用法。
下面介紹社區插件 dsh-ai-search（維護者 745403lkh，分類：聯網工具）。它在 Harness 裏提供獨立搜索面板，底層統一走「聯網檢索 → 廣告過濾 → 正文精讀」，再按 答疑 / 百科 / 瀏覽 三種模式做不同的 AI 處理；README 標明無第三方 npm 依賴，當前 package 版本爲 1.4.5-fix1，MIT 許可證。
這是什麼¶
dsh-ai-search 是 DeepSeek Harness 的一個插件：在宿主裏註冊搜索界面、設置頁、本機 HTTP 接口，以及 Agent 工具 curated_search。默認聯網搜索走 Harness 自帶能力，也可在設置裏換成 Tavily、博查、SearXNG、Serper 等；摘要與百科生成默認用 Harness 模型，也可配置 OpenAI 兼容接口。
插件目錄與源碼：GitHub — 745403lkh/dsh-ai-search。社區條目：SkillHub — dsh-ai-search（獨立社區站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
共用流水線¶
三種模式共享：檢索 → 過濾廣告 → 精讀正文。README 說明廣告判定偏保守（明確廣告域名、Sponsored/【廣告】等），弱信號如「佣金/返利」不會單獨刪結果。同一問題、同一模式在 10 分鐘內重複搜索會讀緩存；瀏覽模式僅第 1 頁緩存，翻頁不緩存。
答疑（默認）¶
流程：檢索 → 過濾 → 精讀 → AI 摘要與推薦排序。
輸出包括：2–4 句摘要、3–6 條推薦（含理由與評分）、已過濾清單、全部來源。推薦鏈接只接受候選裏出現過的 URL，模型編造的鏈接會被丟棄。界面會標註精讀口徑（例如「精讀 N 篇」或「未讀取正文（摘要基於檢索片段）」）。
百科¶
面向百科與權威來源：同時檢索原問題與「百科 / wiki encyclopedia」兩路，優先 Wikipedia、百度百科、Britannica 等域名，再讀正文。按百科體例生成 標題 + 概述 + 章節 + 參考來源。
檔位在 設置 → AI 搜索 → 百科模式詳細程度 調整：
- 簡明：3–4 個章節
- 標準：5–6 個章節（默認）
- 詳盡：7–9 個章節
瀏覽¶
像搜索引擎信息流：綜合 / 文章 / 視頻 / 圖片 四個板塊。排名只用 相關性、時效性、熱度 三項，權重在設置裏用滑桿調節（0–100，自動歸一化）；不含競價權重。每條結果展示分項與加權綜合分。
瀏覽模式還有官網識別（內置 200+ 品牌首頁映射，可自定義或 Excel/CSV 導入）、視頻站 site: 定向、圖片多源檢索、分頁「下一頁」（exclude 去重）、縮略圖與懶補封面等邏輯；細節見 README。
設置與本地數據¶
設置 → AI 搜索 獨立頁，改完即生效。除上述百科檔位與瀏覽權重外，還包括：結果語言（跟隨 Harness / 中文 / English）、切換頁面時保留結果、與 dsh-better-sidebar 的側邊欄適配、鏈接在側邊欄瀏覽器或系統瀏覽器打開、默認/自定義搜索引擎、自定義搜索 API、自定義思考模型、搜索歷史（最近 20 條，可清空）。
本機數據在 DSH home（默認 ~/.dsh）的 ai-search/ 下：
settings.json：語言、檔位、權重、引擎等history.json：{ version: 2, items }結構的最近記錄
Agent 與 HTTP 接口¶
智能體可調用 curated_search(query, mode, page, exclude)，模式與 UI 一致：qa / encyclopedia / browse；瀏覽翻頁時把已見過的 URL 傳入 exclude。
本機調試搜索需 POST，並帶請求頭 x-dsh-ai-search: 1，且來源須爲 localhost 迴環；每分鐘每客戶端 10 次。示例（端口以實際 Harness 爲準）：
curl -H "x-dsh-ai-search: 1" -H "content-type: application/json" \
-d '{"query":"DeepSeek Harness 插件","mode":"qa"}' \
http://127.0.0.1:端口/.dsh-ai-search/search
mode 可選 qa（默認）、encyclopedia、browse；瀏覽模式 page 爲 1–5。健康檢查：GET /.dsh-ai-search/health。
與 dsh-better-sidebar 配合¶
安裝 dsh-better-sidebar 後，可在右側欄多開「AI 搜索」頁籤、豎向切換 AI 搜索與傳統搜索引擎；未安裝時插件跳過注入，原有左側面板仍可用。設置裏可關閉「適配更好的側邊欄」恢復默認佈局。
安裝與啓用¶
SkillHub 目錄頁給出的安裝方式是交給 Harness 處理，而不是手寫 git clone：
請安裝 DSH 插件 745403lkh/dsh-ai-search
在 DSH 對話或插件安裝流程中使用上述標識即可；安裝前建議閱讀 GitHub 源碼 與 LICENSE（MIT），確認符合你的環境與合規要求。插件以當前 dsh 進程權限 運行，聯網與讀頁行爲與宿主一致。
典型用法¶
- 界面搜索：打開插件搜索面板，選擇答疑 / 百科 / 瀏覽，輸入查詢；瀏覽模式可在板塊間切換，需要更多結果時點「下一頁」。
- 調參：在設置裏改結果語言、百科檔位、瀏覽三指標權重，或切換自定義搜索 API / 思考模型。
- Agent：在對話中讓模型調用
curated_search，例如指定mode: "encyclopedia"生成詞條結構，或mode: "browse"並配合page、exclude翻頁。 - 本機集成：僅本機服務可訪問
/.dsh-ai-search/*路由；外部網頁無法跨站觸發搜索接口。
適用場景與注意¶
適合：需要在 DSH 內完成「摘要 + 可信鏈接」「百科體例長文」「可加權的信息流瀏覽」的開發者與用戶；希望統一廣告過濾與正文精讀，並保留搜索歷史的場景。
注意：
- 檢索與模型調用消耗 Harness 或自建 API 配額；外部網頁內容視爲不可信數據，工具輸出會提醒模型勿當作指令執行。
- 搜索接口有頻率限制；舊版
GET /search調試入口已移除。 - 社區目錄頁顯示 GitHub 2 stars（以頁面當時展示爲準），功能演進以 README 與 CHANGELOG 爲準。
結尾¶
dsh-ai-search 把聯網檢索、廣告過濾、正文精讀和三種 AI 呈現方式收進一個 Harness 插件，並暴露設置、歷史、Agent 工具與本機 API。若要查看條目說明或跟蹤版本，可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
