DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-team-kanban

d

dsh-team-kanban

Manifest valid

A living three-column kanban board in the right sidebar for DeepSeek Harness agent teams, driven by the native agentTeam projection DAG.

UI (client)hasBundlePatch

dsh-team-kanban

给 DeepSeek Harness 的多智能体团队,在右侧栏放一块会呼吸的活体任务看板。

三列流转、依赖血缘、负责人运行态、标签页进度角标,全部直接读宿主原生的 agentTeam 会话投影(team_task_* 写出的那份 DAG),不做二次同步、不落盘、不调外部服务。团队没开或没有任务时,它完全不出现。

A living three-column kanban board for DeepSeek Harness agent teams. It renders the native agentTeam session projection inside the right sidebar — dependency-aware cards, teammate liveness, tab progress badge — and stays invisible when there is no team to show.

status npm license


它不是又一个外部看板

生态里已有的 Kanban 插件大多解决「人怎么给 Agent 派活」:卡片存在插件自己的 SQLite 里,靠自定义的 kanban_* 工具维护。这个插件解决的是另一件事——一个复杂任务里,多个智能体如何认领、阻塞、解锁:

外部项目管理型看板dsh-team-kanban
数据来源插件自建存储 + 自定义工具宿主 agentTeam 投影,唯一事实源
卡片粒度一次派发 = 一个独立会话会话内 Lead + Workers 的共享任务
依赖关系通常没有原生 blockedBy DAG,实时算就绪/阻塞
生命周期常驻,需要手动管理有团队任务才出现,清空即消失
写入自己写库不写任务;唯一写操作是停用团队协作

功能

  • 自动显隐:根会话开启团队协作且出现任务时,自动在右侧栏打开;任务清空或关闭团队时自动关闭,不留空标签、不占位。
  • 三列流转:待处理 / 进行中 / 已完成,卡片随投影实时换列;pending 列区分「就绪」与「被依赖阻塞」。
  • 依赖血缘:卡片显示 blockedBy 前置任务与解锁关系,前置完成后阻塞态自动解除。
  • 顶部概览:完成进度条 + 分类统计 + 队友运行态(名册 phase、useSessionStatus、子会话运行态三路合一)。
  • 标签角标:标签页标题内嵌完成度圆环与计数,停留在文件树或浏览器标签时也能看到进度。
  • 几何与主题:@container 响应式适配 360px 窄栏 / 分栏 / 全屏 / 浮动窗;只用宿主 --dsw-alias-* token,Light / Dark 自动跟随;中英双语。
  • 一键停用团队:header 上的「团队」按钮可以直接停用本会话的团队协作(带确认),不用回模型菜单;任务会保留,看板随团队关闭而收起。
  • 手动关闭防打扰:你亲手关掉的看板不会因为下一次状态流转又弹回来。

视觉预览

任务板:右侧栏三列活体看板动态流转演示

1:1 真实运行动效(v0.5.6 · 官方浅色高对比度):涵盖多智能体任务分发、依赖阻塞解锁、FLIP 物理换列及标签页环形角标打勾。20 秒 1080P@60fps 发布片见 docs/assets/kanban-launch-v4.mp4(纯音效版)——真实 60fps 运行素材、跨列飞行慢放、深浅同帧对照、停用团队的真实点击;源码与采集链路在 media/launch-v4/。

查看最新深浅双色实机截帧(1:1 像素)
深色模式(Dark Mode)浅色模式(Light Mode)
深色模式浅色模式

仓库里的 prototype/team-kanban-prototype.html 是一个零依赖的离线原型(假数据 + 真实动效),直接用浏览器打开即可看到看板形态与动效,不需要安装插件。

安装

要求:DeepSeek Harness 0.2.2-rc.x 桌面端(desktop profile)。

# npm(推荐)
dsh plugin --profile desktop add dsh-team-kanban

# git
dsh plugin --profile desktop add github:rongyishuaige7/dsh-team-kanban

# 本地目录(开发中)
dsh plugin --profile desktop add /path/to/dsh-team-kanban

也可以在 DSH 的插件管理里用 install_bundle 指向仓库目录。安装后重启桌面端,控制台里 window.__teamKanbanRev 应等于当前版本号。

从旧名迁移(0.4.0)

