前言¶

DeepSeek Harness（DSH）把智能體能力拆成可組合的插件，核心理念是「一切皆插件」。當你用 DSH 搭建能查資料、讀網頁的 Agent 時，往往還需要單獨對接搜索 API、配置 MCP Server，或者讓模型學習一套新的工具名。社區插件目錄（如 SkillHub 插件庫）由社區維護，與 DeepSeek / 幻方並無官方從屬關係，但能幫助開發者快速發現可用擴展。

@anysearch/anysearch-dsh 是 anysearch-team 維護的聯網工具類插件，在 GitHub 上已獲得約 247 個 Star（MIT 許可證）。它把 AnySearch 接入 DSH：安裝後，Harness 內置的 web_search 和 web_fetch 會走 AnySearch 後端，同時提供垂直搜索、批量併發等高級能力。本文基於插件目錄頁與 GitHub 倉庫 README、中文使用指南交叉覈實，介紹其定位、安裝與典型用法。

這是什麼¶

@anysearch/anysearch-dsh（npm 包名，倉庫 anysearch-team/anysearch-dsh）是 AnySearch 面向 DeepSeek Harness 的官方 Web 插件。AnySearch 本身是面向 AI Agent 的搜索基礎設施，覆蓋公網網頁以及代碼、金融、學術、法律、安全等垂直數據源。

插件的核心思路是「不換工具名」：Agent 仍然調用 Harness 原生的 web_search 做即時網頁搜索、web_fetch 抓取並清洗指定 URL 正文，底層請求由 AnySearch 處理。此外還掛載 anysearch_capabilities、anysearch_search、anysearch_batch_search 三個高級工具，用於發現可搜索領域、帶參數的結構化檢索，以及 1～5 路併發批量搜索。

核心功能與亮點¶

根據官方文檔，當前版本主要提供以下能力：

1. 原生聯網搜索：通過 web_search 調用 AnySearch，返回標題、URL 和摘要，便於模型引用來源。
2. 網頁正文抓取：通過 web_fetch 調用 AnySearch Extract，對公開 HTTP(S) URL 抓取並清洗爲可讀正文（Markdown/文本），避免 Harness 再次做 HTML 轉換。
3. 動態能力發現：anysearch_capabilities 可即時獲取可搜索領域、標籤和參數定義，模型不必硬猜 tag 或參數名。
4. 垂直與結構化搜索：anysearch_search 支持 tag、params、zone、language 等參數，適合金融行情、CVE 檢索等專業場景。
5. 批量併發搜索：anysearch_batch_search 一次提交 1～5 個獨立查詢，併發執行，單項失敗不影響其餘結果，輸出保持輸入順序。
6. 免 Key 快速體驗：未配置 API Key 時可使用 AnySearch 匿名額度；註冊賬號並配置 Key 後，官方說明提供每日 1000 次免費搜索調用。
7. 憑據熱更新：API Key 寫入 DSH 受管憑據文件後，下一次請求自動解析新值，無需重啓進程（環境變量方式優先級更高，修改後需重啓 DSH）。

工具與 Harness 內置接口的對應關係如下：

環境要求¶

安裝前請確認本機滿足以下條件（摘自官方 README）：

• Node.js 22.19 或更高版本，或 Node.js 24+；
• pnpm 11.7（DSH 的 plugin 子命令通過 pnpm 管理 profile 依賴，pnpm 須在 PATH 中可用）；
• 可通過 npx 運行 DeepSeek Harness；
• 網絡可訪問 https://api.anysearch.com。

DeepSeek Harness 目前仍處於開發預覽階段，上游若有不兼容變更，插件可能需要同步升級。

安裝與啓用¶

將插件安裝到 DSH 的 web profile（以下命令來自 GitHub 官方 README，與 npm 包 @anysearch/anysearch-dsh 一致）：

npx -y @deepseek-ai/dsh plugin --profile web add @anysearch/anysearch-dsh

安裝完成後啓動 DeepSeek Harness：

npx -y @deepseek-ai/dsh web

插件會自動把 AnySearch 選爲 web profile 的搜索與抓取 Provider，並啓用原生 web_fetch。可用以下命令檢查最終配置是否生效：

npx -y @deepseek-ai/dsh --profile web --dump-config

配置中應能看到 searchProvider: anysearch、fetchProvider: anysearch，以及插件條目 name: '@anysearch/anysearch-dsh'。

如需固定到某一 Git 提交，可在 profile 配置中按 DSH 慣例指定來源；日常安裝以上述 npm 包方式即可。

