前言¶
在使用 DeepSeek Harness Web profile 進行開發或協作時，通常需要同時管理多個會話中的任務。分散的任務狀態和跨工作區的任務追蹤可能帶來操作上的不便。dsh-taskboard 插件旨在解決這個問題，它將一個任務看板入口添加到 DSH 側邊欄，聚合所有可見 DSH 會話的最新 todo_write 投影，並提供統一的視圖進行管理。
插件定位¶
這是一個跨項目任務看板插件。它爲 DSH Web profile 添加了一個任務看板按鈕，聚合所有可見 DSH 會話的最新 todo_write 投影，併爲每個任務標記其所屬的工作區和會話。插件不維護單獨的任務存儲、不添加服務器、也不寫入瀏覽器本地任務，而是完全依賴 DSH 的原生機制。
安裝與啓用¶
在安裝前，請確保你的 DeepSeek Harness 版本與該插件的 peer dependencies 兼容。
- 進入插件目錄，安裝依賴並構建：
pnpm install
pnpm run build
- 將構建好的本地包安裝到 Web profile：
pnpm dsh plugin --profile web add ../dsh-taskboard
- 安裝完成後，需要重啓 Web profile 才能生效：
pnpm dsh --profile web
核心功能¶
- 側邊欄集成：在 DSH 側邊欄添加任務看板按鈕。
- 投影聚合：聚合所有可見 DSH 會話的最新
todo_write投影。 - 上下文標記：爲每個任務明確標記其工作區和會話。
- 原生狀態識別：使用 DSH 原生生命週期顏色識別待辦和已完成任務。
- 實時狀態條：進行中的任務顯示實時活動條，而非百分比。
任務與會話操作¶
看板顯示當前所有可見未歸檔會話的 todo 投影。
- 同意與確認：進行中的任務僅顯示“同意”或“確認”操作。顯示“同意”取決於 DSH 會話的待處理批准狀態；顯示“確認”取決於計劃審查狀態。DSH 允許每個會話有一個進行中的任務。
- 批量選擇：按住
Ctrl(Windows/Linux) 或Command(macOS) 並點擊可進行中的任務卡片，可以批量選擇其所屬會話。 - 歸檔操作：在會話側邊欄可以打開會話並執行歸檔。歸檔調用 DSH 的真實工作區會話歸檔 API，歸檔的是會話而非單個任務。批量歸檔同樣作用於選中的會話。
數據與歷史¶
- 數據同步：任務列表來自 DSH 的持久化
todo/write會話事件，並在可見會話收到新結果時實時更新。由於 DSH 擁有任務創建和狀態變更的管理權，看板列表與 DSH 內置任務工具不會 diverge。 - 歷史記錄：歷史
todo/write事件保留在會話日誌中，但插件不創建單獨的任務歷史或持久化格式。
注意事項¶
- 兼容性：需要使用與 peer dependencies 兼容的 DeepSeek Harness 版本。
- 重啓：安裝後必須重啓 Web profile。
- 範圍限制：看板僅顯示當前所有可見未歸檔會話的投影，不顯示歷史任務。
dsh-taskboard 提供了一個輕量級的視圖層，幫助開發者在不引入額外存儲層的情況下，更直觀地管理多會話任務。更多細節可參考社區目錄或源碼。
