DSH (DeepSeek Harness) web 控制台下的插件入口往往散落在側欄或瀏覽器標籤頁中,頻繁切換影響效率。dsh-plugin-palette-board 是一款基於 Raycast / Launchpad 風格的 2D 應用網格,通過懸浮面板將常用入口聚合,支持全鍵盤交互與本地化存儲。
核心功能¶
- 全鍵盤交互:支持
⌘K/Ctrl+K/Alt+Space喚出,Esc關閉。進入面板後,使用方向鍵或 Tab 進行網格導航,回車執行。 - 本地化卡片目錄:卡片數據固化在
~/.dsh/storages/palette-board.json,採用雙段結構(entries用戶手寫卡片 +layout插件佈局),刷新重啓後原樣恢復。 - paletteHub 服務化接入:爲所有 client 插件提供半發佈服務
ctx.paletteHub,支持軟依賴接入,插件停止時不會影響宿主啓動。 - 掃描收編:讀取側欄
sidebar.footer.actionslot 註冊表,一鍵將側欄入口轉化爲自定義卡片。 - 篩模式:提供漏斗開關,可隱藏失效卡片(如鏈接 404、不在側欄的按鈕),僅影響顯示。
- 主題與尺寸:支持
fresh(紙感)與glass(玻璃擬態)雙主題切換,以及緊湊/標準/寬大三檔尺寸循環切換。 - 零依賴:運行時零依賴,
lib/構建產物隨倉庫提交,克隆即用。
安裝與啓用¶
- 克隆倉庫。
- 編輯 dsh web profile 的
package.json,在dependencies中添加軟鏈接:
"dsh-plugin-palette-board": "link:/path/to/dsh-plugin-palette-board"
- 在
dsh.profile.bundles數組中加入該插件名稱。 - 執行安裝:
cd ~/.dsh/profiles/web && pnpm install
典型用法¶
- 喚出面板:使用
⌘K/Ctrl+K/Alt+Space。 - 註冊卡片:面板上的「註冊」功能允許手寫卡片或填入頁面鏈接收編任意 web 頁面。
- 掃描側欄:點擊「掃描」按鈕,將側欄底部的現有操作入口一鍵轉化爲調色盤卡片。
- 第三方接入:其他插件通過
ctx.inject(['paletteHub'], ...)註冊卡片,無需主插件主動添加。
注意事項¶
- 依賴宿主版本:需要宿主 dsh web >= 0.1.2-alpha.1。
- 環境要求:需要 Node.js >= 20。
- 存儲文件:卡片目錄位於
~/.dsh/storages/palette-board.json。若文件損壞,host 會先備份再重置。 - 權限範圍:插件運行於當前 DSH 進程權限下,安裝前請檢查源碼。