前言¶
用 DeepSeek Harness 跑 Agent 任務時,主窗口往往被其他應用擋住,或你只想最小化窗口繼續幹活。此時要知道 Agent 是在思考、調工具還是在等你點批准,通常得切回 Harness 看狀態欄或對話區。社區插件 dsh-island 在 Windows 桌面上提供一塊類似 iPhone 靈動島的懸浮條:任務進行時貼在屏幕邊緣顯示狀態,展開後可看計劃進度、上下文佔用,並在不打開主窗口的情況下批准權限、回答提問或接着發消息。下面介紹它是什麼、能做什麼,以及如何安裝與使用。
這是什麼¶
dsh-island 是維護者 a961282799-crypto 發佈的 DeepSeek Harness 桌面端插件(社區作品,非 DeepSeek 官方產品)。倉庫簡介爲:DeepSeek Harness desktop dynamic island plugin (community)。當前 package 版本爲 0.6.1,許可證 MIT,在 SkillHub 目錄中歸類爲「客戶端」。
插件通過 Harness 的 Cordis 生命週期訂閱會話與 Agent 事件,在獨立 Electron 窗口裏渲染 UI;傳給界面的只有狀態、任務標題、計劃條目、工具名、模型與 token 統計等概括信息,不讀取 API Key,也不把進行中的對話全文或工具參數塞進靈動島(可在設置裏進一步關閉「顯示任務內容」)。
核心功能¶
形態與狀態¶
靈動島有多種尺寸形態:待機(118×32)、緊湊任務條(212×36)、短暫彈出提醒(312×66)、懸停或單擊展開的 task 控制台(344×寬自適應),以及貼左右側時的豎條形態。任務進行中,鯨魚外圈按上下文佔模型窗口比例顯示佔用環(70% 以下綠、70% 起黃、90% 起紅並呼吸)。
README 列出十一種視覺狀態,包括隨時待命、正在思考、正在回答、正在執行、等待你確認、已完成、已暫停、需要留意、正在重試、整理上下文、連接已斷開等,並配有對應動效說明。
任務控制台¶
鼠標在膠囊上停留約 0.7 秒或單擊可展開控制台:進行中的任務顯示標題、計時、計劃進度(如 4/7)、最近工具調用、模型與上下文佔用、緩存命中率、工具次數、輸出 tokens,以及 停止任務(需點兩次確認)。任務剛結束時預覽最後回覆開頭;空閒時顯示今日完成數、工作時長、賬戶餘額(登錄 DeepSeek 賬號時)、24 小時 token 柱狀圖與估算費用、最近任務列表。
在靈動島交互,而不必回到主窗口¶
- 回答提問:Agent 使用
ask_user_question時自動展開提問卡;與 Harness 窗口裏的提問卡 哪邊先答用哪邊。計劃審閱等需在 Harness 內完成的內容除外。 - 批准權限:需要授權時展開審批卡,可 允許一次 或 拒絕;按鈕出現後約 0.6 秒纔可點。持久「始終允許」仍在 Harness 設置。
- 發消息:展開面板頂部有對話卡與輸入框,走 Harness 會話控制器的
prompt接口;空閒時可 發送 新輪次,任務進行中可 排隊 或 插話。暫不支持在靈動島新建對話或發圖片、文件。
用量統計¶
從面板底部柱狀圖按鈕或托盤菜單「用量統計」打開,可選今天(按小時)、7 天、30 天(按天),彙總 tokens、緩存命中率、輪次、工作時長,並按 DeepSeek 官方價格(README 標註 2026-10-27 查詢)估算人民幣費用。數據來自 Harness 會話記錄,彙總保存在 %USERPROFILE%\.dsh\dsh-island\usage.json,保留約 35 天,不含對話正文。
安裝與啓用¶
需要 DeepSeek Harness 桌面版 0.2.1-rc.5(Windows)。peer 依賴與 README 中適配版本一致。
在 Harness 裏安裝:側欄「插件」→「添加插件」,輸入 dsh-island,安裝後啓用。
命令行:先從托盤退出 Harness,再執行:
dsh plugin --profile desktop add dsh-island
裝好後,位置、大小、懸停展開、是否在靈動島回答/審批/發消息等選項在 Harness 的 設置 › 靈動島 中調整,修改後立即生效。插件條目配置鍵爲 dsh-island;部分本地狀態(如顯示器選擇)由托盤菜單保存。
運行環境複用機器上已有的 %USERPROFILE%\.dsh\dsh-orb\electron-runtime\electron.exe,或通過環境變量 DSH_ISLAND_ELECTRON 指定;安裝包不含 Electron,不會自動下載。插件以當前 Harness 進程權限運行,安裝前建議在 GitHub 查看源碼與 MIT 許可證。
從源碼安裝需使用倉庫內的 安裝到 Harness.cmd 或 scripts/install-desktop.ps1(用戶若走源碼路徑,README 有完整說明;本文不展開 clone 步驟)。
典型用法¶
- 安裝並啓用後,托盤可見藍色鯨魚;無任務時靈動島待機,僅鯨魚與呼吸藍點。
- 在 Harness 中啓動 Agent 任務後,緊湊形態顯示狀態文字與動態指示器;多任務時顯示數量,待確認與異常優先展示。
- 需要批准或回答提問時,靈動島自動彈出並展開對應卡片;處理完可移開鼠標讓面板收起,或單擊固定展開。
- 想接着對話但不切回主窗口:展開控制台,在輸入框輸入內容,Enter 發送,Shift+Enter 換行。
- 查看費用與 token:空閒時展開面板看 24 小時柱狀圖,或打開用量統計窗口按天/模型/會話下鑽。
透明區域不攔截鼠標;窗口置頂但不搶輸入焦點。「隱藏」只藏靈動島,點托盤鯨魚可再顯示。
適用場景與注意¶
適合:長期在 Windows 上用 Harness Desktop 跑 Agent、希望任務狀態始終可見、並經常在後臺批准工具或快速回復的用戶。
注意:
- 僅適配 README 寫明的 Harness Desktop 0.2.1-rc.5 / Windows;換宿主版本前應看倉庫
VALIDATION.md與測試腳本說明。 - 社區插件,DeepSeek 名稱與商標歸其所有者;SkillHub 目錄與 DeepSeek / 幻方無官方從屬關係。
- 費用估算僅供參考,實際扣費以 DeepSeek 賬單爲準;高峯時段按 README 表格中的北京時間規則計價。
- 卸載可走
scripts/install-desktop.ps1 -Action Remove(需已退出 Harness);停用插件後窗口隨宿主關閉。
結尾¶
dsh-island 把 Harness 裏「Agent 在幹什麼、要不要你點一下」濃縮到屏幕邊緣,並在展開面板裏補上用量與簡短對話入口,適合不想一直盯着主窗口的桌面用戶。更多截圖、狀態說明與開發細節見倉庫 README。
- 目錄頁:https://www.skillhub.cn/plugins/a961282799-crypto/dsh-island
- GitHub:https://github.com/a961282799-crypto/dsh-island