# ComfyUI 任务连接与恢复 工作台将一次生成提交为一个 ComfyUI prompt,并保存任务编号。刷新页面、重新联网或恢复标签页时,查询原任务;不会重新提交 `/prompt`。提交响应丢失时,后端可能已经接收任务,需要先人工核对队列,不能把网络错误当作安全重试的依据。 ## 实时连接与 HTTP 保底 - 提交前启动 WebSocket,使用与 `/prompt` 的 `client_id` 相同的 `clientId`。连接失败不会阻断提交。 - 拿到 `prompt_id` 并保存恢复记录后立即查询 history,补齐订阅前已结束、全部缓存等快任务。 - WebSocket 正常时,生命周期与采样事件更新进度,history 每 30 秒核对一次。`status` 仅触发队列查询,最多每 3 秒一次,不把共享队列总数当成当前任务状态。 - WebSocket 断开时,HTTP 每 3 秒查询;连接恢复、重新联网和页面重新可见时立即核对。HTTP 临时失败也在 3 秒后重试;HTTP 401/403 会停止当前跟踪并保留任务记录,修正凭据后可恢复。 - 完成、出错、中断及 `executing` 的空节点事件立即触发 history 查询。完成事件可能早于 history 写入,先按 500 毫秒间隔短暂重试,再继续保底查询。 - history 确认产出后下载图片;单个 `executed` 节点事件不代表整项任务成功。所有 HTTP 核对串行执行,避免事件密集时堆积请求。 节点进度百分比只代表当前节点。部分节点没有采样事件,长时间没有进度消息不表示任务失败。浏览器后台计时器可能受到节流,重新激活页面会立即核对状态。 只接收与当前 `prompt_id` 匹配的执行事件。ComfyUI 重连时可能发送不带 `prompt_id` 的当前节点消息,这类消息不用于确认任务归属,由 HTTP 对账补齐。 ## 浏览器保存与恢复 未决任务和生成历史保存在当前浏览器的 IndexedDB;事务提交成功后才更新已保存状态。参考图和生成结果会转成可持久保存的数据,避免临时 Blob URL 在刷新后失效。生成快照保存配方、参数和实际提交的工作流,不复制提供方配置中的 API Key 与端点。 存储不可用时暂停生成,避免覆盖未知任务。超时或停止等待不代表取消后端执行;主动点击“停止跟踪(不取消后端)”会清除当前未决记录,后端任务仍可能继续,下一次提交前应核对队列。服务重启或历史被清理时,可能无法找到原任务,工作台不会自动重新提交。 ## 原生 ComfyUI 与可选网关 原生 ComfyUI 使用 `/ws?clientId=...` 发送任务事件。本项目未给 ComfyUI 后端增加远程鉴权协议。 如果访问地址前部署了自行维护的鉴权网关,浏览器无法直接为 WebSocket 设置 Authorization 请求头;可选约定为请求子协议 `comfyui` 与 `comfyui-auth.`,网关验证凭据和 Origin 后仅回显固定子协议 `comfyui`,并向后端剥离凭据。这是网关与网页之间的约定,不是原生 ComfyUI 能力,需自行配置网关支持。HTTP 请求继续使用 Bearer Authorization。 不要将令牌放进 URL、截图或日志。没有配置此约定的网关,应先核对其实际认证方式;HTTP 测试连接成功也不能替代 WebSocket 握手验证。