前言¶

在 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