前言¶
用 DeepSeek Harness（DSH）做智能體開發或日常對話時，主窗口往往被 IDE、瀏覽器或終端佔滿。需要追問、切換會話、選模型或處理工具審批時，只能反覆 Alt-Tab 切回 Harness，打斷當前工作流。社區插件 dsh-quorfloat（維護者 Azetus）提供系統級懸浮窗：全局快捷鍵呼出面板，在使用其他應用時也能向 Harness 提問、繼續會話並處理審批。面板複用 Harness 的工作區、會話、模型與權限；對話執行與歷史仍由 Harness 管理。支持 macOS 與 Windows，npm 主包名爲 dsh-quorfloat，安裝時會自動拉取當前平臺的面板程序，無需自行編譯。
這是什麼¶
dsh-quorfloat 是 DSH 的客戶端類插件：宿主側註冊插件，側車進程提供帶 WebView 的懸浮窗 UI。分類上屬於「客戶端」——運行在本機 DSH 主機上，而不是瀏覽器裏。遠程只開 WebUI 時，可以在 WebUI 裏安裝並查看插件狀態，但懸浮窗只會出現在運行 dsh web 的那臺機器上。
核心功能¶
以下能力均來自項目 README，安裝後需完全重啓 Harness 本體（僅關懸浮窗或刷新 WebUI 不足以重載宿主插件）。
- 隨時呼出：全局快捷鍵顯示或收起懸浮窗；可拖動並記住位置，可設置失焦後仍保持展開。默認快捷鍵爲 Alt + Space（macOS 爲 Option + Space），可在設置中更換。
- 工作區與會話：瀏覽當前工作區已有會話，切換其他工作區開新對話，或瀏覽「未分組」會話；可固定會話或固定默認工作區。
- 對話閱讀與控制：Markdown、代碼塊、表格；工作過程可展開/摺疊；長會話可加載更早內容並保持閱讀位置。支持發送、停止生成，選擇 Harness 提供的模型、推理檔位與權限預設。
- 審批與追問：在面板內處理當前會話的工具審批和問題，無需切回 Harness 主窗口。
- 外觀與診斷：淺色/深色/跟隨系統，中英文界面；設置自動保存。設置頁或 Harness「設置 → 內置插件 → dsh-quorfloat」可導出診斷日誌到
~/.dsh-quorfloat/logs/。
安裝與啓用¶
準備：已安裝 DeepSeek Harness。使用瀏覽器 WebUI 時，終端需能執行 dsh。插件在 package.json 中聲明需要 dsh >= 0.2.0-rc.2。當前資料中的 npm 主包版本爲 0.1.9（以你實際安裝的包爲準）。
瀏覽器 WebUI（npm）¶
先停止正在運行的 dsh web。以下示例安裝到 web profile；若使用自定義 profile，將 web 換成你的 profile 名稱，並用同一 profile 啓動 Harness。
聯網安裝最新版：
dsh plugin --profile web add dsh-quorfloat
dsh web
固定版本時，將包名改爲 dsh-quorfloat@<version>。
瀏覽器 WebUI（離線 tgz）¶
下載與操作系統匹配的自包含包，例如 macOS 的 dsh-quorfloat-<version>-darwin.tgz、Windows 的 dsh-quorfloat-<version>-win32.tgz，無需解壓，用絕對路徑安裝：
dsh plugin --profile web add "/絕對路徑/dsh-quorfloat-<version>-darwin.tgz"
dsh web
Windows PowerShell 示例：
dsh plugin --profile web add "C:/Downloads/dsh-quorfloat-<version>-win32.tgz"
dsh web
Harness 官方桌面版¶
- 啓動桌面應用，左側欄打開「插件」→「添加插件」。
- 輸入
dsh-quorfloat或dsh-quorfloat@<version>，點擊安裝並按提示啓用。 - 完全退出並重新啓動 Harness 桌面應用。
離線安裝時在彈窗中輸入 tgz 的絕對路徑，安裝啓用後同樣需重啓桌面應用。
典型用法¶
安裝並重啓 Harness 後，按默認 Alt + Space（macOS：Option + Space）呼出面板，再按一次可收起；也可通過菜單欄或系統托盤操作。
輸入與導航：
- 輸入框：Enter 發送，Shift + Enter 換行；生成中可停止；Esc 優先關閉菜單或返回對話頁，在對話頁且無菜單時收起面板（收起不會停止後臺會話）。
- 點擊頂部工作區或會話名：選真實工作區並在會話菜單選「新會話」（首次發送才創建）；或從列表繼續已有會話；會話旁固定按鈕可在下次呼出時繼續同一會話；新會話狀態下可固定工作區作爲默認創建位置。「未分組」僅瀏覽，不能固定且無「新會話」。
設置：齒輪圖標可調主題、語言、快捷鍵與「失焦時保持展開」。默認快捷鍵若衝突，可先經菜單欄/托盤打開面板再改。
適用場景與注意¶
適合：經常在 IDE、終端、設計工具裏工作，又需要隨時向 DSH 提問、續聊、批工具調用，且希望少切換窗口的 macOS/Windows 用戶。
注意：
- 插件與側車以當前 DSH 進程權限運行；安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證。
- DSH 生態是「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
- Linux 未出現在當前 README 的安裝/發佈說明中；請以倉庫最新文檔爲準。
- 需要自行構建時，README 要求 Node.js 22+、Rust 1.88+ 及 Tauri 相關環境，產物在
bundles/下；一般用戶走 npm 或 tgz 即可。
結尾¶
dsh-quorfloat 把 Harness 的對話、會話切換和工具審批收到一塊懸浮面板裏，用全局快捷鍵即可接入，適合「主窗口在別的應用裏、Harness 在後臺跑」的日常用法。更多說明與界面預覽見倉庫 README；安裝與版本信息也可在 SkillHub 目錄頁覈對。
- 目錄頁：https://www.skillhub.cn/plugins/Azetus/dsh-quorfloat
- GitHub：https://github.com/Azetus/dsh-quorfloat
