在 DeepSeek Harness (DSH) 中，當你在「模型」頁手工添加第三方提供方時，系統默認不會聲明 reasoningEfforts（推理檔位）與 input（圖片輸入）能力。這導致對話界面無法顯示 Effort 選擇器，或者無法上傳圖片。dsh-plugin-effort-declare 插件用於解決這一問題，它通過在設置中增加「推理檔位」頁面，向官方 llm-pi-ai 命名空間寫入這兩項能力。聲明之後，對話輸入框纔會出現 Effort 行，並允許附加圖片；未聲明則按純文本模型處理。
這是什麼¶
這是一個社區維護的 DSH 插件，由 zimodzh 開發，遵循 MIT 許可證。它不修改 API 密鑰、端點或模型名單，也不替換官方的「模型」頁或攔截流。它僅作用於在「模型」頁手工添加、協議爲 OpenAI Completions 的提供方，幫助開發者手動聲明模型的能力邊界。
核心功能¶
該插件主要提供以下能力：
- 推理檔位：按模型勾選可選檔位；若網關對檔位的拼寫要求不同，可在此修改線上名稱。
- 圖片輸入：按模型聲明是否接受圖片。勾選時寫入
input: ['text', 'image']，取消則刪除該鍵。 - 預設：提供 DeepSeek 兼容、OpenAI 兼容等協議方言預設，用於替換當前協議，而非疊加。
- 版本頁腳：頁面底部顯示打包時寫入的插件版本與版權年份。
安裝與啓用¶
該插件要求 DeepSeek Harness 0.1.2-alpha.2 及以上版本。在終端執行以下命令安裝：
dsh plugin --profile web add dsh-plugin-effort-declare
若使用第三方發行的 DSH，必須先設置 DSH_HOME 環境變量，否則包可能被安裝到錯誤目錄。安裝完成後，重啓 DSH 並進入 設置 → 推理檔位 頁面。頁面底部會顯示當前安裝的版本。
典型用法¶
- 打開模型卡片：在「模型」頁找到需要配置的第三方提供方。
- 配置推理檔位：勾選應出現在選擇器中的推理檔。若需關閉思考（Off），可配置爲不提供、提供但不發送參數，或發送
none等字符串。 - 配置圖片輸入：若該模型確實支持視覺，勾選 支持圖片輸入。僅勾選此項也可獨立保存。
- 保存設置：點擊保存。若未選擇任何思考檔或只開啓 Off，錯誤會顯示在該卡片上。
- 處理清除：點擊「清除本模型聲明」只會移除
reasoningEfforts，圖片輸入的聲明需單獨取消勾選。
適用場景與注意¶
- 適用範圍：僅適用於在「模型」頁手工添加、協議爲 OpenAI Completions 的提供方。
- 排除項：官方 DeepSeek、目錄自帶模型、Anthropic 接口不在本頁編輯。
- 權限安全：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 限制：設置爲只讀時無法保存；不會爲標題生成或後臺請求默認打開思考；不會爲整條路由自動打開圖片輸入。
