前言¶
DSH 的側邊欄對話只能依附於主窗口。一旦你切換到別的應用，或者把 DSH 主窗口最小化，側邊欄就會被遮擋，甚至完全看不見。dsh-float-chat 把這段對話獨立出來，做成一個無邊框、可置頂、能覆蓋在任何其他應用之上的懸浮窗。
核心功能¶
獨立原生窗口¶
懸浮窗是一個獨立的 WinForms + WebView2 進程，不是畫在 DSH 頁面裏的浮層。它能夠壓在所有應用之上，並在 DSH 主窗口最小化甚至隱藏時繼續存在。
外觀與交互¶
- 四態外觀：支持淺色、深色、跟隨 DSH、跟隨 Windows 四種模式。在設置裏調整後立即生效。
- 窗口幾何記憶：位置、大小和不透明度會被記住，下次打開保持上次的狀態。
- 標題欄操作：支持新對話、置頂、清理緩存、最小化、關閉等操作。
- Token 用量：每輪對話結束後，底部會顯示輸出 token 數。
會話與安全¶
- 繼承上下文：開窗時繼承當前會話的上下文，並插入邊界提示。
- 多對話管理：通過標題欄下拉菜單切換歷史對話、重命名或刪除記錄。
- 即用即焚：開啓後，關閉窗口即刪除本次側邊對話的記錄（含落盤文件）。
緩存管理¶
- 清理緩存：支持清理瀏覽器緩存與日誌。清理時會有提示。
- 實時統計：設置頁會實時顯示緩存與日誌的大小。
安裝¶
- 獲取插件代碼。
- 在項目根目錄運行
npm link。 - 在 DSH 的 profile 目錄中運行該命令（根據已覈實事實的說明）。
使用方法¶
- 啓動浮窗：在 DSH 主窗口的輸入框右側點擊“浮窗”按鈕。
- 切換對話：點擊標題欄的對話名稱下拉菜單，切換或重命名歷史對話。
- 清理緩存：點擊標題欄的垃圾桶按鈕，或在設置頁的“緩存與日誌”卡片中點擊清理。
- 調整設置：進入設置 -> 懸浮窗，調整外觀、不透明度、窗口大小等。
注意事項¶
- 平臺限制：僅支持 Windows（WinForms + WebView2）。macOS / Linux 不可用。
- 環境要求：需要 DSH Desktop（不支持 Web 版）。需要安裝 WebView2 Runtime。
- 硬依賴：依賴
@deepseek-ai/dsh-client-ui-conversation插件，否則輸入框右側的“浮窗”按鈕不會出現。
