Files
aigc-home/docs/hel-892
2026-10-31 03:43:29 +08:00
..

当前背景移除图与11图用途摘要:见 Qwen背景移除与11图用途摘要说明.md、background-document-evidence/delivery-summary.md。44新增保存位置+4注释,旧272+6注释仅加用途摘要,11图316+10注释展示;1726后台、5070浏览断言通过。155定稿/实跑0、新增转换0,全量未完成。以下为历史批次。

当前Qwen图像编辑增强图中文说明:见 Qwen图像编辑增强图固定参考中文说明.md、qwen-edit-document-evidence/delivery-summary.md。70新增+3注释,旧202+3注释保持,十图展示;1363后台、916新图+2618旧图浏览断言通过。155定稿/实跑0、新增转换0,全量未完成。以下为历史批次。

当前Qwen提示词增强子图中文说明:见 Qwen图像提示词增强子图固定参考中文说明.md、qwen-document-evidence/。64新增保存位置+2注释,旧138项+1注释不变,九图展示;808后台/834新图+1784旧图浏览断言通过。155定稿/实跑0、新增转换0,全量未完成。以下为历史批次。

当前ControlNet常用样例中文说明:见 ControlNet常用样例固定参考中文说明.md、controlnet-document-evidence/。36新增+102旧保存项+1旧注释,八图展示;505后台、494新增+1290旧图浏览断言。155定稿/实跑0、新增转换0,全量未完成。以下为历史批次。

当前Qwen两ASR图中文说明:见 Qwen两ASR图固定参考中文说明.md、asr-document-evidence/。49新增保存值+1注释,旧53项不变,七图展示;340后台和670新增+620旧图浏览断言通过。155定稿/实跑0、新增转换0,全量未完成。以下为历史批次。

当前两媒体图中文说明:见 视频分离与图像排版固定定义中文说明.md、media-document-evidence/。22新增+31旧定义,5图展示;旧库2更新/153跳过,300后台及336新图+200音频+84H3浏览断言通过。155定稿/实跑0,新增转换0,全量未完成。以下为历史批次。

当前两音频图中文说明:见 两音频图固定定义中文说明与详情接入.md、audio-document-evidence/。新增13保存字段定义,H3旧18项仅修引用;真实旧库3更新/152跳过,262后台测试及200音频+84原H3浏览断言通过。155定稿/实跑0,新增转换0,全量未完成。以下为历史批次。

当前H3中文说明:见 H3固定定义中文说明与详情接入.md、h3-document-evidence/。单图18保存字段独立定义接入现有抽屉(16最终标量/1连线覆盖/1前端控制);真实旧库仅刷新1条,154跳过。224后台测试与84浏览断言通过;155定稿/实跑仍0,转换资格不变,全量未完成。以下为历史批次。

当前无UE核心第二组:见 无UE文生视频核心第二组参考契约.md、h3-chain-reference/、h3-chain-evidence/。十类11实例中10个布局通过、CreateVideo多项保存拒绝;组合18实例15布局通过/3拒绝,整图仍关闭。1456受影响测试通过,145UI仍9参考候选/136关闭,155说明定稿/实跑0,全量未完成。以下为历史批次。

当前无UE文生视频核心第一组:见 无UE文生视频核心第一组参考契约.md、h3-core-reference/、h3-core-evidence/。固定官方core0.33.0和前端1.53.10显式假设,六类中主图五实例保存布局通过、两算式布局拒绝;新增完整候选0,145UI仍9候选/136关闭。来源未知、生产停用、155说明定稿/实跑0,全量未完成。以下为历史批次。

当前H3保存态增量:见 H3保存态固定参考契约.md、h3-reference/、h3-evidence/。固定前端1.53.10、插件a59888df与core0.30.0,新增真实原图完整四实体reference-only候选;全145UI现9候选/136关闭,无真实API保持comparison_unavailable。977受影响测试通过,生产仍停用,155说明定稿/实跑0,全量目标未完成。以下为历史批次。

当前 VideoInfoLoaded@537f3a02 增量:见 VHS_VideoInfoLoaded固定最小契约.md、videoinfo-reference/、videoinfo-evidence/。两个Scail实体五槽/物理边已核验,别名仍来源未证,上游LoadVideo@8e4d7947未覆盖。52新增专项,734受影响回归通过;145UI×22profile仍8参考候选/137关闭,新增完整图0。生产停用、说明定稿/实跑0,全量目标未完成。以下为历史批次。

