概览
dsh-kanban
DSH-native multi-agent kanban board: the Hermes (MIT) kanban engine + board UI, driven by a DSH headless-worker dispatcher, with model tools for card management
README / ZH
插件文档
dsh-kanban · DSH 任务看板
DeepSeek Harness 原生多智能体任务看板插件。完整复用 Hermes(Nous Research,MIT)的看板引擎与界面,接入 DSH 的 web 服务器与模型工具体系,由 DSH headless worker 执行卡片任务。
对标 Hermes Kanban:9 列看板、多 board、评论/附件/链接/事件流、运行记录、诊断与恢复动作、认领锁 + 熔断重试、实时 WebSocket 更新——全部原生可用。
特性
- 9 列看板:triage / todo / scheduled / ready / running / blocked / review / done / archived,支持拖拽、多选批量流转
- 完整卡片:正文、负责人、优先级、依赖(父子卡)、租户、workspace、模型覆盖、目标模式
- 卡片抽屉:评论、附件、链接、事件时间线、运行记录、诊断(含一键恢复动作)、worker 日志
- 多 board:每个 board 独立 SQLite(WAL),可在界面创建/切换
- 模型工具(对话里直接管卡):
kanban_board/kanban_task_create/kanban_task_get/kanban_task_update/kanban_task_comment/kanban_task_link/kanban_task_unlink/kanban_task_delete/kanban_dispatch - DSH 原生派发器:
kanban_dispatch认领 ready 卡片并启动dsh --profile headlessworker 执行;引擎自带认领锁、心跳、崩溃回收、连续失败熔断自动转 blocked、最大并发控制 - 实时更新:
/eventsWebSocket 推送看板事件流
安装
dsh plugin --profile <name> add github:FuncWei/dsh-kanban
首次使用时插件会自动启动 sidecar(自动用 uv 拉取 Python 依赖;无 uv 时回退到 python3 -m venv)。然后重启 dsh web,浏览器打开:
- 看板界面:
http://127.0.0.1:3080/kanban(或点侧栏「任务看板」按钮) - 数据目录:
<DSH_HOME>/storages/kanban/(默认~/.dsh/storages/kanban/)
配置(环境变量)
| 变量 | 默认 | 说明 |
|---|---|---|
DSH_KANBAN_WORKER_CMD |
dsh --profile headless |
派发 worker 的启动命令 |
DSH_KANBAN_MAX_WORKERS |
4 |
全局并发 worker 上限 |
DSH_KANBAN_PYTHON |
自动探测 uv/python3 | sidecar 的 Python 解释器 |
DSH_KANBAN_ROOT |
<DSH_HOME>/storages/kanban |
看板数据目录 |
使用
- 对话里说「建一张卡:整理本周公众号选题」→ agent 调
kanban_task_create - 卡片进入 ready 列后,调
kanban_dispatch(或让 agent 调)→ DSH headless worker 认领执行,看板上实时看到 running → done 与运行记录 - worker 最终消息写 DONE/BLOCKED;非零退出计入失败次数,连续失败自动转 blocked 并给出诊断恢复动作
架构
DSH web 服务器
├─ /kanban → 看板界面(Hermes 前端原样 + SDK shim)
├─ /api/plugins/kanban/* → REST 代理(Hermes plugin_api 原样)
├─ /api/plugins/kanban/events → WebSocket 代理(实时事件)
└─ 9 个模型工具
↓ token + 127.0.0.1
Sidecar(uv 启动的 FastAPI)
├─ hermes_cli/kanban_db.py (MIT, 原样)
├─ hermes_cli/kanban_diagnostics.py (MIT, 原样)
├─ plugin_api.py (MIT, 原样)
├─ dsh_dispatcher.py (本插件:DSH worker 派发 glue)
└─ SQLite: <DSH_HOME>/storages/kanban/
许可
MIT。Sidecar 复用 Nous Research Hermes Agent(MIT)的看板实现,详见 NOTICE.md。
