dsh-comfyui-gateway
Verifieddsh-comfyui-gateway · v0.7.49 · MIT · Web UI
ComfyUI 任务池网关:统一入口排队分发到多张显卡的多个实例,合并 queue/history/system_stats;带账号隔离的远程控制台(工作流/历史/资产只属于本人、跨重启保留)、SFW/NSFW 分级、每工作流提示词表头、自然语言转提示词与知识库检索。
Install
dsh plugin add dsh-comfyui-gateway Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Readme
dsh-comfyui-gateway
一个 DSH 插件,解决「一张显卡一个 ComfyUI 实例,调用方要自己挑端口」的问题:
所有机器只把 JSON 发到 8187,由它排队、挑端口、转发,并把 /queue、/history、
/system_stats、/view 合并成一份返回。另有一个 8186 远程控制台:账号密码 + 桌面端
显示的 6 位动态配对码登录,可挑工作流、填提示词、传图片、看任务池与历史,还能把某个实例
以画中画方式借出来用(期间该实例暂停自动派发)。
两个端口
| 端口 | 谁在说 | 说什么 |
|---|---|---|
| 8187 网关 | 别的电脑的脚本 / ComfyUI 前端 / 另一个 ComfyUI 节点 | 就是 ComfyUI 自己的协议:/prompt、/queue、/history、/system_stats、/object_info、/view、/ws |
| 8186 远程控制台 | 人(另一台电脑或手机浏览器) | 登录、工作流、提示词、上传、任务池、历史、画布桥接 |
两者分开,是因为网关要保持「纯 API」,而控制台要一套登录与 HTML。混在一个端口上, 每个 API 调用方都得先过 HTML 401 流程。
8187:调用方只要改一个数字
原来各设备自己决定发 8188 还是 8189:
# 原来
curl -X POST http://192.168.3.253:8188/prompt -d '{...}'
# 现在:只改端口,别的都不变
curl -X POST http://192.168.3.253:8187/prompt \
-H 'content-type: application/json' \
-d '{"prompt": {...}, "client_id": "my-box"}'
# → {"prompt_id": "…", "number": 12, "node_errors": {}}
curl http://192.168.3.253:8187/history/<prompt_id> # 轮询结果
curl http://192.168.3.253:8187/queue # 合并队列
curl http://192.168.3.253:8187/system_stats # 两张卡的显存
curl http://192.168.3.253:8187/object_info # 节点表(取自主实例)
curl "http://192.168.3.253:8187/view?filename=a.png&subfolder=&type=output"
ws://192.168.3.253:8187/ws # status / executing / progress
关键点:prompt_id 由网关签发,永远有效。上游实例的那个 id 只在网关内部使用,
/history/<id>、/view?prompt_id=<id> 都由网关翻译。调用方不需要知道任务落在哪张卡。
没列出来的路径一律转发给主实例,所以 /embeddings、/features、以后新增的接口照样能用。
转发到上游的规则(其他 DSH 调 8187 时)
8187 上凡是网关自己不认识的路由,一律原样转给主实例。这里踩过三个坑,
每一个在调用方看来都是同一句 上游 p8188: fetch failed,完全无法定位:
/api前缀要剥掉。 网关的方言里/api/queue与/queue等价,但 ComfyUI 只认后者。 把带前缀的路径转过去,等于向一个正常的实例要一个它没有的路由,于是 404 被当成"实例坏了"。- 不要替换 Host 头。 有些 ComfyUI 部署(以及任何反代后面)会拒绝意外的 Host,
undici 把它报成光秃秃的
fetch failed。现在只转发authorization与content-type。 localhost可能解析到::1,而 ComfyUI 只监听 IPv4 —— 同样是fetch failed。 现在出站前把localhost/[::1]固定成127.0.0.1。
超时从 30 秒提到 120 秒:/jobs?limit=100 这类轮询在忙的机器上很容易超 30 秒,
而超时和"连不上"报的是同一句话。
错误信息现在会说明原因,并带上改写后的真实目标 URL:
{
"error": "上游 p8188 (http://127.0.0.1:8188/jobs?status=pending) 请求失败:连接被拒绝(该端口没有服务在监听)(ECONNREFUSED)",
"upstream": "p8188",
"target": "http://127.0.0.1:8188/jobs?status=pending",
"detail": "fetch failed"
}
cause.code 会被翻译成可读原因(拒绝/解析失败/重置/超时/证书…),
包括一条容易误判的:Node 的 fetch 会直接拒绝 1、9、25 这类保留端口(bad port),
那不是网络问题,现在会单独说明。
两种排队方式
- 先后顺序(关掉动态插队):严格按到达时间;显式
priority仍可插队。 - 动态插队(默认开):每个任务按图里的
steps × 分辨率 × batch(CFG>1 再乘 2,因为 CFG 会双跑 UNet)估一个「代价」;每个实例用 EWMA 学习「秒/代价」;派发时把最贵的任务 交给预计最早跑完的实例(LPT + 机器异构时间模型)。目标是总完成时间最短、显卡不空转。 面板/远程页的「插队」「上移/下移」是硬优先级,任何模式下都生效。
审查边界:API 不审查,只有控制台审查
这条是硬约定,不是默认行为:
| 入口 | 审查 | 为什么 |
|---|---|---|
8187 /prompt(脚本、别的 ComfyUI 节点、本插件的 agent 工具) |
不审查 | 它是 ComfyUI 兼容端点,调用方是程序不是人。发什么就执行什么,不扫描、不改写、不加表头、不拦 |
| 8186 远程控制台(登录后的页面) | 审查 | 只有这里有账号,所以只有这里有分级闸门 |
lib/gateway.js 与 lib/pool.js 不 import tiers.js,也不含 nsfw / sfw / adult 任何一个词;
所有闸门都在 lib/remote.js。这条边界由 test/boundary.mjs 固定:
往 enqueue() 或 /prompt 里加过滤会让它失败。
实测(真 8187 → 真 8188):
POST /prompt -> 200 {"prompt_id":"acbf1900-…"}
text reached the backend unchanged: true | nude, on_back, bedroom, soft light, 1girl
state done | backend live | error null
history files boundary_live_00001_.png
view 200 233341 png true
也就是说:API 提交的成人任务照常排队、照常出图;控制台的 SFW 账号既看不到它, 也提交不了同类内容——两条路各自独立。
8186:远程控制台
面板上可开 / 关,端口也能改(和网关端口一起保存,改完点「重启网关」)。关掉时该端口真的不再监听。
登录
默认要账号密码 + 桌面端「任务池」页显示的 6 位动态配对码;面板可关掉配对码,关掉后登录页
连配对码输入框都不显示(/api/pairing-status 里 required:false)。
- 密码存
scrypt(password, salt),明文不出请求; - 配对码由本机密钥 + 60 秒时间步 HMAC 派生,从不落盘;
- 会话是 HttpOnly Cookie,30 分钟空闲 / 12 小时上限;
- 同一账号 10 分钟失败 8 次即锁定窗口内重试。
外网访问(反向代理)
控制台自己不做 TLS,也没有域名白名单——它就是普通 HTTP。要给人从外网用,前面必须有一层
HTTPS 反代(群晖反向代理、nginx、Caddy、cloudflared 都行),把 https://你的域名 转到
http://192.168.3.253:8186。
三条都成立才算配通(这三条是实测过的,不是清单堆料):
X-Forwarded-*与Host:保留原始 Host 或改写都行。实测把 Host 改成127.0.0.1:8186之后登录、取页面、取/api/state全部照常——控制台不比对 Origin/Host, 所以不会被常见的「反代默认改写 Host」卡住。但必须转发 Host,不能删掉。- 不要挂子路径。页面里的跳转是绝对路径(
/app、/),挂到https://域名/comfy/会 404。要单独一个域名或子域名,根路径直达。 - WebSocket 要放行:画布桥接走
/bridge/<token>/的 upgrade。nginx 需要proxy_http_version 1.1+Upgrade $http_upgrade+Connection $connection_upgrade。 没放行时控制台其余功能正常,只有「打开画布」转圈。
上传单文件上限 48 MB(MAX_UPLOAD_BYTES),nginx 默认 client_max_body_size 1m
会让稍大的参考图直接 413;把它调到 64m 或以上。
会话 Cookie 是 HttpOnly; SameSite=Lax,没有 Secure:所以 https 与 http 下都能登录,
不需要额外开关。代价是同一域名下若还有别的 HTTP 服务,Cookie 不会被浏览器按 Secure 隔离——
这是内网自用工具的取舍。
登录仍然要过两道:账号密码 + 桌面「任务池」页那 6 位配对码。外网就靠这个, 所以配对码保持开启;不想让别人看到配对码,就别把「任务池」页面共享出去。
界面
┌ 顶栏:任务池 · 账号(等级·角色) · 网关 ── 刷新 · 管理工作台 · 退出登录 ┐
├─────────────────────────────┬────────────────────────────┤
│ 工作流(点选) │ 队列(状态 + 插队) │
│ 提示词 正向/负向(含表头) │ 历史记录(可收起) │
│ 图片 拖入/上传/资产库 │ 资产库(缩略图 + 像素尺寸) │
│ 主要参数 steps/cfg/尺寸/种子 │ 显卡(显存、在线) │
│ [生成并加入队列] │ │
└─────────────────────────────┴────────────────────────────┘
工作流是下拉框,选中即加载;管理员会多一个「编辑」按钮,可改名字与正负表头 (保存时把原 graph 原样回传,改这些不会碰节点)。
选工作流之后,下面三块由它的属性决定:没有文本节点就没有提示词框,没有图片输入就没有上传入口, 没有采样参数就没有参数面板。
助手框就是一个大输入框,和提示词框在同一个卡片里:边打字边在下方长出临时提示词库, 每行一个提示词带中文含义与「加入哪个位置」,加入后该行消失;清空输入框则清空库。
右栏只有队列、历史、资产库,不显示显卡;队列每行已写明任务落在哪个实例。
图片可以上传,也可以直接从资产库挑一张当输入。 每个图片输入点一格:图生图可能同时要 init image、mask、IPAdapter reference, 旧版只有一个选择器、提交时把同一个文件名写进每一处——给 init 选的照片会覆盖 mask。 现在每格各自上传、各自从资产库选、各自移除,提交时只发填过的那些,每个都带自己的
nodeId与input。标题写明节点 1 · 加载图像 · image,右上角是「已填 / 总数」。renderWorkflow()必须调用renderImageSlots()。 这条听着像废话,但它就是 0.7.39 修的那个 bug:needsImage把面板揭开、写了一行提示,然后没有画任何东西——#imageslots一直是空的。 上一版改成「每点一格」时,setPicked()和各个事件处理器都会重画,唯独初次渲染这条路径漏了, 而它正是打开工作流时走的那条。教训写在测试里:只断言「容器存在」永远抓不到「没人往里画」。
test/pages.mjs现在检查renderWorkflow的函数体里确有这行调用。每个槽位会说明它的默认值能不能用。 工作流可能是从别处导出的,引用的图片从来没进过这台 机器的
input/——本机实测 6 个 i2i 槽位里有 3 个是这种情况。describe()给每个槽位带available:true显示「默认 xxx.png」,false红字提示「在实例上找不到,请选一张」,null(实例没应答)显示「(未核对)」而不是误报。资产是产物(
output/),LoadImage只读input/,所以挑图时会先把这张图复制进input/(POST /api/assets/use),再用复制件在 input 里的名字提交。以前直接把nsfw_xxx.png塞进图里,实例回Invalid image file,运行在节点 1 就死——这就是 「资产库引入图片失败」。队列每行有「插队」「取消」;历史可收起;资产库点开是大图,支持 1:1、左右翻页、下载。
资产库的每个瓦片显示像素尺寸,取不到缩略图时显示占位而不是破格子。
手机端
两处判断,顺序是刻意的:服务端看 User-Agent 把结果写进 <html data-layout>,首屏就是对的;
页面脚本再看真实视口(max-width: 720px)纠正一次——桌面窗口缩窄、平板分屏、"请求桌面版"的手机
都和自己的 UA 不一致。两套布局跑同一份脚本,只有摆放和密度不同。
- 单列 + 底部标签栏(生成 / 队列 / 历史 / 图库);
- 顶栏一行放完,按钮缩到 12px;
- 输入框 16px(再小 iOS 聚焦会放大整页),触摸目标 ≥ 40px;
- 参数两列;管理台的数字列隐藏,避免横向滚动;登录卡片铺满宽度;
- 底部留
env(safe-area-inset-bottom)。
文件选择框不能用 display:none。 它必须由脚本 .click() 打开,而 iOS Safari 与多个安卓
浏览器拒绝对不在盒子里的元素执行 click() —— 对话框永远不弹,表现就是「手机上传图片没反应」。
#fileinput 用 .visuallyhidden(1px 裁剪、仍在盒子树里)。
进度和错误要显示在操作发生的地方。 #gennote 在「生成并加入队列」那一行,手机上在图片区
半屏之外;上传在跑或已失败都看不见,同样表现成「点了没反应」。图片区因此有自己的 #imgnote,
资产库为空、复制中、复制失败都在那里说。
管理员台(/admin)
只对管理员开放(非管理员 302 回控制台,「管理工作台」按钮也不显示):
- 我的工作流:列表、删除;
- 新建工作流:粘贴画布 JSON,填正负表头;
- 桥接实例:把某个实例的画布打开(期间它退出自动派发),用完交还;
- 表头模板:新建工作流的默认表头;
- 退出登录。
每个账号只看得见自己的东西### 每个账号只看得见自己的东西
这是这一版的核心变化:控制台是按账号的视图,不是共享视图。
| 资源 | 规则 |
|---|---|
| 工作流 | 只列自己创建的;读/删别人的 id 返回 404(与不存在同形,避免枚举) |
| 任务池 | 只显示自己提交的任务 |
| 历史 / 资产 | 只读自己的运行记录;文件按「自己索引里出现过」放行 |
| 媒体 | 猜到别人的输出名也是 404 |
历史跨退出、跨重启保留:提交任务时就把记录写进 runs.json,完成后补上文件名,
所以关掉浏览器、退出登录、甚至 DSH 重启之后,重新登录仍能看到之前的图和运行记录。
等级:SFW / NSFW
账号带等级,面板里加账号时选、之后随时改。
- SFW 账号:看不到成人工作流(按 名字 + 标签 + 图里的提示词 判定),提交的提示词里出现成人词会被
拦下并告诉命中了哪个词,创建不了
declared: nsfw的工作流; - NSFW 账号:两者都能用;等级是上限,不是偏好。
因为账号隔离在先(每个人只看自己的),资产列表不需要再按等级分——SFW 账号本来就不可能创建成人内容。 注意这只约束控制台:8187 的 API 不做审查(见上一节),所以别人的脚本仍可提交成人任务,只是它不会出现在任何账号的历史里。 等级只作为一道兜底:管理员把某账号从 NSFW 降为 SFW 时,它旧的成人工作流不会重新出现在选择器里。
生成:提示词就是 JSON 里的编码器文本
正负向提示词只有一份:它就是工作流 JSON 里正/负编码器节点的 inputs.text。不是「表头 +
自定义」两段拼接出来的第三样东西。
工作台里改 = 改 JSON 本体。「文本节点归属」里每个文本槽位是一张卡片,表头独占整行 (多行文本框),与 JSON 双向同步:在框里打字,
inputs.text立刻变;在 JSON 里改,框立刻刷新。 点保存写进本体。槽位 = 节点 + 输入名,不是节点。一个节点可能喂多个字符串——
StringFunction|pysssss就有text_a/text_b/text_c,3lora人物的节点 15 同时用了两个。按节点存的话, 这两行会同属一个归属、共用同一个表头(后者覆盖前者),也分不清谁是谁。所以归属与表头都按
nodeId::input存:"promptNodes": { "positive": ["15::text_a"], "negative": ["15::text_c", "7"] }, "nodeHeads": { "15::text_a": {"input":"text_a","value":"…"}, "15::text_c": {"input":"text_c","value":"…"} }节点有多个输入时卡片标题写明输入名(
节点 15 · text_a);只有一个输入时不写, 避免每张卡片都挂一个text。旧记录里裸nodeId的键仍能读,但只对它自己声明的那个 input 生效,不会泄漏给同节点的另一个输入。只有一个文本输入的节点,保存时仍写裸节点 id。text是连线而不是字符串的节点(如3lora人物的节点 6)不会出现在这张表里—— 它的内容来自别的节点,没有可编辑的值。这是对的。控制台里改 = 只对这次运行生效。生成页的提示词框是这次请求的值,提交时替换编码器文本, 不落盘、不改工作流本体。
选择工作流后自动带出——切换工作流,框里就是那个工作流自己的提示词;
只有需要文字输入的工作流才显示提示词区——没有文本节点的图(纯放大、换脸、插帧) 不显示提示词框,也不显示「自然语言转提示词」按钮,因为填了没人读;
工作台新建时提示词框是空的,不继承任何模板。
0.7.12 的变化:早先版本有一个独立的
heads字段,提交时按表头, 自定义拼接。那让同一份 提示词存在三处(record.heads、JSON 文本、拼好的结果),没人说得清跑的是哪一份,改 JSON 还会留下 旧前缀。现在没有heads了:请求里带heads会被当作「这次运行整段替换」,不再拼接。
每个文本节点:三态归属 + 自己的表头
一个图可以有两个以上的文本输入节点(SDXL 的 clip_l + clip_g、base + refiner、额外的负向编码器)。 每个节点独立配置两件事:
| 配置 | 在哪 | 存成什么 |
|---|---|---|
| 归属:正向 / 负向 / 不参与 | 工作台的「文本节点归属」卡片,按槽位 | promptNodes |
| 表头:这个节点自己的标准提示词 | 同一行右侧的大文本框(textarea,自动换行) | 直接写进 JSON 本体的 inputs.text;与原文不同的才记进 nodeHeads |
| 分层:这个节点自己的层名与顺序 | 同一行下面那一排 chip | nodeLayers({nodeId: [{name}]}) |
三态,不是两态。 不参与 是有意义的第三态:图里可能有控制台永远不该写的文本节点
(文件名前缀、固定风格词),也可能整条工作流就是不想让人填提示词。
全部不参与 = 控制台不显示任何提示词框,整个提示词区块隐藏。needsText 数的是框不是
行——行数永远大于 0(图里的节点还在),只有框数能表达"没有可填的东西"。
但编辑界面必须一直显示这些行。 两件事分开判:
| 页面 | 判据 | 全部不参与时 |
|---|---|---|
| 控制台 | needsText(有没有非不参与的框) |
隐藏提示词区 |
| 工作台编辑器 | 图里有没有文本输入(graphHasText) |
照样显示所有行 |
用 needsText 决定编辑器显示是可逆性的致命伤:一按「全部不参与」,唯一能改回来的控件也跟着
消失。那是 0.7.34 修的。
0.7.25 的语义变更,两处都是反转:
- 一旦存在归属声明,它就是唯一答案,没被声明的节点是
不参与。旧规则是"没声明就保留 推断角色",听起来谨慎,实际让「不参与」完全无效——节点不在正/负两个列表里,就被立刻重新 推断回正向,下拉框下一帧自己跳回去。{positive: [], negative: []}是真实答案,不再是"未改动"。旧规则把它折叠成null, 于是"全部不参与"这个状态根本存不下来,框永远会长回来。0.7.27 补上了最后一段:服务端语义改了,但前端
collectPromptNodes()仍然在"两个列表都空" 时返回null(= 未改动),所以全部不参与依旧存不进去。现在「有行就一定有答案」,见 下面「为什么曾经『全都选不参与』存不下来」。0.7.34 补上第二处:声明改成槽位键后,编辑器里的角色匹配还在按
pos[row.nodeId]查, 每个槽位都查不到、全落成ignored;同时可见性用的是needsText。两处叠加,编辑器整块消失。
表头属于节点,不属于角色。 一旦图里有两个正向编码器,"正向表头"就不再是单一的东西;而单 编码器的图上"按角色选表头"直接退化成「唯一」(没得配)。每个节点自己的编码器文本就是它自己的 表头,所以在表里按行编辑、按行存。表头用多行文本框编辑:它是完整的一串画质词, 单行输入只能横向滚着读。
分层也属于节点。 负向编码器要的是 排除项 / 画质,正向要的是 面部 / 躯干——一份工作流级
列表描述不了这件事。控制台与服务端读同一个函数:promptBoxes(texts, nodeHeads, nodeLayers, layers) 产出
[{nodeId, input, role, classType, head, layers}],控制台每个条目渲染一个框(标题是
节点 6 · 正向提示词,表头单独一行小字),服务端用同一个列表决定逐次文本写进哪个节点。
所以不会出现「框里是节点 6 的文本、跑起来写进节点 7」。
不参与的节点服务端也会拒绝写入:它不是只把框藏起来——请求里点名一个 ignored 节点,
那段文本会被直接丢弃。
兼容:
headNodes(按角色)没删。老工作流存着「正向框在节点 9」,新代码仍让它在有对应框时 优先,否则分层/覆盖写入会静默改投到"第一个正向"。新记录不再写这个字段。
顺带修掉的:
heads覆盖以前会给每一个正向编码器都写一遍,在双正向图上等于把第二个编码器的 自带文本(refiner prompt、风格前缀)也改了。现在只写表头那一个。
关键参数:默认值来自 JSON 本体
工作台的关键参数表和控制台的参数表是同一批参数,判据也同一套(PARAM_KEYS + 布尔输入)。
- 按节点分组,列表展示:两边都是「节点分组 + 组内一行一个参数」。分组标题写
节点 id+节点名+ 节点类型,节点名取自画布里的_meta.title(图上有名字就用图上的)。 早先是 140px 的小方块网格,名字和数值都会被截断,而且看不出参数属于哪个节点。 两个页面是两份独立文档,各自有一份paramGroupsHtml(),改的时候要一起改。 - 工作台的默认值从 JSON 读,改了就写回 JSON:表格不是第二份存储,它就是 JSON 本体的编辑器。
改完点保存,
inputs里的数字随之改变。 - 控制台的改动是临时的:只影响这一次提交,不写回工作流本体。
- 删除 = 解除关联:删掉一行只是让这个参数不再出现在表单里,JSON 本体一个字符都不改, 运行仍然用本体里的值。删的是「表单到输入的这条链接」,不是那个输入——删掉 KSampler 的 steps 会让工作流直接跑不起来,所以绝不做那种事。删掉的派生行记在 paramHidden 里, 重新用下面「加入这一项」加回来时该记录会自动清掉。
- 参数有四类:
- 数值:普通数字或文本(steps、cfg、denoise、width、sampler_name…), 工作台设默认值,控制台可临时改;
- 模型:值必须是模型库里存在的文件名,所以渲染成下拉框(按文件夹列),不是让人手打;
- 种子:带模式的类型之一——「随机」每次运行重新抽一个 12 位数字,「固定」每次都用填的那个。 默认随机。类型由输入名判定(seed / noise_seed / rand_seed),声明成别的也会被纠正;
- 开关:值是 true / false,下拉只有这两个选项。类型由图里值的类型判定,
不需要手工 pin,也改不成别的类型——
tiled_decode、force_uniform_tiles这类布尔输入 会自动出现在分组里。提交上去的是真布尔,不是"true"/1:ComfyUI 对BOOLEAN做 JSON 类型校验,字符串会被拒,而且是任务入队之后才报错。
自然语言 → 实时提示词库
在生成页的助手框里直接打字,下方会实时长出一份临时提示词库。没有"转换"这一步。
- 输入框每停顿约 350ms 就问一次服务端;
- 服务端先调模型把这句话拆成标签,同时跑一遍词库检索,两者合并(同名只留一条);
- 每行是一个提示词:
- 左边:标签本体(等宽字体,如
long_hair); - 下面:中文含义 · 常用场景(
长发 · 发型); - 右边:加入哪个位置 的下拉;
- 末尾:加入 按钮;
- 左边:标签本体(等宽字体,如
- 点「加入」→ 那个标签写进选中的位置,这一行立刻从库里消失;
- 清空助手框 → 临时库清空。
位置下拉覆盖所有真实可写的地方,包括每个节点的每一个分层槽:
节点 6 · 正向提示词
节点 6 · 正向提示词 · 第 2 层 · 躯干
节点 7 · 负向提示词 · 第 1 层 · 排除项
所以"加入提示词层"是真的可选,而不是只能选到整块文本框。标了「不参与」的节点没有框, 自然不会出现在这个下拉里。
一个提示词只加一个位置,加过就不再显示。 已加入的组合记在 nlTaken 里,同一个标签在
同一个位置不会被推荐第二次——库一直推荐你已经拿走的东西,就是个不再可信的库。
允许一直调用模型。 /api/tags 每次都真的走模型;模型失败时降级到词库,不返回空面板
(半句话没有候选,读起来像坏了)。慢的旧请求会被序号丢弃,不会覆盖新结果。
「用模型扩写」按钮仍在:跑一次完整助手回合(带知识库、带分级),把结果并入临时库, 重复的标签不重复加。
助手按「提示词技能」选词
助手不是凭直觉起标签,它读一个技能包并按里面的规则选词。默认技能
pony-prompt-engineering,位置 ~/.agents/skills/<name>/:
| 读什么 | 为什么 |
|---|---|
SKILL.md |
规则本体 |
references/tag-master.md |
哪个词真存在、热度多少 |
references/zh-to-tag.md |
中文口语 → 标签 |
每次调用都重新读盘,改技能立刻生效,不用重启。默认上限 12000 字节——系统提示装不下一整个 技能包,只取「哪些词是真的」这一层。
技能同时注入两条路径:完整助手回合(/api/assist)和实时提示词库(/api/tags)。
只注一条不够——只给完整回合注入,实时库照样会吐自造词,而实时库才是天天用的那条。
技能与内置提示是叠加,不是替换:内置模板继续管分级规则和输出格式 (POSITIVE / NEGATIVE / NOTES),技能管词汇规则(质量前缀、禁用的自造词、负向分层、拼装顺序)。 换技能不用改插件。
控制台助手框那一行会写 技能:pony-prompt-engineering;未配置时显示「未启用提示词技能」并标红。
配置:
"promptSkill": {
"name": "pony-prompt-engineering",
"dir": "",
"maxBytes": 12000,
"includeReferences": true
}
name 留空 = 不注入技能;dir 留空 = ~/.agents/skills。
怎么确认它真的加载了:GET /api/skill(仅管理员)报告配置了什么、真的读到了什么:
{ "ok": true, "configured": "pony-prompt-engineering",
"loaded": { "ok": true, "files": ["SKILL.md", "references/tag-master.md"], "bytes": 12000 } }
判据是 loaded.ok。技能配了但磁盘上没有时,行为与正常完全一样——直到出图变差才被发现,
这个接口把那个差异直接说出来。
技能带来的三条硬规则
- 质量前缀是六项长串(
score_9, score_8_up, … score_4_up),不是score_9。 Pony V6 把整串当成一个信号训练,写短版等于放弃这部分质量信号; source_anime/source_pony必须进负向,否则底模往动漫/小马画风偏;- 只写有热度的真标签:
detailed_skin_texture、subtle_clavicle、masterpiece这类在 Danbooru 语料里没有对应信号,写进去只是挤占注意力预算。
这三条不注入,模型给的「看起来很像」的英文标签就会白写。
其余不变:
- 接 Harness 的
llm服务和当前默认模型; - 参考知识库:下拉里选
dsh-knowledge-wiki的任意一个库(默认「提示词」),助手会读它的 正文摘录一起送进模型;选「不使用」就完全不读。回复里会写明「知识库『提示词』3 篇」, 所以你能分清答案是查过库还是纯靠模型; - 加入永远是 append,不覆盖:标签是片段,覆盖会丢掉工作流自带的表头;
- 切换工作流不会清空库,但会把指向已不存在位置的选项重指到默认位置。
SFW 账号的成人需求在打模型之前就被拦下;模型若仍答出成人标签,SFW 账号收到的答案会把这些标签剔掉。
知识库插件暴露的是工具(kb_query/kb_read)而不是 service,所以这里是直接读它的磁盘布局:
~/.dsh/knowledge/<库名>/markdown/<docId>/<docId>.md + 同目录 kb.json。路径可在面板改(kbName / root),
另外保留一个「备用目录」给还没导入知识库的纯 Markdown 文件。
为什么曾经每次都退化成词库(0.7.11 已修)
宿主的 llm.prepareCall(config) 会先把请求「冻结」,prepared.stream(options) 再用
callConfigEquals() 逐字段(provider/model/reasoningEffort/temperature/maxTokens/stop)
比对 options 与冻结值,不一致就抛 INVALID_PREPARED_CALL
(prepared LLM call config changed before adapter dispatch)。
网关旧代码在 prepareCall() 里只给了 provider/model,把 maxTokens、temperature 留到派发时才加,
于是每一次助手调用和图片判定都在到达 adapter 之前就被拒,请求一个字节都没出网,
表现就是「模型调用失败:prepared LLM call config changed before adapter dispatch」→ 静默退回词库。
口诀:凡是要在派发时带的控制项,必须在 prepareCall() 里同名带上。 两处现在共用同一份常量
(助手 ASSIST_CONTROLS、判定 controls),test/all.mjs 的 prepared 用例用一份按宿主语义复刻的严格
llm 桩钉住这条契约——还原成旧写法会 10/12 失败。
工作流:选、建、改
工作流库在插件数据目录(workflows.json),每人一份自己的。建/改:粘贴 ComfyUI 画布导出的 JSON
(UI 图)或直接 API 格式,UI 图会按实例的 /object_info 转换成 API 格式:
- 连线优先于控件值;
- 控件值按
required/optional声明顺序落位,种子行跳过跟随的control_after_generate; Note/MarkdownNote、静音/旁路节点丢弃;- 实例里没有的节点会报出来,不会硬塞到生成时才神秘失败。
批量导入工作流
一批 API 格式的 JSON({节点id: {class_type, inputs}})要进库时,不必一个个粘贴:直接调
WorkflowLibrary.put() 就是 POST /api/workflows 跑的同一段代码,会一并算出参数槽位、
归属与等级。
两点在实现里踩过,写在这里免得再踩:
- API 格式不再被当成 UI 图去转换。 转换器需要实例的
/object_info;批量导入时没有, 旧代码于是留下api = null,连带targets与nodeCount都是空——控制台在文生图工作流上 连提示词框都不显示。现在先判"这已经是 API 格式",直接当 prompt 用。 - 库在运行时重读。
workflows.json被外部改写后,控制台会在下一次/api/workflows时按mtime+size判定并重读,不需要重启宿主。 在此之前只有重启整个 DSH 才看得到新导入的条目——「重启网关」只重启监听器,不重读状态。
导入的条目默认 heads 为空:这些图是文档的原样转换,擅自加质量词会改变每个工作流本来的行为。
桥接(画中画借用实例)
远程页点某个实例「打开画布」:
- 给这个实例加一把租约锁,调度器立刻跳过它(一个人在手动画画布、同时调度器往同一张卡 塞任务,是显存爆掉、跑到一半失败的经典原因);
- 通过 8186 的
/bridge/<token>/反代该实例:页面 HTML 会被注入一段 shim,把fetch/WebSocket/EventSource/img.src/<base>全部改写到桥接前缀下, 所以画布在同一个 8186 页面里(iframe 画中画)完整可用,远程浏览器不需要直连 8188; - 关闭、退出登录、或 30 分钟无操作 → 自动释放,实例回到派发池。
升级后的画布会通过 WebSocket 直连实例,桥接同样支持 upgrade(字节隧道)。
实例管理(含本机启停)
面板「实例」卡片能绑定任意 ComfyUI 地址。要让启动/停止真的作用于进程,把该实例的
托管方式设为 启动 bat 文件,然后填那个 .bat 的完整路径:
E:\ComfyUI-aki-v3.2\启动.bat
只有 bat,没有命令行,也没有 ssh。 三种方式里只留有意义的两种:
| 托管方式 | 含义 |
|---|---|
启动 bat 文件 |
网关执行这个 .bat;停止时连同它的子进程一起杀掉 |
不托管 |
只派发,不给启停按钮(进程是别人的) |
为什么是文件而不是命令行:启动 ComfyUI 通常要先 cd、激活虚拟环境、带上端口参数,
这些写在 bat 里最清楚,而且双击就能自己验证一次。让面板里再维护一份命令字符串,
等于同一个启动逻辑存两处,改了一处就会对不上。
- 启动:
cmd /d /s /c ""<bat>""→ 轮询/system_stats直到就绪(超时可配,默认 5 分钟)。 用windowsVerbatimArguments传参,否则 Node 会把引号转义成字面量\", cmd 就会把它当成程序名去执行('\"C:\...bat\"'不是内部或外部命令); - 工作目录默认取 bat 所在目录,所以 bat 不必自己
cd;也可以单独填; - 停止:Windows 上先
taskkill /T /F杀进程树再结束子进程(bat 包装器会留下孙进程, 只杀直接子进程的话显存不会释放——这一点在测试里踩过),然后轮询端口确认不再响应; - 插件卸载 / DSH 退出时杀掉本插件起的所有进程,不留孤儿占显存。
旧配置迁移:以前的 spawn + 命令行 与 ssh 已停用。迁移规则保守——只有当一个旧
command 本身就是 .bat / .cmd 路径时才转成 启动 bat 文件;其余(比如
python main.py --port 8190、以及所有 ssh 行)一律退成 不托管。理由很直接:
把一条命令行当文件路径去执行,或者假装能用本地 bat 启动远端主机,都会让「启动」按钮骗人。
桥接为什么卡在 logo(已修)
桥接把实例画布嵌进来时,返回的 HTML 里脚本仍是根绝对路径 /assets/app.js。浏览器于是向 控制台要这个文件,拿到的是控制台的 404 JSON 而不是 JavaScript——脚本没加载,SPA 就 一直停在 logo 动画上。
为什么以前没发现:注入的 shim 只改 fetch / WebSocket / EventSource / img,而 script[src] 是解析阶段就取走的,shim 追不上。另外 base href 也救不了——根绝对路径按源站 解析,直接把 base 的路径丢掉。
现在两层都改:
- HTML 里的 src / href 在返回前加上桥接前缀;
- JS 里的模块说明符(import "/x"、from "/x"、import("/x"))也在返回前加上前缀。 第二层是必须的:动态 import 由浏览器的模块加载器执行,不经过 fetch,任何运行时 shim 都拦不住它。
改写是幂等的,已带前缀的不会再加一次;协议相对地址(//host)与普通字符串里的斜杠不动。
实测:一个带模块脚本、根绝对 API、动态 import 的 SPA 通过桥接后完整启动 (ready|stats=ok|late=ok),无任何请求失败。
还有第三处:JSON
网页的 manifest 用根绝对路径写图标:/assets/images/comfy-icon-192.png。浏览器按源站 解析它,于是去问控制台要图标,拿到 404——就是报告里那条 comfy-icon-192.png Not Found。 manifest 由浏览器自己解析,页面里的 shim 拦不到,只能在返回的字节上改。
所以 JSON 响应也过一层改写:只动「以单个斜杠开头的字符串值」,数字、布尔、正文里的 斜杠都不碰。实测图标从 404 变成 200(9944 / 27941 字节的真实 PNG)。
403 的原因:桥接把浏览器的 Origin 转给了上游
截图里三个 bundle 报 403 Forbidden。实测同一条 URL:
- 不带 Origin → 200,168214 字节
- 带 Origin → 403,0 字节
这是 ComfyUI 的 CSRF 防护在正常工作。而桥接是代理,它原本把浏览器的 Origin (控制台的地址)原样转给了上游,于是每个模块脚本、每个 XHR 都被判成跨源请求。 浏览器加载 ES 模块必然带 Origin,所以画布脚本一个都下不来。
WebSocket 是同一个原因:ComfyUI 只在 Origin 与自身同源时回 101,否则 403。 桥接的握手是逐条转发请求头,把 Origin 也带过去了,所以画布的实时通道根本连不上—— 表现就是「外壳加载出来了,但画布不动」。
现在两条路径都剥掉 Origin / Referer / Sec-Fetch-*。调用方在进入桥接前已经过会话 校验,所以这里丢掉 Origin 不等于放宽鉴权:跟上游说话的是控制台,不是外来的页面。
实测(带浏览器真实会发的头):4 个 bundle 全部 200、API 200、WebSocket 101。
顺便说清:为什么不能直接 iframe 嵌进去
试过这条更简单的路,结论是走不通,判据如下:
- 页面本身可以被 iframe(没有 X-Frame-Options,也没有 CSP frame-ancestors);
- 但 iframe 里的 WebSocket 会被拒(Origin 是控制台,不是实例)——403;
- iframe 里的 API 同样 403。
也就是说 iframe 会加载出外壳,然后画布死在那里,症状和桥接坏掉时一模一样。 除非让 iframe 与实例同源,而那正是桥接在做的事。
报告里另外两条 404 不是桥接的问题
user.css 与 api/userdata/user.css 在实例上本来就是 404(ComfyUI 允许用户自建这两个 文件,没建就没有),这不是桥接该修的。
产物前缀:sfw_ 与 nsfw_
每张产出图都带内容类别前缀,一次运行只判一次:
- SFW 工作流 → sfw_名称
- 成人工作流 → nsfw_名称
- 吃到 nsfw_ 输入图的运行 → nsfw_名称,即使工作流本身是安全的
第三条是关键。图生图本身就是一次转码,如果产物跟着工作流变回 sfw_,那张成人图过一遍 安全流程就被洗白了——这是整个过滤最容易被一个来回击穿的地方。所以判据是 「工作流是成人的 或 输入图是 nsfw_ 的」。
前缀是替换而非叠加:两层前缀会让类别失去意义。工作流自己的命名保留在前缀之后 (nsfw_我的命名),文件仍然认得出是谁做的。
管理员的小眼睛
工作台右上角有个眼睛按钮,默认关闭。关闭时不显示任何成人内容;打开就在本会话内 显示成人级工作流,并且可以运行它们。
状态完全由服务端保存,键是会话 token,只存在内存里:
- 写盘的话重启后还在,那和「关闭页面就恢复」正好相反,所以不落盘;
- 按 token 而不是按用户,两个标签页(或两个人共用管理员账号)不会互相继承;
- 退出登录时清除,关闭或刷新页面时由 pagehide 发一个 keepalive 请求复位;
- 只有管理员能切,普通账号按 403 拒绝。
刷新页面也算关闭页面,所以刷新后会回到关闭——这是设计如此,不是状态丢失。
模型列表:读所有实例
原来只问主实例,所以双卡机器上第二张卡独有的模型看不见。现在遍历每个启用的实例, 按文件夹合并去重:两个实例共享同一目录时不会重复列出,只存在于某一张卡的模型会出现, 并标明来自哪些实例。空文件夹直接过滤掉——一个选不了东西的分区只是噪音。
本机实测:两个实例都响应,底模 3 / LoRA 2 / 放大模型 2 / VAE 1,空文件夹 0 个,无重复。
编辑器:一个入口,一个页面
「新建工作流」从独立表单改成一个按钮,点开的就是编辑那同一个页面(空草稿)。 两套表单意味着两处校验要同步,这是它们的归宿。
页面顺序按操作时想的顺序排:
- 名称
- 分类(文生图 / 图生图 / 文生视频 / 图生视频 / 文生音频)与分级(SFW / NSFW)
- JSON 主体
- 提示词表头 + 分层提示词——只在 JSON 里真有文字输入时才显示; 放大这类不接文字的工作流不会看到一个空白提示词区
- 主要参数——按 JSON 自动识别,可手动增删(选节点 + 选输入名即可加入)
两个按钮:重新识别(改完 JSON 刷新下面所有派生内容)与测试这个工作流。
测试按钮检查什么
不排队、不出图。编辑时点「测试」问的是「这份图能不能跑」;提交真任务会白烧显存, 而且坏图要等几分钟才在队列里报错,不是当场。
检查三件事,逐条列出问题所在节点:
- 连线指向的节点是否存在(最常见的静默断裂)
- 每个 class_type 在实例上是否装了
- 引用的模型文件是否真的在对应文件夹里
模型文件夹按节点类型判定,不能只看输入名:model_name 在 LoraLoader 上是 LoRA、 在 UpscaleModelLoader 上是放大模型。只看输入名会把正常的放大模型报成「找不到」—— 这个错误是本轮实测里真实出现过的。
审查就三条
- SFW 账号看不到成人工作流(不是灰掉,是不出现)。
- SFW 账号的成人提示词被拦截——分层框和正文都查,命中就拒绝执行。 不做静默清洗:悄悄改掉的提示词会生成一张没要求过的图,比明确拒绝更糟。
- 上传的图片用模型判一次,判为成人就拦在上传口。图片不进 ComfyUI 的 input 目录, 没有后续按名字被捞起来的可能。NSFW 账号直接跳过这次判定,不花这个调用。
判定失败、没有模型、回答看不懂——一律放行。过滤器在自己坏掉的时候拦住所有人, 比漏判更坏事。
工作流库是所有账号共用的
一份库,管理员配一次,所有账号都能用。可见性只由账号等级决定:
| 账号等级 | 看到的工作流 |
|---|---|
| 全年龄(SFW) | 只看到 SFW 的 |
| 成人(NSFW) | 全部 |
看不见的那条完全不出现,不是灰掉——工作流名字本身就是信息,私房_NSFW 这样的标题
显示出来就已经泄露了。
写入是管理员专属:库是共用的,一个账号的编辑会改掉所有人跑的东西,这是部署级动作。
运行不限制,任何人跑任何自己等级能看到的工作流——共享的意义就在这里。
GET /api/workflows 会返回 canEdit,界面据此隐藏编辑入口,而不是让人填完表单才被拒。
分级判定只看向正向
这一条是共享之后必须修的。Pony 系工作流的负向里全都写着
rating_explicit, rating_questionable, nsfw, nude——写在负向里正是为了排除它们。
原来按整张图扫描,于是这台机器上 10 个工作流有 3 个被判成成人级,
共享后全年龄账号会直接看不到自己的人像工作流。
现在只扫描正向编码器(顺着采样器的 positive 连线走,跳过 negative 指向的节点)。
判定的是「这个工作流会生成什么」,而不是「它想排除什么」。同一个库实测:
修正前 SFW 账号看到 7 个、修正后看到 10 个,而真正的成人内容仍然被拦。
没有采样器连线可循的裸节点图会退回全扫——宁可多藏,不漏显。
资产库为什么以前不显示图片
两个独立原因,叠在一起表现为「一片空白」:
缩略图标签没闭合。 生成 HTML 时写成了
<img src="…" loading="lazy"然后直接接<span>——浏览器把整个 span 当成 img 的属性吞掉,<img>元素根本没有出现, 于是每格都是空框。少一个>就够了。重启前的运行没进资产库。 资产只从内存里的
pool.tasks同步,而 DSH 重启后内存是空的;runs.json里明明有完成记录与文件名,资产库却一直是 0 条。实测本机就是: runs 有 1 条完成记录带 1 个文件,assets.json里 0 条。现在多一遍「按持久索引补齐」的扫描:遍历
runs.json里每个账号的已完成记录, 缺就写进资产库。幂等——hasRun先比行数,已经齐了就不写。本机实测 0 → 1, 第二次扫描新增 0 条。
另外加了 scripts/check-void-tags.mjs:扫出 <img/<input 这类标签是否真的闭合。
第一版按单行判断,误报了 4 处跨行拼接,改成按逻辑行(把 + 续行拼起来)判断后为 0 误报。
为什么会出现「节点 15 显示 a 和 c」
StringFunction|pysssss 的节点 15 是:
{ "text_a": "score_9, … 1girl, solo",
"text_b": ["14", 0],
"text_c": "" }
text_a字符串 → 可编辑;text_b连线 → 内容来自节点 14,不可编辑(应排除);text_c空字符串 → 没有内容可编辑(应排除)。
旧规则只判 typeof value === 'string',于是 text_b 被跳过(对),text_c 被当成槽位(错)
—— 显示出来就是「a 和 c」。
现在空字符串不算槽位,但已经为它声明过角色的除外:清空提示词时行不能从光标下面消失。
自定义节点升级后,旧工作流为什么会整图失败
两类变化都在实测里出现过:
| 节点 | 工作流里写的 | 实例现在要的 |
|---|---|---|
TagsSelector |
civitai_tags_list |
tags_list |
TagsSelector |
Selector |
selector |
LoraLoaderVanilla |
(没有) | append_loraname_if_empty(必填) |
界面上没有地方能补:那个输入根本不在 JSON 里。所以 generate() 在提交前做两件事:
- 补默认值:只补缺失的必填项,用节点自己声明的
default;已有值一律不动。 链接型输入(MODEL / CLIP / IMAGE…)不补 —— 给常量只会换一种错误。 - 对齐键名:存量键在 spec 里不存在时,按大小写和去掉前缀后的名字找唯一候选。 候选多于一个就放弃 —— 猜错会静默接到别的输入上。
为什么图生图会有多个图片输入点
一个图生图工作流可能同时需要:init image、mask、IPAdapter 参考图。旧面板只有一个 选择器,提交时把这个文件名写进每一个图片节点:
(wfDetail.images || []).forEach(function(target){
images.push({ nodeId: target.nodeId, filename: picked.filename }); // 同一张图,全部
});
给 init 选的照片,同时覆盖了 mask。服务端 setImage(prompt, nodeId, filename) 也只看节点 id,
写入该节点第一个像文件名的字符串——同一节点上的第二个图片输入永远收不到值。
现在:
- 前端每个图片输入一格,状态是
pickedSlots["nodeId::input"],提交只发填过的槽位; - 服务端
setImage(..., input)优先按输入名精确写入,不带input才退回启发式 (链接步骤、旧客户端仍可用)。
顺带修掉发现逻辑:imageTargets 的名字判断原来是精确匹配 image|image_path|mask|video,
mask_path 这类名字被漏掉,同一个有 image 和 mask 的节点只报出 1 个槽位。现在实例声明为
IMAGE/MASK 的一律算,名字兜底放宽到「名字里有图片/遮罩/视频/参考这层概念」,
但仍要求值确实是图片/视频扩展名,纯文本输入不会误判。
为什么图片输入会「未识别」
工作流里可能存着带前端标注的文件名:
"#4 LoadImage": { "image": "Upscale_2x_Pure_00003_.png [output]" }
[output] 是 ComfyUI 前端下拉框给文件来源加的标注,不是文件名。它让扩展名检查失败,
整张图一个图片输入都识别不出来;就算识别了,把这个字符串发给实例也只会得到
Invalid image file。
stripNameAnnotation() 只去掉结尾的 [something](名字中间的方括号保留),三处都用:
imageTargets用它判断并上报干净文件名;setImage的启发式用它比较,否则「值不像图片」就选不中这个槽位;generate()提交前把所有字符串输入里残留的标注清掉(即使这一轮没换图)。
为什么「种子设为固定」存不下来
collectParamPicks 曾有一行:
if (descBox === null || descBox.readOnly) return;
派生行的描述框是 readonly(它们的值是图的镜像,不该手改),所以种子这一行从来没进过
paramPicks,seedMode: 'fixed' 没机会被保存。
现在每个可见行都贡献一个 pin。被删除的行不在 DOM 里,本来就不会回来;paramHidden
才是压制它的机制。派生行的 pin 只是复述图里的值,无害——而且它是「表单属性」(种子模式、
改名)能存下来的唯一通道。
资产库选图为什么会失败
资产库每一条都是产物:{filename: "nsfw_xxx.png", type: "output"}。
而 LoadImage 的下拉只列 input/。
旧代码把产物名原样当输入名交给图,实例回:
node #1 (LoadImage): custom_validation_failed
details = image - Invalid image file: nsfw_xxx.png
本地上传为什么不失败:/api/upload 会把字节真的写进 input/,返回的名字就在那个目录里。
差别不在名字,在文件在不在 input 目录。
现在选图走 POST /api/assets/use:校验归属与分级 → 用实例自己的 /view 取回字节 →
以 asset_<原名>.png 上传进 input/ → 返回那个新名字。不沿用输出名,因为 input/
与 output/ 是两个命名空间,同名在列表里看起来像同一张。
顺带修掉的三处:
| 问题 | 后果 |
|---|---|
| 上游错误截到 200 字符 | node_errors 正好被切掉,失败原因存不下来,runs.json 里的 JSON 都解析不了 |
上传返回丢 subfolder |
文件进了子目录时只回 name,LoadImage 需要 subfolder/name,于是"文件存在却读不到" |
文件名清洗 [^\w.\-] → _ |
测试图片.png 变成 ____.png,中文名全丢,两张不同照片可能撞名 |
关键参数:可以自己加
控制台的「主要参数」原来只认一张固定白名单(steps / cfg / seed / 尺寸 / batch)。 真实工作流里的 ControlNet 强度、LoRA 权重、第二个采样器都不在里面,用户没法调。
工作台编辑工作流时新增「额外关键参数」:选节点 + 选输入名,加入即可。
这些 pin 存在工作流上(paramPicks),控制台把它们和自动识别的参数并排显示。
- 值仍然读自图,pin 只是让它出现在面板上,不能凭空造值;
- 连线输入(值是
[节点, 槽位]而不是标量)在下拉里标为「不可调」并禁用; null表示不改、[]表示清空,与 layers / heads 同一套语义;- 最多 40 个,重复的会自动折叠;
- 布尔输入是例外:它们不需要 pin,
mainParams()会把每个true/false输入直接派生成 参数行,并归成「开关」类型(见下面「类型与判据」)。手工 pin 一个布尔输入也可以, 但它仍然是开关,改不成数值或模型。 - 两套界面的参数区都是按节点分组的列表(
节点 id + 节点名 + 类型作分组标题), 不再是小方块网格。
加一行就有下拉可填(0.7.25 修)
两个独立的 bug 让"手动添加"看起来坏了:
- 下拉本来是空的。
renderPickSelectors()只在"新建工作流"里被调用过,打开已有工作流 时从不调用,所以节点/输入两个下拉一直是空的。现在由renderEditorFields()调用——打开、 重新识别、加一行、删一行,所有路径都经过它。 - 「+ 加一行」加出来的行会立刻消失。 它推的是
{nodeId: '', input: ''}的 pin,而collectParamRows会丢掉任何在图里找不到的 pin(这条规则本身是对的:pin 不能凭空造值), 于是新行下一帧就不见了。现在它是一个草稿行:自带节点下拉和输入下拉,选完两个就变成 正式 pin;分组标题显示「+ 待选节点」。
布尔输入也算"可选":tiled_decode 这类开关以前在下拉里是禁用的,现在可以选。
工作链里可以改内嵌工作流的参数与文本
原来点环节里的工作流名,是连弹几个 window.prompt 问负向、分层、次数。
那套撑不住参数——一个工作流十几个可调项,逐个弹窗既没法用,取消第 5 个还会丢掉前 4 个。
现在是一个内联面板:分层文本框(按该工作流正向节点的层数生成)、负向、主要参数表格、运行次数, 一次性看完、点「应用本步设置」才写入。参数列表来自该工作流自己的 detail 载荷, 所以每一步只显示这张图真有的旋钮。设置只作用于该步,不改工作流本身。
主题
两套完整配色,同一批 CSS 变量,右上角一个按钮切换:
| 底 | 面 | 字 | 强调 | |
|---|---|---|---|---|
| 暗色(默认设计) | #0e1013 |
#161a1f |
#e9e6e1 |
#d98b3a |
| 亮色 | #f7f6f3 |
#ffffff |
#1b1917 |
#a9631f |
亮色不是暗色的反相:铜色在纸上会变成刺眼的警示色,所以压深到 #a9631f;
描边、悬停、危险态各自有一套对应的浅色版本,否则会出现「白底上贴着几块深色补丁」。
- 切换只改
<html data-theme>一个属性,没有元素带主题专属规则; - 选择存在
localStorage(按浏览器,不按账号——这是这块屏幕的显示偏好,不该跟着账号跑到别的设备); - 没选过时跟随系统
prefers-color-scheme,并且系统偏好变化时只在「没手选过」时才跟着变; - 主题脚本在
<head>里、页面绘制之前执行:放到<body>会先闪一帧暗色再跳到亮色,那比任何一套配色都难受。
分层提示词(每个文本节点各一份)
每个文本节点都能有自己的分层,不只是正向。
理由很直接:负向编码器想要的是 排除项 / 画质 / 水印,跟正向的 面部 / 躯干 毫无关系。
旧实现只有一份工作流级列表、控制台也只画在正向下面,所以「分层」从构造上就是正向专属的。
在工作台的每个文本节点卡片里,表头下面那一行就是它自己的分层:
1 [面部] ×2 [躯干] ×+ 加一层,最多 8 层;- 顺序就是拼接顺序,也是唯一契约——模型看到的是拼好的那条串;
- 名字只是标签,留空就显示成「第 N 层」;
- 一个节点一层都不加,就还是那一个整段框;
×是 24×24 的真按钮,点掉即刻消失(它曾经读错属性名,静默什么都不做)。
控制台按节点渲染:某节点声明了几层就在它自己那个框下面画几个输入框,不再同时给一个整段框—— 同一个内容有两个地方能填,最后一定是填错那个。没有分层的节点保留原来的单框。
拼接在服务端做(joinLayers):按层序用 , 连接(英文逗号 + 一个英文空格),
空层跳过,所以留空躯干不会产生 面部, , 环境;两端多余的逗号也会被剪掉。
拼接结果写回同一个节点的编码器,然后照旧套上表头,表头仍然排在最前。
存储语义:[] 和「没有条目」不是一回事
| 值 | 含义 |
|---|---|
nodeLayers = { "7": [{name:"排除项"}] } |
节点 7 用这一套 |
nodeLayers = { "7": [] } |
节点 7 不分层(就一个框) |
nodeLayers 里没有 "7" 这个键 |
回退到工作流级 layers(老工作流的兼容路径) |
第三行是给 0.7.27 之前写的工作流用的:它们只有一份工作流级列表,那份列表继续作用在没单独配置的 节点上,不会凭空消失。
[] 必须留住:最初 normalizeNodeLayers 把空数组直接丢掉,于是「删掉某节点的最后一层」
被读成「这个节点没配置过」→ 回退到工作流级列表 → 删掉的层又回来了。这条是被测试
(an explicit empty list beats the fallback)抓出来的。
为什么曾经「全都选不参与」存不下来
这是 0.7.27 修的。前端 collectPromptNodes() 里有一句:
if (positive.length === 0 && negative.length === 0) return null;
null 在这套协议里表示「未改动,保持库里原样」。全部选「不参与」时两个列表都是空的 →
返回 null → 服务端认为这次没做声明 → 库里原来那份声明原样保留 → 下次打开框又回来了。
现在是:有行就一定有答案,只有「表格根本没有行」才返回 null。
配合服务端「一旦有声明它就是唯一答案」,全部不参与 → {positive:[],negative:[]} → 被存下来 →
每个节点 ignored → 0 个框 → 控制台整个提示词区块不显示 → 重新打开还是不显示。
LoRA 层:助手永远不填
层名命中 lora / lycoris / embedding / 触发词 的那一层是 LoRA 触发词槽——
触发词来自 LoRA 文件自己的元数据,不由这一次的需求决定。所以:
- 系统提示里逐层点名要求留空(不是一句泛泛的"注意");
- 模型即使填了,服务端也会强制清空并在 notes 里报告"已清空 …";
- 词库回退路径(没连上模型时)也跳过它,写进第一个非保留层。这一条是 0.7.24 修的:
原来回退把标签全写进 L1,而线上工作流的层名恰好是
lora层 / 主体… / 环境…, 最该保护的那层正是它写入的那层。 - 三个地方共用一个判定
isLoraLayer()/firstWritableLayer(),不再各写一份正则。
关键参数:四个字段,和 JSON 严格对应
每个参数就是一行,字段固定四个:
| 字段 | 含义 |
|---|---|
| 参数名 | 必须与 JSON 里的输入名完全一致,它同时就是写入图里的那个键 |
| 节点 id | 填了就按这个节点;不填要求参数名在整张图里唯一 |
| 默认值 | 控制台打开时输入框里显示的值 |
| 说明 | 显示在输入框下面的一句话 |
为什么名字必须严格一致
试过模糊匹配(「步数」自动找 steps),放弃了:图里两个节点都有 steps 时它会默默挑一个。 绑错节点的参数只会在出图时报错,而报错里既不说哪个参数、也不说哪个节点。
所以现在找不到就不加入,并明确说原因:
- JSON 里找不到名为 X 的输入
- X 出现在多个节点上(3(KSampler)、4(KSampler)),请补上节点 id
- 节点 99 在 JSON 里不存在
- 节点 5 没有输入 cfg
从文字识别
编辑界面有一个识别框,每行一个参数:
参数名 | 默认值 | 节点id | 说明
用竖线或逗号分隔都行,也可以写 参数名 = 默认值(这时节点 id 留空,要求名字唯一)。
识别失败的行会逐条列出,不会静默丢弃。
模型参数(仅 NSFW)
关键参数可以设成模型:值不再手打,而是从模型库里选。比如面部 LoRA,把类型设为
「模型」、文件夹选 loras,控制台就是一个下拉框,列出 LoRA 目录里的文件。
参数因此多两个字段(其余仍是那四个):
| 字段 | 含义 |
|---|---|
| 类型 | 普通值 / 模型 / 种子 / 开关 |
| 模型文件夹 | 选「模型」时生效,决定下拉框列哪个目录 |
类型与判据(谁说了算):
| 类型 | 由什么决定 | 能否手改 |
|---|---|---|
| 开关 | object_info 声明这个输入是 BOOLEAN(其次才是图里值的 JS 类型) |
不能(布尔只能表达两个值) |
| 种子 | 输入名(seed / noise_seed / rand_seed / random_seed) | 不能(声明成模型也会被纠正) |
| 模型 | 工作台里的声明 | 能 |
| 数值 | 兜底 | 能 |
为什么判据是 object_info 而不是值的类型:这些自定义节点把布尔存成字符串 "true",
例如 LoraLoaderVanilla.force_fetch。只看 typeof value === 'boolean' 永远不成立,
于是开关被渲染成文本框、提交时写入 "true" —— 实例会拒(BOOLEAN 按 JSON 类型校验)。
现在的链路是:保存工作流时把 object_info 里的布尔输入固化成记录上的 booleanKeys
(运行时不依赖再问实例一次)→ 控制台据此渲染 true/false 下拉 → 提交时写真布尔。
布尔输入不需要手工 pin:mainParams() 会把每个布尔输入派生成参数行(名字由节点决定,
白名单永远补不全),并渲染成 true / false 下拉。写回 JSON 时一定是真布尔——
ComfyUI 对 BOOLEAN 做 JSON 类型校验,"true" 和 1 都会被拒,而且是入队后才报错。
文件夹清单与模型面板共用同一份常量,所以编辑界面不会给出一个模型面板根本不读的目录。
为什么只给 NSFW
这不是内容判断,是能力划分:挑模型文件属于运维操作,全年龄表单只保留普通参数。
门在服务端,不在页面:
- 工作流详情接口对全年龄账号直接不返回模型参数,返回体带 modelsLocked: true;
- 模型清单接口对全年龄账号把文件名清空,只留文件夹形状——面板不会 403 破版, 但也拿不到任何文件名;
- 手改请求没有用:服务端在组装返回体时就滤掉了。
实测:NSFW 账号拿到 4 个参数(含 1 个模型,下拉框已用 loras 目录的 2 个文件填好); 同一请求换成 SFW 账号,只剩 3 个普通参数,模型清单里所有文件夹的 items 都是空的。
默认值覆盖图里的值
声明的默认值是控制台打开时显示的值,会覆盖图里的原始值。实测:图里 steps 是 20, 声明 35,控制台显示 35。这样同一个工作流可以给不同账号/场景配不同起点,而不用改图。
控制台里改值、编辑界面增删改,两边都在这一张表上。
工作链模式
控制台顶部两个小标签:工作流(原来的单工作流出图)与工作链。点哪个显示哪个, 切换只切显示,两边状态都不丢。
工作链是「按顺序跑一串工作流」,严格串行,上一级的产物就是下一级的输入:
- 设定环节数(1–12),点「生成环节」,出现对应数量的槽位;
- 把下方的工作流图标拖进槽位(手机上点槽位,从编号列表里选);
- 点槽位里的工作流名,设定这一步的负向提示词、分层正向、运行次数;
- 第 2 步起默认勾选「用上一步的图作为本步输入」,取消勾选则该步独立生成;
- 「运行整条链」→ 逐步执行,每步完成后显示产物文件名。
为什么必须串行:/api/chains/run 不是把 N 个任务一次塞进队列。后一步依赖前一步的
产物,一次全提交会在前一步还没出图时就开始后一步,那个「接收上一步」的输入就是空的。
所以它逐步提交、逐步等待完成,再带着产物走下一步。
几个实现上的取舍:
- 产物取「已保存的 output」而不是 temp 预览。接着中间渲染往下跑会让第二步质量更差, 而这个差别光看代码看不出来。
- 某一步失败就停。后续步骤是照着前面的产物设计的,继续跑只会产出自信的废话; 返回体里带上是第几步、什么错。
- 每步 30 分钟上限:卡住的一步不能把整条链永远挂在那里。
- 链的中间产物不进资产库——资产库记的是「你生成过什么」,不是「流水线中间态」。
收藏:设好后「收藏这条链」,下次在「收藏的工作链」里点一下就能整套载回(含各步设置与 串联关系)。草稿也可以直接运行,不必先收藏。
助手如何填提示词
助手(「用一句话描述想要什么」)不是把一整段话塞进一个框,它按工作流的结构分发:
- 分层工作流:模型被要求按层输出,
L1=面部的话进第一层,L2=躯干进第二层。 层名来自工作流定义,服务端按声明顺序解析,前端按下标填入——不是全堆在第一层。 - 负面内容进负向框:说「不要模糊、不要多余手指」→
blurry, extra_fingers写进负向编码器, 绝不会出现在任何正向层里。这一条同时写在系统提示词里,并在解析端兜住。 - 控制台里是替换,不是追加:工作流自带的起始提示词会被新内容覆盖。追加意味着 每生成一次都会在旧提示词后面粘一段,那正是要避免的。
- 分层回复解析容错:
L1:/1./第一层:/第1层:都能落位;空层保持空而不整体前移; 无法识别的行会记下来并在提示里说明,而不是悄悄并进第一层。
层名由服务端从工作流读取(workflowId → library.get),不接受客户端随便指定——
否则客户端能让模型产出工作流里根本不存在的层数。
提示词收藏
控制台提示词区底部有「收藏当前提示词」,把当前各层与负向一起存下来;喜欢的一条点一下就能
一键填回(同样是替换)。收藏是按账号的,存在插件数据目录的 prompts.json:
- 同名再存一次是更新那一条,不是产生两条——改个错别字不该变成两个收藏;
- 只存文字,不绑工作流:一条「雨夜街景」可以用在任何文生图工作流上;
- 空提示词与空名字都会被拒绝并给出原因;
- 每人最多 200 条,超出丢弃最旧的。
运行次数
生成按钮旁有「运行次数」,1–8 次,一次提交排队 N 条独立任务:
- 每条是池子里独立的一个任务,取消、插队、优先级都按单条生效,没有额外的「批量」状态;
- 每次用一份 prompt 深拷贝——池子会改写自己持有的 prompt,共用一个对象会让第二条看到第一条的改动;
- 上限 8 而不是更多:这些活落在一两张消费级卡上,手滑排 50 条就是半天的队列,还得一条条取消。
工作台(管理工作台)
控制台是出图的地方,工作台是管工作流的地方。两页各管一件事,编辑与复制只在工作台里。
左栏是工作流:每一行有「编辑 / 复制 / 删除」。点「编辑」在下方展开详情块,一个工作流就是一整块:
| 字段 | 说明 |
|---|---|
| 名称 | 列表里显示的名字 |
| 分级 | SFW / NSFW,决定哪些账号能看到它 |
| 正向 / 负向表头 | 选中这个工作流时自动带出 |
| 主要参数 | steps / cfg / sampler / scheduler / seed / denoise / 尺寸 / batch,从图里抽出来,直接改 |
| 文本节点 | 每个文本节点的完整提示词 |
| JSON 主体 | 整份图,用于改上面没覆盖的东西 |
保存会关闭详情块并回到列表;「另存为副本」用当前改名后的图另存一条新工作流。JSON 主体是唯一真源: 上面的字段在保存前叠加到从它解析出来的对象上,所以手改过 JSON 也不会被覆盖,JSON 坏了会拦下来不写入。
右栏两块,都读实时状态:
模型:从实例的
/models读真实文件夹清单(本机 39 个),逐个读/models/<文件夹>拿库存,按文件夹折叠, 一个装了几百个 LoRA 的库摊开会把队列挤出屏幕。文件夹名用本名,不翻译:ComfyUI 自己的界面写
checkpoints,磁盘上是models/checkpoints, 面板也写checkpoints。显示「底模」等于多一层对不上号的翻译。文件夹来自实例,不是写死的表:旧实现只有 13 个硬编码项,本机实际有 39 个——
sams、facerestore_models、ultralytics_bbox、rmbg、unet_gguf、clip_gguf、diffusers这些根本选不到,而且modelsInFolder()还拿它当白名单,不在表里直接返回空数组, 和「这个文件夹没有文件」长得一模一样。现在问实例,常量只作为实例不可用时的兜底。多级文件夹:
/models/<folder>本身返回递归路径(subdir/name.safetensors),原样透传并去重, 子目录内容自然合并在同一个下拉里。模型清单只读本机磁盘,不走实例。一次
readdir就够,不发任何实例请求。三个理由都是实测的:问题 现象 /models只列folder_paths注册过的grounding-dino、insightface、reactor、yolo、nsfw_detector在磁盘上,API 从不提API 按实例作答 两个实例共用同一份 models时,同一批文件名回来两遍实例不在线就没有清单 而工作流库恰恰是「机器关着也要能改」的东西 本机实测:磁盘 38 个文件夹,比 API 多 9 个。
目录怎么定位:优先实例配置的
modelsRoot;留空时从control.batPath推导 (<bat 目录>/ComfyUI/models,便携版标准布局);都读不到就报错并提示去设modelsRoot。 读的是设置而不是instances.enabled()——runtime 要等sync()才刷新,改完配置不重启会一直显示旧值。递归与类型:
modelsInFolder()递归最多 6 层(防符号链接环),返回subdir/name.ext, 与 ComfyUI 的/models同形。只列权重:白名单
\.(safetensors|ckpt|pt|pth|bin|gguf|ggml|onnx|sft|pkl)$。早先的版本写着「不按扩展名过滤,否则会藏起真文件」,结果本机漏出 17 个非模型文件:
grounding-dino/GroundingDINO_SwinB.cfg.py、bert-base-uncased/{config.json,vocab.txt}、configs/*.yaml(12 个采样配置)…… 它们和权重放在同一个目录,但选中任何一个都会在加载时失败。用白名单而非黑名单:模型目录里冒出一个新的辅助文件类型,比出现一种没人告诉过这份清单的新权重 格式要常见得多。ComfyUI 自带的零字节占位文件 (
put_esrgan_and_other_upscale_models_here)另有一条单独的排除。路径安全:文件夹名必须是单个路径段,
..、a/b、a\b一律拒绝。但磁盘不是唯一权威——节点自己的选项优先级更高。 有些自定义节点不用文件名,而是自己造 一套显示名:
磁盘上的文件 节点接受的选项 groundingdino_swinb_cogcoor.pthGroundingDINO_SwinB (938MB)groundingdino_swint_ogc.pthGroundingDINO_SwinT_OGC (694MB)给这种节点填磁盘名,提交就是
value_not_in_list。所以mainParams填row.options时: 先问object_info这个节点+输入有没有声明具体选项(有就是它,optionsFrom: 'node'); 没有(声明只是IMAGE/STRING这类裸类型)才回落到磁盘(optionsFrom: 'disk')。comboValuesOf()两种声明形态都认:旧写法["a.png","b.png"],新写法["COMBO", {options:[...]}]。只认旧写法会在新版本返回空数组并回落磁盘——正是出错的那条路径。提交前还有一次保守修复:模型值不在声明选项里、且归一化后(忽略大小写/空格/标点/扩展名/括号容量) 能唯一对上一个选项时才替换并记 warn。
swint_ogc.pth能修,swinb_cogcoor.pth对不上就不修—— 猜错会换成另一个模型,比一个看得见的失败更糟。界面上,当前值不在可选项内时会保留并标注「(当前值,不在可选项里)」, 而不是让它消失成空白下拉。
工作队列:8187 的整机队列,排队中的可以上移或取消,另有「清空排队」只取消排队项、不动正在跑的。 这是唯一按管理员显示全量任务的入口——
/api/state仍然只回当前账号自己的任务,账号隔离不变。 面板顶上是倒计时(剩余 7:07),不是"预计剩余 427s"。
预计用时是倒计时
三处(控制台队列标签、工作台队列面板、侧边栏面板)都显示 剩余 m:ss,超过一小时是 h:mm:ss。
它不是"秒数除以 60",两个细节决定它像不像一个倒计时:
- 锚在截止时间,不是递减计数。 服务端的
makespanMs是"从现在起还要多久",所以每次轮询 重算deadline = now + makespan,显示值永远是deadline - now。递减写法丢一次 tick、 或标签页被挂起,就会永久偏移,而且新估算到达时没法重新对齐。 - 本地每秒 tick。 控制台 3 秒一轮询、工作台 5 秒、侧边栏 2 秒;只靠轮询的数字会一跳好几秒, 看着像时钟走慢。本地 1 秒渲染,轮询只负责重新锚定。
秒向上取整(还剩 912ms 显示 0:01,不是 0:00——队列还在跑却显示 0:00 会让人以为卡死);
队列清空就隐藏而不是留个 0:00;超过估算显示 0:00 · 即将完成,不走进负数。数字用等宽
tabular-nums,免得每秒跳动时整行抖动。
原来的「表头模板」面板已删除:表头本来就跟着每个工作流走,再有一份全局模板是第二个真源。
「停止」为什么以前不好用
两个独立原因,都已修:
DSH 重启后网关没有 pid。 ComfyUI 进程比控制台活得久,但
pid只存在于本次会话 亲手拉起的那个运行时。重启之后进程还在(显存还占着),网关手上却没有句柄——旧代码于是 跳过 kill 直接进轮询,等满 15 秒再报「端口仍在响应」,而进程一动没动。实测:15.6 秒、 失败、进程还在。现在会先向操作系统问「谁在监听这个端口」(Windows
netstat -ano,其他平台lsof), 拿到 pid 再杀整棵树。同一个场景变成 394 毫秒成功、端口确实变暗。顺带修正两种边界:端口本来就没有服务时,停止算成功(这正是它要的结果),不再报错; 真的找不到归属进程时,如实说找不到——不再假装是超时。
点了没有任何可见反馈。 服务端的
stopping要等下一次 2 秒轮询才传到面板,所以点击后 最多两秒静默;同时busy是全局面板级的,一张卡点一下,所有按钮一起变灰,看起来像卡死。 现在按钮按下立刻显示「停止中…」,动作结束立刻恢复,失败原因挂在卡片上而不只是页面顶部。
关闭 DSH 时自动关闭实例
默认开启。DSH 退出时,网关托管(托管方式 = 启动 bat 文件)的实例进程会被一并结束,
不会留下占着显存的孤儿进程。
每个实例卡里可以单独关掉「关闭 DSH 时一并停止」——那种情况适合「ComfyUI 要活得比控制台久」的机器, 但代价是显存继续被占,下次启动还要先手动清场。
实现上有两处不写不行:
- 必须是同步的 kill。 原来用
spawn('taskkill', …)发一个异步子进程,问题在于 这个 taskkill 本身是宿主进程的子进程:宿主一开始退出,它跟着死,ComfyUI 那一棵进程树 根本没被杀掉。改成spawnSync,退出路径会等它真的结束(并带 8 秒上限,卡死的进程不能拖住 DSH 退出)。 - 两条路都要走。 插件的
ctx.effect清理只在有序卸载时执行;窗口关闭、进程被结束、 或退出链中前面某个环节抛错时,它不会跑。所以另注册了process.once('exit')兜底, 两处共用一个disposed标志,先到的那个干活,另一个变成空操作(避免对可能被复用的 pid 重复下手)。
control.type = none 的实例永远不碰:那是别人的进程,杀掉它是把别人的 ComfyUI 干掉。
真机验过 10 项(dispose 后 pid 从系统进程表消失、端口不再应答;stopOnExit=false 时进程仍在;
子进程宿主自行退出时进程树一起死),不是只看「有没有调用 dispose」。
智能体工具 comfyui_gateway
status(默认,含每卡显存/速度/是否托管)、dynamic、start/stop/restart、
probe、add/update/remove、prioritize、cancel、free。
配置与数据
<DSH_HOME>/data/dsh-comfyui-gateway/
├─ settings.json 实例、两个端口、远程开关、配对码开关、账号(scrypt + 等级)、
│ 会话、配对密钥、新建工作流的默认表头、参考知识库名、提示词技能名
├─ workflows.json 工作流库(每份带 owner 和**自己的**表头;graph + api + 识别出的输入位)
└─ runs.json 每个账号的运行记录(promptId / 名称 / 状态 / 文件名)
面板改完立即生效并落盘;只有网关端口 / 远程端口 / 远程开关变化需要点「重启网关」。
面板分组按「谁在用这个端口」划:远程端口(8186,浏览器看的那套)的输入框在「远程控制」卡里, 网关端口(8187,脚本调的那套)的在「网关」卡里。两个端口共用一套校验(1–65535、互不相同), 但各存各的——只发自己那一半,另一个字段原样不动。
实例端口就地可改:每张实例卡右上角有「改端口」,点开直接填端口号(8290)或完整地址
(http://192.168.3.253:8290)。只填数字时保留该实例原主机名,只换端口——这是"改了端口"的本意。
runs.json 是「退出再登录还能看到历史和资产」的基础,写入已串行化(并发 rename 会写坏索引)。
旧数据迁移:启动时跑两条幂等迁移——没有等级的账号(管理员→NSFW、其他→SFW)、 没有 owner 的工作流归给第一个账号。不做的话旧库在新规则下会「什么都看不见」。
测试
node test/all.mjs # 23 套件 753 项
node test/live-isolation.mjs # 真机:账号隔离、表头、助手分级、重启后仍能取图
node test/live-boundary.mjs # 真机:成人提示词走 8187 API 直接出图(不审查)
node test/live-heads.mjs # 真机:表头随工作流、无文字输入的图不被污染
node test/live-kb.mjs # 真机:助手真的读到「提示词」库(19 篇)
node test/live.mjs # 真机:网关协议与出图
| 套件 | 覆盖 |
|---|---|
cost / settings / ordering |
代价模型、设置合并、FIFO 与动态 LPT、优先级、并发上限 |
gateway |
真 HTTP 网关:/prompt /queue /history /view /system_stats /object_info /ws |
lifecycle / resilience |
真子进程启停:真 .bat 经 cmd.exe 启动、非 bat 被拒、taskkill 杀树、死实例故障转移、任务消失重排队 |
remote |
控制台协议、登录、工作流、生成、桥接租约、/media 归属 |
isolation |
账号隔离(工作流/任务/历史/媒体)、跨重启持久化、配对码开关、端口开关、迁移 |
assist |
表头随工作流走(继承默认值、显式指定、改后保存、切工作流即换)、无文字输入的工作流不注入表头、助手分级与无模型降级、LoRA 层在模型路径与词库回退路径都不填 |
knowledge |
知识库发现与读取、坏库名如实报错、摘录真的进了给模型的提示、字典模式也报告用了哪个库、分区字典仍按等级过滤 |
boundary |
API 不审查、只有控制台审查:成人提示词走 /prompt 原样执行、pool 不过滤、源码级契约(gateway/pool 不含分级词)、控制台侧仍拦截 |
pages |
三个页面的静态审计:脚本可解析、无裸 window 全局、id 都存在、布局顺序、无渐变/无 emoji;控制台是下拉选择、无显卡面板、描述框与提示词同卡、编辑仅管理员;关键参数在两个页面都是按节点分组的列表(标题含 id 与节点名)、开关只有 true/false、每个文本节点一个框且每行一个表头、全部不参与→不显示框、参数下拉每次渲染都重填、队列是倒计时、助手产出可勾选候选列表 |
console |
控制台接口:桥接仅管理员、参数真的写进图、资产像素尺寸与下载、越权取图 404、设置接口仅管理员 |
layout |
设备适配:UA 判定(iPhone/Android/iPad/平板/桌面/未知)、属性戳在 <html>、视口纠正脚本、HTTP 层首屏布局与 Vary、手机标签栏、两栏拍平 |
render |
侧边栏面板真渲染:分组、端口框、开关、账号等级;远程端口只在远程卡里、网关卡不含远程端口、每张实例卡都有「改端口」并真的驱动一次改端口 → 落盘(只填数字保留主机名);托管方式读得到真实类型,且选择在重复轮询后不被重置 |
node test/screenshot.mjs 用真 Edge 登录后截图到 _shots/——布局问题只有看图才发现。
test/live*.mjs 用临时数据目录和 18187/18186(或 18880/18881)端口,不碰已安装插件的配置。
发布 npm
当前线上版本:0.7.10(dist-tags.latest = 0.7.10,34 个文件)。
别人那台要自动跟进,依赖写 "dsh-comfyui-gateway": "^0.7.10";file: / link: 写法永远不会自动更新。
node scripts/publish.mjs # 预演:身份/补丁/客户端 id/语法/tarball 内容/版本是否被占
node scripts/publish.mjs --apply # 真发布(需 token)
NODE_AUTH_TOKEN=npm_xxx node scripts/publish.mjs --apply
token 要 npmjs.com 的 Granular Access Token(Read and write + Bypass 2FA)。
registry 固定为 registry.npmjs.org——本机配置的是 npmmirror,它不接受发布。