在管理多個 OpenAI 兼容模型提供方時,調整默認模型和過濾模型列表往往需要多次點擊和配置。在 Composer 模型選擇器和 /model 命令中保持會話一致性容易出錯,且在 Web 搜索中強制使用特定的 OpenAI Responses 模型通常需要手動配置。sharewiner/dsh-model-management 旨在通過集中管理提供方、模型和可見性,解決這些繁瑣的重複操作。
這是一個 DSH Web profile 插件,用於管理 OpenAI 兼容的模型提供方,設置默認模型,控制模型可見性,並可選地將 Web 搜索路由到選定的 OpenAI Responses 提供方。該插件由 sharewiner 維護,使用 MIT 許可證。
核心功能¶
- 集中設置入口:在 DSH 設置中添加
模型管理部分。 - 全局模型概覽:列出 DSH 當前註冊的所有模型,按提供方分組顯示。
- 路由控制:設置默認提供方、默認模型以及支持的推理努力。
- 可見性管理:隱藏單個模型,使其不出現在 Composer 模型選擇器和
/model命令中;或關閉整個提供方,移除該提供方的所有模型。 - 會話保護:保持當前選定的模型可見,直到用戶主動切換,防止會話丟失當前路由。
- Web 搜索路由:註冊
model-management-openai-responses,這是一個使用活動默認 OpenAI Responses 模型、基礎 URL 和憑據引用的 Web 搜索提供方。
安裝與啓用¶
該插件需要 DSH Web profile 環境以及 Node.js 22.19 或更高版本。
在終端中執行以下命令安裝指定版本:
dsh plugin --profile web add @sharewiner/dsh-model-management@0.2.3
安裝完成後,需要重啓 DSH Desktop 或刷新 Web profile 以加載插件。
典型用法¶
- 打開 DSH 設置並選擇 模型管理。
- 在 DSH 的原生 模型 設置頁面中,添加 OpenAI 兼容提供方及其模型。
- 從 模型管理 中選擇默認模型。
- 使用 隱藏 從 Composer 模型選擇器和
/model列表中移除單個模型。 - 使用 關閉提供方 從這些列表中移除提供方的所有模型。
- 使用 顯示 或 開啓提供方 恢復它們。
- 如果你想讓 Web 搜索自動跟隨當前默認模型,請配置 DSH 的 Web 服務以使用該提供方。
適用場景與注意¶
- 早期訪問狀態:儘管 npm 版本 0.2.3 使用穩定語義化版本,但該項目仍處於早期訪問階段。
- 兼容性檢查:插件使用一個兼容層來訪問 DSH 的客戶端
modelDirectories服務,因爲 DSH 尚未公開模型目錄過濾 API。在每次 DeepSeek Harness 升級後,建議驗證 Composer 模型選擇器和/model命令的功能是否正常。 - 安全機制:插件僅在執行 OpenAI Responses Web 搜索請求時,才通過 DSH 的憑據服務或啓動環境讀取提供方憑據。它不會將 API 密鑰、令牌或端點密鑰存儲在插件源代碼或模型管理設置中。
- 依賴要求:需要安裝兼容的宿主包(peer dependencies)。
結語¶
該插件爲 DSH 用戶提供了更精細的模型控制能力,通過統一管理提供方和默認路由,簡化了多模型環境下的操作流程。如果你正在尋找更高效的方式來管理 DSH 的模型生態,可以訪問插件目錄或 GitHub 倉庫查看源碼。