Super 雞排哥看板:在界面上看 dsh-superagent 的派單調度

前言

用 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
羽毛球分组比赛记分
小程序二维码

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

小夜