dsh-web-search-scrape：DeepSeek Harness 六檔分級抓取式網頁檢索插件

前言¶

DeepSeek Harness (DSH) 的插件生態支持高度定製。對於需要聯網能力的場景，現有的官方搜索往往需要 API Key，且模型側的 web_search 工具在 DSH 0.1.5+ 版本中會被預設遮蔽，導致無法傳遞深度參數。

dsh-web-search-scrape 插件直接通過 Node 內置 fetch 抓取搜索引擎與社交平臺的公開結果頁，爲 ctx.web 註冊名爲 web-scrape 的 provider，並註冊 web_search_deep 工具以繞過遮蔽機制，實現無需 API Key 的本地檢索。

核心功能¶

該插件提供以下能力：
* 雙後端切換：支持 local（本地抓取，默認）與 official（官方 API）。
* 六檔深度控制：T1 極速至 T6 研究，支持顯式傳參或自動選檔。
* 雙池引擎：P0 搜索引擎池（Google, Bing, 百度等）+ P1 社交平臺池（微博, Bilibili, Reddit 等）。
* 設置頁卡片：在瀏覽器設置中提供可視化的配置卡片，支持持久化。
* 驗證機制：T4 以上支持子代理分診與網頁內容覈實。

後端與計費¶

搜索後端¶

插件通過設置卡片切換後端。默認爲 local，完全免費。

若需使用官方搜索（backend: official），必須在設置中開啓 allowOfficial。默認情況下，allowOfficial 爲 false，此時即便配置寫錯也不會產生任何網絡請求或計費。

計費控制¶

計費僅發生在以下兩種情況，均有硬開關：
1. 官方搜索：開啓 allowOfficial 後，按 DeepSeek Messages API Token 計費。
2. 深度子代理：T4 及以上檔位會派發 LLM 子代理進行分診或覈驗，按當前會話模型計費。

爲避免靜默產生費用，插件默認將 maxAutoTier 限制爲 3（即自動檔位最高到 T3，僅純抓取）。若需恢復 T4-T6 的子代理功能，需顯式傳入 tier 參數。

推薦配置（免費且安全）¶

backend: local          # 使用本地抓取
allowOfficial: false    # 禁止官方搜索，防止誤觸
maxAutoTier: 3          # 限制自動檔位，防止靜默產生 LLM 費用

檔位與工具¶

六檔檢索深度¶

插件提供 T1 至 T6 六檔檢索，結果上限默認爲 130 條。

工具遮蔽處理¶

在 DSH 0.1.5+ 版本中，模型側的 web_search 工具被移至 agent 預設平面，會遮蔽本插件的同名註冊，導致無法傳遞 tier 參數。

插件通過註冊同名的 web_search_deep 工具解決此問題。該工具不受預設遮蔽，且參數與 web_search 一致，可在任何預設下使用。

安裝與配置¶

前置條件¶

• DSH 版本需 >= 0.1.5-rc.2。
• 安裝時需確保宿主兼容性，特別是 ctx.settings.installSection 與 createSnapshotStore 的 API 版本。

目錄結構¶

插件倉庫直接提供 ESM 源碼，無需構建：

.
├── package.json
├── cordis.patch.yml
└── lib
    ├── index.js      # 宿主側：Provider 與工具註冊
    └── client.js     # 瀏覽器側：設置頁卡片

使用示例¶

1. 在設置頁卡片選擇 backend 爲 local。
2. 在配置文件中設置 allowOfficial: false 以避免計費。
3. 在代碼或提示詞中調用 web_search_deep，傳入 tier 參數（如 tier: 5）。
4. 使用 maxAutoTier: 3 限制自動選檔的上限。

適用場景與注意¶

• 場景：需要深度控制檢索結果數量（默認 130 條）和深度的開發者；希望避免 API Key 管理或付費的長期運行會話。
• 注意：插件以當前 DSH 進程權限運行。安裝前建議檢查源碼與許可證（MIT）。T4-T6 檔位涉及子代理調用，會產生對應的模型 Token 費用，需謹慎配置。

總結¶

dsh-web-search-scrape 提供了一個無需 API Key、可控制檢索深度與結果數量的本地抓取方案，並通過工具重命名機制解決了 DSH 新版本的工具遮蔽問題，適合對聯網能力有精細化要求的 DSH 用戶。

• GitHub 倉庫
• 插件目錄頁