前言¶
DeepSeek Harness（DSH）裏的插件通常圍繞對話、工具和瀏覽器界面組合使用。對智能體開發者來說，規劃、功能拆解和缺陷跟蹤很容易散落在聊天記錄或外部文檔裏。dsh-project-kanban 把看板放進 DSH 內部：agent 在對話中使用 kanban_* 工具寫規劃卡片，看板按工作區（項目）隔離，數據寫入磁盤。
這是什麼¶
dsh-project-kanban 是 DeepSeek Harness 內的看板插件，由 StruggleYang 維護，許可證爲 MIT。
它解決的是“在 DSH 會話中順手維護項目卡片”的問題：瀏覽器會話頭部提供“看板”tab，agent 工具端可以寫規劃卡片，數據落到 kanban-board-<workspaceId>.json。
核心能力¶
下面按常見使用順序列出已覈實的插件能力。
- Agent 規劃卡片：Agent 使用
kanban_*工具在規劃和功能拆解時直接寫卡片。 - 按項目隔離：看板按工作區（項目）隔離。
- 磁盤持久化：數據持久化到
kanban-board-<workspaceId>.json。 - 瀏覽器入口：瀏覽器會話頭部提供“看板”tab。
- 卡片標籤與顏色：支持功能、缺陷、文檔、優化等標籤和顏色，支持任意
#rrggbb自定義卡片顏色。 - 優先級：支持
high/medium/low優先級及顏色條。 - 排序與複製：支持列內排序和一鍵複製卡片。
- 篩選搜索：支持關鍵字、標籤、優先級篩選和搜索。
- 截止日期：支持
YYYY-MM-DD截止日期和逾期高亮。 - 回收站：支持刪除到回收站、恢復或徹底刪除。
- 批量操作：支持多選批量移動、打標或移入回收站。
- 統計：支持按標籤、優先級和逾期數量統計。
- 拖拽：支持拖拽卡片插入到其他卡片位置。
- 模板列：支持
default/dev/content模板列預設。 - 撤銷：支持 50 步撤銷。
- 跨項目：支持跨工作區移動卡片。
- 來源會話：支持記錄卡片來源會話並跳回。
安裝與啓用¶
安裝前需要已安裝 dsh CLI，並選擇目標 profile。默認瀏覽器 profile 爲 web。
從 GitHub 安裝¶
推薦從 GitHub 安裝：
dsh plugin --profile web add github:StruggleYang/dsh-project-kanban
如果 pnpm ≥ 10 首次安裝 git 依賴時拒絕運行 prepare script，需要把 pnpm 輸出的 package key 寫入目標 profile 的 pnpm-workspace.yaml：
allowBuilds:
dsh-project-kanban: true
然後重新執行 add。allowBuilds 會授予安裝時代碼執行權限，只應對信任源啓用。如果考慮固定 commit，可以使用帶 commit 的安裝形式，例如將 <commit-sha> 替換爲實際 commit：
dsh plugin --profile web add github:StruggleYang/dsh-project-kanban#<commit-sha>
從本地倉庫安裝¶
也可以先克隆倉庫，再按本地路徑安裝：
git clone https://github.com/StruggleYang/dsh-project-kanban.git
dsh plugin --profile web add ./dsh-project-kanban
使用 npm 包名安裝¶
如果通過 npm 包名安裝：
dsh plugin --profile web add dsh-project-kanban
驗證與啓用¶
安裝後先驗證配置層：
dsh --profile web --dump-config
輸出應以 # == dsh-project-kanban layer 結尾。
然後重啓 dsh web。重啓後，kanban_* 工具會出現，會話頭部會出現“看板”tab。
卸載¶
卸載命令：
dsh plugin --profile web remove dsh-project-kanban
這會移除依賴和 layer，但看板數據文件會保留在磁盤。
典型用法¶
安裝並重啓後，可以在對話和瀏覽器看板之間配合使用。
1、在 DSH 會話中說明需求，例如“把這個需求拆成規劃卡片”或“給這張卡片改優先級”。Agent 會通過 kanban_* 工具寫入或更新卡片。
2、打開瀏覽器會話頭部的“看板”tab，按關鍵字、標籤或優先級篩選卡片。
3、用列內排序、拖拽卡片插入到其他卡片位置，或進行批量移動、批量打標、批量移入回收站。
4、設置 YYYY-MM-DD 截止日期，關注逾期高亮；統計信息可按標籤、優先級和逾期數量查看。
5、如果誤操作，可使用 50 步撤銷；卡片刪除後也可從回收站恢復，或徹底刪除。
6、需要跨項目處理時，可將卡片移動到其他工作區的看板；卡片如果由 Agent 創建，也可跳回來源會話。
適用場景與注意¶
這個插件適合已經在 DSH 中做對話式開發、規劃或功能拆解的場景，尤其是希望按項目隔離、不需要額外外部任務系統的輕量使用。
使用前建議注意：
- 該插件作爲 dsh 插件運行，安裝與運行時應視爲具有當前
dsh進程權限；安裝前請檢查源碼、依賴和許可證。 allowBuilds會給安裝階段授予代碼執行權限，只應對信任源啓用，並可考慮固定 commit。- 卸載不會刪除看板數據文件，數據仍保留在磁盤。
- 許可證爲 MIT © 2026 StruggleYang。
結尾¶
dsh-project-kanban 的價值在於把 DSH 會話中的規劃動作落到一個可按項目隔離、可持久化、可撤銷的看板裏。項目源碼和更多說明見 GitHub：
