thomasvvugt/dsh-kanban-flow

dsh-kanban-flow

面向 DeepSeek Harness 的智能体驱动看板——每个工作区一个看板，每个事项一个任务会话。

DSH Web UI 中的看板：五列，每个事项一张卡片，每张卡片上显示最新的智能体活动

CI
License: MIT

你负责分诊。智能体接手、开始工作、在自己的任务会话中叙述每一步，并在需要你时请求审核。 看板强制执行工作流——而非凭感觉：智能体不能抓取未分配的工作，不能跳过你的审核，也不能背着你关闭事项。

部分基于 dsh-kanban 插件架构，围绕 multica 风格的人机/智能体工作流重建。

快速开始

从 npm 安装——预构建，无需构建审批步骤
dsh plugin --profile web add dsh-kanban-flow

或直接从 GitHub 安装
dsh plugin --profile web add github:thomasvvugt/dsh-kanban-flow

之后重启 dsh web。用 dsh --profile web --dump-config 确认（查找 dsh-kanban-flow 层）。侧边栏中每个工作区旁边都会出现一个看板图标——点击它即可打开该工作区的看板。

工作流

列是固定的：Backlog → To Do → In Progress → Review → Done

| 谁 | 移动 | 含义 |
| --- | --- | --- |
| 人类 | Backlog → To Do | 将事项交给智能体（唯一的领取触发条件） |
| 智能体 | To Do → In Progress | 确认领取，开始工作 |
| 智能体 | In Progress → Review | 需要人类（在任务会话/对话中说明问题） |
| 智能体 | Review → In Progress | 在人类反馈后直接继续 |
| 智能体 | Done → In Progress | 当人类对已完成事项回复时重新打开 |
| 智能体 | In Progress → Done | 自评估完成——仅在确认关闭时 |
| 人类 | Review → Done / In Progress | 接受/返工 |

宿主插件在 kanbanflow_move_item 工具中强制执行所有这些规则——智能体永远不会将事项移入 To Do，永远不会从 Review 完成，非法移动会被拒绝并给出解释。

当事项处于 Review 状态时，在其任务会话中回复会让智能体重新开始工作：它会确认、将事项从 Review → In Progress 移动，并在同一轮中处理反馈。

亮点

看板就在你工作的地方
- 每个工作区一个看板，在对话的 Board 标签页中于应用内打开——没有弹窗
- 侧边栏中每个工作区旁边都有一个看板图标；点击工作区会打开看板（可在 Settings → Plugins → Kanban Flow 中切换回会话展开）
- 看板视图每 3 秒轮询一次，因此智能体的移动会在你观看时出现在看板上

每个事项一个智能体会话
- 领取时会创建一个名为 CODE-12 · Item name 的任务会话——点击卡片即可直接跳转到该会话
- 进度叙述保存在该会话中；每张卡片显示一行紧凑的最新活动（“harness moved to Done · 3 seconds ago”）
- 悬停在卡片上可查看 agent 的最新状态：agent 在每一轮结束时设置一条简短的状态说明（kanbanflow_set_status）——已完成的内容、下一步要做什么或需要你提供什么。它会显示在悬停提示中（以及条目对话框中）；尚无状态的卡片不显示提示
- 无会话的工作区也不会被遗漏：它们的看板会固定到当前对话的 Board 标签页中（标题显示看板的代码和工作区），一旦该工作区有了自己的对话，就会转为原生模式

由你调整
- 每个工作区的看板代码（2–6 个字符）：条目 id 形如 API-3、DKF-17；更改代码时，现有 id 保持不变
- 完成工作需要确认（按看板，齿轮菜单）：开启后，agent 永远无法到达 Done——你通过将 Review → Done 拖动来完成
- 条目包含 id、名称和描述；删除条目会归档其任务会话

在 DSH 中看起来浑然一体
- 通过 DSH 设计令牌支持浅色与深色模式，并使用 light-dark() 列强调色：slate/blue/violet/amber/emerald
- 响应式看板：五列在桌面端缩放以填满可用宽度，在平板/手机上垂直堆叠（容器查询，因此它会响应看板的实际宽度——包括侧边栏等）
- 创建/移动的动画过渡、带列高亮的拖动抬起、agent 更改的卡片脉冲——全部遵循 prefers-reduced-motion
- 端到端英文

Agent 工具

kanbanflow_get · kanbanflow_get_item · kanbanflow_create_item · kanbanflow_update_item ·
kanbanflow_move_item · kanbanflow_delete_item · kanbanflow_set_status · kanbanflow_set_code

存储与信任

- 每个工作区一个 JSON 文件：/.dsh-kanban-flow.json——带 schema 版本，自动迁移，损坏的文件在重置前会先备份。你的看板数据永远不会离开工作区。
- 预构建发布：没有安装时脚本，安装时无需构建步骤，客户端唯一的网络调用是访问插件自身同源的 /api/kanban-flow 路由。

开发

npm install
npm test          # vitest unit tests (state machine, ids, links, migrations)
npm run typecheck
npm run build     # rebuild lib/client.js (committed) via esbuild

CI 在每次推送时运行测试、类型检查和构建；为版本打标签（v*）会将其发布到 npm。

说明

- 基于 DSH 0.1.1-rc.2 构建。侧边栏图标和工作区点击行为锚定在其侧边栏标记上（目前尚不存在逐行插槽）；如果标记发生变化，它们会降级为原生行为，并且图标仅出现在展开的侧边栏中。

致谢与许可

- 架构部分基于其作者的 dsh-kanban——谢谢。
- MIT——参见 LICENSE。