dsh-open-deep-research: DeepSeek Harness 深度研究插件

前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。在構建需要聯網搜索、閱讀網頁或 PDF 並生成引用報告的研究型智能體時，手動編排這些步驟既繁瑣又容易出錯。dsh-open-deep-research 插件提供了一個現成的深度研究框架，它基於 DSH 構建，負責規劃、執行研究和綜合結論。

這是什麼¶

dsh-open-deep-research 是一個可配置的 Deep Research 代理和 TypeScript 框架。該插件由 songyang0603 維護，旨在解決從單一問題出發，生成帶引用鏈接的 Markdown 報告的需求。它通過 CLI、DSH Tool 和 TypeScript API 暴露了標準化的研究服務。

核心功能¶

規劃與執行：規劃 1 到 3 個專注的研究單元，並通過 DSH 子智能體運行，最後由合成智能體生成報告。
多模態檢索：支持 Web 搜索（在專用 Profile 中）以及通過 research-jina Profile 讀取選定的頁面或 PDF。
結構化輸出：返回帶引用的 Markdown 報告、規範化的鏈接、終端狀態和運行元數據。
多種接入方式：提供 CLI、DSH Tool 和 TypeScript 入口點，底層基於可替換的 ResearchEngine。

安裝與啓用¶

環境要求：
* Node.js ^22.19.0 或 >=24.0.0
* pnpm 10.x
* DeepSeek Harness 0.1.0-rc.8

下載預發佈包：

    curl -fL -O \
      https://github.com/songyang0603/dsh-open-deep-research/releases/download/v0.1.0-alpha.5/dsh-open-deep-research-0.1.0-alpha.5.tgz

安裝插件（以 research-jina Profile 爲例）：

    npx @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile research-jina add ./dsh-open-deep-research-0.1.0-alpha.5.tgz

典型用法¶

全量研究（搜索 + 閱讀）¶

使用 research-jina Profile，需要 DeepSeek Key 和 Jina Key。該 Profile 提供網頁搜索和頁面閱讀能力，會將選定的公共 URL 發送到 Jina。

export DEEPSEEK_API_KEY='<your-deepseek-key>'
export JINA_API_KEY='<your-jina-key>'

npx @deepseek-ai/dsh@0.1.0-rc.8 --profile research-jina \
  --breadth balanced \
  --language English \
  "Research the main changes in DeepSeek Harness rc.8. Search for relevant material, read important source pages, and produce a report with citation links."

僅搜索¶

當沒有 Jina Key 或網絡無法訪問 Jina 時，使用獨立的 research Profile。它提供規劃、Web 搜索、多個研究單元、綜合和報告生成，但不提供可靠的全頁面或 PDF 讀取能力。

export DEEPSEEK_API_KEY='<your-deepseek-key>'

npx @deepseek-ai/dsh@0.1.0-rc.8 --profile research \
  --language English \
  "Research the main changes in DeepSeek Harness rc.8 and produce a report."

適用場景與注意¶

該插件適用於需要在 DeepSeek Harness 中快速構建複雜調研流程的場景。

注意 1：項目狀態爲 0.1.0-alpha.5 Alpha Public Preview，不建議在生產環境直接使用。
注意 2：Reader 每次請求最多返回 8,000 tokens，長文檔可能被截斷。
注意 3：第一次乾淨的 npx 調用會花費幾分鐘下載和構建依賴，請耐心等待。
注意 4：research-jina Profile 會發送選定的公共 URL 到 Jina，請使用非敏感、公開的 URL。
注意 5：DSH 在管理 Profile 插件時會調用 pnpm，確保 pnpm 已安裝。
注意 6：兩個 Profile（research 和 research-jina）是獨立的，它們之間不會互相覆蓋。

結語¶

dsh-open-deep-research 爲 DeepSeek Harness 用戶提供了一個開箱即用的深度研究解決方案。它通過標準化的接口和 Profile 管理，簡化了從問題定義到報告生成的全過程。