前言¶
在 DSH 裏讓 Agent 使用 web_search 和 web_fetch 時，常見做法是隻看最終回答裏有沒有引用鏈接，卻很難回答「這一輪到底搜了什麼、返回了哪些頁、哪些被讀過、哪些進了上下文」。排查幻覺來源、對比不同 prompt 的檢索行爲，也缺少結構化記錄。下面介紹的插件把每次聯網調用的關鍵詞、結果 URL 與抓取結果寫成可審計日誌，並在界面裏按輪次和會話彙總引用與抓取情況，方便回看與篩選。
這是什麼¶
dsh-web-search-insights（npm 包名 @ypingcn/dsh-web-search-insights）是 DeepSeek Harness 的 web profile 插件，維護者爲 ypingcn，在社區目錄中歸類爲「記憶」。它針對 Agent 的 web_search / web_fetch 使用方式，提供 JSONL 審計日誌、會話級統計投影，以及在聊天界面中的引用入口、右側「搜索記錄」面板和會話頂部的「快速搜索」視圖。
核心功能¶
審計日誌¶
每次 web_search 會記錄搜索關鍵詞以及結果中的網址與標題；每次 web_fetch 會記錄 URL 與 HTTP 結果。日誌寫入 JSONL。失敗調用可按需記錄錯誤碼；正文內容不會寫入日誌，避免把整頁網頁堆進本地文件。
會話統計（webSearchInsights）¶
插件通過 webSearchInsights 投影產出：
- 本輪 / 本會話的引用來源與返回來源；
- 被
web_fetch實際抓取過的頁面。
這些數字與列表會驅動回答下方的引用入口和右側欄面板。
界面入口¶
- 回答末尾：顯示來源圖標、本輪與會話的引用數，以及「查看」按鈕。搜索輪展示引用/返回數；僅發生
web_fetch的輪次還會展示抓取/失敗數（可在配置頁關閉該入口）。 - 右側欄「搜索記錄」：支持本輪/本會話切換；按已引用、未引用、已抓取篩選；來源與抓取頁面均可按域名分組；頭部與工具欄吸頂。
- 會話頂部「快速搜索」：不寫入審計日誌的獨立搜索視圖與結果列表；依賴宿主提供的同源 HTTP 路由（web profile 自帶）。
依賴要求¶
安裝前請確認環境滿足 README 中的約束：
- DSH：
>=0.2.1-rc.2且<0.3.0； - Node.js：
^22.19.0或>=24.0.0； - 快速搜索功能需要 web profile 提供的同源 HTTP 路由。
安裝與啓用¶
推薦使用 npm 發佈包，且需指定 web profile：
dsh plugin --profile web add @ypingcn/dsh-web-search-insights
若要從 GitHub 安裝：
dsh plugin --profile web add github:ypingcn/dsh-web-search-insights
本地開發調試可使用 link 方式：
dsh plugin --profile web add link:/path/to/dsh-web-search-insights
安裝完成後，在插件管理頁打開「搜索溯源」，詳情頁中會出現配置表單，可按需調整（例如是否顯示回答末尾的引用入口）。
典型用法¶
插件啓用後無需單獨調用 API：Agent 在正常對話中觸發 web_search / web_fetch 時，插件會自動寫 JSONL 並更新統計。
人工回看時，可按下面路徑操作：
- 在某條回答下方點擊引用入口，查看該輪引用與返回情況；
- 打開右側欄「搜索記錄」，切換「本輪 / 本會話」，並用「已引用 / 未引用 / 已抓取」篩選；
- 需要按站點歸類時，在面板中使用按域名分組；
- 若只想快速查網頁而不留審計記錄，使用會話頂部的「快速搜索」視圖。
適用場景與注意¶
適合誰：在 DSH web profile 下開發或調試聯網 Agent、需要覈對「搜了什麼、回了哪些鏈、讀了哪些頁」的開發者；希望用會話級統計對比多輪檢索行爲的場景。
注意：
- 插件在當前 DSH 進程權限下運行，日誌與配置落在本地；安裝前建議閱讀 GitHub 倉庫 源碼與許可證（package.json 中版本爲
0.1.0，以倉庫爲準）。 - 社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本插件爲社區維護項。
- 快速搜索依賴 web profile 路由；非 web profile 或未滿足 Node / DSH 版本要求時，部分能力可能不可用。
結尾¶
dsh-web-search-insights 把聯網搜索從「黑盒回答」拆成可審計的 JSONL 與可篩選的界面統計，便於對齊 Agent 的實際檢索與閱讀路徑。進一步瞭解與 issue 反饋見：
- 目錄頁：https://www.skillhub.cn/plugins/ypingcn/dsh-web-search-insights
- GitHub：https://github.com/ypingcn/dsh-web-search-insights
