前言¶
在 DeepSeek Harness（DSH）的開發實踐中，一次派發多個任務往往導致智能體無法深入，或者希望智能體幹完一件事後自己找下一件事。dsh-todo-board 是一個給 DSH agent 的跨會話 TODO 板。它以右上角浮窗的形式存在，按工作目錄分組，支持拖動排序。每條待辦可以設定不同的執行模式，AI 完成後調用接口打勾，用戶驗收後勾選，真正了結任務。
安裝與啓用¶
安裝命令如下。安裝後必須重啓 Profile（重新執行 dsh web）纔會裝載，因爲插件是 host 組合裏的一行，不是運行時熱加載。
dsh plugin --profile web add dsh-todo-board
核心功能¶
執行模式
每條待辦在新增時必須選一檔（默認「提醒」），可獨立選擇「提醒」、「自動續跑」或「自動新開會話」。新增框裏的「目錄」決定這條待辦歸屬哪個目錄，留空則跟隨當前會話的工作目錄。派發順序即面板裏從上到下的順序。
任務狀態與雙勾選
任務狀態由實時會話列表推導，不落盤。每一行都有一個狀態標籤。左勾代表 AI 已完成（等待驗收），右勾代表用戶驗收（真正了結）。只有右勾纔會將任務從未完成列表移除，並進入下方獨立的「已完成」列表。已完成的行不參與執行順序。
界面與分組
面板是一個浮窗，支持摺疊、縮放，位置和尺寸記在 localStorage。待辦按工作目錄分組，列表順序即執行順序。支持四種界面風格（票據/素白/緊湊/隨主題）切換。
長任務規劃
長任務可以拆成步驟，通過 /todo <目標> 命令或直接粘貼模板注入，一次調用寫入整份計劃、一次審批。
其他能力
- 圖片附件：支持 Ctrl+V 粘貼截圖，最多 4 張，派發時作爲真正的圖片發給模型。
- 定時執行：可設定本地時間到點才執行，列表裏隨時可改。
- 卡住自愈：派發失敗會記錄並按退避重試，絕不靜默退休。
- 開發者日誌：面板內可查看日誌。
典型用法¶
- 右上角浮窗出現，輸入待辦內容，選擇執行模式，點擊「添加」。
- AI 執行時，完成後會調用
todo_board action=done給自己打左勾，然後自動查找同目錄下一條未完成待辦並繼續執行。 - 用戶驗收後點擊右勾，該行移入「已完成」列表。底部「清理已驗收」可批量刪除。
適用場景與注意¶
本插件適合需要精細化管理智能體任務進度的場景。使用前需注意：
- 版本要求：本插件 0.11.2 起要求 DSH ≥ 0.1.7-rc.2，並在 DSH 0.2.0-rc.2（桌面端）上驗證。
- 權限限制：AI 改板子需經過 DSH 原生審批框，板子路由需瀏覽器會話憑據。
- 數據存儲：板子是全局單文件（
${DSH_HOME}/todo-board/board.json），原子寫入。
