前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在使用 DSH Web 進行智能體開發或工作流編排時，面對多個 Session、Workspace 以及複雜的任務狀態，缺乏一個直觀的集中視圖可能會降低效率。dsh-ds-kanban 是一個外部 bundle 格式插件，它爲 DSH Web 提供了一個側邊欄入口和一個全屏實時看板。
該插件不替換 Harness 的應用殼，也不存儲獨立的任務數據庫。它基於現有的 Session、Workspace、projection、pending-interaction 和 connection 服務進行投影，將 Inbox/Ready 的手動放置和視圖偏好存儲在現有的設置能力中。
核心功能¶
該插件提供以下功能：
- 側邊欄徽章：顯示等待、失敗、受阻、高上下文壓力的任務計數。
- 全屏實時看板：包含收件箱、就緒、運行中、等待、受阻或失敗、空閒、目標完成列。
- 交互與篩選：支持實時統計、搜索和篩選，工作區分組，以及密度和時間戳控制。
- 數據導出與操作：提供顯式的 JSON/CSV 導出，支持任務創建、導航、取消、歸檔以及任務 ID 複製。
- 狀態過濾：提供“需要關注”狀態過濾，用於查找待審批、失敗、受阻等任務。
安裝與啓用¶
在安裝之前，請確保 Harness 版本爲 0.1.2-alpha.1 或更高版本。
使用官方命令添加插件：
dsh plugin --profile <name> add dsh-ds-kanban
安裝、更新或移除插件會改變配置文件組合和客戶端 bundle 發現，安裝後需要重啓 Host 才能生效。
安裝完成後，在側邊欄選擇 DS Kanban 即可打開看板。更新時再次執行 add 命令即可，移除時執行：
dsh plugin --profile <name> remove dsh-ds-kanban
典型用法¶
看板支持鍵盤快捷鍵和鼠標操作：
- 打開任務：點擊卡片或聚焦後按
Enter打開其 Harness 任務。 - 列間導航：使用左右箭頭在已填充的列之間移動焦點。
- 搜索：按
/聚焦搜索框。 - 關閉看板：按
Escape關閉看板或對話框。 - 拖放：只有收件箱和就緒列中的空白卡片可以被拖放。
- 關注狀態：導航到“需要關注”以查找待審批、失敗、受阻等任務。
實現與安全¶
- 實現：插件聲明瞭
dsh.bundle.patch。它通過生命週期擁有的插槽貢獻一個側邊欄頁腳操作和一個 Shell 覆蓋層。board.ts是純權威狀態投影，settings.ts擁有手動放置和視圖偏好。Host 不添加 HTTP 路由，瀏覽器 mutations 複用已暴露的 RPC 服務。 - 安全與隱私：插件不執行外部網絡請求，不啓動服務器，不執行 shell 命令，不發送遙測。它讀取列表摘要和輕量級生命週期/投影狀態，但不請求 transcript 內容。拒絕未知的設置格式。
注意事項¶
- Goal complete：意味着持久目標完成，不意味着審查者接受。
- 陳舊狀態：運行中的卡片如果停止報告會被標記爲陳舊。
- 自動狀態覆蓋：自動狀態始終覆蓋手動收件箱/就緒放置。
- 設置格式：拒絕未知的設置格式，Client 會保留其最後一次接受的快照。
該插件由 Stijnus 維護，許可證爲 MIT。更多技術細節可參考 GitHub 倉庫。
