前言¶
在 DeepSeek Harness(DSH)裏跑智能體時,任務狀態往往散落在對話記錄、臨時筆記或各自維護的列表裏。人改一處、Agent 改另一處,重啓後更容易對不上。DSH 社區插件普遍走「一切皆插件」路線;工作流類插件要做的,是把狀態和界面收進同一套 Harness 進程裏。下面介紹維護者 ssalentin 的 dsh-kanban-board:五列看板、Web 疊加層,以及 Agent 側的 kanban 工具,數據落在單個 JSON 文件裏,重啓後仍保留。
這是什麼¶
dsh-kanban-board 是面向 DeepSeek Harness Web GUI 的看板插件。你在瀏覽器裏拖拽卡片、編輯子任務和標籤;智能體通過 Host 註冊的 kanban 工具讀寫同一塊板。官方簡介概括爲:帶 Web GUI 的任務看板,支持子任務、彩色標籤與看板內對話。
- 維護者:ssalentin(Sebastian Salentin)
- 分類:工作流
- 許可證:MIT(
package.json標註版本 1.19.0) - 目錄頁:https://www.skillhub.cn/plugins/ssalentin/dsh-kanban-board
- 源碼:https://github.com/ssalentin/dsh-kanban-board
核心功能¶
看板與交互¶
五列固定流程:Backlog → Prioritized → Doing → Block → Done。支持列間拖拽、橫向平移與邊緣自動滾動;Done 列默認可摺疊爲窄條,拖入仍可標記完成。右下角 Board 膠囊或 Ctrl/Cmd + Shift + K 打開疊加層(設置裏快捷鍵名稱爲「Open board」)。看板打開時每 1.5 秒輪詢;他人或 Agent 改動的卡片會短暫高亮(尊重減弱動畫偏好時爲靜態描邊)。
每張工單有永久短編號(如 #42),刪除後不重用;內部 id(k-…)與 #42 在工具和界面中均可使用。右鍵工單可複製 ID 或進入編輯。
工單內容與協作¶
工單編輯器以疊加對話框承載:標題、備註、子任務(卡片上顯示進度條與 done/total)、彩色標籤(藍/綠/琥珀/紅/灰/紫)、可選截止日期(YYYY-MM-DD)、命名鏈接(僅 http/https)、依賴關係、評論線程。評論支持受限 Markdown 子集(粗體、列表、代碼塊等),界面語言含英語、德語與簡體中文。
支持任務依賴:卡片展示等待項與阻塞關係;Agent 工具輸出中帶 ⛓ depends on 與 ⇠ blocks。看板頂部 ✦ Ask 欄可用自然語言操作看板(需 profile 配置默認模型);模型可先 find / show / list 再執行變更,並保留最近幾輪上下文。
Agent 工具與會話記憶¶
Host 暴露全局工具 kanban,動作包括 list、show、find、add、update、move、delete、reorder、subtask_*、tag_*、comment_*、link_* 等。當前 Agent 會話會記住本對話中編輯或檢索過的工單;省略 id 時可指向最近工單,"lastMentioned" / "lastEdited" 用於多輪跟進。
數據路徑爲 $DSH_HOME/kanban/board.json(通常爲 ~/.dsh/kanban/board.json),原子寫入。Host 部分僅依賴 node: 內置模塊,無構建步驟。
安裝與啓用¶
環境要求:
- DeepSeek Harness 0.2.x,且啓用 Web 應用(開發與測試基線爲 0.2.1-rc.5)。
- Profile 中配置默認模型,供看板聊天使用(任意 OpenAI 兼容 / DeepSeek 提供商均可)。
按 README 安裝到 profile(示例以 GitHub 源爲主):
# from GitHub
dsh plugin --profile web add github:ssalentin/dsh-kanban-board
# from npm (if published)
dsh plugin --profile web add dsh-kanban-board
# from a release tarball
dsh plugin --profile web add ./dsh-kanban-board-1.3.0.tgz
包內聲明 dsh.bundle 補丁(cordis.patch.yml),會作爲 profile bundle 接入。在 Plugins 中啓用 Kanban Board(若未自動啓用),然後刷新頁面一次。本地開發可直接用 Plugin Manager 安裝目錄。插件更新後同樣需要刷新頁面,以便瀏覽器端加載新 bundle。
典型用法¶
在界面裏操作¶
- 點擊右下角 Board 或 Ctrl/Cmd + Shift + K 打開看板。
- 拖拽工單換列,或在工單上點開編輯器維護子任務、標籤、依賴與評論。
- 用
/聚焦搜索框;可組合標籤篩選、逾期與「等待依賴」開關。 - 只讀模式下(看板頭鎖定開關)隱藏編輯控件,仍可拖拽改列狀態。
讓 Agent 改同一塊板¶
工具調用示例(摘自 README):
kanban { action: "move", id: "k-1a2b3c4d", column: "block" }
kanban { action: "comment_add", body: "blocked on infra" } // same ticket, no id needed
kanban { action: "find", query: "login redirect" } // locate + remember tickets
kanban { action: "delete" } // the last ticket mentioned
看板聊天示例意圖:「add a task to review the PR and tag it urgent」「what’s blocked?」——具體行爲受 README 中的限額與超時約束(如提示 ≤ 2000 字符、單次最多 20 個操作、模型超時 45 秒)。
適用場景與注意¶
適合在 DSH Web 工作區裏做人機共管的待辦與阻塞跟蹤:你拖拽列、Agent 在會話中 add / move / comment_add,無需單獨任務系統。依賴、標籤與子任務適合稍複雜的協作流;單文件持久化便於備份,但也需注意文件權限。
權限與安全:插件與當前 dsh 進程同源運行,能讀寫其配置的數據目錄。安裝前請閱讀 源碼倉庫 與 MIT 許可證,確認符合你的審計要求。社區目錄 SkillHub 獨立於 DeepSeek / 幻方,並非官方應用商店。
規模上限以 README「Limits」爲準(例如最多 500 張工單、每工單最多 50 個子任務等);超出時服務端會拒絕變更且不落盤。
結尾¶
經過上面的步驟,你可以在 DSH Web GUI 裏用五列看板統一人和 Agent 的任務視圖,並用 kanban 工具或看板內對話保持同步。進一步瞭解請查看目錄頁 https://www.skillhub.cn/plugins/ssalentin/dsh-kanban-board 與 GitHub https://github.com/ssalentin/dsh-kanban-board。