前言¶
在 DeepSeek Harness (DSH) 中,智能體負責處理任務,但如果缺乏結構化的工作流,任務狀態容易混亂。dsh-kanban-flow 插件提供了一個基於看板的界面,強制執行人類與智能體之間的協作流程。它將每個工作區映射爲一個看板,每個任務對應一個獨立的智能體會話,確保任務流轉有跡可循且受控。
這是什麼¶
dsh-kanban-flow 是一個 Agent 驅動的看板插件,專爲 DeepSeek Harness 設計。
- 核心定位:每個工作區一個看板,每個任務一個智能體會話,強制執行人類/智能體工作流。
- 維護者:thomasvvugt
- 許可:MIT
- 依賴:基於
dsh-kanban插件架構,構建於 DSH 0.1.1-rc.2。
核心功能¶
固定列與工作流強制執行¶
看板的列是固定的,從左至右依次爲:Backlog → To Do → In Progress → Review → Done。插件通過 kanbanflow_move_item 工具攔截非法移動,確保工作流符合規則:
- Backlog → To Do:僅允許人類將任務移入此列,作爲智能體接手的觸發點。
- To Do → In Progress:智能體確認接手後執行。
- In Progress → Review:智能體完成工作並請求人類審查。
- Review → In Progress:人類在任務會話中反饋後,智能體繼續處理。
- Done → In Progress:人類在已完成的任務中回覆,重新打開任務。
- In Progress → Done:僅當“完成確認”選項關閉時,智能體可自行完成;開啓時必須由人類拖動 Review → Done。
智能體工具集¶
插件爲智能體提供了以下工具,用於操作看板:
kanbanflow_get:獲取看板概覽。kanbanflow_get_item:獲取特定任務信息。kanbanflow_create_item:創建新任務。kanbanflow_update_item:更新任務內容。kanbanflow_move_item:移動任務(受工作流限制)。kanbanflow_delete_item:刪除任務(歸檔會話)。kanbanflow_set_status:設置任務狀態(顯示在卡片懸停提示中)。kanbanflow_set_code:設置工作區代碼(2-6 字符)。
界面與交互¶
- 本地存儲:數據存儲在
<workspace>/.dsh-kanban-flow.json,支持模式版本化,自動遷移。 - UI 設計:支持淺色/深色模式,利用 DSH 設計令牌,支持響應式佈局(桌面橫向,移動端縱向)。
- 動畫:包含創建、移動的過渡動畫,以及智能體變更時的脈衝效果。
安裝與啓用¶
在終端執行以下命令安裝插件:
dsh plugin --profile web add dsh-kanban-flow
安裝完成後,重啓 dsh web 服務。確認安裝成功的標誌是在配置輸出中找到 dsh-kanban-flow 層,且側邊欄的每個工作區旁邊會出現一個看板圖標。
典型用法¶
- 初始化:確保
dsh web已重啓,點擊側邊欄中的看板圖標進入對應工作區的看板。 - 創建任務:在 Backlog 列創建新卡片(可通過智能體工具
kanbanflow_create_item或直接在 UI 操作)。 - 流轉任務:人類將卡片從 Backlog 拖動到 To Do。
- 智能體工作:智能體在對應的任務會話中開始處理,並在移動卡片到 Review 列前設置狀態說明。
- 人工審查:人類在 Review 列審查結果,若通過則拖動到 Done;若需修改,則在會話中回覆,卡片自動回退到 In Progress。
適用場景與注意¶
- 適用場景:需要嚴格管理任務狀態流轉的團隊,或希望利用智能體處理具體任務但需要人類把控最終交付質量的場景。
- 注意事項:
- 插件無安裝時腳本或構建步驟,通過 npm 直接分發。
- 所有數據存儲在本地工作區目錄下,不會離開該目錄。
- 插件爲全英文界面。
短結尾¶
dsh-kanban-flow 通過將任務狀態與智能體會話綁定,爲 DSH 增加了一個可控的工作流層。它沒有改變 DSH 的核心邏輯,而是通過插件機制補充了可視化的任務管理能力。
- 項目主頁:https://github.com/thomasvvugt/dsh-kanban-flow
- 目錄頁:https://www.skillhub.cn/plugins/thomasvvugt/dsh-kanban-flow