前言¶
在 DeepSeek Harness(DSH)里跑智能体时,任务状态往往散落在对话记录、临时笔记或各自维护的列表里。人改一处、Agent 改另一处,重启后更容易对不上。DSH 社区插件普遍走「一切皆插件」路线;工作流类插件要做的,是把状态和界面收进同一套 Harness 进程里。下面介绍维护者 ssalentin 的 dsh-kanban-board:五列看板、Web 叠加层,以及 Agent 侧的 kanban 工具,数据落在单个 JSON 文件里,重启后仍保留。
这是什么¶
dsh-kanban-board 是面向 DeepSeek Harness Web GUI 的看板插件。你在浏览器里拖拽卡片、编辑子任务和标签;智能体通过 Host 注册的 kanban 工具读写同一块板。官方简介概括为:带 Web GUI 的任务看板,支持子任务、彩色标签与看板内对话。
- 维护者:ssalentin(Sebastian Salentin)
- 分类:工作流
- 许可证:MIT(
package.json标注版本 1.19.0) - 目录页:https://www.skillhub.cn/plugins/ssalentin/dsh-kanban-board
- 源码:https://github.com/ssalentin/dsh-kanban-board
核心功能¶
看板与交互¶
五列固定流程:Backlog → Prioritized → Doing → Block → Done。支持列间拖拽、横向平移与边缘自动滚动;Done 列默认可折叠为窄条,拖入仍可标记完成。右下角 Board 胶囊或 Ctrl/Cmd + Shift + K 打开叠加层(设置里快捷键名称为「Open board」)。看板打开时每 1.5 秒轮询;他人或 Agent 改动的卡片会短暂高亮(尊重减弱动画偏好时为静态描边)。
每张工单有永久短编号(如 #42),删除后不重用;内部 id(k-…)与 #42 在工具和界面中均可使用。右键工单可复制 ID 或进入编辑。
工单内容与协作¶
工单编辑器以叠加对话框承载:标题、备注、子任务(卡片上显示进度条与 done/total)、彩色标签(蓝/绿/琥珀/红/灰/紫)、可选截止日期(YYYY-MM-DD)、命名链接(仅 http/https)、依赖关系、评论线程。评论支持受限 Markdown 子集(粗体、列表、代码块等),界面语言含英语、德语与简体中文。
支持任务依赖:卡片展示等待项与阻塞关系;Agent 工具输出中带 ⛓ depends on 与 ⇠ blocks。看板顶部 ✦ Ask 栏可用自然语言操作看板(需 profile 配置默认模型);模型可先 find / show / list 再执行变更,并保留最近几轮上下文。
Agent 工具与会话记忆¶
Host 暴露全局工具 kanban,动作包括 list、show、find、add、update、move、delete、reorder、subtask_*、tag_*、comment_*、link_* 等。当前 Agent 会话会记住本对话中编辑或检索过的工单;省略 id 时可指向最近工单,"lastMentioned" / "lastEdited" 用于多轮跟进。
数据路径为 $DSH_HOME/kanban/board.json(通常为 ~/.dsh/kanban/board.json),原子写入。Host 部分仅依赖 node: 内置模块,无构建步骤。
安装与启用¶
环境要求:
- DeepSeek Harness 0.2.x,且启用 Web 应用(开发与测试基线为 0.2.1-rc.5)。
- Profile 中配置默认模型,供看板聊天使用(任意 OpenAI 兼容 / DeepSeek 提供商均可)。
按 README 安装到 profile(示例以 GitHub 源为主):
# from GitHub
dsh plugin --profile web add github:ssalentin/dsh-kanban-board
# from npm (if published)
dsh plugin --profile web add dsh-kanban-board
# from a release tarball
dsh plugin --profile web add ./dsh-kanban-board-1.3.0.tgz
包内声明 dsh.bundle 补丁(cordis.patch.yml),会作为 profile bundle 接入。在 Plugins 中启用 Kanban Board(若未自动启用),然后刷新页面一次。本地开发可直接用 Plugin Manager 安装目录。插件更新后同样需要刷新页面,以便浏览器端加载新 bundle。
典型用法¶
在界面里操作¶
- 点击右下角 Board 或 Ctrl/Cmd + Shift + K 打开看板。
- 拖拽工单换列,或在工单上点开编辑器维护子任务、标签、依赖与评论。
- 用
/聚焦搜索框;可组合标签筛选、逾期与「等待依赖」开关。 - 只读模式下(看板头锁定开关)隐藏编辑控件,仍可拖拽改列状态。
让 Agent 改同一块板¶
工具调用示例(摘自 README):
kanban { action: "move", id: "k-1a2b3c4d", column: "block" }
kanban { action: "comment_add", body: "blocked on infra" } // same ticket, no id needed
kanban { action: "find", query: "login redirect" } // locate + remember tickets
kanban { action: "delete" } // the last ticket mentioned
看板聊天示例意图:「add a task to review the PR and tag it urgent」「what’s blocked?」——具体行为受 README 中的限额与超时约束(如提示 ≤ 2000 字符、单次最多 20 个操作、模型超时 45 秒)。
适用场景与注意¶
适合在 DSH Web 工作区里做人机共管的待办与阻塞跟踪:你拖拽列、Agent 在会话中 add / move / comment_add,无需单独任务系统。依赖、标签与子任务适合稍复杂的协作流;单文件持久化便于备份,但也需注意文件权限。
权限与安全:插件与当前 dsh 进程同源运行,能读写其配置的数据目录。安装前请阅读 源码仓库 与 MIT 许可证,确认符合你的审计要求。社区目录 SkillHub 独立于 DeepSeek / 幻方,并非官方应用商店。
规模上限以 README「Limits」为准(例如最多 500 张工单、每工单最多 50 个子任务等);超出时服务端会拒绝变更且不落盘。
结尾¶
经过上面的步骤,你可以在 DSH Web GUI 里用五列看板统一人和 Agent 的任务视图,并用 kanban 工具或看板内对话保持同步。进一步了解请查看目录页 https://www.skillhub.cn/plugins/ssalentin/dsh-kanban-board 与 GitHub https://github.com/ssalentin/dsh-kanban-board。