dsh-runninghub-plugin

dsh plugin --profile web add dsh-runninghub-plugin

DSH RunningHub 插件


<p align="left">

<a href="https://github.com/achenjins/dsh-runninghub-plugin/actions/workflows/ci.yml"><img src="https://github.com/achenjins/dsh-runninghub-plugin/actions/workflows/ci.yml/badge.svg" alt="CI"></a>

<a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white" alt="Node.js"></a>

<a href="https://github.com/achenjins/dsh-runninghub-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-007ACC" alt="DSH Plugin"></a>

<a href="https://www.runninghub.cn"><img src="https://img.shields.io/badge/RunningHub-ComfyUI-FF6B6B" alt="RunningHub"></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>

</p>

在 DSH 中调用 RunningHub 工作流，生成图片、视频、音频或其它文件。

支持由 AI 对话自动解析并配置工作流，也可在浏览器面板中直观调整节点参数、管理 Key 池与维护提示词规范文档。

[!NOTE]

平台入口与准备工作：

- 国内站：RunningHub 国内 ｜ 获取国内 API Key

- 海外站：RunningHub 海外 ｜ 获取海外 API Key

💎 通过上述邀请链接注册，可获得 500 RH 币（平台积分，可用于运行工作流）。

使用前需要准备：DSH（桌面版或 Web 版）、RunningHub API Key，以及支持 API 调用的工作流。国内平台（.cn）与海外平台（.ai）的账号和 Key 分开使用、互不通用，运行费用由 RunningHub 按平台标准收取。

---

安装

DSH 桌面版：在桌面应用的插件页面安装，可以使用 npm 包名 dsh-runninghub-plugin、GitHub 仓库 achenjins/dsh-runninghub-plugin，或下载 Releases 里的 .tgz 安装包后从本地安装；也可以在已收录本插件的插件市场中搜索安装。桌面版的 profile 由应用自己管理，命令行的 dsh plugin --profile desktop … 不能用于桌面版。

DSH Web 版 / 命令行（从 npm 安装）：

dsh plugin --profile web add dsh-runninghub-plugin

也可以直接从 GitHub 安装：dsh plugin --profile web add github:achenjins/dsh-runninghub-plugin。

安装后重启 DSH 并刷新页面。配置面板位于「插件」→「dsh-runninghub-plugin」。

卸载：桌面版在插件页面移除；Web 版执行

dsh plugin --profile web remove dsh-runninghub-plugin

• 锁定版本：命令行安装时可在包名后加版本号，例如 dsh-runninghub-plugin@0.3.3；从 GitHub 安装时可追加 tag 或 commit，例如 github:achenjins/dsh-runninghub-plugin#v0.3.3。
• 免构建：纯手写原生代码，没有构建步骤，安装时无需批准执行任何脚本。

<details>

<summary><b>本地开发安装</b></summary>

在仓库根目录执行：

node tools/install.mjs             # 安装到 profile（自动备份配置）
node tools/install.mjs --uninstall # 撤销安装

</details>

---

主要功能

• 提示词深度优化（核心功能）
• 规范文档库：在面板上传或编写提示词规范（Markdown / 纯文本），随时挂载到指定工作流。
• 两种优化模式：可以由主模型读取文档后自行改写；也可以开启「独立子代理」模式，把文档作为系统提示词交给极简子代理专门润色，不占用主模型的对话上下文，改写风格也更统一。
• AI 辅助工作流配置
• 把 RunningHub 工作流链接直接发给 AI，AI 会自动读取 ComfyUI 节点结构，推断哪些节点是提示词、参考图、采样步数等，逐项向你提问确认后保存配置。
• 节点可视化精细调优
• 提供开箱即用的浏览器配置面板，支持逐项调整节点角色、默认值、必填项、数值范围及下拉枚举选项，未保存的修改有草稿保护。
• 多 Key 轮换与资产保护
• 支持添加多把 Key 并自动识别所属地域。
• 地域隔离：国内池与海外池互不混用，避免用错地域的 Key 白白浪费调用。
• 余额不足自动换号：某把 Key 余额不足时会被标记为「余额不足」，并轮换到下一把可用 Key；充值后，插件会在下次提交前复查余额并自动恢复（也可以在面板点「查余额」立即恢复），不会每隔几分钟就拿没钱的 Key 重试一次。
• 并发已满自动排队：并发已达上限（1520 / 421）或独占机器不足（415）时，任务在本地排队，按 30s → 60s → 120s 退避自动重投；前面的任务结束时会提前唤醒。这些情况下 RunningHub 都没有受理任务、不会扣费，Key 也不会被冷却。
• 防止重复扣费：提交时遇到网络超时或异常，任务会记为 UNCERTAIN（待核对），绝不盲目重投；核对后可用 task.adopt 接回远端任务，或用 task.dismiss 结案。
• 异步后台生成与结果直达聊天
• 任务提交后立即返回任务 ID，由后台静默轮询；显式启用 background: true 时通过 DSH 作业系统通知会话。默认模式接着调用 task.wait；后台模式收到完成通知后再取回尚未展示的图片 / 视频附件。
• 若远端已生成完毕但本地因网络波动下载中断，支持随时一键补下载，无需重新运行。

