前言¶
DeepSeek Harness (DSH) 的插件化架構允許用戶擴展原生功能。默認的模型選擇器在處理大量服務商和模型時，界面空間有限，且分類邏輯固定。下面介紹 dsh-model-shelf。這是一個爲 DSH 提供的模型選擇器插件，它提供了一個寬大的、可摺疊的模型面板，並允許用戶手動管理“不常用”列表，以適應更復雜的模型管理需求。
核心功能¶
插件主要提供以下功能：
- 寬麪板與分組：模型選擇面板最大寬度爲 640px，最大高度 720px，窗口較小時自動收縮。支持按服務商分組，並允許單獨摺疊、全部展開或全部摺疊。
- 三欄管理：包含“主列表”、“不常用”和“收藏”三個獨立標籤頁。首次使用時所有模型均在主列表，收藏列表爲空。
- 手動分類：不進行自動使用頻率統計。用戶可手動點擊“移至不常用”或“移回主列表”來調整分類。
- 賬號備註：支持爲服務商分組添加賬號備註（如“工作賬號”），備註按服務商配置 ID 保存。
- 模型身份展示：每行顯示服務商名稱、服務商 ID、模型名稱和精確模型 ID。
- 思考強度恢復：支持一鍵恢復服務商默認的思考強度。對於未聲明檔位的模型，若安裝了
dsh-workbuddy-connect，可在面板內就地檢測檔位。 - 上下文容量顯示：若安裝了
dsh-workbuddy-connect並打了 CTXPATCH 補丁，面板底部會顯示每個模型聲明的上下文容量（如 300K / 1M）。
安裝與啓用¶
本插件未發佈到 npm，也不在 dsh-market 中。安裝需指定版本號。
- 確保宿主 DSH 版本爲 0.2.0-rc.2。
- 執行以下命令安裝最新版本（v1.2.0）：
dsh plugin --profile desktop add "https://github.com/Hobartoakes/dsh-model-shelf/releases/download/v1.2.0/dsh-model-shelf-1.2.0.tgz" --ignore-scripts
如果網絡受限，可先從 GitHub Release 下載 .tgz 文件，再使用本地路徑安裝。
安裝後刷新 DSH 頁面即可生效。卸載命令如下：
dsh plugin --profile desktop remove dsh-model-shelf
典型用法¶
啓用插件後，點擊輸入框當前模型按鈕即可打開選擇面板。
- 管理不常用模型：在主列表找到模型，點擊右側“移至不常用”，該模型會被移動到獨立標籤頁。在“不常用”列表中同樣可以選擇模型，或點擊“移回主列表”。
- 使用收藏列表：點擊模型旁的“☆ 收藏”按鈕。收藏是快捷入口，不影響模型在主列表或不常用列表中的位置。切換到“收藏”標籤頁可快速使用已標記的模型。
- 添加賬號備註：點擊服務商標題旁的“賬號備註”圖標，輸入備註內容並按 Enter 鍵保存。備註僅保存在當前瀏覽器，用於區分同一服務商下的不同 API 配置。
- 恢復思考強度默認值：在面板底部，如果當前模型被固定了思考強度，會出現“恢復服務商默認”選項。點擊即可解除固定，恢復爲服務商的默認設置。
注意事項¶
- 數據存儲：插件的分類、收藏和備註偏好僅保存在瀏覽器的
localStorage中，鍵名爲dsh-model-shelf.preferences.v1。不支持跨設備同步，更換瀏覽器或設備後需重新設置。 - 依賴要求：插件需要 DSH 0.2.0-rc.2。思考強度檢測和上下文容量顯示是可選功能，依賴於
dsh-workbuddy-connect插件及其補丁。 - 身份驗證限制：插件無法驗證上游 API 對模型 ID 的實際映射關係，僅顯示 DSH 目錄中聲明的身份信息。
- 兼容性：目前未驗證在其他 DSH 版本、macOS 或 Linux 上的兼容性。
結語¶
dsh-model-shelf 提供了一個結構化、可定製的模型選擇界面，適合需要精細化管理多個服務商和模型配置的用戶。通過手動分類和賬號備註功能，可以更清晰地組織模型資源。更多技術細節和源碼可查閱 GitHub 倉庫。
