前言¶
DeepSeek Harness (DSH) 在展示模型推理（思考）級別控制時，要求模型具備 reasoning 或 reasoningEfforts 能力聲明。官方內置的模型列表已包含這些聲明，因此使用官方提供商時無需額外配置。
對於通過自定義網關或中轉（如 pptoken、one-api、LiteLLM）使用的模型，其 ID 往往不在 DSH 的內置目錄中。當目錄不包含描述時，DSH 默認不顯示推理級別選擇器。本插件通過在 settings.yaml 中寫入缺失的聲明，讓這些自定義網關模型也能被選擇推理強度。
核心功能¶
該插件爲 GPT、Codex、Gemini 和 OpenAI 兼容模型聲明推理級別，主要能力如下：
- 聲明推理級別：支持
off、minimal、low、medium、high、xhigh六個級別。 - 寫入配置映射：將推理級別映射寫入
settings.yaml中的reasoningEfforts字段，供主機 (dsh-llm-pi-ai) 轉換使用。 - 圖像模型標記：將
gpt-image-*開頭的圖像模型標記爲非推理模型 (reasoningEfforts: false)。 - Gemini 特殊處理：爲
gemini-*模型添加特定映射。 - 通用模型支持：支持
gpt-*、codex-*、claude-*等通用模型 ID 及任意自定義 ID。 - 設置說明區：在設置中添加 “Reasoning adapter” 區域，說明映射關係（目前爲信息展示）。
- 輔助腳本：提供 PowerShell 腳本用於批量啓用或禁用聲明。
安裝與啓用¶
插件通過 DSH 的插件系統安裝。安裝後不會自動修改配置，需手動運行輔助腳本。
- 安裝插件
從 npm 安裝：
dsh plugin add dsh-more-models-thinking-level
或從 GitHub 倉庫安裝：
dsh plugin add https://github.com/Henta111/dsh-more-models-thinking-level
- 啓用功能
安裝完成後，必須手動運行輔助腳本來寫入settings.yaml。以下命令默認針對desktop配置文件：
powershell -ExecutionPolicy Bypass -File "$HOME\.dsh\profiles\desktop\node_modules\dsh-more-models-thinking-level\enable-capabilities.ps1"
運行腳本後，需重啓 DSH 使配置生效。
工作原理¶
插件不會修改 DSH 核心文件，也不在運行時攔截請求。其核心作用是充當“安裝器”和“說明文檔”：
- 聲明能力：通過輔助腳本將
reasoningEfforts映射寫入settings.yaml。主機檢測到該聲明後，會在界面上渲染推理級別選擇器。 - 邏輯轉換：主機 (
dsh-llm-pi-ai) 負責將用戶選擇的邏輯級別轉換爲網關原生參數。 - 入口點：插件主入口 (
lib/index.js) 的apply方法僅記錄日誌，不執行實際的參數轉換邏輯。
注意事項與限制¶
安裝前請閱讀以下限制，部分限制可能影響使用效果：
- 市場列表不可見：由於相關 PR 尚未合併，該插件不會出現在
dsh plugin search結果中，需通過名稱或 URL 安裝。 - 非自動執行：安裝或啓用插件不會自動運行輔助腳本，必須手動執行。
- 手動清理：輔助腳本會持久編輯
settings.yaml。如果卸載插件或不再需要，需手動清理腳本注入的配置項。 - 能力猜測：輔助腳本通過正則表達式從模型 ID 猜測能力。如果中轉暴露了非推理模型（如嵌入模型或純視覺模型）的 ID，它們仍會被標記爲推理模型，可能導致網關拒絕請求。
- 網關依賴：聲明僅讓級別“可選”，網關是否實際接受
reasoning參數由網關決定。嚴格的網關可能會拒絕未在 Schema 中定義的字段（如input[x].status）。 - 系統限制：輔助腳本僅支持 Windows PowerShell 和
desktop配置文件，其他系統或配置文件需手動適配。 - 設置界面僅爲信息：界面中的 “Reasoning adapter” 部分僅用於展示映射說明，不具備編輯器功能，無法在界面上微調。
結語¶
該插件解決了自定義網關模型在 DSH 中無法選擇推理級別的問題。它通過寫入配置文件的方式實現功能，適合需要精細控制推理強度的開發者。請確保瞭解網關對參數的限制後再啓用。
