ComfyUI 生成相册（内部站点）部署与使用说明（2026-09-09）

一、这是什么

DSH 机上新增的内部 Web 站点（类 Civitai 的作品库），每次 GPU 机 ComfyUI 完成图片/视频生成，作品会自动收录，可在网页上按模型分类浏览、在线预览、查看提示词/模型/工作流/参数并下载。

• 访问地址：http://192.168.31.76:8900 （仅内网；需访问口令）
• 站点名：ComfyUI 生成相册（civitai-like）

二、功能

• 自动收录：同步代理每 ~5s 增量拉取 GPU 机 ComfyUI/output/（跳过 minimax_seg_cache、rtx2x、.pt）。2026-09-13 起 config.json 的 indexAll: true = 收录 output 下全部作品（含存量，已全量回填 1725 条）；改回 false 则只收录新生成。
• 元数据：
  • PNG/JPG：解析 ComfyUI 内嵌 prompt/workflow（模型、LoRA、参数、提示词都能拿到）；
  • 视频（mp4/webm/mov）：直接读容器内嵌 tag——ComfyUI SaveVideo/VHS 会把整个 prompt+workflow 写进 mp4 的 prompt/workflow（webm 为大写 PROMPT/WORKFLOW），用 ffprobe -show_format 即可还原主模型/LoRA/提示词/参数；确无 tag 时再用同目录同名 PNG 或 ComfyUI /history 兜底。（2026-09-13 修正：旧逻辑只解析 PNG、视频靠 /history，导致 411 个视频全部"未识别"。）
• 浏览/筛选：按 基础模型家族（MiniMaxH3 / Boogu / Krea / AnimateDiff / SDXL-Turbo / FLUX…自动归类）＋ LoRA 标签 ＋ 类型（图片/视频）＋ 关键字搜索 ＋ 排序。
• 详情页：大图/视频预览（可拖动进度、静音循环）；信息标签（文件、生成时间、基础模型、全部权重文件路径、LoRA、参数、节点链）；提示词标签（各节点文本全文）；工作流标签（API prompt 与 UI workflow 原始 JSON）。
• 下载：原文件下载（Range 支持，大视频可拖动）；缩略图由 ffmpeg 懒生成。
• 访问控制：登录口令（HttpOnly Cookie 30 天）。

三、部署位置与运行

项	值
应用目录	/home/zyw/Downloads/comfyui-gallery/
Web	server.js → 端口 8900
同步代理	sync-agent.js（常驻，拉取+解析+入库）
元数据	data/meta/<id>.json（id=sha1(相对路径)前24位）
媒体镜像	media/（GPU output 增量镜像，当前含存量镜像 ~3.3G）
缩略图缓存	data/thumbs/
配置	config.json：password（口令）、port、syncIntervalMs、indexAll（是否收录全部作品）、sinceEpoch（旧的收录起点，indexAll=true 时不生效）
回填工具	backfill.js（全量重解析+家族重算+继承；--no-pull 只重建元数据）
日志	~/Downloads/gallery-sync.log、gallery-web.log

启停：bash /home/zyw/Downloads/comfyui-gallery/galleryctl.sh {start|stop|restart|status}

改口令：编辑 config.json 的 password → bash galleryctl.sh restart。

四、访问口令（当前）

部署时随机生成：kqXQEI9q（在 config.json 中，可自行修改后重启生效）

五、验证记录（2026-09-09 已测）

• 登录：未登录 401/302、错口令拒绝、对口令发 Cookie ✓
• 收录：真实 ComfyUI PNG（Boogu_ 系列）→ family=Boogu、3 个模型权重、seed/steps/cfg 参数、提示词、workflow ✓
• 视频：mp4 → 收录为 video、缩略图 ffmpeg 生成 ✓、Range 206 拖动 ✓
• 归类：家族规则按主模型优先（boogu→Boogu；dasiwa/minimax/h3→MiniMax H3；krea2→Krea 2；pony→Pony/SDXL；guofeng 等中文系→SD1.5…），主模型缺失的后处理作品按 LoadImage 原图继承家族
• 分类 bug 已修复（家族拼串把文件名当对象取 .file → undefined）
• 代理保活修复：去掉 setInterval.unref()（否则首轮后进程退出）
• 测试产物已全部清理，库内当前为空，等待首个真实新生成

六、局限与后续可做

• 视频元数据依赖 ComfyUI /history → 已证伪：视频自带容器 tag，411/411 可解析（2026-09-13）
• 目前无删除/编辑功能、无收藏、无分页大列表限制 200 条（后续可按需加）
• 家族不再走"文件名关键词"单一路径：主模型 → LoRA → 来源继承 → 文件名 → 节点类型 → 辅助模型，规则表在 meta-lib.js 的 FAMILY_RULES
• 存量入库：node backfill.js（已执行，1725 条，"其他/未识别"归零）
• 2026-09-13 完整修复记录：06-ComfyUI-H3运维记录/2026-09-13-相册模型与LoRA识别修复和全量回填.md
• 相册与下载中心(8899)相互独立。
• 8899 入口已加（2026-09-09）：下载中心桌面与移动列表页标题处新增「🎞 ComfyUI 相册」按钮（新窗口打开，需口令），由 download-server.js 的 .gallery-link 渲染（已同步备份重启生效）。