DeepSeek Harness (DSH) 通過插件機制擴展功能。對於需要結構化工作流和特定工具的研究場景，dsh-researchcraft 提供了一個現成的配置方案。它將 ResearchCraft 的科學技能集、活體實驗室筆記本和專業子智能體集成到 DSH 的 Web UI 和 Agent 中。
插件概覽¶
- 名稱：dsh-researchcraft
- 定位：工作流
- 維護者：raktim-mondol
- 許可證：MIT
安裝與啓用¶
在安裝此插件前，需確保已正確安裝並運行 DeepSeek Harness CLI (dsh)。
安裝命令¶
執行以下命令添加插件，這會創建 researchcraft 配置文件（如果不存在）：
dsh plugin --profile researchcraft add github:raktim-mondol/dsh-researchcraft
更新與本地安裝¶
若需更新到最新版本：
dsh plugin --profile researchcraft update dsh-researchcraft
若用於本地開發或調試，可直接添加本地路徑：
dsh plugin --profile researchcraft add /path/to/dsh-plugin
配置文件要求¶
在配置 researchcraft profile 時，必須確保 @deepseek-ai/dsh-web-app 列於 dsh-researchcraft 之前。
核心功能¶
該插件主要提供以下能力：
-
ResearchCraft Agent 預設
包含特定的人格設定、研究系統提示詞以及連接器配置。該預設集成了學術搜索、PaperMemory 和語義搜索等功能，但需在聊天中顯式選擇。 -
科學技能目錄
集成了多個開源技能庫：- 領域與方法論：140 個領域技能（化學、基因組學等）和 16 個研究方法論技能。
- 職業特定技能：503 個職業特定技能（加速器物理學家、動物學家、精算師等）。
- 專業技能：包含藥物發現、數據科學管道、超參數優化、科學制圖等特定技能。
-
工具集
提供以下工具：image_generate：生成科學概念圖。sci_inspect：科學文件格式檢查（化學、結構、質譜等）。latex_compile：編譯 LaTeX 文件生成 PDF。pdf_to_markdown：將 PDF 轉換爲 Markdown。modal_run/runpod_run：遠程 GPU/CPU 計算任務提交。workflows：工作流管理。
-
MCP 連接器
包含parallel_search（並行搜索）、consensus_search（共識搜索）和papermemory（文獻記憶）。 -
活體實驗室筆記本
提供筆記本工具，用於記錄、讀取和導出 JSONL 格式的實驗日誌，支持 Markdown 和 Zip 打包導出。
運行與使用¶
啓動插件提供的 Web UI：
dsh --profile researchcraft
或使用共享啓動器：
dsh-researchcraft
通常會在 http://127.0.0.1:3080 打開界面。
預設選擇¶
安裝插件後，Agent 預設選擇器中會出現“ResearchCraft”選項，但該選項不會替換默認預設（如“Standard mode”或“PTC mode”）。新建會話時默認仍爲舊預設，需手動切換：
- 開始新會話。
- 點擊消息框頂部的預設選擇器。
- 選擇 ResearchCraft。
注意事項¶
- 單界面限制
dsh-web、dsh-tui、dsh-martty和dsh-researchcraft共享$DSH_HOME，包括端口 3080 和zvec-grep守護進程。一次只能運行一個 DSH 界面。若端口被佔用，請先檢查：
ss -ltnp | grep 3080
-
後臺進程清理
直接使用Ctrl+C結束進程時，後臺守護進程可能未完全退出。再次啓動前建議運行zg server off停止守護進程，或使用共享啓動器scripts/dsh-launch。 -
全局默認值清除
切換到其他 profile（如dsh-tui）會清除全局settings.yaml中保存的researchcraft默認值。若後續切回dsh-tui並使用該全局默認值，因dsh-tui未安裝該插件，會導致 Agent 啓動失敗。
結語¶
dsh-researchcraft 爲 DeepSeek Harness 用戶提供了完整的科研工作流基礎設施。通過集成的技能庫、MCP 連接器和筆記本工具，可以在 DSH 環境中快速搭建專業的研究環境。
