前言¶

在 DeepSeek Harness（DSH）裏使用第三方或自定義模型時，一個常見情況是：模型已經在 llm-pi-ai 中可用，但沒有 reasoningEfforts，模型選擇器裏看不到思考檔位。

dsh-models-dev-reasoning 插件用來處理這個問題：它從 models.dev 補齊尚未設置思考檔位的模型，不覆蓋已有配置。

這是什麼¶

dsh-models-dev-reasoning 由 aerince 維護，許可證爲 MIT。

它爲 DeepSeek Harness 中尚未設置 reasoningEfforts 的第三方或自定義模型添加 models.dev 推理檔位，使 llm-pi-ai 的模型選擇器能顯示思考檔位。

核心功能¶

• 從 models.dev 補齊 DSH 中第三方或自定義模型的思考檔位。
• 讓 llm-pi-ai 的模型選擇器顯示 reasoningEfforts。
• 只處理尚未設置 reasoningEfforts 的模型；已有配置不會覆蓋。
• models.dev 的 none 會映射爲 DSH 的 off。
• 讀取 https://models.dev/api.json；失敗時回退到 models.dev 的 GitHub dev tarball。
• 將目錄緩存到系統臨時目錄，有效期 24 小時。

工作方式¶

插件啓用後，DSH 啓動時會按下面步驟處理：

1、等待 settings 可用。

2、讀取 https://models.dev/api.json。

3、如果讀取失敗，回退到 models.dev 的 GitHub dev tarball。

4、匹配 llm-pi-ai 下的模型，並補寫缺失的推理檔位。

5、把目錄緩存到系統臨時目錄，有效期 24 小時。

該插件沒有插件配置項，也沒有 prepare 安裝腳本。

安裝與啓用¶

安裝前需要可用的 dsh、pnpm 和 git。

本包要求 Node.js 版本滿足：

node ^22.19.0 || >=24.0.0

它是零構建 JavaScript，不需要爲它添加 pnpm allowBuilds。

下面使用 web profile 安裝：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning

如果你需要固定版本安裝：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#v0.1.0

如果你需要固定 commit 安裝：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#0893e91cbe7bdc684eaf1ed52767b8ca3289c751

安裝後重啓 DSH。

DSH 會把插件寫入 $DSH_HOME/profiles/<profile>；請確認 CLI 與 Desktop 使用的是同一個 DSH home。

驗證與卸載¶

安裝後先查看配置：

dsh --profile web --dump-config

配置樹中應出現 models-dev-reasoning。

再打開一個此前沒有 reasoningEfforts 的第三方或自定義模型，檢查模型選擇器是否出現思考檔位；已有 reasoningEfforts 的模型應保持不變。

如果不需要這個插件，可以移除：

dsh plugin --profile web remove dsh-models-dev-reasoning

適用場景與注意¶

適合使用 DSH 管理第三方或自定義模型、並且希望統一顯示思考檔位的人。

使用時注意：

• 插件只會寫入 llm-pi-ai 下缺失的 reasoningEfforts，不會覆蓋已有配置。
• 插件會訪問 models.dev 和 GitHub 回退地址。
• 插件會在系統臨時目錄寫入可選緩存；緩存寫失敗不會阻止插件運行。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

獲取¶

• GitHub：dsh-models-dev-reasoning
• 插件目錄：可按插件名 dsh-models-dev-reasoning 在 DSH 插件目錄中查找