前言¶
DeepSeek Harness (DSH) 中的 DSV4.1 模型有時能在最小模式下解決問題，但在全智能體的工具和項目上下文中會遺漏條件。dsh-reasoning-support 插件旨在填補這一差距，通過精簡的分析流程、多模態上下文支持以及有限的接受/修復循環，在保留全智能體工具鏈的同時，儘可能接近最小模式的推理效果。
核心功能¶
該插件提供以下核心能力：
- 精簡分析管道：在最終響應前，增加預分析和評審階段，通過額外的模型調用來校驗結果。
- 多模態上下文支持：支持圖片和附件進入輔助管道，用於截圖驅動的創建和工程任務。
- 自適應工具上下文：默認限制工具列表，僅保留原生工具和按需發現的工具，防止工具過多幹擾推理。
- 有界的接受與修復：設置修復和證據收集的輪次上限，防止無限循環。
安裝與啓用¶
安裝前請確保環境滿足以下要求：
* Node.js >= 24
* DSH 版本 0.1.7-rc.2 至 0.2.0（0.3.1 使用新的聲明式預設 API）
執行以下命令安裝插件：
dsh plugin --profile web add dsh-reasoning-support
安裝後需重啓 DSH 以使新插件生效。在新建會話時選擇 Reasoning Support 預設。
若希望將其設爲新會話的默認預設，可在 agent-preset-registry 設置條目中添加：
selectedDefault: reasoning-support
配置與典型用法¶
使用該插件前，需在 DSV4.1 模型配置中聲明圖片輸入支持。以 llm-pi-ai 爲例，需在現有條目中增加 input 字段：
input: [text, image]
該插件適用於日常問答、截圖驅動的創建任務，以及需要處理文檔或源文件的工程任務。
限制與注意事項¶
插件在運行過程中存在以下限制：
- 修復輪次：最多允許 2 輪修復/證據收集，隨後必須進入評審階段。
- 輔助調用限制：單個輔助調用超時時間爲 150 秒。一旦報告的輔助使用達到 2，將不再啓動新的輔助調用。
- 圖片數量：每個輔助請求最多支持 16 張圖片。
- 文件處理：掃描的 PDF 需要頁面圖片或 OCR 處理才能被驗證。默認支持讀取 UTF-8 編碼的文本文件，大小限制爲 2 MiB。
- 工具發現：按需發現工具時，每次
tool_search最多返回 5 個結果；保留最近 12 個額外工具（配置範圍 5-100）。
生態背景¶
DeepSeek Harness 的一切皆插件。dsh-reasoning-support 是一個 DSH profile bundle，安裝後無需手動放置配置文件，插件會自動加載。更多細節可查看 GitHub 倉庫 或 社區目錄。
