dsh-model-probe：DeepSeek Harness 模型能力聲明審計插件

前言¶

在 DeepSeek Harness (DSH) 中配置模型能力（如 maxTokens、contextWindow）時，如果聲明值超過端點實際限制，或者聲明值錯誤，往往不會報錯，而是導致請求靜默失敗（如 HTTP 400）。dsh-model-probe 插件通過直接探測端點行爲，修正這些聲明錯誤。

插件簡介¶

該插件由用戶 xiaomao49 維護，是一個 DeepSeek Harness 插件。它通過向端點發送探測請求，測量模型實際接受的能力範圍，並與本地聲明的配置進行比對，僅重寫證據證明錯誤的字段。

核心功能¶

實測與修正：不依賴靜態知識庫，而是直接測量端點實際接受的內容。
審計現有值：與只填充缺失值的插件不同，它會檢查字段是否已有值，並驗證這些值是否正確。
檢查範圍：支持檢查 contextWindow、maxTokens、reasoningEfforts、input（圖像支持）四個字段。
雙協議支持：支持 openai-completions 和 anthropic-messages 兩種協議。
自包含：純 JavaScript 實現，無構建步驟，無運行時依賴。

安裝與啓用¶

安裝前需確認 DSH 實際啓動的 Profile 名稱。如果安裝到錯誤的 Profile，插件不會被加載。

確認 Profile 名稱：
- DSH Desktop: 檢查 profile-selection/state.json 中的 active 字段（通常是 "desktop"）。
- CLI / Web: 使用 dsh --profile <name> 指定的名稱（默認爲 web）。
安裝插件：

    dsh plugin --profile web add dsh-model-probe

驗證安裝：

    dsh --profile web --dump-config | grep model-probe

輸出中包含 `id: model-probe` 表示已生效。

重啓：需完全退出並重啓 DSH 以完成熱掛載。

典型用法¶

通過設置頁面¶

在 DSH 界面中進入設置 -> 模型配置實測。

爲對應的 Provider 開啓 允許探測。
執行掃描或確認應用修改。

通過 Agent Tools¶

在 Agent 場景下，可以使用以下工具：

model_probe_status：查看探測狀態。
model_probe_scan：執行掃描。
model_probe_apply：應用修正。

注意事項¶

Profile 限制：必須安裝到 DSH 實際啓動的 Profile（如 DSH Desktop 的 desktop），否則不會生效。
重啓要求：配置生效需要完全重啓 DSH。
舊版本兼容性：0.1.2 及更早版本存在 Peer Dependency 警告（信息性，不影響運行），且在所有請求失敗時無法正確報告錯誤，建議使用最新版本。

總結¶

dsh-model-probe 解決了模型聲明能力與實際端點不一致導致的靜默失敗問題，特別適合需要精準控制模型上下文和 Token 限制的場景。插件通過自包含的純 JS 實現，提供了設置頁和 Agent 工具兩種使用方式。

目錄頁
 GitHub 倉庫