前言¶
在 DSH 裏做生圖、生視頻或音頻，常見做法是自建 ComfyUI、寫 MCP，或把任務切到瀏覽器裏手動填節點。RunningHub 把 ComfyUI 工作流託管在雲端，按平臺規則計費；若要在智能體對話裏直接提交工作流並拿回附件，還需要一層適配：解析節點、管 Key、處理異步任務與失敗重試。
下面介紹社區插件 dsh-runninghub-plugin（維護者 achenjins），它把 RunningHub 接到 DSH 桌面端，向模型註冊 runninghub_search 與 runninghub_call，並附帶瀏覽器配置面板，用於 Key 池、工作流節點與提示詞規範文檔管理。
這是什麼¶
dsh-runninghub-plugin 是 DSH 的聯網類插件（社區目錄分類：聯網工具）。作用是在 DSH 內調用 RunningHub 在線 ComfyUI 工作流，生成圖片、視頻、音頻或其它類型輸出；支持由 AI 對話解析工作流鏈接並保存配置，也支持在面板裏逐項調整節點參數。
源碼與說明見 GitHub：achenjins/dsh-runninghub-plugin。目錄頁：SkillHub 插件頁。當前 package 版本爲 0.1.5，許可證 MIT，要求 Node.js >= 20。插件以當前 DSH 進程權限運行，安裝前建議自行查看倉庫源碼與許可證。
使用前需準備：DSH 桌面版、RunningHub API Key，以及支持 API 調用的工作流。國內站（.cn）與海外站（.ai）賬號和 Key 分開使用、互不通用；運行費用由 RunningHub 按平臺標準收取。
核心功能¶
模型側工具¶
插件向大模型註冊兩個工具：
runninghub_search：無參數，返回runninghub_call各動作的使用方式。runninghub_call：執行查詢、配置工作流與提交生成；工作流列表、任務狀態等均通過對應action查詢。
典型動作包括：workflow.get（列出或讀取已配置工作流）、workflow.probe / workflow.configure（探測並保存新工作流）、workflow.run（提交任務）、task.status、task.wait（等待完成並取回附件）、task.retry（補下載，無需重複生成）等。完整參數見 README「模型工具調用參考」。
提示詞與配置¶
- 規範文檔庫：在面板上傳或編寫提示詞規範（Markdown / 純文本），可掛載到指定工作流。
- 兩種優化模式：主模型讀取文檔後改寫；或開啓「獨立子代理」模式，由極簡子代理專職潤色，不佔用主對話上下文。
- AI 輔助工作流配置：把工作流鏈接發給 AI，插件讀取 ComfyUI 節點結構，推斷提示詞、參考圖、採樣步數等，經確認後保存。
- 節點可視化調優：瀏覽器面板中調整節點角色、默認值、必填項、數值範圍與枚舉選項；未保存修改有草稿保護。
Key 池與任務可靠性¶
- 多 Key 添加，自動識別國內 / 海外；國內池與海外池物理隔離，不混用。
- 餘額不足時標記並輪換下一把可用 Key；併發已滿（如 1520）或獨佔機器不足（415）時本地排隊並按 30s → 60s → 120s 退避重投。
- 網絡異常時記錄爲
UNCERTAIN，不盲目重投；可用task.adopt接回遠端任務，或task.dismiss結案。 - 後臺異步輪詢；支持
task.wait將結果作爲附件渲染在聊天中；遠端已完成但本地下載中斷時可補下載。
工作流與任務數據落在 DSH_HOME/runninghub（README / package 描述）。
安裝與啓用¶
安裝到 DSH 桌面端：
dsh plugin --profile desktop add github:achenjins/dsh-runninghub-plugin
安裝後重啓 DSH 並刷新頁面。配置入口：插件 → dsh-runninghub-plugin。
卸載：
dsh plugin --profile desktop remove dsh-runninghub-plugin
可在安裝地址後追加 #<commit> 鎖定版本。README 說明爲純手寫原生代碼，安裝時無需額外批准執行腳本。
典型用法¶
1. 添加 API Key¶
在 RunningHub 對應平臺 API 頁面複製 Key（國內與海外頁面不同，見 README 中的平臺入口鏈接），在配置面板 Key 池管理 中添加，地域可選國內、海外或自動探測。
2. 讓 AI 配置工作流¶
向 AI 發送工作流鏈接，例如：
幫我配置這個工作流：https://www.runninghub.cn/workflow/xxxxxxxxxxxxxxxxxxx
AI 會讀取節點並確認提示詞節點、參考圖與常用參數後保存。新工作流可先通過 workflow.probe 得到待確認 config，再 workflow.configure 保存。
3. 提交生成並取回結果¶
查動作與工作流列表：
runninghub_search({})
runninghub_call({ action: "workflow.get" })
runninghub_call({ action: "workflow.get", name: "我的文生圖" })
後臺提交（推薦）：
runninghub_call({
action: "workflow.run",
name: "我的文生圖",
prompt: "一隻在竹林裏喫竹子的熊貓",
background: true
})
等待並展示附件：
runninghub_call({ action: "task.wait", taskId: "任務 ID" })
帶參考圖與自定義參數時，可使用 images、params（如 "節點 ID:字段名"）、saveDir、fileName 等字段，詳見 README。
配置完成後，也可直接用自然語言，例如：「用剛纔配置的文生圖工作流，畫一隻在竹林裏喫竹子的熊貓」。
適用場景與注意¶
適合誰：已在 RunningHub 上使用或準備使用 ComfyUI 工作流，希望在 DSH 對話裏完成「選工作流 → 填參 → 異步生成 → 結果回到聊天」的開發者或創作者。
注意：
- 插件屬於 DSH 社區生態（SkillHub 等爲獨立目錄站點，與 DeepSeek / 幻方無官方從屬關係），非官方應用商店條目。
- 費用、併發與平臺規則以 RunningHub 爲準；Key 勿提交到公開倉庫。
- 首次保存新導入工作流時，面板要求確認節點角色、默認值與輸出類型，避免誤配。
結尾¶
dsh-runninghub-plugin 把 RunningHub 工作流、Key 分池、提示詞規範與異步任務封裝成 DSH 可調用的工具鏈，並配有可視化面板，適合在 Harness 裏做聯網生圖 / 生視頻 / 生音頻。
- 目錄頁：https://www.skillhub.cn/plugins/achenjins/dsh-runninghub-plugin
- GitHub：https://github.com/achenjins/dsh-runninghub-plugin
