前言¶
在 DeepSeek Harness（DSH）裏同時跑多個會話時，很難一眼知道哪個會話還在執行、哪個已經失敗、哪個正等你審批。通常得逐個點開窗口確認，狀態越多越亂。Taskball 的思路是做一個常駐懸浮球，把每個會話的狀態用顏色畫在球上，掃一眼就知道全局。
它是由社區開發者 ef-umbra 維護的第三方插件（GitHub 項目 ef-umbra/dsh-useful-taskball，MIT 許可），屬於「客戶端」類插件。DSH 的理念是「一切皆插件」，Taskball 就是掛在客戶端側的一個界面擴展。下文按功能、安裝、用法的順序介紹。
定位與狀態顏色¶
Taskball 把會話狀態映射成五種顏色：
| 顏色 | 含義 |
|---|---|
| 紅 | 任務中斷或失敗 |
| 黃 | 有任務等你審批或決策 |
| 藍 | 有任務正在執行 |
| 綠 | 任務已完成 |
| 灰 | 暫無任何狀態 |
球按有狀態的會話數等分扇區，每個扇區顯示對應會話的顏色。一個會話同時命中多種狀態時取優先級最高的：紅 > 黃 > 藍 > 綠。沒有任務時球是灰色。
核心功能¶
一眼看全局。 每個扇區對應一個會話，顏色即狀態。會話增減時扇區平滑滑開或收攏。
點開就是任務面板。 按工作區分組列出待處理會話，點標題直接跳過去。面板裏勾了「已處理」，球上對應扇區同時消失，球和麪板保持一致。
狀態突變提醒。 狀態從「執行中」變成失敗或待審批時，球旁邊彈出氣泡通知。完成態是否提醒可以自己設。
完成的任務自動收納。 已完成會話收進面板底部，可展開、可撤銷，超過保留時長後自動消失。失敗、待審批、執行中的任務不會自動消失，必須手動處理。
草稿也可見。 寫了半句還沒發出的會話排在面板最上方，點一下回去接着寫。行首圖標區分：文件夾表示還沒寫過內容的新會話，氣泡表示聊過且留着半句話的老會話。
可以收起。 右鍵選擇收起後，球變成一條細豎條貼在輸入框左邊，豎條按任務狀態分段着色，一個任務一段；點一下變回球，位置仍是收起前的位置。
安裝¶
要求 DSH 0.2.1-rc.3 或更高版本。社區目錄頁的插件版本爲 0.10.2。
從 npm 安裝（推薦）：
dsh plugin add dsh-useful-taskball
也可以從 GitHub 直接裝：
dsh plugin add github:ef-umbra/dsh-useful-taskball
用 GitHub 方式時，DSH 會詢問是否允許運行構建腳本，選允許即可，包需要現場編譯出產物。
典型用法¶
球本身的操作：
- 拖動到順手的位置，位置會記住。拖到側欄分界線或屏幕邊緣附近鬆手，球自動吸附；之後側欄展開、右欄開關、窗口縮放，吸附的球會跟着移動。
- 單擊展開任務面板，再點一次收起。
- 右鍵打開快捷設置，含球大小、磨砂、面板不透明度、狀態突變提醒、是否顯示已處理區、面板字號等常用項。鍵盤可用
Shift+F10調出，或點面板首行的齒輪。
處理任務：
- 每行右側勾選框即「已處理」，勾上後該行移到下方摺疊區，可隨時撤銷。
- 失敗任務直接勾選時會先確認：整行滑走，原位出現「取消 / 確認已處理」，點確認才真正摺疊，按
Esc可取消。 - 按住
Shift再勾選失敗，會列出當前所有待處理的失敗會話，一次確認全部處理。 - 按住
Shift再勾選已完成，直接收納全部已完成會話，無需逐個確認。
讓紅色退場的三種方式：勾選「已處理」、歸檔該會話，或回到對應會話發一條消息。
設置¶
入口在 DSH 的「插件 → 已安裝插件 → Taskball · 任務狀態懸浮球」，也可在快捷面板裏點「打開全部設置」。分三個標籤：
外觀：懸浮球大小（小 / 中 / 大）、面板質感（不透明度滑塊 + 磨砂玻璃開關，默認半透明磨砂）、色盲友好配色（把失敗與完成的紅綠換成紫紅和青綠）、狀態表示（矩形或圓點）、面板字號、是否顯示已處理區、是否顯示已處理計數。
動效：勾選動畫（向外淡出 / 向下移入）、吸附距離（設爲 0 則完全不吸附）、氣泡顯示時長、點擊面板外是否關閉。
通知：狀態突變提醒（默認開啓，關閉後任何氣泡都不彈，包括失敗提醒）、完成態保留時長。
適用場景與注意事項¶
適合同時維護多個 DSH 會話、需要頻繁切換並快速判斷哪些任務已失敗或待審批的開發者，尤其適合值班或多人協作時盯任務池的場景。
需要注意幾點：
- 這是第三方社區插件，不是 DSH 官方項目，與 DeepSeek 官方沒有隸屬或背書關係；社區目錄是獨立站點，也不是官方應用商店。
- 插件以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證（本項目爲 MIT 許可），再決定是否引入。
- 作者自述這是「vibe coding」項目，由人與 AI 協作寫成，可用性優先於工程完備；屬於個人項目，沒有團隊維護，Issues 不一定能及時響應。
- GitHub 安裝方式會執行構建腳本，屬於較敏感操作，確認腳本內容後再選擇允許。
結尾¶
Taskball 的價值在於把分散在多個會話裏的任務狀態收斂到一個常駐的視覺焦點上，減少逐個翻面板確認的動作。如果你已經在用 DSH 0.2.1-rc.3 或更高版本，且管理着不止一個會話，值得裝一個試試。
目錄頁：https://www.skillhub.cn/plugins/ef-umbra/dsh-useful-taskball
GitHub：https://github.com/ef-umbra/dsh-useful-taskball
