前言¶
DeepSeek Harness（DSH）在 0.2.0-rc.2 引入了推理強度選擇器，但該功能默認僅對內置的 DeepSeek 模型生效。通過 llm-pi-ai 配置的第三方網關模型（如 OpenCode Go、GOAT、Volcengine Ark 等）無法在界面上選擇推理檔位。此外，OpenCode Go 網關嚴格要求在 HTTP 請求頭中攜帶 x-opencode-session，否則會返回 400: MissingSessionID 錯誤。
這是什麼¶
dsh-reasoning-options 是一個 DeepSeek Harness 插件，由用戶 Scorp1o117 維護。它通過掃描 llm-pi-ai 命名空間，爲未聲明推理檔位的模型自動補全推理強度選擇器，並自動爲 OpenCode Go 提供商注入必需的路由請求頭。
核心功能¶
- 自動補齊推理檔位：爲所有 pi-ai 模型添加推理強度選擇器，支持從 off 到 max 七個檔位。
- 自動注入路由頭：檢測 OpenCode Go 網關，自動注入
x-opencode-session請求頭。 - 原生集成：寫入通過 DSH 的原生 settings API 進行，直接持久化到 Profile patch。
- 冪等與序列化：操作是冪等的，序列化執行，避免文件鎖衝突。
安裝與啓用¶
通過命令行安裝到 Web 配置文件：
dsh plugin --profile web add dsh-reasoning-options
安裝後，在 DSH 界面中進入 Plugins -> Installed -> dsh-reasoning-options 進行配置。
典型用法¶
插件提供配置頁面，主要包含以下設置：
* enabled：控制是否自動補齊配置，默認爲 true。
* autoSessionHeader：控制是否自動注入 OpenCode Session 頭，默認爲 true。
* sessionHeaderValue：注入的 Session 值，默認爲 'dsh-session'。
* pollIntervalMs：兜底輪詢掃描間隔，默認爲 30000 毫秒。
適用場景與注意¶
- 適用場景：正在使用
llm-pi-ai配置第三方網關，需要統一管理推理檔位，或者正在使用 OpenCode Go 需要自動處理 Session 頭的用戶。 - 權限說明：插件通過 DSH 進程權限讀取和修改
llm-pi-ai命名空間，安裝前建議檢查源碼與許可證。 - 配置機制：插件採用數組全量替換機制，每次寫入會重寫完整的模型列表。手動編輯
cordis.patch.yml後，無需重啓 dsh，等待下一次輪詢即可生效。 - 兼容性：需要 DSH 0.2.0-rc.2 及更高版本。
結尾¶
該插件解決了第三方網關在 DSH 中的配置缺失問題，通過原生接口確保了配置的持久化和熱加載。更多詳情與源碼請參考下方鏈接。
- 目錄頁: SkillHub 目錄
- GitHub: Scorp1o117/dsh-reasoning-options
