前言¶
用 DeepSeek Harness（DSH）跑任務時，主窗口往往被 IDE 或瀏覽器擋住。想知道「現在有幾個會話在跑、每個跑到哪一步、已經燒掉多少 Token、有沒有卡在等你點允許」，通常得切回 DSH 翻界面。下面介紹 Windpixy 維護的客戶端插件 dsh-floating-window（DSH 狀態懸浮窗）：在 Windows 桌面上浮一塊磨砂玻璃小窗，把上述信息彙總成一眼能掃到的卡片或細柱，儘量不打擾手頭工作。
這是什麼¶
dsh-floating-window 是 DSH 的客戶端類插件，displayName 爲「DSH 狀態懸浮窗」。插件側用 Node.js 監聽 DSH 會話事件，把狀態寫入 %USERPROFILE%\.dsh\desktop-card\ 下的 state.json；窗口本體在 panel/ 裏，由 PowerShell + WPF 繪製，每約 500ms 讀一次該文件。窗口進程刻意脫離 DSH 進程樹，關掉 DSH 後卡片仍可留在桌面。
維護者：Windpixy。源碼與說明：https://github.com/Windpixy/dsh-floating-window；npm 包名 dsh-floating-window（README 安裝示例版本 0.10.13）。許可證 MIT。DSH 插件社區目錄頁：https://www.skillhub.cn/plugins/Windpixy/dsh-floating-window（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。
核心功能¶
卡片態：任務與用量¶
有任務運行時，卡片按行列出任務名、已跑時長、當前在做什麼，以及該任務已消耗的 Token（右下角小字，如 12.3k Token）。該數字按會話統計，含子代理用量；爲 0 時不顯示；與底部「今日 Token」口徑不同——底部是全天合計。
無任務時卡片收成一行，在「今日 Token」與「谷時倒計時」之間輪播。谷時指 DeepSeek 低價時段：工作日 9–12 點、14–18 點之外，以及週末與法定節假日全天；插件自行判斷，節假日列表從網上更新。
審批與多任務¶
有待你審批的操作（例如刪除、改系統）時，狀態會在懸浮窗上體現；柱態下用紅色色條表示「等你審批」。任務多時卡片自動增高（最多 5 行），子智能體單獨計數。
柱態（細條）¶
右鍵菜單選「縮成細條」後，窗口變爲約 14×120 像素的細柱貼邊。色條含義：藍—有任務在跑；紅—待審批；綠—剛有任務完成；灰—空閒。任務運行中色條會明暗起伏。單擊展開回卡片；懸停彈出氣泡顯示任務明細；可拖動換邊並吸附屏幕邊緣。
交互與外觀¶
單擊卡片可跳回 DSH 主窗口（可在設置裏關閉）。拖動位置會記住；可選貼邊與留白。卡片會根據壁紙明暗自動切換文字黑/白。右鍵菜單還提供置頂、回到默認位置、重新讀取設置、導出診斷包、退出等。
設置裏可調磨砂濃度（24–144）、輪播間隔（5–120 秒）、卡片寬度（200–360，默認 260）、收起高度（72–160，默認 96）等；保存後約半秒內生效，無需重啓 DSH。
安裝與啓用¶
<你的 profile> 指 DSH 側欄「插件」頁上顯示的當前配置名；不確定時可填你在用的名字，DSH 會在首次使用時創建。
方式一（npm，README 推薦）——版本號須寫精確，避免 pnpm 11 的 minimumReleaseAge 靜默裝到舊版：
dsh plugin --profile <你的 profile> add dsh-floating-window@0.10.13
方式二（GitHub）：
dsh plugin --profile <你的 profile> add github:Windpixy/dsh-floating-window
方式三：DSH 圖形界面 → 插件 → 添加插件，輸入 dsh-floating-window@0.10.13 或 github:Windpixy/dsh-floating-window 等。
裝好後重啓一次 DSH；默認卡片出現在屏幕右側。若已裝過要更新，可重跑安裝命令；提示已存在時先 remove 再 add：
dsh plugin --profile <你的 profile> remove dsh-floating-window
dsh plugin --profile <你的 profile> add github:Windpixy/dsh-floating-window
卸載：
dsh plugin --profile <你的 profile> remove dsh-floating-window
卸載不會自動關閉已打開的卡片窗口；卸載後請右鍵卡片 → 退出，否則窗口會停在最後一幀。數據目錄 %USERPROFILE%\.dsh\desktop-card\ 需手動刪除纔會清掉設置與日誌。
典型用法¶
- 安裝並重啓 DSH，確認 Windows 10 / 11 下屏幕右側出現磨砂玻璃卡片（能透出壁紙，而非純色塊）。
- 跑一個 DSH 任務，看卡片任務行與 Token 小字是否隨進度更新；底部「今日 Token」與任務行用量區分查看。
- 需要省位置時：右鍵 → 縮成細條，用色條判斷狀態；懸停看明細，單擊恢復卡片。
- 調外觀與行爲：右鍵 → 設置…，改磨砂、尺寸、貼邊、輪播間隔；審批相關開關默認偏保守（「在懸浮窗上直接審批」默認關），按需閱讀 README「審批相關的兩個開關」後再開。
- 卡片不出現：先確認系統爲 Windows；查插件日誌
%USERPROFILE%\.dsh\desktop-card\plugin.log；或手動運行插件目錄下panel\run-panel.bat看控制台報錯。
適用場景與注意¶
適合：在 Windows 上長時間開 DSH、希望不切窗口就能掌握多會話進度、Token 與審批狀態的開發者。
務必知曉：
- 僅支持 Windows 10 / Windows 11。在 macOS / Linux 上插件可加載但不報錯，卡片不會出現；日誌可能出現「兩種啓動策略都沒成功」類提示——README 明確寫先看是否在 Windows 上。
- 插件隨當前 DSH 進程權限運行；安裝前建議查看源碼與 MIT 許可證，自行評估信任邊界。
- 「在懸浮窗上直接審批」涉及高危操作確認，默認關閉；開啓前應理解 README 中的安全說明。
- 包要求 Node.js
^22.19.0 || >=24.0.0（見package.json的engines）。
結尾¶
dsh-floating-window 把 DSH 會話狀態落到桌面一塊輕量磨砂窗上：卡片看明細，細柱看狀態，Token 與谷時信息不用切回主界面。詳情與截圖見倉庫 README；安裝可走 npm 精確版本或 GitHub。
