Super Jipaige Dashboard: Viewing dsh-superagent's Dispatch Scheduling on the Interface

前言

用 dsh-superagent 做多 agent 协作时,你常碰到一个问题:只看到最终结果,中间哪个工位(worker)在干什么、哪个卡住、哪个已经收工,都要去翻日志或报告。插件 sycflash/dsh-jipaige-board(包名 @local/super-jipaige-board)解决的就是这件事。它在 DSH 会话工作区新增一个「🍗 鸡排哥看板」标签页,用工厂流水线的视觉方式实时展示 dsh-superagent(鸡排哥)把工单派给哪些 worker、各工位处于什么状态。插件由 sycflash 维护,纯 JavaScript,无构建步骤、无 npm 依赖。下面介绍它的功能、安装方式和运行要求。

这是什么

一句话定位:一个 DSH 本地插件,把 dsh-superagent 的 Ticket 派单调度过程渲染成可视化流水线,供你在浏览器里只读观测。

它不是调度器,也不参与派单。Host 侧只读,不驱动 agent、不追加会话事件、不发起模型调用。因此装上它不会改变 dsh-superagent 的运行行为,只多一个观测窗口。

核心功能

看板的布局和 dsh-superagent 的派单概念一一对应:

  • 最左侧是派单口,中间是横向传送带,工位分列传送带上下两侧。
  • 每个工位 ID 可以点击复制完整值,方便把排障信息粘出来。
  • 进行中的工位滚动显示最近 3 条进展,一次露一行;已收工的工位不再滚动。
  • 每个工位状态徽标旁有「隐藏」,点掉后不再占位;分组标题旁有「显示已隐藏 · n」一键恢复。

工位状态直接对应 dsh-superagent 的 Ticket 阶段,判定依据如下:

徽标 含义 判定依据
作业中 真的在干活 Assignment 执行中,且没有新的报告
待回答 卡在你身上 Ticket 上有未回答的 Attention
排队 等排工 还没有 Assignment,或 Assignment 待启动
空闲 本轮已收工 最新报告是 waiting,或 Assignment 已结束
待验收 等你验收 最新报告是 ready
已完成 工单结束 Ticket 已结束,或报告为 dropped/无需处理
异常 需要处理 报告为 failed / blocked,或输入投递失败

状态来源是 dsh-superagent 自身的 Ticket 阶段(见其 docs/003-execution.md 的「Ticket stages」)。

安装与启用

插件不提供 dsh plugin add 之类的一行安装命令,安装分三步:下载解压、注册成 profile bundle、启用。

1. 获取插件

从 GitHub Releases 下载 super-jipaige-board-<版本>.tar.gz,解压到 DSH 默认插件目录:

mkdir -p ~/.local/share/deepseek-superagent/plugins
tar -xzf super-jipaige-board-1.5.0.tar.gz -C ~/.local/share/deepseek-superagent/plugins

不要把插件放到会被同步或清理的目录,例如 Documents、iCloud、或 profile 的 stateDir。

2. 注册成 profile bundle

方式 A(推荐):在 DSH 的 Web 会话里让 agent 执行:

plugin_manager
  action: install_bundle
  target: /绝对路径/.local/share/deepseek-superagent/plugins/super-jipaige-board

方式 B(手动):编辑目标 profile 的 package.json,加入依赖并在 dsh.profile.bundles 里登记:

{
  "dependencies": {
    "@local/super-jipaige-board": "link:/绝对路径/.local/share/deepseek-superagent/plugins/super-jipaige-board"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "...",
        "@local/super-jipaige-board"
      ]
    }
  }
}

3. 生效

先关掉再打开 bundle 状态,让它重新挂载:

plugin_manager { action: "set_bundle", target: "@local/super-jipaige-board", enabled: false }
plugin_manager { action: "set_bundle", target: "@local/super-jipaige-board", enabled: true }

然后刷新浏览器页面。打开任意会话,工作区视图行会出现「🍗 鸡排哥看板」标签页。完整说明见仓库的 INSTALL.md。

运行要求

项 要求
DSH 约 0.2.1-rc.5(较新的版本通常也可)
Profile 含 Web 界面(@deepseek-ai/dsh-web-app),Host 提供 webServer
真实工位数据 同一 profile 里装了 dsh-superagent;没有也能用,会自动进入演示数据
重启后恢复派单流水 可选:storage + storage-json + storage-domain
构建 / 依赖 不需要

安装前确认你的 profile 满足前两行,否则看板标签页不会出现。

数据与隐私

  • 不联网、不发遥测、不读写会话日志、不调用模型。
  • Host 只在进程内维护一份有界快照(节点 ≤ 60、事件 ≤ 80),通过同源 HTTP 路由 GET /__jipaige_board/state 提供给前端轮询。
  • 可选持久化:若 profile 有 storageDomain,把有界派单流水写到 $DSH_HOME/storages/super_jipaige_board.json(5 秒节流,best-effort)。
  • 「隐藏工位」只存在浏览器 localStorage(key jpb:hidden:v1),不影响其他设备。

适用场景与注意

适合正在用 dsh-superagent 跑多 agent 流程、想随时确认某个工位是卡在「待回答」还是要「待验收」的开发者。你也可以先不装 dsh-superagent,只用来理解这套派单状态模型;此时看板会自动进入演示数据。

注意两点:

  1. 插件以当前 DSH 进程的权限运行。安装前先读一遍源码,确认它访问的目录和本地数据符合你的预期。许可证是 MIT,但仓库不是 DeepSeek / 幻方的官方项目,社区目录 SkillHub 也与 DeepSeek / 幻方无官方从属关系。
  2. 想重启后保留派单流水,需要 profile 同时提供 storage、storage-json 和 storage-domain,否则快照只存在于当前进程。

结尾

这只提供了一个观测窗口,不改变 dsh-superagent 的调度行为,值得作为排障和状态确认的日常工具装在本地。

  • 社区目录:https://www.skillhub.cn/plugins/sycflash/dsh-jipaige-board
  • GitHub:https://github.com/sycflash/dsh-jipaige-board
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye