前言¶
在 DeepSeek Harness (DSH) 中，智能体负责处理任务，但如果缺乏结构化的工作流，任务状态容易混乱。dsh-kanban-flow 插件提供了一个基于看板的界面，强制执行人类与智能体之间的协作流程。它将每个工作区映射为一个看板，每个任务对应一个独立的智能体会话，确保任务流转有迹可循且受控。
这是什么¶
dsh-kanban-flow 是一个 Agent 驱动的看板插件，专为 DeepSeek Harness 设计。
- 核心定位：每个工作区一个看板，每个任务一个智能体会话，强制执行人类/智能体工作流。
- 维护者：thomasvvugt
- 许可：MIT
- 依赖：基于
dsh-kanban插件架构，构建于 DSH 0.1.1-rc.2。
核心功能¶
固定列与工作流强制执行¶
看板的列是固定的，从左至右依次为：Backlog → To Do → In Progress → Review → Done。插件通过 kanbanflow_move_item 工具拦截非法移动，确保工作流符合规则：
- Backlog → To Do：仅允许人类将任务移入此列，作为智能体接手的触发点。
- To Do → In Progress：智能体确认接手后执行。
- In Progress → Review：智能体完成工作并请求人类审查。
- Review → In Progress：人类在任务会话中反馈后，智能体继续处理。
- Done → In Progress：人类在已完成的任务中回复，重新打开任务。
- In Progress → Done：仅当“完成确认”选项关闭时，智能体可自行完成；开启时必须由人类拖动 Review → Done。
智能体工具集¶
插件为智能体提供了以下工具，用于操作看板：
kanbanflow_get：获取看板概览。kanbanflow_get_item：获取特定任务信息。kanbanflow_create_item：创建新任务。kanbanflow_update_item：更新任务内容。kanbanflow_move_item：移动任务（受工作流限制）。kanbanflow_delete_item：删除任务（归档会话）。kanbanflow_set_status：设置任务状态（显示在卡片悬停提示中）。kanbanflow_set_code：设置工作区代码（2-6 字符）。
界面与交互¶
- 本地存储：数据存储在
<workspace>/.dsh-kanban-flow.json，支持模式版本化，自动迁移。 - UI 设计：支持浅色/深色模式，利用 DSH 设计令牌，支持响应式布局（桌面横向，移动端纵向）。
- 动画：包含创建、移动的过渡动画，以及智能体变更时的脉冲效果。
安装与启用¶
在终端执行以下命令安装插件：
dsh plugin --profile web add dsh-kanban-flow
安装完成后，重启 dsh web 服务。确认安装成功的标志是在配置输出中找到 dsh-kanban-flow 层，且侧边栏的每个工作区旁边会出现一个看板图标。
典型用法¶
- 初始化：确保
dsh web已重启，点击侧边栏中的看板图标进入对应工作区的看板。 - 创建任务：在 Backlog 列创建新卡片（可通过智能体工具
kanbanflow_create_item或直接在 UI 操作）。 - 流转任务：人类将卡片从 Backlog 拖动到 To Do。
- 智能体工作：智能体在对应的任务会话中开始处理，并在移动卡片到 Review 列前设置状态说明。
- 人工审查：人类在 Review 列审查结果，若通过则拖动到 Done；若需修改，则在会话中回复，卡片自动回退到 In Progress。
适用场景与注意¶
- 适用场景：需要严格管理任务状态流转的团队，或希望利用智能体处理具体任务但需要人类把控最终交付质量的场景。
- 注意事项：
- 插件无安装时脚本或构建步骤，通过 npm 直接分发。
- 所有数据存储在本地工作区目录下，不会离开该目录。
- 插件为全英文界面。
短结尾¶
dsh-kanban-flow 通过将任务状态与智能体会话绑定，为 DSH 增加了一个可控的工作流层。它没有改变 DSH 的核心逻辑，而是通过插件机制补充了可视化的任务管理能力。
- 项目主页：https://github.com/thomasvvugt/dsh-kanban-flow
- 目录页：https://www.skillhub.cn/plugins/thomasvvugt/dsh-kanban-flow
