前言¶
DeepSeek Harness (DSH) 側重於插件化架構,但部分模型的高級功能(如推理思考等級、輸入模態切換)在官方 UI 中並不完整,或者缺乏精細的控制入口。dsh-model-think-level 插件旨在補齊這一缺口,通過注入控件和接管路由配置,讓用戶能更直接地管理模型的高級屬性。
插件簡介¶
這是一個 DSH 插件,由開發者 GaoHu1997 維護,開源協議爲 MIT(v1.1.7)。它主要解決的是在官方 Models 頁面和輸入框中,缺少對“思考”能力(Reasoning)的統一開關與強度調節,以及供應商與模型選擇不夠直觀的問題。
核心功能¶
該插件提供了以下核心能力:
-
Models 頁面增強
在官方 Models 頁的每個模型行注入 Thinking 開關和強度/模態編輯器。插件會隱藏官方自帶的“推理等級”編輯區,避免在同一個字段上出現重複控件。 -
輸入框菜單增強
在輸入框的模型菜單中,增加供應商選擇器、視覺徽章與等級行。同時支持搜索、拖拽排序以及供應商啓用/禁用開關。 -
請求頭接管
支持按路由接管請求頭與 user-agent,以適配特定的下游服務。
長緩存保留配置詳解¶
在供應商卡片的「高級配置」中,請求頭下方有一節獨立的「其他配置」。其中的「長緩存保留」開關控制 compat.supportsLongCacheRetention。
- 顯示條件:該開關僅在以下協議中顯示:
openai-completions、openai-responses、azure-openai-responses、openai-codex-responses、anthropic-messages。其他協議會直接說明不支持。 - 生效時機:新建供應商卡片時,由於還沒有真實路由可寫,該節不會顯示。
- 操作方式:寫入是立即生效的,無需重啓 DSH。
- 作用機制:該開關控制是否發送 OpenAI 的緩存字段(
prompt_cache_key與prompt_cache_retention)。- 關閉:寫入
compat.supportsLongCacheRetention: false,不再發送緩存字段。 - 打開:刪除該鍵(
unset),跟隨適配器默認值。如果下層配置(如cordis.patch.yml)同樣固定了該鍵,顯式寫入true才能覆蓋。
- 關閉:寫入
- 注意:該開關僅控制
prompt_cache_key這一個字段,不會覆蓋compat裏其他開關(如supportsDeveloperRole)。
兼容字段與配置調整¶
插件不再提供 thinkingTokenBudgetField、vllmPriority、supportsMaxOutputTokens 的專用編輯控件。這些值仍由 DSH 的 pi-ai 適配器使用。在修改模型的思考檔位或輸入模態時,插件會保留這些值和其他手動兼容配置,避免覆蓋供應商的定製行爲。
若需手動調整這些舊值,需編輯配置文件:
- 備份當前 profile 的
cordis.patch.yml(位於 DSH 數據目錄的profiles/<profile>/)。 - 找到
llm-pi-ai對應的供應商和模型行,在compat字段下進行修改或刪除:thinkingTokenBudgetField:令牌預算的請求字段名(如thinking_token_budget)。刪除後使用默認字段。vllmPriority:刪除後不再發送定製的 vLLM 優先級。supportsMaxOutputTokens:刪除後恢復適配器默認行爲。
適用場景與注意¶
該插件適合需要精細控制模型“思考”能力、視覺模式以及處理特定中轉站兼容性問題的 DSH 用戶。
- 安全提示:該插件以 DSH 進程權限運行,安裝前建議檢查源碼與許可證。
- 數據安全:不要刪除包含 API key 的配置文件。
- 安裝方式:插件未提供單一的安裝命令,通常通過 DSH 的目錄安裝或 GitHub 源安裝。
結尾¶
dsh-model-think-level 通過補齊官方 UI 的缺失項,簡化了 DeepSeek Harness 中複雜模型的高級配置流程。更多細節與源碼,請參考 GitHub 倉庫。