前言¶
用 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