当前 Set/Get 增量:见 SetGet具名取值固定参考契约.md、setget-reference/、setget-evidence/。固定 KJ 注册/具名查找与两版前端,新增2个显式根图 profile;836个目标实例/39图与旧gap234节点/7图分开计数。两张Scail帧率只给原始链证据,提供方/作用域/上游仍阻断。682受影响回归通过,145UI×20profile仍8参考候选/137关闭,新增完整图0。生产停用、定稿/实跑0,全量目标未完成。以下为历史批次。

当前 VHS 固定版本增量:见 VHS固定版本视频契约.md、vhs-reference/、vhs-evidence/。5个Combine/5个LoadVideo节点重核,7节点66字段契约通过,3旁路拒绝;整图新增0。145UI×18profile仍8完整参考候选/137关闭,622受影响回归通过;生产停用、定稿/实跑0,全量目标未完成。以下为历史批次。

当前AudioCrop/GuHai增量:见 AudioCrop与GuHai分割最小契约.md、crop-split-reference/、crop-split-evidence/。新增音频人声分离图完整reference-only候选;GuHai实际图因PreviewImage出口冲突保持关闭。145UI×16profile现8候选/137关闭,555受影响回归通过。无真实API保持comparison_unavailable,生产停用、定稿/实跑0,全量目标未完成。以下为历史批次。

当前视频音频分离增量:见 视频音频分离固定契约.md、separation-reference/、separation-evidence/。按核心0.3.68/0.3.71及AudioSeparation1.4.0固定来源新增1份完整reference-only候选;145UI×14profile现7候选/138关闭。无真实API保持comparison_unavailable,生产停用、定稿/实跑0,全量目标未完成。以下为历史批次。

当前 ControlNet_aux 增量:见 ControlNet_aux参考构造与完整候选.md、controlnet-reference/、controlnet-evidence/。显式新 profile 可生成 case01 的22节点候选,57项输入及类型/端点相同,完整JSON仍有13处标题差异;生产仍停用,目标版本/选项/实跑未知。以下为历史批次。

当前 UI 转换增量:见 UI序列化与Reroute参考转换.md 与 serialization-evidence/。case01 的16项核心标量、23条输入端点(9条经转接)已由固定官方参考算法对齐;整图仍因第三方契约关闭。参考不改变生产导入资格,全量目标未完成。

当前输出协议增量:见 输出协议固定参考与兼容验证.md、protocol-evidence/ 与后台 protocol_references.json。case02/03及case04/07的同协议预览已补公开固定版本参考与实际说明;目标版本/history仍未验证,配套保持停用,全量目标未完成。

当前范围:源文件156 / 本次目标155 / 用户明确排除case06共1份。落实策略、协调恢复与证据见 155份范围落地与协调恢复.md、scope-evidence/;当前145份UI通用转换未证明,6份采用API配套、139份尚无配套,完整定稿/实跑为0。下面156/146及7份收件数字保留为历史范围。

当前第六批:见 第六批真实API配套导入.md、supplied-api/ 和 sixth-evidence/。7份真实附件已收取,6份采用为停用的配套API,case06缺类型继续关闭;294项API具名现值与源侧审校分开。通用转换146份仍未证明,完整定稿/实跑仍为0,未合并部署。以下批次为历史记录。

当前第四批:见 第四批字段审校与转换前置清单.md、逐字段第四批审校.md、146份UI转换前置清单.md 及 fourth-evidence/。685项新增局部审校已入实际说明;旧542项和140份说明保留。可靠转换仍剩146份,完整定稿/实跑均为0;以下为历史批次。

当前批次:见 第三批语义审校与差分准备.md、逐文件第三批审校.md 和 third-evidence/。140份源语义局部审校已补入实际说明;不要求暂停TTS或交出本地节点包/模型。下文及旧批次材料要求为历史记录,全量目标仍未完成。

最新批次:两处审查返工与 156 份结构/用途局部审校见 整改与局部审校.md,检查证据见 revision-evidence/。下文为首批历史交付记录;“15 项 lint”仅是首批变更文件范围,当前全后台检查口径详见最新报告。offline/documents/ 已更新为本批实际说明,完整定稿仍为 0。

HEL-892 离线施工交付

本次只交付后台、保守转换框架、全量库导入和说明证据草稿;不代表总目标完成。未修改界面和视觉样式,未部署、未写测试机数据库,未停止 TTS,未提交目标机生成任务。

