DeepSeek Harness (DSH) 提供了運行智能體的基礎環境。在構建涉及雲端繪圖或複雜工作流的智能體時，直接集成外部服務通常需要額外的開發工作。dsh-runninghub-api 是一個 DSH 插件，旨在將 RunningHub 的雲端 ComfyUI 工作流直接接入 DSH 環境。
該插件由 lucyTrump 維護，遵循 MIT 許可證。
核心功能¶
該插件提供了一套完整的機制，用於在 DSH 智能體中管理 RunningHub 工作流：
- 雲端工作流整合：直接在 DSH 環境中調用 RunningHub 的雲端 ComfyUI 工作流。
- 配置管理：提供 API Key 和工作流庫的配置表單。
- 工具集：提供
runninghub_*工具集供智能體調用。 - 上傳緩存：使用 SHA256 算法對上傳的媒體文件進行緩存，避免重複上傳。
- 併發控制：提供本地併發門控，採用 FIFO 隊列和超時機制管理任務。
- 後臺任務：支持帶有完成通知的後臺任務。
- 持久化與恢復：提供持久化的任務賬本，支持任務自動重啓恢復。
安裝與啓用¶
在 DSH ≥ 0.1.6-alpha.2 版本中，配置位置已調整。
- 執行安裝命令：
dsh plugin --profile web add dsh-runninghub-api
或者通過應用內的插件市場（dshmarket）進行安裝/更新。
- 打開側邊欄的 Plugins 頁面。
- 找到 dsh-runninghub-api 卡片，在描述下方填寫配置表單。
配置項¶
配置位於插件頁面的表單中，默認值如下：
| 配置項 | 默認值 | 說明 |
|---|---|---|
apiKey |
— | API 密鑰（Literal 類型），建議優先使用 apiKeyEnv |
apiKeyEnv |
RUNNINGHUB_API_KEY |
環境變量引用，每次請求時解析 |
baseUrl |
https://www.runninghub.cn |
OpenAPI 基礎地址 |
pollIntervalMs |
5000 |
狀態輪詢間隔（最小 1000） |
runTimeoutMs |
3600000 |
運行階段超時（0 表示無限制） |
queueTimeoutMs |
0 |
隊列階段超時（0 表示無限制） |
maxConcurrentTasks |
3 |
本地併發門控上限 |
uploadUseLegacy |
false |
是否使用舊的 multipart 上傳端點 |
workflows |
[] |
保存的工作流定義列表 |
工具與用法¶
插件提供了以下工具供智能體在對話中調用：
runninghub_list_workflows：列出可用工作流。runninghub_fetch_workflow：獲取單個工作流定義。runninghub_run_workflow：運行工作流（兩階段：報告缺失參數/值，而非直接提交）。runninghub_get_task：獲取指定任務狀態。runninghub_list_tasks：列出任務。runninghub_cancel_task：取消任務。runninghub_upload_file：上傳文件（支持 SHA256 去重）。runninghub_refresh_workflow：刷新工作流定義。runninghub_note_workflow：爲工作流添加使用提示。
在瀏覽器端，插件通過 ctx.remote.$mount() 自我掛載命名空間，提供以下遠程接口：
fetchWorkflow：獲取並解析工作流 JSON。validateWorkflow：執行幹運行 payload 組裝。describeWorkflow：生成包含節點約束、參數、使用提示的 LLM 描述。runTest：使用配置表單進行真實的付費提交測試。testConnection：測試連接有效性。
注意事項¶
- 版本要求：需要 DSH ≥ 0.1.6-alpha.2。
- 本地開發：如果通過鏈接安裝到本地 DSH 檢出（
dsh plugin add <this dir>），node_modules中的@deepseek-ai/*條目必須是符號鏈接，否則會導致 cordis 單例重複。 - 熱更新：
dsh-hmr觀察的是配置文件和補丁文件，而非插件內容本身。 - 依賴檢查：安裝鏈接版本時，確保源碼環境正確，避免因依賴複製導致的問題。
總結¶
dsh-runninghub-api 填補了 DSH 環境與 RunningHub 雲端 ComfyUI 之間的連接空白。它通過工具集、後臺任務管理以及持久化賬本，爲智能體提供了穩定、可控的雲端工作流執行能力。
