前言¶
在 DeepSeek Harness（DSH）裏配好模型和賬號之後，日常提問往往還要切回主窗口或終端。若希望像豆包懸浮窗那樣，隨時有一個置頂、可縮放的小面板，並能框選屏幕區域直接提問，就需要在 desktop profile 上掛一個客戶端插件。dsh-float 由社區維護者 18840024879 發佈，分類爲「客戶端」，當前 GitHub 星標爲 0；它複用 dsh 裏已有的模型與賬號，不需要單獨填 API Key。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-float 是面向 Windows 10/11 x64 的桌面浮動助手：獨立 Electron Helper 提供常駐置頂的對話面板，宿主爲 DSH 插件（lib/index.js），通過本地橋接調用已配置的會話能力。插件版本 0.1.0，許可證 MIT，要求 Node.js >= 20、dsh >= 0.2.1-rc.2 且 < 0.3.0。關閉 dsh 後 Helper 會自動退出，不留後臺進程。
核心功能¶
打開方式與窗口行爲¶
安裝了 dsh-pet 時，可在系統雙擊間隔內、位置基本不變地雙擊桌寵本體打開或隱藏面板；單擊或拖動桌寵不會誤觸。未裝桌寵時，可用默認快捷鍵 Alt+Space（被佔用時自動降級爲 Ctrl+Alt+Space）或系統托盤菜單顯示/隱藏。面板可拖標題欄移動，拖右邊緣、底邊或右下角縮放；位置與大小寫入 ~\.dsh\dsh-float\window.json 並自動記憶，最小約 320×420。
對話與渲染¶
支持流式回答、停止生成、模型選擇、新對話；歷史保留最近 8 輪（history.json 存最近 40 條，面板顯示最近 12 條）。回答中的 LaTeX（$...$、$$...$$、\(...\)、\[...\]）用本地 KaTeX 渲染；Markdown 標題、列表、表格、引用、代碼塊等也會正常排版，而不是裸符號。
截圖提問¶
左下角相機按鈕進入框選：拖拽選區後鬆開完成，Esc 取消。截圖作爲附件發送，歷史裏保留縮略圖。遮罩窗口常駐預熱，懸停相機時即開始取屏幕流；遮罩在畫面繪好後才淡入。文本模型遇到圖片時，會按 README 說明尋找含 image 能力的視覺路由（優先 modlens）；找不到會報 VISION_UNAVAILABLE，不會靜默丟圖。
與 dsh-pet 的配合¶
雙擊桌寵打開面板是可選集成；不依賴桌寵也能完整使用快捷鍵與托盤。Electron 運行時查找順序包括 DSH_FLOAT_ELECTRON_PATH、DSH_PET_ELECTRON_PATH、插件依賴與 ~\.dsh\electron\electron.exe，都沒有時首次啓動會下載 Electron 43.3.0 到 ~\.dsh\dsh-float\electron\（約 110 MB，僅一次）。
安裝與啓用¶
普通用戶從命令行安裝（命令來自官方 README）：
dsh plugin --profile desktop add dsh-float
裝完後重啓 DeepSeek Harness。啓動成功時 dsh 日誌中應出現 [dsh-float] loaded 和 helper ready on 127.0.0.1:…。Helper 是獨立 Electron 進程；若需跳過自動下載，可設置環境變量 DSH_FLOAT_ELECTRON_PATH 指向已有的 electron.exe。
卸載時從 desktop profile 的 package.json 去掉 dsh-float 依賴及 dsh.profile.bundles 中的 "dsh-float"，重新 pnpm install，或刪除 node_modules/dsh-float 鏈接後重啓 dsh。本地開發安裝步驟見 GitHub README，本文不展開。
典型用法¶
- 雙擊 dsh-pet 桌寵（或按
Alt+Space/ 托盤「顯示」）打開面板；再次雙擊、Esc或右上角「—」隱藏。 Enter發送，Shift+Enter換行；生成過程中可點停止。- 面板頂部模型名可切換；選「跟隨 dsh 默認」即使用 dsh 當前會話模型（對應
config.json裏model: null）。 - 相機按鈕框選屏幕區域提問；托盤菜單同樣提供截圖提問與退出。
配置與數據目錄均爲 ~\.dsh\dsh-float\。config.json 示例：
{
"hotkey": "Alt+Space",
"systemPrompt": "你是一個常駐桌面的 AI 助手……",
"model": null,
"maxHistoryRounds": 8,
"autoVision": true,
"opacity": 1
}
刪除 config.json 可恢復默認。截圖暫存於 %TEMP%\dsh-float\shot-*.png，發送後由宿主刪除。
適用場景與注意¶
適合已在 DSH desktop profile 下日常使用、希望在 Windows 桌面上快速問答或「框選即問」的開發者。插件以當前 dsh 進程權限運行，安裝前應在 GitHub 查看源碼與 MIT 許可證，並自行評估截圖、網絡與模型路由行爲。
僅支持 Windows，Linux/macOS 不可用。社區插件目錄站點（SkillHub）與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，dsh-float 是其中一條客戶端擴展，不是官方應用商店內置應用。
排障時可查看 ~\.dsh\dsh-float\helper-debug.log（面板打不開、Electron 下載失敗、截圖黑屏等，README 有分場景說明）；徹底重置可退出 dsh 後刪除整個 ~\.dsh\dsh-float\ 再重啓。
結尾¶
dsh-float 把 DSH 已配好的模型與賬號接到一個可置頂、可縮放、支持截圖與 KaTeX/Markdown 渲染的桌面小窗，並與 dsh-pet 雙擊聯動。目錄頁：https://www.skillhub.cn/plugins/18840024879/dsh-float；源碼與完整文檔：https://github.com/18840024879/dsh-float。