---

快速上手

只需要三步即可跑通：

1. 获取并添加 Key

• 登录对应平台的 API 页面复制专属 API Key：
• 国内站：打开国内 API 页面
• 海外站：打开海外 API 页面
• 在 DSH 配置面板的「Key 池管理」中添加 API Key（地域可选国内、海外或自动探测）。

2. 让 AI 配置工作流

把你的 RunningHub 工作流链接发给 AI，让它辅助配置。

[!TIP]

推荐体验工作流：可以试试我发布的 Qwen Image 2.1 工作流：

- 国内站：【Qwen Image 2.1】万能输入工作流

- 海外站：【Qwen Image 2.1】文生图，图生图工作流

进入页面后一定要先点击「运行工作流」，进入工作流后再保存为自己的工作流；然后把你账号下这份工作流页面的网页链接（或 ID）发给 AI。海外站保存后，还可以在工作台页面看到你保存的工作流。

新用户通过上面的链接注册，或注册时填写邀请码（国内站 8cq8uhl8，海外站 c1ooihmg），可获得 500 RH 币。

向 AI 发送指令，例如：

“帮我配置这个工作流：https://www.runninghub.cn/workflow/xxxxxxxxxxxxxxxxxxx”

AI 会读取节点结构，向你确认提示词节点、参考图输入和常用参数，确认后自动保存。配置上面推荐的工作流时，建议让 AI 只保留 1 个提示词输入节点、6 个图片输入节点和画幅比例节点。

RunningHub 的画幅比例参数通常是下面这种格式，但也可能不同，实际取值需要进入 RunningHub 的工作流页面查看。确认一致后，可以直接复制发给 AI 辅助配置，或在面板编辑该节点时填入枚举选项（options）：

• 1:1 (Square)
• 2:3 (Portrait Photo)
• 3:2 (Photo)
• 3:4 (Portrait Standard)
• 4:3 (Standard)
• 9:16 (Portrait Widescreen)
• 16:9 (Widescreen)
• 21:9 (Ultrawide)

3. 开始生图

配置完成后，直接向 AI 发送指令：

“用刚才配置的文生图工作流，画一只在竹林里吃竹子的熊猫”

任务提交后会立刻返回任务 ID。调用 task.wait 即可将结果图片取回并直接展示在聊天气泡中。

---

配置面板与节点配置详解

打开 DSH「插件」→「dsh-runninghub-plugin」即可进入配置面板。点击任意工作流将其展开，进入节点配置详情页：

1. 工作流基本信息区

• 名称与英文标识：支持设置直观的中文名称，以及供大模型内部识别的稳定英文标识（displayNameEn）。
• 重命名与克隆：重命名保留本地 ID；克隆创建独立本地 ID，复制已保存的配置。面板中当前未保存的修改会继续保留。
• 地域选择：指定该工作流默认使用国内池还是海外池的 Key。
• 输出类型：指定生成类型，支持 image（图片）、video（视频）、audio（音频）、3d、text、mixed。
• 描述（给模型看）：向模型说明该工作流的适用场景，模型挑选工作流时会参考这里的描述。
• 运行设备：每个工作流分别选择 Standard（24GB）/ Plus（48GB）/ Ultra（84GB），保存后模型运行直接使用。模型辅助配置时会询问并保存机型，生成时无需重复选择。三档分别传 instanceType: default / plus / ultra，包括 Standard 也明确发送；设备支持与计费以 RunningHub 账号权益为准。
• 查看 JSON：支持随时一键展开/收起底层原始 JSON 配置，便于技术排查。

2. 节点表格与自动分组（8 列清晰呈现）

工作流导入后，插件会自动将底层 ComfyUI 节点按功能分类（如画面、采样器、模型、提示词等），支持按分组折叠。表格清晰呈现 8 项核心属性：

列名 · 说明

节点 · ComfyUI 内部原生数字 ID（如 6、9）

类型 · 节点 ClassType（如 CLIPTextEncode、KSampler、LoadImage）

角色 · 当前赋予的语义角色（如提示词、参考素材、参数等）

*

…(truncated)