前言¶
用 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(keyjpb:hidden:v1),不影响其他设备。
适用场景与注意¶
适合正在用 dsh-superagent 跑多 agent 流程、想随时确认某个工位是卡在「待回答」还是要「待验收」的开发者。你也可以先不装 dsh-superagent,只用来理解这套派单状态模型;此时看板会自动进入演示数据。
注意两点:
- 插件以当前 DSH 进程的权限运行。安装前先读一遍源码,确认它访问的目录和本地数据符合你的预期。许可证是 MIT,但仓库不是 DeepSeek / 幻方的官方项目,社区目录 SkillHub 也与 DeepSeek / 幻方无官方从属关系。
- 想重启后保留派单流水,需要 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