前言¶
在 DeepSeek Harness（DSH）的 web 客戶端裏，換模型和調推理等級往往走默認下拉：provider 一多、模型一長，就要反覆點開列表。若你還希望把「常用」和「某 provider 全量」分開看，原生座位不一定順手。dsh-gear-grid-model 是社區插件，把輸入框旁的模型座位換成 Gear Grid（2D Cosmic Shifter） 風格：28px 藥丸觸發器 + 星野彈窗，在同一界面裏完成模型與思考強度選擇；模型列表不另建數據源，直接讀 ctx.modelDirectories，與 /model 命令、原生座位同源。
下面按定位、能力、安裝與用法說明；事實以 GitHub 倉庫 README 爲準。
這是什麼¶
dsh-gear-grid-model（npm 包名）由維護者 Hana-ame 發佈，分類屬於 模型推理，面向 DSH web 客戶端的純瀏覽器端 UI 插件。宿主側 index.js 的 apply() 爲空，行爲集中在 client.js；通過 package.json 的 dsh.bundle.patch（cordis.patch.yml）與 dsh.client 自聲明注入 web bundle，由客戶端模塊掃描器拾取。原生模型座位仍留在 DOM 樹中但隱藏，避免影響其它依賴，本插件只做顯示層替換。
核心功能¶
Gear Grid 座位與星野彈窗¶
輸入框模型座位變爲藥丸觸發器，展示當前模型、思考強度與箭頭；點擊後彈出全屏宇宙彈窗（標題爲「GEAR GRID · 選擇模型」），帶閃爍星野背景。
「常用」、provider tab 與搜索¶
- 「常用」tab：僅顯示手動收藏（☆ 或鍵盤
F）的模型，按 provider 分組；未收藏時有引導文案。 - provider tab：每個 provider 一個 tab（如 SenseNova · Key Pool、SiliconFlow · Key Pool、DeepSeek 等），展示該 provider 下全部可用模型。
- 搜索：按
/聚焦搜索框，按模型名或 id 跨 provider 過濾，結果仍按 provider 分塊。
藥丸即「模型 + 推理強度」¶
每個模型一顆藥丸：名稱、思考強度分段（適配器聲明瞭 efforts 的模型纔有 Off/Low/High/Max 等分段）、收藏星。點分段可同時設定模型與推理等級；Enter 或點擊完成選擇。
鍵盤與視覺¶
方向鍵 ← → ↑ ↓ 移動焦點，Enter 選擇，F 收藏，/ 聚焦搜索，Esc 關閉。樣式僅使用 DSH 主題令牌（--dsw-*），宇宙色相由 color-mix 派生，隨明暗主題變化。provider 組頭 8px 色點可改色：9 個預設、原生取色器、「自動」回退，偏好寫入 localStorage。
v1.1 可複用組件¶
自 v1.1.0 起，客戶端 bundle 額外導出 GearGridPicker、ensureGearGridStyles 等，供其它插件嵌入同一選擇器；調用方自行管觸發器與彈窗開關，拿不到導出時應回退普通下拉（README 中有 require 與 jsx 示例）。
安裝與啓用¶
要求：已安裝 DeepSeek Harness（dsh），並使用 web profile。安裝命令來自 README 原文：
# 從 npm 安裝（發佈後）
dsh plugin --profile web add dsh-gear-grid-model
本地開發可用 link 方式編輯 ~/.dsh/profiles/web/package.json 後執行 dsh --profile web（路徑以你本機爲準）。裝完後需 重啓 dsh。
插件以當前 dsh 進程權限運行；安裝前建議瀏覽 GitHub 源碼 與 MIT 許可證（見倉庫 LICENSE），確認符合你的安全與合規要求。
典型用法¶
- 打開：點輸入框旁藥丸觸發器（顯示當前模型）。
- 瀏覽：「常用」看收藏；點 provider tab 看該 provider 全量模型；按
/聚焦搜索並按名稱過濾。 - 收藏：鼠標懸停點 ☆，或焦點在模型上按
F。 - 選擇：方向鍵移動焦點，
Enter或點藥丸/強度分段，一次定好模型與推理等級。 - 關閉：
Esc或點擊遮罩外區域。
適用場景與注意¶
適合經常在 web 客戶端切換 provider、模型與推理強度，且希望「常用」與全量列表分開管理的 DSH 用戶。不適合非 web 客戶端：本插件 dsh.client.platform 僅爲 web。
數據完全依賴運行時 ctx.modelDirectories；若宿主未加載模型目錄，界面與原生 /model 行爲一致地受同一數據源約束。社區目錄頁 SkillHub · dsh-gear-grid-model 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-gear-grid-model 用 Gear Grid 交互替換默認模型下拉，在星野彈窗裏完成模型與推理強度的一次性選擇，並複用 DSH 原生模型目錄。進一步瞭解可訪問目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/Hana-ame/dsh-gear-grid-model
- GitHub：https://github.com/Hana-ame/dsh-gear-grid-model