实际结果

源版本 1fc8bdb8bb2a88ccace6f21a507fd77bcf22f532,递归覆盖 156 个源文件,数量与技术方案基线一致。全部在本地隔离库建立条目并默认停用;10 份 API 图为 pending_check,146 份 UI 图为 needs_conversion。重复导入 156 份全部 skipped。

说明草稿 156 份、完成说明 0 份、真实生成验证 0 份。每份草稿保留该文件自身的节点 ID/类型、原始输入和控件值、连线、子图及文件注释,并提取模型引用;API 图可确认的具名参数记录源文件现值。UI 位置数组未具名,未猜测单位、范围或调整效果。用途、步骤和错误建议仍需人工逐项补全;本阶段不是 156 份可指导实际操作的定稿。

架构和接口

沿用 README 描述的 SQLite → 工作流 router → ComfyUI parser/output map → queue worker 模块边界,仓库没有独立架构文档。新增代码均置于后台现有 comfyui 目录,不引入依赖。

  • library.py:来源路径唯一键、SHA1、源提交、批次、原始源文、说明结构、转换问题及三项独立时间戳;旧表约束迁移保留列、索引、引用和自增水位。启动时旧用法/输出回填不改来源库条目。
  • ui2api.py:API 图保留原具名输入;UI 图只接受目标节点定义可核对的具名控件和直接连线。子图、虚拟节点、静音/旁路和位置数组全部失败关闭,返回节点级原因。input_order 不足以证明第三方前端的序列化顺序,不能据此猜字段。尚未实现完整 graphToPrompt 兼容,7 类真实黄金导出差分尚未取得。
  • library_cli.py:显式本地库导入、批次回退、只读 /object_info 快照。成功快照必须含来源、时间及节点定义;失败记录不能作为转换依据。
  • 类型:工作流 kind 增 audio/file/unknown,unknown 用于尚未确认输出的条目,不伪装图片或视频;usage 增语音、转写、音乐、工具、数字人和动作迁移。后端 output_map 支持 image/video/audio/file。音频用途不按文件名自动下结论,须确认。
  • worker:从已映射节点收取 audio/audios/files 文件描述符,经 /view 下载。只接受含 filename 的文件对象;内联文本、SRT 字符串、外部 URL 和自定义响应结构不冒充已支持产物。字幕播放器、音频页面和实际节点的历史输出结构尚待核对。
  • GET /api/workflows 提供来源、阻塞和状态;列表不带庞大的 doc_json/源文。GET /api/workflows/{id} 返回结构化 doc_json 和 import_issues,原始源文仍仅留库。占位图、待核查和已回退条目不可通过启用、确认用途、重新分析或测试入口绕过阻塞。

本地复现

从仓库根运行,Python 3.11,使用锁文件安装既有依赖。数据库路径由操作人明确指定,以下是本地演示路径,不针对任何在线应用。

uv sync --project calliope-backend --frozen --extra dev --python 3.11
uv run --project calliope-backend --frozen python -m calliope.comfyui.library_cli import \
  --root example_ComfyUI_workflows --db .local-evidence/catalogue.db \
  --source-commit 1fc8bdb8bb2a88ccace6f21a507fd77bcf22f532 --output-dir .local-evidence/report

重复同命令应全部 skipped。源变更写入 workflow_revisions 旧行快照;若条目已被用户修改,返回 conflict 并保持整行不动。导入和回退均持有数据库写锁并在单事务内完成。按批次回退:

uv run --project calliope-backend --frozen python -m calliope.comfyui.library_cli rollback \
  --db .local-evidence/catalogue.db --batch-id <import_report中的batch_id> \
  --output-dir .local-evidence/rollback

升级条目恢复旧快照;新建条目保留记录及引用并停用,状态 rolled_back;用户修改冲突不覆盖。再次导入可恢复未被修改的 rolled_back 条目。导入器不会自动安装节点、下载模型、启用工作流或执行任务。现有用户工作流(无 source_repo_path)永不被库导入器覆盖;常规去重也不删除来源库条目。

拿到授权窗口后只读获取快照(失败也写来源/时间/错误,退出码 1):

uv run --project calliope-backend --frozen python -m calliope.comfyui.library_cli snapshot \
  --url http://192.168.200.12:8188 --output .local-evidence/object-info.json

