DSH 通過插件擴展能力,各類功能分散在斜槓菜單、模型選擇器、側邊欄和 Composer 的 @ 菜單等不同位置。鍵盤優先的用戶需要一個統一的入口來回答:當前工作區我能做什麼,以及如何快速到達那裏。
Universal Palette 提供了一個共享的搜索控制器,通過官方 API 實時獲取命令、模型、會話和歷史記錄。
插件介紹¶
名稱:yunmin311/dsh-universal-palette
類別:客戶端
維護者:yunmin311
許可證:MIT
核心功能¶
- 命令:通過官方 API 搜索和執行的實時主機命令目錄。新增的 Host 命令會自動出現。
- 模型:會話的真實模型目錄,顯示當前選中項。
- 會話:當前優先的會話導航,支持穩定的身份去重。
- 對話命中:通過 DSH 的會話搜索進行全文歷史檢索。
- 確定性相關性:精確前綴優先評分,過濾低相關性結果。
- 原生外觀:使用 DSH 設計令牌,提供原生菜單排版和玻璃擬態表面,跟隨本地化文案。
- 公共契約互操作性:基於驗證的公共契約與社區插件協作,無私有耦合。
安裝與啓用¶
通過 DSH 官方插件管理器安裝:
dsh plugin --profile web add @yunmin311/dsh-universal-palette@0.2.1
安裝後,在 --profile web 模式下啓動 DSH 即可生效。
典型用法¶
- Composer 搜索:在原生 DSH 斜槓菜單中輸入
/find,或使用搜索按鈕。搜索結果會以 DSH 原生界面顯示,位於 Composer 之上或之下(取決於會話狀態)。 - 全局懸浮調色板:在 Windows/Linux 上按
Alt+Q,或在 macOS 上按Cmd+Shift+K,可切換全局懸浮調色板。 - 關閉:按
Esc關閉調色板。
適用場景與注意¶
- Composer Search 限制:Composer Search 功能需要一個聲明瞭
conversation.hero.composer.dock座位的主機。如果主機未聲明該座位,Composer Search 將在 Hero 界面關閉。 - 行爲一致性:對於未驗證公共契約的功能,插件不改變任何行爲。
- 隱私與耦合:插件不進行私有註冊表讀取,不引入硬依賴,僅實現共存。
結尾¶
Universal Palette 爲鍵盤優先的用戶提供了集中的控制點,確保了與 DSH 生態系統的兼容性。