前言¶
DeepSeek Harness (DSH) 採用“一切皆插件”的架構，Web UI 中的交互與工作流編排通常需要通過插件擴展。對於需要管理多個 Agent 場景、處理複雜參數配置以及監控執行狀態的開發者來說，原生界面往往缺乏系統化的工作臺能力。lycheelink/dsh-workbench 插件爲 DSH Web UI 提供了一個基於場景卡片和動態表單的集成化入口，旨在解決場景入口分散、參數採集繁瑣和會話管理割裂的問題。
它是什麼¶
@lycheelink/dsh-workbench 是由 lycheelink 維護的 DSH Web UI 插件，定位爲企業級 Agent 工作臺。它不替換、不禁用任何官方插件，而是作爲增量組件存在。
該插件通過場景卡片網格提供入口，配合動態表單收集參數，並利用宿主的 sessionController 真實創建 Agent 會話。它解決了在 Web 界面中快速啓動定製化任務、管理參數校驗以及監控會話狀態的痛點。
核心功能¶
插件提供了一套完整的前後端交互能力：
- 場景卡片網格：提供響應式的場景入口，支持按類別篩選和全局搜索。
- 動態表單與條件字段：參數收集面板支持字段展開與摺疊。通過表達式（如
key == 'value'）動態顯示或隱藏子表單，邏輯與宿主共享單一來源。 - 會話真實啓動：點擊“啓動”後，通過宿主的
sessionController創建真實的 Agent 會話，並將組裝好的 Prompt 注入會話。Agent 會話出現在對話列表中並開始執行。 - 服務器路徑校驗：文件字段僅接受服務端絕對路徑（如
/mnt/share_space）。插件在啓動時會校驗路徑是否存在。 - 控制室：提供實時會話狀態監控（創建/運行/等待決策/完成/失敗）。支持對會話記錄進行管理，失敗或完成的會話可直接刪除；運行中的會話需兩步確認刪除（僅刪除工作臺記錄，不操作真實會話）。
- 側邊欄與全頁視圖：在左側側邊欄新增“工作臺”菜單項。點擊後工作臺以無邊框全頁視圖覆蓋中間對話列，點擊“啓動”成功後會自動關閉全頁視圖並跳轉至新會話的對話視圖。
安裝與啓用¶
該插件僅支持 Web profile。安裝前請確保已安裝 DSH 及其依賴。
dsh plugin --profile web add @lycheelink/dsh-workbench
安裝成功後，左側側邊欄將出現“工作臺”入口。由於該插件依賴宿主的 typert 機制來註冊端點，確保宿主已正確加載相關 Artifact。
典型用法¶
使用該工作臺執行任務通常包含以下步驟：
- 選擇場景：在場景卡片網格中點擊目標場景卡片（如“開箱尋優”或“Profiling 採集”）。
- 填寫參數：在滑出的參數收集面板中填寫必要參數。如果啓用了條件邏輯，填寫特定字段會自動展開子表單。
- 上傳文件：在文件字段中輸入服務端絕對路徑。系統會在啓動時校驗文件是否存在。
- 啓動會話：點擊“啓動”按鈕。
- 系統組裝 Prompt 並執行校驗。
- 若成功，工作臺關閉，視圖切換至新創建的對話窗口，Agent 開始執行任務。
- 若未成功，控制室會顯示狀態說明。
適用場景與注意¶
適用人羣：使用 DSH Web UI 進行 Agent 開發與運維的工程師，需要頻繁啓動特定場景、處理複雜參數或監控會話狀態的團隊。
重要注意事項：
- 依賴項：插件依賴宿主的
typertartifact (./typert)。如果缺少該文件，宿主不會暴露任何workbench/*端點，插件將無法工作。 - Profile 限制：當前版本僅支持 Web profile。
- Agent 啓動模式：默認情況下，“啓動”會真實創建 Agent 會話。若需要僅記錄日誌而不創建真實會話，可配置
spawnAgent: false。 - 階段邊界：目前插件僅將卡片配置的
agentPreset掛載，卡片級的agentConfig.skills尚未透傳給預設組合（preset 本身可帶 skills）。
結語¶
dsh-workbench 通過插件化方式爲 DSH Web UI 增加了結構化工作臺能力。它提供了從場景入口、參數採集到會話創建與監控的完整閉環。更多細節與源碼可訪問：