更新與卸載：

npx -y @deepseek-ai/dsh plugin --profile web update @anysearch/anysearch-dsh
npx -y @deepseek-ai/dsh plugin --profile web remove @anysearch/anysearch-dsh

配置 API Key（可選）¶

快速體驗可不配置 Key，請求走 AnySearch 匿名額度。持續使用或需要賬號級配額時，建議在 anysearch.com 註冊，並在 API Keys 頁面創建密鑰。

將 Key 寫入 DSH 受管憑據文件（默認 ~/.dsh/.credentials.yaml，若設置了 DSH_HOME 則爲 $DSH_HOME/.credentials.yaml）：

ANYSEARCH_API_KEY: "as_sk_your_key"

請將 as_sk_your_key 替換爲真實 Key；保留佔位符時插件會拒絕發送請求。也可通過啓動環境變量提供（優先級高於憑據文件，修改後需重啓 DSH 進程）：

export ANYSEARCH_API_KEY="as_sk_your_key"
npx -y @deepseek-ai/dsh --profile web

注意：DSH Web 設置頁目前不會爲第三方 Provider 自動生成 AnySearch Key 輸入框，請使用憑據文件或環境變量。--dump-config 輸出中只應出現 apiKeyEnv: ANYSEARCH_API_KEY，不應泄露真實 Key。

如需自定義 API 地址或正文渲染上限，可在 profile 用戶配置層覆蓋 bundled 條目（保持 id: web-search-anysearch 不變）：

- id: web-search-anysearch
  config:
    apiKeyEnv: ANYSEARCH_API_KEY
    baseURL: https://api.anysearch.com
    maxRenderedContentChars: 12000

典型用法示例¶

安裝完成後，像平時一樣向 DSH 提問即可。普通聯網查詢會走 web_search；需要閱讀某個確定 URL 的正文時走 web_fetch。

普通搜索示例（直接向 Agent 提問）：

搜索 DeepSeek Harness 最近的發佈變化，並附上來源鏈接。

查找今天關於開源 Agent Harness 的重要新聞，比較三個來源。

垂直 / 結構化搜索示例：

查詢 AAPL 最新行情。先獲取 finance 領域能力，再使用準確的標籤和參數搜索。

檢索最近的 CVE，並保留 AnySearch 的請求 ID 和搜索耗時。

批量搜索示例：

分別搜索三個開源 Agent Harness 的最新版本，並保留每項請求 ID。使用批量搜索。

需要專業數據時，Agent 應先調用 anysearch_capabilities 獲取即時標籤與參數，再調用 anysearch_search；多個獨立查詢可交給 anysearch_batch_search（最多五項，併發執行）。

適用場景與注意事項¶

適合誰用：

• 已在 DSH web profile 上開發 Agent，希望快速獲得穩定聯網能力，又不想改模型側工具協議；
• 需要公網搜索之外，還要查金融、學術、安全等垂直數據源的場景；
• 希望批量併發檢索、保留請求 ID 與耗時元數據，便於溯源和排錯。

使用前請注意：

1. 插件以當前 DSH 進程權限運行。安裝前請閱讀 GitHub 源碼 與 MIT 許可證，確認其行爲符合你的安全策略；不要把真實 API Key 寫入 Git 倉庫、截圖或日誌。
2. 匿名額度有限流。匿名模式適合體驗；生產或高頻調用建議配置 API Key。
3. Harness 仍在預覽期。關注 DSH 與插件版本更新，必要時執行 plugin update。
4. 網絡與配額。若出現 WEB_PROVIDER_ERROR，依次檢查 baseURL、到 api.anysearch.com 的連通性、Key 有效性及賬號/匿名額度是否耗盡。
5. 正文展示有上限。web_search 只向模型返回標題、URL、摘要；完整正文需通過 web_fetch 或高級工具在 includeContent: true 時按字符上限展示。

結尾¶

@anysearch/anysearch-dsh 的價值在於：在不改變 Harness 原生 web_search / web_fetch 調用方式的前提下，把 AnySearch 的即時搜索、網頁清洗、垂直檢索和批量併發能力接入 DSH。免 Key 即可上手，需要更高配額時再配置憑據即可。

• 插件目錄頁：https://www.skillhub.cn/plugins/anysearch-team/anysearch-dsh
• GitHub 倉庫：https://github.com/anysearch-team/anysearch-dsh
• AnySearch 官網：https://anysearch.com