成功快照经总工核对来源后,用 import 的 --snapshot 传入;即使源 SHA 不变,新快照也触发重新分析。pending_test 只表示离线检查未发现问题,绝不写 exec_verified_at。/prompt 不是只读预检,本轮没有针对目标机调用。

审计材料

offline/manifest.json 将全部源路径和 SHA 对应到 offline/documents/*.json;逐文件清单.md 便于人工审查。offline/import_report.json 是首次导入逐文件结果,reimport-report.json 是重启迁移后的重复导入。object-info-attempt.json 记录目标连接拒绝。待补材料.json 列出每份文件受影响节点和待具名控件,模型引用仅代表源文件引用,不代表目标机已确认缺失。

后续工作及操作影响

  1. 请总管安排目标机只读 /object_info 获取窗口,无需发生成任务;当前目标机拒绝连接。不能要求用户为离线入库提前长时间停止 TTS。
  2. 请提供 7 类各一份从实际 ComfyUI 前端导出的原始 API 黄金文件,并补齐复杂子图/虚拟连线/旁路/循环图的可靠转换适配。位置数组不因得到节点定义就自动变成可信具名输入。仍需转换 146 份。
  3. 节点包版本/实际模型位置和获取来源、可用测试图片/参考音频/视频待提供。材料逐文件在待补清单中,不把源引用 102 项模型或 436 种节点写成实际缺项。
  4. 156 份说明仍须具名参数语义、单位、范围、调整效果和中文操作步骤逐份审校。复杂图可用原 API 导出兜底;导入器不会改原始文件。
  5. 界面按既有完整规范另行施工;本轮不采用 HEL-891 新图。音频/字幕展示与入口、实际材料槽组合、键盘和窄屏验收均未施工。
  6. 真实生成待明确授权窗口和资源后逐类先一份;届时需空闲 GPU 和素材,由总管协调用户切换。施工员不停止 TTS、不启动 ComfyUI、不改端口、不部署。时长、显存及付费节点开关须取得真实参数后估计。

本轮材料扫描明确采用更宽的可审计口径:472 种源图 type 字符串(包括注释、虚拟节点、子图 UUID 以及未使用子图),186 条节点控件模型引用(不同路径分别保留,包含旁路/未连接节点;排除编辑器模型下载 URL 和注释)。这不是目标机服务端节点数,也不是实际加载权重数。与前方案的 436 类节点、102 项模型清单不能直接相减或当成新发现缺项;逐份原值均在说明草稿中,待目标快照和实际 API 导出确定执行依赖集合。

自测结果与限制

  • Python 3.11 + 锁定依赖:相关后台回归 107 passed;最后补充“注释/编辑器 URL 不作为模型依赖”的提取检查后,库专项 13 passed。覆盖全量156、重启幂等、来源更新、用户修改保护、回退、外键/索引/自增水位、占位条目启用和测试拦截、不同路径同名条目防误去重、音频/字幕夹具队列下载;原图片/视频、真实状态、预检及批处理回归通过。
  • 后端 wheel/sdist 构建成功;前端生产构建成功;前端既有 4 组脚本测试通过。
  • 新模块和新增测试 Ruff 通过;变更文件对照基线无新增 lint 问题,现有15项问题仍在(基线17项,见 lint-comparison.json),不能称全仓 lint 全绿。
  • 前端 npm run check 未通过:原有 PromptPreviewModal.svelte:125 调用 mutate 缺参数,另有2项警告。本轮没有前端源文件或依赖改动,未扩展范围去修此前问题。详细日志随交付附上。
  • 真实目标机只做一次 GET /object_info,连接拒绝;真实节点/模型核对、7类黄金文件差分、音频编码/SRT格式、真实生成和新界面均未验证。夹具回传的占位字节只证明传输落盘,不证明媒体编码正确。

当前 Primitive/标准子图增量:见 Primitive与标准子图结构参考转换.md、structure-reference/、structure-evidence/。case02具名字符串已折叠;case03/04双向边界及实例复合ID已结构展开。PreviewAny、边界控件/内部序列化、case07坏连线等具体缺口保留,均不构成整图可靠转换或生产执行资格。本轮178项受影响回归通过,全量目标仍未完成。

本批 PreviewAny 与 promoted 取值参考增量见 PreviewAny与子图promoted取值参考.md;216项本次验证及固定来源、13项已解/2项未解边界和完整case02参考候选见 promoted-evidence/,生产资格仍关闭。