前言¶
DeepSeek Harness (DSH) Desktop 的 Web 模式在運行長時間任務時，原生終端輸出往往缺乏實時性反饋，且界面樣式定製能力較弱。dsh-better-uiux 插件爲 DSH 提供了兩個核心 UI 增強：實時流式終端輸出和自定義 CSS 注入。這兩個功能被整合在同一個設置區塊中，通過開關控制，旨在解決開發者調試過程中的可視化和定製化需求。
插件定位¶
這是一個爲 DSH Desktop 提供的 UI 增強（UIUX）插件，由 nguyenduclong-ict 維護。它將功能模塊化地集成在 Settings -> Better UIUX 中，主要包含以下兩個獨立組件：
* Live terminal output: 實時流式終端輸出。
* Custom CSS: 自定義 CSS 注入。
核心功能¶
1. 實時終端輸出¶
開啓此開關後，前臺命令的輸出和後臺任務（Job）的輸出都會被實時流式傳輸到日誌記錄中。
* 交互元素: 輸出塊帶有脈衝式頭部圓點。每個輸出條目旁提供了 Copy（複製）、Stop（停止）和 View Job（查看任務）按鈕。
* 輸出彈窗: 支持通過彈窗查看詳細的流式輸出內容。
2. 自定義 CSS 注入¶
在設置中編輯 CSS 代碼，樣式會實時生效。此功能允許用戶對 DSH 的 Web 界面進行深度定製，無需修改插件源碼。
3. 開關控制機制¶
兩個功能均由獨立的開關控制。
* 運行時行爲: 當功能關閉時，其對應的路由會返回 enabled:false，且不再攔截子進程或任務。
* 自動清理: 關閉 Live terminal 後，插件會移除所有注入的節點，以避免與 DSH 原生實時輸出的未來版本衝突。
安裝與啓用¶
安裝此插件需使用 DSH CLI 命令。
dsh plugin --profile web add https://github.com/nguyenduclong-ict/dsh-better-uiux
執行命令後，請重啓 DSH Desktop 或重新加載 Web 配置文件，插件即可生效。
典型用法¶
- 進入 DSH Desktop 的 Settings 菜單。
- 找到 Better UIUX 區域。
- 打開 Live terminal output 開關，即可在日誌流中看到前臺和後臺任務的實時輸出，並使用彈窗或按鈕進行交互。
- 在 Custom CSS 編輯框中輸入 CSS 代碼，保存後界面樣式會即時更新。
注意事項¶
- 插件衝突: 請勿同時運行獨立的
dsh-plugin-live-terminal插件。兩者使用相同的樣式 ID (dsh-live-*) 和模態框結構，會相互覆蓋節點。 - 功能狀態: 當前版本中，“編輯消息”功能已實現代碼但處於隱藏和禁用狀態，設置界面中不顯示該開關。
- 性能開銷: 即使關閉 Live terminal 開關，後臺仍會保持 1Hz 的輪詢（僅執行無操作調用）以檢測狀態變化。
- 卸載: 若需卸載，使用
dsh plugin --profile web remove dsh-better-uiux。配置數據存儲在本地，卸載後需手動清理<harness>/plugins/dsh-better-uiux/config.json及瀏覽器中的localStorage(dsh_better_uiux_config_v2)。
總結¶
dsh-better-uiux 通過簡單的開關機制解決了 DSH 在實時監控和樣式定製上的短板，適合需要精細調試或定製界面樣式的開發者。該插件無運行時依賴，安裝後直接可用。
- GitHub: https://github.com/nguyenduclong-ict/dsh-better-uiux
- 目錄頁: https://www.skillhub.cn/plugins/nguyenduclong-ict/dsh-better-uiux
