前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在使用 DSH Web 进行智能体开发或工作流编排时,面对多个 Session、Workspace 以及复杂的任务状态,缺乏一个直观的集中视图可能会降低效率。dsh-ds-kanban 是一个外部 bundle 格式插件,它为 DSH Web 提供了一个侧边栏入口和一个全屏实时看板。
该插件不替换 Harness 的应用壳,也不存储独立的任务数据库。它基于现有的 Session、Workspace、projection、pending-interaction 和 connection 服务进行投影,将 Inbox/Ready 的手动放置和视图偏好存储在现有的设置能力中。
核心功能¶
该插件提供以下功能:
- 侧边栏徽章:显示等待、失败、受阻、高上下文压力的任务计数。
- 全屏实时看板:包含收件箱、就绪、运行中、等待、受阻或失败、空闲、目标完成列。
- 交互与筛选:支持实时统计、搜索和筛选,工作区分组,以及密度和时间戳控制。
- 数据导出与操作:提供显式的 JSON/CSV 导出,支持任务创建、导航、取消、归档以及任务 ID 复制。
- 状态过滤:提供“需要关注”状态过滤,用于查找待审批、失败、受阻等任务。
安装与启用¶
在安装之前,请确保 Harness 版本为 0.1.2-alpha.1 或更高版本。
使用官方命令添加插件:
dsh plugin --profile <name> add dsh-ds-kanban
安装、更新或移除插件会改变配置文件组合和客户端 bundle 发现,安装后需要重启 Host 才能生效。
安装完成后,在侧边栏选择 DS Kanban 即可打开看板。更新时再次执行 add 命令即可,移除时执行:
dsh plugin --profile <name> remove dsh-ds-kanban
典型用法¶
看板支持键盘快捷键和鼠标操作:
- 打开任务:点击卡片或聚焦后按
Enter打开其 Harness 任务。 - 列间导航:使用左右箭头在已填充的列之间移动焦点。
- 搜索:按
/聚焦搜索框。 - 关闭看板:按
Escape关闭看板或对话框。 - 拖放:只有收件箱和就绪列中的空白卡片可以被拖放。
- 关注状态:导航到“需要关注”以查找待审批、失败、受阻等任务。
实现与安全¶
- 实现:插件声明了
dsh.bundle.patch。它通过生命周期拥有的插槽贡献一个侧边栏页脚操作和一个 Shell 覆盖层。board.ts是纯权威状态投影,settings.ts拥有手动放置和视图偏好。Host 不添加 HTTP 路由,浏览器 mutations 复用已暴露的 RPC 服务。 - 安全与隐私:插件不执行外部网络请求,不启动服务器,不执行 shell 命令,不发送遥测。它读取列表摘要和轻量级生命周期/投影状态,但不请求 transcript 内容。拒绝未知的设置格式。
注意事项¶
- Goal complete:意味着持久目标完成,不意味着审查者接受。
- 陈旧状态:运行中的卡片如果停止报告会被标记为陈旧。
- 自动状态覆盖:自动状态始终覆盖手动收件箱/就绪放置。
- 设置格式:拒绝未知的设置格式,Client 会保留其最后一次接受的快照。
该插件由 Stijnus 维护,许可证为 MIT。更多技术细节可参考 GitHub 仓库。