0.4.0 之前的包名是本地占位 @local/dsh-client-ui-team-kanban,标签类型是 team-board。升级时先移除旧插件再装新包——旧插件卸载时会顺手清掉已保存布局里残留的旧标签:

dsh plugin --profile desktop remove @local/dsh-client-ui-team-kanban
dsh plugin --profile desktop add /path/to/dsh-team-kanban

dsh plugin 只转发给 pnpm,不会清理 profile 自己的配置。装完请核对两处,否则同一份 client.js 会被注册两次,第二次注册会撞上宿主「tab type id already registered」并中断该实例的 watcher:

  • ~/.dsh/profiles/desktop/package.json
    • dependencies 与 dsh.profile.bundles 里都不应再有 @local/dsh-client-ui-team-kanban
  • ~/.dsh/profiles/desktop/cordis.patch.yml
    • 删掉 # >>> 智能体任务板 (@local/dsh-client-ui-team-kanban) >>> 到 # <<< 智能体任务板 <<< 那几行

然后 ⌘Q 完全退出 DSH(不是关窗口)再打开,确认 window.__teamKanbanRev。0.4.1 起,注册撞车会在控制台留下 [team-kanban] could not register the sidebar tab type 的警告,不再静默。

兼容性

宿主版本状态
0.2.2-rc.3(desktop)已验证:T3(清空自动关闭)、T4(流转与角标同步);0.5.0 的停用按钮、T1/T2/T5/T6 待补
0.2.1-alpha.4 的 Team 结构(隐式根团队、名册、无 ownerId)读取路径已兼容(normalizeTeam),未实机验证
其他版本未验证

