dsh-socrates：DeepSeek Harness 深度研究插件

前言¶

DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。現有的深度研究插件大多表現爲固定提示詞的流水線，缺乏對研究過程的閉環控制與結果驗證。dsh-socrates 插件通過引入蘇格拉底式的澄清機制與自適應研究邏輯，試圖解決這一問題。

插件定位¶

dsh-socrates 是 DeepSeek Harness 的深度研究插件，由 Cruciforms 維護，採用 MIT 許可證。它主打調查前澄清 + 自適應多輪研究 + 交叉驗證 + 引用閉環。與固定提示詞流水線不同，它是一個活的、可收斂的研究閉環。

核心功能¶

1. 調查前澄清¶

在開始研究前，Planner 會針對主題生成 ≤3 個澄清問題，通過 userQuestions.ask 提問給用戶。用戶確認後，研究計劃才進入執行階段。支持 planReview 意圖卡片進行計劃審批。

2. 自適應多輪研究¶

研究過程不是一次性完成，而是分輪進行。
* 並行研究：每輪中，多個 researcher（flash 模型）並行搜索、精讀並逐字摘錄入證據庫。
* 缺口驅動：每輪末尾收集高優先級缺口，若邊際增益驗證爲負，則提前停止。
* 止損機制：連續零增益、輪次硬上限、token 預算三重保險。

3. 交叉驗證¶

Verifier 對每個聲明進行聲明級三分裁決：entailed（蘊含）、contradicted（矛盾）、baseless（無依據）。若未驗證，會在報告中標記 ⚠️ UNVERIFIED。系統支持單跳回補任務與條件修訂輪。

4. 引用閉環¶

編號引用必須出自證據庫中的逐字片段（≤100 字，含段落錨點）。非原文內容會被標記爲 model_knowledge。程序化引用審計會檢查編號存在性、摘錄緊鄰格式、逐字一致性及長度上限。

5. 學術三源與源策展¶

插件內置 arXiv、PubMed、Semantic Scholar 檢索接口，無需 API Key。當 depth ≥ 2 時，會啓用 LLM 策展子代理剔除弱相關低質源。

6. 模型分層降本¶

插件支持模型分層調度：Planner、Synthesizer、Reviewer 使用 Pro 模型；Researcher 使用 Flash 模型，以降低成本。

安裝與啓用¶

使用官方命令安裝：

dsh plugin --profile web add dsh-socrates

安裝後需要重啓 DSH 進程以使插件生效。

使用方式¶

在對話中直接使用自然語言，模型會根據工具描述自動觸發研究流程。

通用調研：「深度調研一下 MCP 生態現狀，重點對比幾家主流實現，出一份帶引用的報告」
已有清單：「按這份問題清單做研究：1. … 2. …」（提供清單後，插件會跳過自動拆解，直接並行研究）
明確用途：「調研一下 A/B 方案，purpose 是決定我們選哪個」（用途越明確，答案空間越準）

對於更復雜的主題，插件會自動擴展輪次；簡單主題則一輪收斂。若需更嚴謹的輸出，可傳遞參數 depth: 3；若要開啓引用糾錯和覆蓋度審計，可傳遞 review: true。

參數說明¶

參數	必填	默認	說明
`topic`	是	—	研究主題
`purpose`	否	—	研究用途，用於定義答案空間
`questions`	否	—	已有問題清單（每行一個）
`depth`	否	`2`	精度等級：1=初步（3 子問題/2 輪），2=深入（4 子問題/3 輪），3=窮盡（6 子問題/4 輪）
`synthesize`	否	`true`	是否生成最終綜合報告
`verify`	否	`true`	是否啓用交叉驗證
`review`	否	`false`	是否啓用對抗性審查（引用糾錯、覆蓋度審計）
`clarify`	否	`true`	是否在調查前進行澄清提問
`planReview`	否	`false`	是否在研究前進行計劃審批

輸出與架構¶

輸出目錄¶

每次研究的證據與報告落盤在宿主側。默認路徑爲插件安裝目錄下的 runs/<topic-slug>/。

輸出文件¶

evidence.jsonl：逐字摘錄證據庫，包含 URL、段落錨點、質量分級。
report.md：帶編號引用的最終報告。
state.json：運行狀態、覆蓋度、驗證統計。
review.md：審查意見（review=true 時生成）。

架構設計¶

插件通過 index.js 作爲薄殼，調用 DSH 官方 workflow 引擎進行編排。
* 編排：使用 ctx.workflows，支持併發控制與取消傳播。
* 搜索/抓取：直接調用 DSH 內置的 web_search / web_fetch，插件本身不包含網絡邏輯或自研編排。
* 證據存儲：由宿主的 src/evidence-store.js 管理，workflow 腳本無直接文件系統訪問權限。

與同類插件對比¶

功能	dsh-socrates	dsh-deepresearch	dsh-raven-research	dsh-research-report
核心差異	蘇格拉底式澄清 + 自適應閉環 + 驗證 + 引用審計	證據管理 + Web 工作區	中途 steer 糾偏	內容尋址證據賬本 + 密封報告
多輪編排	✅ 自適應閉環	❌ 不自調度搜索	❌ 單 Task 漸進	❌ 無研究閉環
交叉驗證	✅ 聲明級三分裁決 + 回補	❌	❌	✅ 驗證裁決
引用審計	✅ 程序化（逐字一致性）	❌	✅ 字節比對	❌
學術檢索	✅ arXiv / PubMed / S2	❌	❌	❌
模型分層	✅ Pro/Flash 自動分層	❌	❌	❌

其他信息¶

曾用名：項目原名爲 dsh-deep-research。爲避免與 GitHub 上 dsh-external/dsh-deep-research 同名倉庫混淆，於 2026-08 更名爲 dsh-socrates。
依賴：需要 @deepseek-ai/dsh-tools (v0.1.0-rc.6+)。

插件源碼與文檔可在 GitHub 查看。