前言¶
DeepSeek Harness (DSH) 的 Web GUI 提供了插件管理入口,但原生面板的功能較爲基礎。dsh-lego-plugin 是一個將動態 Cordis 插件以樂高積木形式呈現的客戶端插件,旨在提升交互直觀性和視覺反饋。
插件介紹¶
該插件由 XIAOke8698 維護,採用 MIT 許可證。它不依賴外部庫,完全使用 CSS 渲染樂高積木的物理質感(ABS 塑料光澤、微倒角、同心圓凸點)。
核心功能¶
- 面板替換與熱插拔:替換 Web GUI 左下角的“Cordis Plugin”原生面板,支持熱插拔,無需刷新頁面。
- 樂高積木渲染:積木具有 ABS 塑料質感、光澤和倒角。運行中的插件呈現霓虹發光寶石效果,停止狀態爲半透明,等待審批狀態爲紅色脈衝輪廓。
- 多色與自適應形狀:系統根據插件 ID 自動分配官方樂高 10 色調色板,並根據哈希值自適應幾何形狀(2x2、2x3、2x4 等)。
- 交互反饋:點擊積木有觸覺“咔嗒”聲(Web Audio 合成),面板頭部提供“搖一搖”按鈕以重新分配顏色。
- 輔助功能:支持按插件 ID 搜索、側邊欄顯示運行數量、中英文國際化(i18n)以及跟隨系統的淺色/深色主題。
安裝¶
安裝前請確保 DSH 環境已配置 Web GUI,並且 pnpm 已加入系統 PATH(dsh plugin 命令會轉發到 pnpm)。
dsh plugin --profile web add dsh-lego-plugin
如果你在 DSH 源碼樹內開發測試,dsh 命令不可用,可改用:
pnpm dsh plugin --profile web add dsh-lego-plugin
使用方法¶
- 啓動 DSH Web GUI。
- 在左側邊欄底部點擊“Cordis Plugin”條目。
- 面板以樂高積木列表形式展示當前會話的動態插件。
- 點擊積木進行操作:
| 積木狀態 | 操作 |
|---|---|
| 運行中(實心 + 綠點) | 停止、移除 |
| 已停止(灰色) | 運行、移除 |
| 等待審批(紅色輪廓) | 批准、批准(未來版本)、拒絕 |
適用範圍與注意事項¶
- 管理範圍:僅管理動態插件(
dyn/*),這些是通過cordis_define創建的插件。靜態插件(cordis.yml中定義的)不會出現在列表中。 - 卸載影響:卸載插件後,原生 Cordis Plugin 面板會自動恢復,並清理該插件注入的樣式和
cordis.patch.yml配置。 - 版本兼容:需要
pnpm版本 ≥ 10,且安裝源碼包時需處理構建腳本權限。
結尾¶
該插件通過可視化的方式簡化了動態插件的啓停與審批流程,適合需要頻繁調試或管理多個動態插件的開發者。