dsh-model-reasoning：爲非官方模型自動填充推理與上下文參數

前言¶

在 DeepSeek Harness（DSH）的生態中，開發者常需配置非官方或自定義的模型提供方。這些提供方往往缺少推理級別、上下文窗口、輸出上限以及圖片模態等關鍵參數。手動配置不僅繁瑣，還容易出錯。

插件介紹¶

dsh-model-reasoning 是一個由 TikaFlow 維護的 DSH 插件。它通過讀取 models.dev 的數據，自動爲非官方提供方的模型填充推理級別、最大上下文、輸出上限與圖片模態，解決了配置缺失的問題。

核心功能¶

1. 自動參數填充
   自動填充缺失的推理級別（reasoningEfforts）、最大上下文（contextWindow）、輸出上限（maxTokens）與圖片模態（input）。
2. 路由級兼容性配置
   默認爲所有 api: openai-completions 的提供方寫入路由級兼容性配置，禁用 developer 角色（compat.supportsDeveloperRole: false）。
3. 提供方排除
   支持通過列表排除特定提供方，對它們完全跳過填充與更新操作。
4. 離線支持
   內置緩存支持，插件啓動時即可離線使用。

安裝與啓用¶

通過命令行安裝：

dsh plugin --profile web add github:TikaFlow/dsh-model-fix

安裝後進入 DSH，插件即自動生效，無需額外操作。

典型用法¶

自動生效¶

插件啓動時利用內置緩存自動填充模型參數。隨後會自動保持數據最新。

手動調整¶

進入 Web 設置 →「模型」→ 頁面底部調整參數，或手動編輯 settings.yaml 中的 tikaflow-model-fix 配置段。

排除特定提供方¶

在配置中列出不想被插件接管的提供方 ID。

適用場景與注意¶

本插件適用於需要快速配置非官方模型提供方的場景。使用時需注意宿主版本依賴（DSH 0.1.2-rc.1）。

注意事項¶

• 數據源爲 models.dev。
• 依賴 DSH 宿主版本 0.1.2-rc.1。
• 啓動時已填充的模型參數會自動恢復備份（重啓即重建）。
• 本插件已被 awesome-dsh-plugin 收錄。

總結¶

該插件通過自動化參數填充和兼容性配置，降低了非官方模型接入的門檻。

插件目錄
GitHub 倉庫