DeepSeek Harness (DSH) 插件：dsh-research-autoresearch

前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。對於需要構建科研工作流的開發者而言，如何將文獻檢索、評分、評審和狀態管理標準化，是一個常見需求。dsh-research-autoresearch 是該協議的 DSH 工具化實現，旨在爲智能體提供一個閉環的科研處理流程。

插件概覽¶

該插件由 yuan-source-666 維護，是一個單 bundle 發佈的 AutoResearch 全家桶。它採用 MIT 許可證。核心價值在於將 AutoResearch 框架協議轉化爲可插拔的 DSH 工具集。

核心功能¶

插件包含以下六個主要工具：

1. arxiv_search：文獻 Recall。支持 arXiv 檢索與去重。
2. lit_score：LQS 五維評分分桶。
3. research_state：研究狀態/進度面板。包含 7 種操作。
4. stall_check：停滯檢測。提供 pivot/escalate/cap 紅綠燈機制。
5. peer_review：五人格中位數評審。
6. research_ui_switch：可視化總控臺。支持運行時開關。

設計理念¶

該插件的設計靈感源自 Deli Chen 的 AutoResearch 框架協議，特別是其關於評審機制和停滯檢測的實證研究：
* 評審機制：採用 MEDIAN 而非均值，防止單人格抬分。
* 誠實降分：保留 scoreDropped 字段，用於記錄外部引用覈查後的主動降分。
* 停滯檢測：遵循 “pivot structure, not tactics” 原則，設置 15 輪 / 30 分鐘雙上限。

安裝與啓用¶

安裝方式如下：

方式一（git 安裝）：

dsh plugin --profile web add github:<your-github-user>/dsh-research-autoresearch

方式二（預構建 tarball）：
先構建並打包：

npm run build && npm pack

然後安裝：

dsh plugin --profile web add ./dsh-research-autoresearch-0.3.1.tgz

安裝後，可在 profile 的 cordis.patch.yml 中添加配置以停用插件，或在 Web 設置頁的「插件配置」中通過科研可視化總控臺卡片進行控制。

可視化控制¶

插件提供三級可視化控制，以避免功能不可見：
1. 套件級：通過 config.enabled=false 禁用整個 bundle。
2. 部署級：通過 *Cards 聲明式注入進度卡片（默認關閉）。
3. 會話級：通過命令 research_ui_switch {feature, action: on|off|reset} 或設置 defaultCards 進行即時開關。

版本更新與修復¶

插件在 0.3.0 和 0.4.0 版本中針對科研流程中的常見缺陷進行了修復：

• v0.4.0 編排層補全：修復了註冊缺失導致的“裝着但沒生效”問題。新增了 autoresearch runtime skill，確保模型能正確調用工具。修復了 6 個工具被調用 0 次的 Bug。
• v0.3.0 文獻驅動升級：
  • 引用窗口校正：針對 <400 天的新論文，當引用數爲 0 時，使用其餘分量均值插補，並標記 citationEmergingImputed。
  • 評審不確定性帶：新增 judgeDisagreement（極差）與 scoreBand（MAD 穩健區間）。分歧 ≥4 的面板不能再直接 accept。
  • 構建自含化：所有源碼打包，確保獨立構建。

測試成果¶

插件經過多輪測試，結果如下：
* 宿主半冒煙：11 項斷言通過。
* 瀏覽器半回放：9/9 通過。
* 安裝態穩定性：16/16 通過。
* 冷啓動穩定性：3/3 通過（HTTP 200，3-7s）。
* 真實網絡往返：arXiv ≈1.0–1.3s；S2 ≈2.9–16.5s。
* 類型檢查：0 診斷。
* 端到端模擬：133/133 通過。

依賴項¶

插件依賴以下 DSH 核心庫：
* @deepseek-ai/cordis
* @deepseek-ai/dsh-settings
* @deepseek-ai/dsh-tools
* @deepseek-ai/schemastery

生成物位於 lib/client.js，不建議手動修改。

總結¶

該插件爲 DSH 提供了一套標準化的科研處理流程，涵蓋了從文獻召回、評分、評審到狀態管理的全鏈路。對於需要構建科研類智能體的開發者，這是一個可直接落地的工具集。

GitHub 倉庫
社區目錄