dsh-web-search-anysearch: AnySearch 網頁搜索插件

前言¶

在 DeepSeek Harness (DSH) 生態中，構建具備聯網能力的智能體通常需要適配特定的搜索後端。dsh-web-search-anysearch 是一個 AnySearch 網頁搜索提供者插件，旨在通過 ctx.web 能力 seam 提供開箱即用的網頁搜索能力，無需編寫額外的後端服務代碼。

插件定位¶

該插件由 fan56 維護，開源協議爲 MIT。它作爲一個 DeepSeek Harness 插件，通過 AnySearch 服務提供網頁搜索功能。插件採用無狀態設計，不依賴緩存或持久化配置寫入。

核心功能¶

統一接口調用：註冊 WebSearchProvider，ID 爲 anysearch。模型調用 web_search 工具時，通過 ctx.web 能力 seam 統一處理，保持引用格式和邊界一致。
多場景支持：支持匿名訪問。支持域名固定（domain pinning），可用於 finance（金融）、academic（學術）等特定領域搜索。
結果解析：將 AnySearch 返回的 Markdown 結果塊解析爲可引用的來源（包含 title、url、snippet）。
傳輸與限制：使用 node:https 傳輸層（非 fetch/undici）。API 對 max_results 的限制爲 10。

安裝與啓用¶

安裝插件需要 DeepSeek Harness 版本 >= 0.2.0-rc.2。

dsh plugin --profile <name> add @aiwayds/dsh-web-search-anysearch

安裝後重啓 DSH 以應用更改。插件會自動註冊到 dsh.profile.bundles，並掛載到 web_search 默認引擎。

配置說明¶

所有配置項均爲可選。

API Key：API Key 可選。匿名訪問可用，但速率限制較低。Key 存儲在 ~/.dsh/.credentials.yaml。

    version: 1
    refs:
      ANYSEARCH_API_KEY: <your_key>

搜索參數：
- maxResults：默認爲 8，上限爲 10。
- timeoutMs：默認爲 30000。
- domain：用於固定搜索領域（如 finance, academic）。
- endpoint：默認爲 https://api.anysearch.com/mcp。
默認引擎切換：若需保留其他搜索引擎作爲默認，可在配置文件中手動指定，該配置優先級高於插件註冊的默認值。

使用示例¶

安裝並重啓。
驗證當前 web_search 引擎：

   dsh --profile <name> --dump-config | grep -A3 'id: web$'

在對話中直接使用 web_search 工具。

注意事項¶

版本要求：必須使用 DSH >= 0.2.0-rc.2。插件僅支持 DSH 的 RC/stable 線，不再支持 alpha 線。
錯誤類型：取消操作返回 WEB_ABORTED，其他錯誤（如網絡、非 2xx 狀態、JSON-RPC 錯誤）返回 WEB_PROVIDER_ERROR。
配置優先級：Literal apiKey 會覆蓋 apiKeyEnv 引用。
可用性檢查：available() 是本地檢查，僅驗證端點是否可解析，不檢查權限。