前言¶
在 DeepSeek Harness（DSH）裏做調研，宿主自帶的 web_search / web_fetch 適合查事實、鏈接或定義；一次 Agent 搜索則是「問一次、答一次」，拆題、檢索、彙總都在一條串行鏈路上，深度和廣度大致相當於單個檢索上下文的工作量。主題需要拆成多個子問題、並行交叉覈對、再在同一對話裏一輪接一輪往下挖時，單靠連跑幾次搜索或重複提問，很難既保留上下文又產出可逐輪閱讀的帶引用報告。
下面介紹社區插件 dsh-deepsearch（維護者 NeptuneRY，GitHub NeptuneRY/dsh-deepsearch）。它在 DSH 裏實現「多輪深度搜索」：主會話拆題、派活、彙總，子問題交給獨立子代理並行查；每一輪結束落一份 Markdown 報告，多輪在同一主題目錄裏按編號順序讀，後一輪繼承前一輪的未決問題繼續挖，而不是把同一個問題問兩遍。
這是什麼¶
dsh-deepsearch 是 DSH 工作流類插件（當前 package 版本 1.1.45，MIT 許可證）。定位可以概括爲：Multi-round deep research for DeepSeek Harness——同一會話裏一輪接一輪往下挖，帶引用的報告寫在右側欄（需配合 Better Sidebar）並可落盤到本地目錄。
檢索本身仍走宿主提供的 web_search / web_fetch（DeepSeek 搜索 API）；插件不接管這些工具，只決定查什麼、誰去查、查到哪一步算夠。它不替換宿主任何工具；是否把檢索外包給子代理，由模型自己判斷。
和一次 Agent 搜索的差別¶
| Agent 搜索 | 深度搜索（本插件） | |
|---|---|---|
| 上下文 | 每次提問從零開始 | 同一會話連續多輪，後一輪繼承前一輪 |
| 檢索單位 | 一個會話串行查 | 每個子問題一個獨立子代理，並行查 |
| 問題拆分 | 一次性拆完 | 每輪重排：上一輪「未決」變成下一輪重點 |
| 產出 | 一段回答 | 每輪一份 Markdown 報告，同一主題目錄按編號讀 |
| 適合 | 事實、鏈接、定義 | 需要縱深與交叉驗證的調研 |
工作流程可以概括爲四步：拆（主會話把主題拆成互不重疊的子問題）、派（每個子問題交給獨立子代理並行查，默認 3 個，最多 8 個）、挖（一輪查完主會話看還缺什麼，同一會話繼續）、匯（每輪一份帶引用的報告寫入同一主題目錄）。
只查一個事實、幾條鏈接或一個定義時，用宿主自帶的 web_search 更快；本插件面向「答案不在第一頁」、需要拆題與交叉驗證的任務——行業與公司研究、盡調、方案對比、技術路線評估、政策與人物背景等。適用範圍 README 裏也寫得很寬，但核心仍是「多子問題 + 並行子代理 + 多輪繼承」。
核心功能¶
兩個入口¶
面板（Better Sidebar 頁籤 + 左側欄圖標）
右側欄「深度搜索」標籤頁有四個頁：
| 頁 | 做什麼 |
|---|---|
| 深度搜索 | 輸入主題、選輪數（1–10）；報告寫到 <reportDir>/<主題短名>/NN-<標題>.md；多輪同一會話連續跑，每輪單獨落盤，中途失敗不丟已完成輪次 |
| Agent 搜索 | 輸入自然語言，在「深度搜索」工作區新開會話跑單次問答，答案同步回面板；可在左側欄繼續追問 |
| 歷史 | 按全部 / Agent 搜索 / 深度搜索篩選；深度搜索卡片可「再搜一輪」（沿用原會話追加一輪） |
| 配置 | 通用項、深度搜索參數、方法筆記 |
面板依賴 Better Sidebar（dsh-better-sidebar）；未安裝時仍可通過宿主左側欄常駐搜索圖標打開同一面板。結果卡與歷史卡片可將報告「保存到桌面」。
deepsearch 工具
主會話裏按需調用，與面板走同一條鏈路。參數包括：topic（必填）、rounds（1–10，大於 1 走多輪）、use_context、reference_paths（額外只讀的文件或目錄）。返回 { ok, title, reportPath, ms, summary, rounds }；正文爲按 deepsearchSummaryChars 截斷的摘要，完整報告在文件裏。在深度搜索工作區裏調用時默認只跑 1 輪；可在設置裏打開「限制解除」。
調查方法可編輯¶
「深度搜索」頁底部「調查方法」卡對應包內 methods.md：在面板裏改、保存即生效；關開關則不注入任何調查方法。
多輪報告如何累積¶
多輪不會覆蓋上一輪報告：例如第一輪橫向對照若干樣本，第二輪在同一主題目錄追加 02- 報告，只推進第一輪未回答的問題。兩份都在同一目錄，按 01-、02- 順序讀，第二份是第一份的補充。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議自行查看 GitHub 倉庫 源碼與 MIT 許可證。
環境要求（來自 package.json）：Node >=22；DSH >=0.2.1-rc.1 且 <0.3.0。更早的 0.2.x 預覽版缺少 ctx.tools.restrict 與 sessionController，裝上也加載不起來。
從 DSH 插件市場安裝：搜索 dsh-deepsearch，安裝後重啓宿主（新 bundle 只在啓動時組裝）。
從命令行安裝：
dsh plugin add dsh-deepsearch # 默認裝到桌面 profile；別的 profile 加 --profile <name>
dsh plugin remove dsh-deepsearch # 卸載
若從 Git 倉庫直接安裝，README 建議把提交號釘住（github:NeptuneRY/dsh-deepsearch#<commit>），避免未釘住時隨作者推送變化。裝完後右側欄出現「深度搜索」頁籤即表示成功；若無，先確認已重啓且裝的是當前使用的 profile。
典型用法¶
面板快速開始（README 步驟）：
- 打開右側欄「深度搜索」。
- 輸入主題，輪數選 3。
- 等跑完：報告在結果卡里，可一鍵存到桌面。
- 想接着挖：在歷史裏點「再搜一輪」。
數據目錄（默認 ~/.dsh-deepsearch，Windows 爲 %USERPROFILE%\.dsh-deepsearch）：
~/.dsh-deepsearch/
config.json # 行爲參數
history.json # 面板歷史
workspace/ # 面板會話側欄工作區
reports/ # reportDir 留空時的默認報告目錄
drafts/ # 未跑完的草稿
常用配置可在面板各頁修改，例如：deepsearchSubagents（默認 3，並行子代理數）、deepsearchRounds（默認 1，面板可選 1–10）、reportDir（留空則用 <dataRoot>/reports）、deepsearchTimeoutSec（默認 1200 秒）、referencePaths / referenceEnabled（讀本地資料）。完整鍵表見倉庫 README「數據與配置」。
適用場景與注意¶
適合：需要拆多個子問題、並行檢索與交叉覈對、同一會話多輪收窄結論，且希望每輪產出帶引用、可落盤 Markdown 報告的場景。
不適合或應慎用：只查單一事實或少量鏈接（用 web_search 更快）；在深度搜索工作區內打開 deepsearchWorkspaceToolEnabled 且解除「只跑 1 輪」限制時，遞歸調用可能消耗大量時間與 tokens。
權限與安全：插件不修改 git 索引；報告由宿主寫盤。配置裏的 referencePaths 會按開關決定是否只讀本地路徑——路徑與權限仍受當前 DSH 進程約束。
生態說明：DSH 社區插件目錄（如 SkillHub 上的 NeptuneRY/dsh-deepsearch）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝來源以市場或上述官方 README 命令爲準。
結尾¶
dsh-deepsearch 把「拆題—並行子代理檢索—多輪繼承—帶引用報告落盤」收進 DSH 工作流：面板與 deepsearch 工具共用一條鏈路，歷史裏還可「再搜一輪」延續同一會話。若你已經在用 DSH 0.2.1-rc.1+ 做資料型任務，可以從市場或 dsh plugin add dsh-deepsearch 裝起，用三輪深度搜索試一個「答案不在第一頁」的主題，對照 reports/ 下逐編號的報告閱讀體驗。
- 目錄頁：https://www.skillhub.cn/plugins/NeptuneRY/dsh-deepsearch
- GitHub：https://github.com/NeptuneRY/dsh-deepsearch
