前言¶
在 DSH 里做角色扮演或长对话时,正文往往已经够长,却还要单独复制到 ComfyUI、再切回界面看图。常见做法是再起一个桥进程或手工粘贴工作流,聊天和出图不在同一套界面里。ComfyRP Bridge(仓库 bmhty123/dsh-comfyui-rp)是装在 DSH 里的本地文生图自动化桥:捕获会话正文 → 经提示词会话整理 → 调本机 ComfyUI → 图片回到右侧栏、悬浮球和图库。插件不依赖外部桥进程,README 也说明不调用 LLM。
下面介绍它是什么、能做什么,以及安装与第一次使用的步骤。
这是什么¶
维护者为 bmhty123,在社区目录中归类为模型推理。一句话定位:ComfyUI × DSH 生图插件(目录简介与 README 一致)。
数据流如下:
DSH 会话 → ComfyRP Bridge → 提示词会话 → 本地 ComfyUI → 图片回 DSH
聊天、出图、看图可在同一界面完成。运行环境要求:本地已安装 ComfyUI,DSH 0.2.x(package.json 中 engines.dsh 为 >=0.2.0 <0.3.0-0,Node >=18)。当前包版本 0.2.3,许可 MIT。
核心功能¶
以下均来自仓库 README,仅列已写明的能力。
自动化
- 自动出图:捕获正文 → 解析提示词 → 出图 → 归档;「投递」与「出图」可分开开关。纯黑图会自动换种子重生成,进行中可点「停止自动补图」。
- 投递:正文来源与提示词来源可分开配置,可指向另一个会话甚至另一台 DSH;附加消息可放在正文最上或最下,投递成功后附加区自动清空。
看图与跟图
- 右侧栏面板、全屏、悬浮球、悬浮图片框:翻页、下载、收藏、刷新、删除、圆角;用户拖过或缩放过尺寸后,切图不会恢复初始大小。
- 跟图:滚动正文自动切图;连续图按段落比例拆位置;支持光标跟图、手动偏移、清空定位。
工作台
- 三种提示词格式(内置 / 全部匹配 / 自定义标签)、多套正负面、标题、原文锚点、分辨率、连续图、LoRA、随机种子、干跑。
图库
- 当前会话 / 全部 / 收藏夹 / 回收站;收藏为复制副本,误删可还原。
工作流与 LoRA
- 导入 ComfyUI API JSON,自动识别正面 / 负面 / 分辨率 / 输出节点,支持占位符与节点映射。
- LoRA 支持堆 / 单 / Power / Stacker / Tag,可改名、调强度、写回工作流。
说明中的约束
- 图片按当前聊天归档;更换正文来源不改变图片归属。
- 数据在 DSH 数据目录,设置中可查看与修改路径。
- 悬浮球与图片框限制在 DSH 窗口内;右侧栏默认收起,从会话标题栏展开。
- 远程会话场景下,两台 DSH 都需安装本插件。
- 提示词质量取决于所选提示词会话;README 推荐搭配 anima-tagger(本插件不包含、不修改该工具)。
节点识别思路参考了 dsh-tavern-image,完整声明见仓库 THIRD_PARTY_NOTICES.md。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证;插件以当前 DSH 进程权限运行,并会访问本机 ComfyUI 地址(默认 http://127.0.0.1:8188)。
官方安装命令(README):
dsh plugin --profile web add dsh-comfyui-rp
装完后重启 DSH。也可在插件市场安装;尚未发布 npm 时可用仓库地址:
dsh plugin --profile web add git+https://github.com/bmhty123/dsh-comfyui-rp.git
本地改代码时用目录装法(README):
node tools/install.mjs --apply
卸载加 --uninstall。
启用:装好 DSH 后打开右侧栏,在「开始」里点 ComfyRP。
第一次使用¶
按 README 顺序操作即可复现。
- 设置 → ComfyUI:填写 ComfyUI 地址(默认
http://127.0.0.1:8188),点「测试连接」。 - 工作流:导入 ComfyUI 的 API JSON →「解析预览」→ 确认正面 / 负面 / 分辨率 / 输出节点 → 保存 → 启用。
- 设置 → 正文来源 / 提示词来源:默认跟随当前会话,也可指定其他会话。
- 概览:需要自动把正文送去提示词侧时,打开「自动投递正文」;需要连带出图时再打开「自动出图」。
- 建议先手动试一次:填写正文或附加消息,点「投递最新正文」。
常用操作¶
- 让下一轮自动出图:概览打开「自动投递正文」与「自动出图」,并保持右侧栏或悬浮球可见。
- 临时手动出一张:悬浮球 → 铅笔菜单 →「请求生成」,读取来源会话的最新正文。
- 只重做一张:图片框 → 重新生成 →「仅此图」;整套重来选「全部」。
- 找图:图库 → 当前会话 / 全部 / 收藏夹 / 回收站。
- 会话列表未更新:概览右上「检测」,或设置里会话旁的「刷新」。
- 清理跟图定位:图片框 → 更多 →「清空定位」(仅当前会话),之后按比例重新分配。
适用场景与注意¶
适合谁
- 已在本地跑 ComfyUI,希望在 DSH 对话界面内完成正文投递、提示词整理、出图与看图的用户。
- 需要工作流 JSON 映射、LoRA 参数微调,或「跟图」阅读体验的角色扮演 / 长文场景。
注意
- 必须自备 ComfyUI 与可用工作流;插件负责桥接与 UI,不替代 ComfyUI 本身。
- 社区插件目录(如 SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系;安装前核对仓库与许可。
- 勿使用资料未给出的安装命令;勿
git clone代替上述dsh plugin流程(除非你在本地开发并执行install.mjs)。
结尾¶
ComfyRP Bridge 把 DSH 会话、提示词会话与本地 ComfyUI 串成一条闭环,减少在多个窗口之间复制粘贴。进一步了解可访问社区目录页与 GitHub 仓库:
- 目录页:https://www.skillhub.cn/plugins/bmhty123/dsh-comfyui-rp
- GitHub:https://github.com/bmhty123/dsh-comfyui-rp