前言¶
在 DSH 裏跑多步任務時，工作區少了一層輕量的中間狀態：哪些事還沒開始、哪些正在做、哪些等人複覈。常見做法是把這些寫進對話歷史或另起一個 todo 文件，時間一長就散落，agent 也難以按統一狀態取用。dsh-kanban 想用插件解決這個問題：每個項目一張看板，人負責把任務從草稿推進到「可以做了」，agent 從「可以做了」接走並維護後續狀態。下面介紹它的定位、功能、安裝與典型用法。
這是什麼¶
dsh-kanban 是一個 DSH 客戶端插件，由 fourclub 維護，社區目錄把它歸入工作流類（星標 1，當前版本 0.2.3，MIT）。它給每個項目生成一張 Kanban 看板，數據落在項目工作區裏，並註冊 kanban_* 工具讓 agent 直接讀寫任務。解決的是兩件事：任務狀態不再散落在對話裏，人有統一視圖；agent 有穩定的「取下一個可做的事」入口。
五列狀態與草稿¶
看板固定五列：
| 列 | 含義 | 誰能移動 |
|---|---|---|
| Backlog | 草稿／想法，agent 不碰 | 人 |
| 可以做了（To Do） | 就緒，agent 可以領取 | 人用「可以做了」按鈕置入 |
| 進行中（In Progress） | agent 已領取 | agent |
| 待複覈（Review） | 等人決策或答覆 | agent |
| 已完成（Done） | 任務結束 | agent（若被允許）或人 |
新任務默認建在 Backlog 列，作爲草稿：可以隨時長期編輯，不會出現在 agent 的取用範圍裏。點「可以做了」把它置入 To Do，同時啓動一次 agent 會話。草稿到就緒這道閘門，是整塊看板的核心。
卡片與任務詳情¶
每張卡片顯示優先級、標籤、最近活動，以及三個計數器：agent（含子 agent）、子 agent、後臺 job。點擊卡片，右側面板以只讀的「任務」頁籤打開：分組後的元數據（列、優先級、負責人、日期、是否草稿）、agent 狀態、標籤、佔滿高度的描述、該任務的會話。頂部「編輯」按鈕把面板切到編輯模式，可改標題、描述、優先級、標籤，也可以移動或刪除任務。
只讀模式另有兩個頁籤。「評論」是帶作者與時間的條目流加輸入框，Ctrl+Enter 發送；「日誌」記錄完整歷史：創建、列間移動（含「從 → 到」）、修改、負責人、草稿狀態、agent 狀態。評論保存在看板文件裏，同時顯示在日誌中。卡片上的鉛筆圖標可以在獨立模態窗口打開同一份信息，右側面板被別的任務佔用時用得上。寬看板下表頭和各列頭固定，列內列表各自滾動，已完成列堆上百條也不會把整塊看板拉長。
Agent 工作流¶
Host 部分註冊 kanban_* 工具，向 agent 追加一段系統提示，併爲每個任務維護會話。agent 不能碰草稿，也不能自行把任務置爲 To Do，或從 Review 直接關閉。工具共十個：kanban_get、kanban_get_item、kanban_create_item、kanban_update_item、kanban_move_item、kanban_next、kanban_assign、kanban_set_status、kanban_delete_item、kanban_set_code。其中 kanban_next 取「可以做了」列的第一條任務，把它移入「進行中」並綁定到當前會話。
看板每 3 秒輪詢一次 API；來自 agent 的改動會讓對應卡片高亮。
數據與安全性¶
每個項目一個 JSON 文件：<workspace>/.dsh-kanban.json，帶版本化 schema 並自動遷移；文件損壞時先備份，再以空看板替換。數據不離開項目，客戶端只訪問該插件自身的 same-origin 路由 /api/kanban。切換項目就是切換看板。
安裝與啓用¶
dsh plugin --profile desktop add github:fourclub/dsh-kanban
或從本地目錄安裝：
dsh plugin --profile desktop add /path/to/dsh-kanban
安裝後需要重啓 Harness。「Kanban」頁籤會出現在 Chat 與 Trajectory 旁邊，左側 sidebar 裏該項目會出現看板圖標。運行環境要求 DeepSeek Harness Web/Desktop 支持客戶端插件（dsh.client）；詳情面板依賴 sidebarRight/sidebarRightTabs 服務，缺失時改用備用對話框打開；構建需要 Node.js ≥ 20。許可證 MIT，見倉庫 LICENSE。
典型用法¶
開始一個項目時：
1、先在 Backlog 列建草稿，慢慢編輯到可執行。
2、點該任務的「可以做了」，插件把它移入 To Do 並拉起 agent 會話。
3、agent 用 kanban_next 取走任務後進入「進行中」，完成後移入「待複覈」。
需要人介入時，任務停在「待複覈」，agent 不會自行關閉；人確認後可以把它移到「已完成」，也可以通過 kanban_move_item／kanban_set_status 調整狀態。
適用場景與注意¶
適合想在 DSH 裏把多步任務顯式分層、並讓 agent 按統一狀態取用的人；面向單輪對話、不需要狀態板的項目不必引入。插件以當前 dsh 進程的權限運行，可以讀寫項目文件並給 agent 註冊工具；安裝前建議先讀一遍源碼，確認加載方式符合預期，並留意 MIT 許可證下的再分發邊界。倉庫提供三條開發命令：
npm install
npm run typecheck
npm test
npm run build
npm run build 會重新生成提交進倉庫的 lib/client.js 產物（host 代碼與客戶端產物都在倉庫裏），因此 CI 不是必需步驟。
結尾¶
dsh-kanban 沒有引入新的「項目管理系統」概念，它把任務列成五列寫進項目自己的 JSON 文件，同時給 agent 留出一套最小工具。功能細節和源碼見目錄頁與 GitHub：https://www.skillhub.cn/plugins/fourclub/dsh-kanban 、https://github.com/fourclub/dsh-kanban 。