package.json 声明 engines.dsh: ">=0.2.2-rc.1 <0.3.0",并在 dsh.compatibility 里记录已验收的宿主版本。宿主侧目前有一个已上报的缺陷会让桌面端收不到投影帧(discussion #13416),排查过程见 docs/issues/。

工作原理

index.js                Host 侧空实现:不提供服务、不注册工具、不持久化
client.js               Client 侧 bundle:注册标签类型 team kind、标题、正文与观察器
  ├─ TeamKanbanWatcher  挂在 conversation.session.header.actions,按投影开/关标签
  ├─ TeamKanbanTitle    标签胶囊:图标 + 标题 + 完成度角标
  └─ TeamKanbanBoard    三列看板:概览、队友条、卡片、展开详情
  • 数据:useProjection('agentTeam') 是唯一事实源;队友名册与运行态来自 agentTeam.members / subagentCatalog / useSessionStatus。
  • 统一入口:三条来源(投影 face、会话列表快照、兜底拉取)都经 newestTeam → normalizeTeam 汇聚成一个值,看板与角标读同一份,不会互相落后。
  • 兜底拉取:因为上面那个宿主缺陷,watcher 按 pullPlan 有节奏地补拉——有人干活时 2.5s,有未完成任务但没人在跑时 10s。空闲或子会话不做周期轮询,但挂载和每轮结束时各做三次有界探测(0 / 1.2 / 3.6 秒),兜住「回合最后一秒才建出第一个任务、而投影帧根本没送到」的情况;宿主没装团队功能时探测一次就停。
  • 样式:ctx.effect 注入 <style data-plugin="dsh-team-kanban">,卸载时移除;所有类名走 .tkb-* 前缀,语言包走独立命名空间 teamKanban。

隐私与边界

  • 不写会话、不调 team_task_*、不改任务状态。唯一的写操作是停用团队协作(agentTeams.setEnabled(sessionId, false)),且必须由你在看板里确认。
  • 不读 ~/.dsh/sessions,不发任何网络请求。宿主 RPC 只有两个:只读的 ctx.remote.session.projections({ sessionId }),以及停用按钮触发的 ctx.remote.agentTeams.setEnabled(...)。
  • 不 require 宿主的内部 UI 包(dsh-client-ui-primitives、dsh-client-ui-agent-team 等),只依赖公开的 slot / projection / locale / sidebarRight 契约。
  • 唯一写入是浏览器内的 UI 状态(卡片展开、手动关闭标记)以及一条排障记录 localStorage['team-kanban:diag.v1'];两者都不含对话内容,也不离开本机。

开发

Node ≥ 20,无第三方依赖,无构建步骤——client.js 是手写的 __ModuleLoader__ bundle。

npm run check   # node --check 两个入口
npm test        # node:test,33 项:纯函数、双结构渲染冒烟、清单一致性、旧标签清理、空闲探测、诊断记录、团队开关

测试用假的 __ModuleLoader__ 加载 client.js,用 hook 形状的 React 替身走完渲染路径,不需要浏览器或宿主。

dsh-team-kanban/
├── client.js            # 浏览器侧全部实现(UI + watcher + 拉取兜底)
├── index.js             # Host 侧空实现
├── cordis.patch.yml     # 向 profile 注入插件行
├── locale/{zh,en}.json  # 插件市场元数据
├── test/                # node:test
├── prototype/           # 离线视觉原型
├── PRD.md / DESIGN.md   # 需求与技术设计(含宿主契约核实记录)
└── docs/                # 排查记录与宿主缺陷报告

排障

看板不出现时,先看 localStorage['team-kanban:diag.v1'](DevTools → Application → Local Storage,或插件报障时附上这一条):

phase含义
键不存在客户端半根本没执行:宿主图里的行 id 与 client.js 注册的 id 不一致(常见于改名后旧包条目没清干净)
apply客户端模块跑起来了,但停在标签类型注册之前
registered标签类型注册成功;看 kind 是否等于 dsh-team-kanban.board
register-failed宿主拒绝注册,error 通常含 already registered(同一份代码被注册两次)
watchwatcher 已在跑,tasks / running 是它当时的判断;tasks: -1 表示投影还没到
opened / open-failed打开成功 / 9 秒内重试都失败,error 是最后一次的原因
pull-failed / unsupported拉投影失败 / 宿主没有 agentTeam 投影

已知限制

  • 桌面端投影帧不推送(宿主缺陷),实时性靠有界拉取兜底:回合中新建的任务最坏要等一个 10 秒慢周期,回合结束后建立的约 1–4 秒内出现。
  • 只读:不能在界面里建任务、认领、改状态——这些仍走 team_task_* 与对话。
  • 只在根会话显示,与官方顶部 TeamBoard 的范围一致。

路线图

  • 等宿主修复投影推送后,删掉拉取兜底,回到纯事件驱动。
  • 在只读看板稳定后,评估认领 / 完成等最小写操作。
  • 补齐 T1 / T2 / T5 / T6 的实机验收矩阵。

License

MIT © 2026 rongyishuaige7

Comments

Loading…

Similar plugins

dsh-kanban

by alpacachen

A shared kanban board for people and AI agents in DeepSeek Harness.

UI & ExperienceManifest valid

★ 25

↓ 939/wk

MIT

JavaScript

Nov 14, 2026

dsh plugin --profile web add @alpacachen/dsh-kanban

by thomasvvugt

Agent-driven kanban board for DeepSeek Harness: one board per workspace, per-task agent sessions, guarded human/agent workflow

Workflow & AutomationDevelopment & InfrastructureManifest valid

★ 7

↓ 242/wk

MIT

TypeScript

Sep 26, 2026

dsh plugin --profile web add dsh-kanban-flow

by Denis-Tang

Live two-column card board of the current session's main and sub agents in the DeepSeek Harness right sidebar (independent fork of agent-trees).

Manifest valid

★ 0

MIT

JavaScript

Oct 24, 2026

dsh plugin --profile web add dsh-agent-board

Visual Kanban board for DeepSeek Harness with Gitea-backed tasks, workflow columns and a dedicated agent session per task.

Workflow & AutomationTerminal & ClientsManifest valid

★ 0

↓ 789/wk

MIT

JavaScript

dsh plugin --profile web add @goodandready/dsh-kanban

by zoe1nan

Live command deck for DeepSeek Harness agent teams: roster telemetry, task board, approvals, write actions, built-in Windows desktop capsule, and phone access.

UI & ExperienceTerminal & ClientsManifest valid

★ 22

↓ 162/wk

MIT

JavaScript

Oct 21, 2026

dsh plugin --profile web add dsh-cockpit

Replaces the DeepSeek Harness sidebar with a fixed 2x4 board of eight standing agent seats — each seat shows its own status, latest tool call, reasoning and result; a settings switch restores the stock sidebar.

UI & ExperienceManifest valid

★ 1

NOASSERTION

JavaScript

dsh plugin --profile web add dsh-agent-grid