前言¶
DSH 生態裏，插件是擴展能力的主要方式。對智能體開發者來說，一個常見的問題是：需求通常從一句自然語言開始，但落到代碼裏時，需要細化、拆分、執行、合併，並且要能看見每一步的狀態。
dsh-task-kanban 是一個 DSH web 插件，它爲 DSH web 主界面新增“任務看板”：把需求細化成多 phase 實現計劃，在 git worktree 中串行實現，並在全部 phase 完成後自動合入主分支。
下面介紹它的定位、核心能力、安裝方式和典型用法。
這是什麼¶
dsh-task-kanban 的 npm 包名是 @fonlan/dsh-task-kanban，由 fonlan 維護，許可證爲 MIT。
它的核心價值是把“需求 → 計劃 → 執行 → 合併”這條鏈路放到 DSH web 主界面中管理，並通過泳道展示任務狀態。
GitHub 倉庫地址：
https://github.com/fonlan/dsh-task-kanban
核心功能¶
看板泳道¶
任務看板把卡片按五條泳道可視化：
需求 / 隊列 / 運行中 / 已完成 / 已合併
卡片會顯示以下信息：
- 標題
- 需求摘要
- 模型
- 細化 Skill
plan狀態徽標- 所屬階段
- 時間
卡片還支持停止、重試、刪除。
需求細化爲 Phase 計劃¶
新建任務後，插件會自動進入細化會話。
在這個會話中，需求會被拆解爲串行執行的 phase 計劃，也就是 plan。後續執行會圍繞這些 phase 推進。
Skill 驅動的需求細化¶
插件支持通過 Skill 驅動需求細化。
在新建任務的需求輸入框開頭輸入 /，會彈出可用 Skill 列表；也可以直接輸入 /skill-name 指定細化時使用的 Skill。
示例：
/grill-me 幫我規劃…
插件會把該 Skill 的完整指令注入細化會話，並進入交互式細化模式。
如果 Skill 未知或不可用，會給出明確報錯，並且可以重試。
隊列與串行執行¶
已規劃的卡片可以拖入隊列，並按 FIFO 順序領取執行。
執行時的約束如下：
- 每個 phase 使用獨立會話。
- 每個 phase 在同一
git worktree中嚴格串行推進。 - 同一工作區保持單併發。
- 跨工作區可以按設置並行。
自動合併主分支¶
當全部 phase 完成後，插件會執行以下動作：
- 將
plan分支合入main或master。 - 清理
worktree。 - 清理分支。
插件設置¶
設置入口位於：
側邊欄設置 → 插件配置 →「任務看板」
這裏可以配置：
- 全局並行 worker 數。
- 細化需求會話的默認模型、推理強度與 Agent 預設。
- Phase 實現會話的默認模型、推理強度與 Agent 預設。
具體含義如下：
- 模型留空表示走默認鏈路。
- 推理強度僅列出所選模型支持的推理等級。
- Agent 預設在會話開始後固定。
安裝與啓用¶
通過 npm 發佈包安裝¶
先確認你要安裝到的目錄。運行安裝命令的目錄將作爲默認 workspace 根目錄。
在目標 workspace 根目錄運行：
dsh plugin --profile web add @fonlan/dsh-task-kanban
已覈實資料中，README 給出了固定版本安裝示例：
dsh plugin --profile web add @fonlan/dsh-task-kanban@0.1.0
但同一批已覈實資料中，README 的安裝說明與 package.json 的版本說明存在衝突：README 稱當前發佈版本爲 0.1.0，而 package.json 中 version 爲 0.2.3。因此本文不將其中的某一個版本號作爲當前發佈版本結論。
本地源碼安裝¶
如果從本地倉庫安裝，需要先構建出 lib/ 產物。
在倉庫目錄下運行：
pnpm build
dsh plugin --profile web add .
安裝後，插件會通過 cordis.patch.yml 掛載到 web profile。通常重啓 web profile 後，可以看到“任務看板”入口。
典型用法¶
下面是一個可復現的使用路徑。
1. 新建任務¶
在任務看板中新建任務，輸入需求。
如果沒有指定 Skill，系統會進入普通細化會話。
2. 指定細化 Skill¶
如果希望用特定 Skill 細化需求，在需求輸入框開頭輸入 /，選擇 Skill；也可以直接輸入：
/skill-name 需求描述
例如：
/grill-me 幫我規劃…
插件會注入該 Skill 的完整指令，並進入交互式細化模式。
3. 將已規劃卡片放入隊列¶
需求細化完成後，將已規劃卡片拖入隊列。
隊列會按 FIFO 順序領取執行。
4. 查看執行狀態¶
執行過程中，可以在看板中觀察卡片狀態變化：
需求 / 隊列 / 運行中 / 已完成 / 已合併
卡片上可以看到模型、細化 Skill、plan 狀態徽標、所屬階段與時間，並支持停止、重試、刪除。
5. 等待自動合併¶
全部 phase 完成後，插件會自動將 plan 分支合入 main 或 master，並清理 worktree 與分支。
6. 調整會話默認值¶
進入：
側邊欄設置 → 插件配置 →「任務看板」
可以配置全局並行 worker 數，以及兩類會話的默認模型、推理強度與 Agent 預設：
- 細化需求會話。
- Phase 實現會話。
適用場景與注意¶
適合誰¶
這個插件比較適合以下場景：
- 使用 DSH web 主界面管理智能體任務。
- 希望把自然語言需求拆成多 phase 計劃。
- 希望在
git worktree中串行執行，並在完成後自動合入主分支。 - 希望在看板裏跟蹤“需求 / 隊列 / 運行中 / 已完成 / 已合併”狀態。
使用注意¶
使用前需要關注以下幾點：
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 插件會自動合入
main或master，執行前應確認分支策略。 - 同一工作區保持單併發；跨工作區並行受設置約束。
- 模型留空表示走默認鏈路。
- 推理強度僅列出所選模型支持的推理等級。
- Agent 預設在會話開始後固定。
- 未知或不可用的 Skill 會給出明確報錯，並且可以重試。
- 修改服務端後需重啓 web profile。
- 客戶端改動走 web 端 HMR 鏈路，
pnpm run dev:web同啓時生效。
結尾¶
dsh-task-kanban 的價值在於把需求細化、階段執行、狀態跟蹤和自動合併放到同一個 DSH web 看板中，減少在多個會話之間手動切換和追蹤的開銷。
倉庫地址：
https://github.com/fonlan/dsh-task-kanban
如需查看插件目錄，以對應 DSH 插件目錄站點爲準；DSH 插件目錄屬於社區目錄站點，不應理解爲 DeepSeek 或幻方的官方應用商店。
