前言¶
在 DeepSeek Harness (DSH) 中，智能體通常使用內置的 todo_write 工具記錄任務計劃。官方界面將計劃渲染爲輸入框上方的細條，但這條細條容易錯過，且在智能體持續工作時會自動摺疊，導致進度不可見。
這就帶來一個問題：當智能體運行十分鐘不結束時，用戶往往需要翻閱對話記錄才能回答“進度如何”。dsh-todo-float-ball 將這份清單移至屏幕上常駐的懸浮球中，解決進度可見性問題。
這是什麼¶
這是一個 DeepSeek Harness (DSH) 的客戶端插件，由開發者 loyalchiiina 維護。它將智能體的任務清單轉化爲一個常駐屏幕的、可拖拽的懸浮球，實時顯示完成進度和當前任務狀態。
插件採用 MIT 許可證，無任何數據上傳或遙測行爲。
核心功能¶
- 常駐懸浮球：球體默認位於屏幕右下角，支持拖拽，位置保存至
localStorage，關閉重啓後自動恢復。 - 實時進度顯示：球面直接顯示
done/total比例及環形進度條，下方顯示當前正在進行的任務名稱。 - 雙路數據同步：通過 DOM 觀察者監聽官方 todo 面板，並結合會話投影幀解析，確保即使官方面板摺疊，清單依然完整。
- 歷史歸檔：當新計劃覆蓋舊計劃時，舊任務不會消失，而是進入“歷史歸檔”區域。
- 固定會話：支持固定多個會話，並在面板中並排顯示，便於並行工作的狀態監控。
- 膠囊模式：在懸浮球上右鍵點擊，可切換爲僅顯示當前任務和計數的膠囊形態。
- 皮膚系統：與
dsh-skill-browser和dsh-font-enhancer共享 120+ 款皮膚目錄。 - 紀律注入：默認開啓，強制每輪對話的第一個工具調用必須是
todo_write，防止智能體遺漏計劃。
典型用法¶
- 展開/摺疊：點擊懸浮球展開完整任務面板，再次點擊或按
Esc鍵摺疊。 - 膠囊模式：在懸浮球上右鍵點擊，切換爲僅顯示當前任務和進度的膠囊形態。
- 拖拽定位：按住球體拖動到任意位置，位置信息會按配置文件獨立保存。
- 狀態識別：根據球體顏色判斷狀態：橙色脈動表示進行中，綠色表示全部完成，藍色表示僅待辦，灰色表示暫無清單。
- 歷史管理：在面板歷史區，可以對舊任務進行隱藏、批量清理或一鍵恢復。
- 佈局切換：支持將固定會話的列表在“上下堆疊”和“左右並排”兩種佈局間切換。
適用場景與注意¶
- 零侵入：插件基於 Shadow DOM 和
all:initial實現樣式隔離，不修改官方面板、對話或其它插件，不產生遙測數據。 - 零配置：安裝後即可使用，無需配置文件。
- 雙端支持：同一份代碼庫同時支持 Electron 桌面端和 Web 網頁端。
- 紀律注入說明：插件默認開啓“紀律注入”，要求每輪對話的第一個工具調用必須是
todo_write。如需關閉，需在配置中顯式設置enforceFirstTodoWrite: false。只有顯式布爾false纔會關閉該功能。
總結¶
dsh-todo-float-ball 是一個爲 DSH 長任務運行設計的輕量級 UI 輔助工具。它通過常駐懸浮球解決了進度追蹤的痛點，適合需要長時間無人值守運行智能體的開發者使用。
