Skip to content

Make videos on the computer you already own. FreeVideo runs MiniMax H3 in as little as 8 GB of VRAM and 16 GB of RAM, and adapts its acceleration path to your hardware.

Show complete failure details and export redacted reports (#3)

Bowen Xue9470db46fa62
diff --git a/freevideo_engine/attention.py b/freevideo_engine/attention.py
index 337b40f..20fd7e9 100644
--- a/freevideo_engine/attention.py
+++ b/freevideo_engine/attention.py
@@ -85,6 +85,8 @@ class WindowAttention:
if 'sage2' in (self.global_backend, self.window_backend):
if not importlib.metadata.version('sageattention').startswith('2.'):
raise ImportError('The sage2 route requires SageAttention 2.x; the tested version is 2.2.0.')
+ from .triton_compat import activate
+ activate()
from sageattention import sageattn
self.attention = sageattn
if self.window_varlen and self.window_backend == 'sage2':
diff --git a/freevideo_engine/bootstrap.py b/freevideo_engine/bootstrap.py
index fff033d..b53476a 100644
--- a/freevideo_engine/bootstrap.py
+++ b/freevideo_engine/bootstrap.py
@@ -883,7 +883,8 @@ class Installer:
self.ui.end(key, success=success, detail=(getattr(progress, 'last_notice', None) or 'Log: ' + str(log))
if self.ui.verbose or not success else 'Ready')
if child.returncode:
- raise RuntimeError('%s failed; all files retained. See %s\n%s' % (label, log, log.read_text(errors='replace', encoding='utf-8')[-2500:]))
+ from .failure_details import setup_command_failure
+ raise RuntimeError(setup_command_failure(label, log, child.returncode))
return log
def component_tasks(self, uv):
@@ -1300,7 +1301,7 @@ def main(argv=None):
installer.execute()
installer.state['status'] = 'complete'
except BaseException as error:
- installer.state.update(status='failed', error=repr(error))
+ installer.state.update(status='failed', error='%s: %s' % (type(error).__name__, error))
ui.phase('Setup interrupted' if isinstance(error, KeyboardInterrupt) else 'Setup failed', ui.done, ui.total)
finally:
try:
@@ -1321,6 +1322,7 @@ def main(argv=None):
if args.verbose:
print('Configuration: %s' % (installer.root / 'machine.json'))
return 0
+ ui.event('failure', error=installer.state.get('resource_guard') or installer.state['error'])
print('\nSetup failed: %s\nAll files retained. Logs: %s\nRerun the same setup command to resume.' %
(installer.state.get('resource_guard') or installer.state['error'], installer.run_dir), file=sys.stderr)
return 1
diff --git a/freevideo_engine/comfy_launcher_runtime.py b/freevideo_engine/comfy_launcher_runtime.py
index 2af41f6..1146405 100644
--- a/freevideo_engine/comfy_launcher_runtime.py
+++ b/freevideo_engine/comfy_launcher_runtime.py
@@ -420,7 +420,7 @@ class Controller:
self.setup.runner.cancel()
if not row['busy'] and row['status'] != 'running':
if row['status'] != 'complete' and not (row.get('action') == 'plan' and row.get('plan')):
- raise RuntimeError(row.get('error') or row.get('tail', '')[-2000:] or 'Installation stopped; completed files are retained.')
+ raise RuntimeError(row.get('error') or row.get('tail', '') or 'Installation stopped; completed files are retained.')
if self.cancelled.is_set():
raise RuntimeError('Stopped; files retained')
return row
diff --git a/freevideo_engine/comfy_setup.py b/freevideo_engine/comfy_setup.py
index c1e3460..8f88ef0 100644
--- a/freevideo_engine/comfy_setup.py
+++ b/freevideo_engine/comfy_setup.py
@@ -342,12 +342,20 @@ class Setup:
self.state['tail'] = (self.state.get('tail', '') + value)[-8192:]
elif kind == 'done':
self.state.update({key: value[key] for key in ('status', 'action', 'error', 'wall_seconds', 'log')})
+ if value['status'] == 'failed' and not value.get('error'):
+ # Older/bootstrap failures may not emit a structured error.
+ # Recover the complete retained output once, after exit.
+ try:
+ self.state['error'] = (Path(value['log']) / 'launcher.log').read_text(encoding='utf-8', errors='replace')
+ except OSError:
+ self.state['error'] = value.get('output') or self.state.get('tail', '')
if value['action'] == 'plan' and value['status'] in ('complete', 'failed'):
try:
self.plan = preflight_json(value['output'])
self.state.update(plan=self.plan, plan_id=uuid.uuid4().hex)
except ValueError:
- self.state.update(status='failed', error='Setup inspection failed; see retained details')
+ self.state.update(status='failed', error='Setup inspection failed\n' +
+ (self.state.get('error') or value.get('output', '')))
elif value['action'] == 'setup' and value['status'] == 'complete':
try:
self.bind(value['root'])
diff --git a/freevideo_engine/desktop_runtime.py b/freevideo_engine/desktop_runtime.py
index 3e91804..b1f98b5 100644
--- a/freevideo_engine/desktop_runtime.py
+++ b/freevideo_engine/desktop_runtime.py
@@ -250,6 +250,8 @@ class Runner:
try:
message = json.loads(line)
if message.get('event') == 'freevideo_ui':
+ if message.get('kind') == 'failure' and isinstance(message.get('error'), str):
+ error = message['error']
self.events.put(('progress', message))
elif message.get('event') == 'local_model_progress':
self.events.put(('progress', local_model_ui(message)))
diff --git a/freevideo_engine/diagnostics.py b/freevideo_engine/diagnostics.py
index 604cf07..6cada52 100644
--- a/freevideo_engine/diagnostics.py
+++ b/freevideo_engine/diagnostics.py
@@ -199,7 +199,7 @@ def latest(root, category):
return max(directories, key=lambda p: p.name) if directories else None
-def collect(root, config, run, output, *, complete=False):
+def collect(root, config, run, output, *, complete=False, extra_files=(), notes=''):
root, config = root.expanduser().resolve(), config.expanduser().absolute()
if run is not None and (not run.is_dir() or is_link(run)):
raise ValueError('--run must be a real report directory')
@@ -333,6 +333,14 @@ def collect(root, config, run, output, *, complete=False):
add_path('source/dependencies.json', Path(__file__).with_name('dependencies.json'))
source = {p.name: hashlib.sha256(p.read_bytes()).hexdigest() for p in sorted(Path(__file__).parent.glob('*.py'))}
add('source/hashes.json', json.dumps(source).encode())
+ # Read structured reports first so their secrets are also redacted
+ # when they occur in a launcher's plain-text error or log.
+ if notes:
+ add('launcher/error.txt', str(notes).encode('utf-8'))
+ # These are retained log paths selected by the local launcher, never
+ # archive names or directories supplied by a web request.
+ for index, path in enumerate(extra_files):
+ add_path('launcher/selected-%d.log' % index, Path(path))
disk = shutil.disk_usage(output.parent)
add('current/collector.json', json.dumps({'python': sys.version, 'disk_free_bytes': disk.free,
'selected_run': str(selected) if selected else None}).encode())
diff --git a/freevideo_engine/failure_details.py b/freevideo_engine/failure_details.py
index b017f70..ed38c99 100644
--- a/freevideo_engine/failure_details.py
+++ b/freevideo_engine/failure_details.py
@@ -1,4 +1,4 @@
-"""Bounded, copyable request failures for interactive callers. No GPU imports."""
+"""Readable, copyable failures for interactive callers. No GPU imports."""
import json
from pathlib import Path
import re
@@ -6,11 +6,84 @@ import re
from .diagnostics import Redactor
+STEP_OUTPUT = '\n\nFull step output:\n'
+
+
+def redacted_launcher_error(value, replacements=()):
+ redactor = Redactor(replacements)
+ # Seed structured secrets (including GPU UUIDs) from a doctor's full JSON
+ # before redacting the surrounding exception or retained launcher log.
+ output = str(value).partition(STEP_OUTPUT)[2].lstrip()
+ if output.startswith('{'):
+ try:
+ report, _ = json.JSONDecoder().raw_decode(output)
+ redactor.structured(report)
+ except ValueError:
+ pass
+ return redactor.text(value)
+
+
+def setup_command_failure(label, log, exit_code):
+ """Keep the complete failed step, with required GPU failures before metadata."""
+ log = Path(log)
+ try:
+ output = log.read_text(encoding='utf-8', errors='replace')
+ except OSError as error:
+ output = 'Could not read the retained step log: ' + str(error)
+ lines = ['Failed step: %s (exit code %s)' % (label, exit_code)]
+ if label == 'kernels':
+ try:
+ report = json.loads((log.parent / 'kernel-capabilities.json').read_text(encoding='utf-8'))
+ except (OSError, ValueError):
+ report = {}
+ if isinstance(report, dict):
+ probes = report.get('kernel_probes', [])
+ probes = [row for row in probes if isinstance(row, dict)] if isinstance(probes, list) else []
+ linear_ok = any(row.get('backend') == 'linear' and row.get('status') == 'complete' for row in probes)
+ attention_ok = any(row.get('backend') not in (None, 'linear') and row.get('status') == 'complete' for row in probes)
+ if probes and not linear_ok:
+ lines.append('Required linear kernel did not pass.')
+ if probes and not attention_ok:
+ lines.append('No attention backend passed.')
+ for row in probes:
+ # An optional backend failure is not the reason setup stopped
+ # when another attention backend passed.
+ if row.get('status') == 'complete' or (row.get('backend') != 'linear' and attention_ok):
+ continue
+ reason = row.get('error') or row.get('stderr_tail') or row.get('stdout_tail') or row.get('status', 'unknown')
+ lines.append('%s: %s' % (row.get('backend', 'unknown'), reason))
+ paths = report.get('paths', {})
+ if isinstance(paths, dict):
+ for name, row in paths.items():
+ if isinstance(row, dict) and row.get('exists') is False:
+ lines.append('Required path missing (%s): %s' % (name, row.get('path', 'unknown')))
+ if len(lines) == 1:
+ # The doctor can fail before it writes a JSON report, e.g. during
+ # an import. Keep that exception visible above the full traceback.
+ causes = re.findall(r'^[\w.]+(?:Error|Exception):[^\n]*', output, re.M)
+ if causes:
+ lines.append(causes[-1])
+ lines.append('Retained step log: ' + str(log))
+ return '\n'.join(lines) + STEP_OUTPUT + output
+
+
def launcher_failure(value, *, zh=False):
"""Short guidance for known failures; callers retain the full error separately."""
if not value:
return dict(title='', detail='', action='', kind='')
- text = str(value)[-65536:]
+ text = str(value)
+ summary = text.partition(STEP_OUTPUT)[0]
+ if 'Failed step: kernels (' in summary:
+ detail = summary[summary.index('Failed step: kernels ('):]
+ detail = detail.partition('\nRetained step log:')[0]
+ if zh:
+ detail = detail.replace('Failed step: kernels (exit code ', '失败步骤:GPU 检查(退出码 ').replace(')\n', ')\n', 1)
+ detail = detail.replace('Required linear kernel did not pass.', '必需的 linear 运算检查未通过。')
+ detail = detail.replace('No attention backend passed.', '没有可用的 attention 后端。')
+ detail = detail.replace('Required path missing', '缺少必需目录')
+ return dict(title='GPU 检查未通过' if zh else 'GPU validation failed', detail=detail,
+ action='展开详情或导出脱敏报告,查看完整检查结果。' if zh else
+ 'Open the details or export a redacted report for the complete results.', kind='kernels')
rules = (
(r'Installation RAM monitoring failed|Cannot read process-tree memory', 'memory-monitor',
('Memory usage could not be read', '暂时无法读取进程内存'),
@@ -38,10 +111,12 @@ def launcher_failure(value, *, zh=False):
# Validation messages are already actionable. Show the cause, not a stack
# trace or a guessed hardware diagnosis, and leave long details expandable.
lines = [line.strip() for line in text.splitlines() if line.strip()]
- detail = next((line for line in reversed(lines) if not line.startswith(('File ', 'Traceback', '^'))), '')
+ causes = [line for line in lines if re.match(r'^(?:[\w.]+(?:Error|Exception):|ERROR[: ]|Failed step:|Setup failed:)', line)]
+ detail = causes[-1] if causes else next((line for line in reversed(lines)
+ if not line.startswith(('File ', 'Traceback', '^', 'All files retained.', 'Rerun the same setup command'))), '')
detail = re.sub(r'^(?:ValueError|RuntimeError|OSError):\s*', '', detail)
return dict(title='暂时未能完成' if zh else 'Couldn’t complete this step',
- detail=detail[:400], action='', kind='unknown')
+ detail=detail, action='', kind='unknown')
def _read(path, limit, *, tail=False):
diff --git a/freevideo_engine/fp8_gemm.py b/freevideo_engine/fp8_gemm.py
index 3d2e890..c35dde7 100644
--- a/freevideo_engine/fp8_gemm.py
+++ b/freevideo_engine/fp8_gemm.py
@@ -12,6 +12,9 @@ import torch
import triton
import triton.language as tl
+from .triton_compat import activate
+activate()
+
from .kernel_capabilities import fp8_implementation
ACCUMULATOR_BYTES = 32 * 1024 * 1024
diff --git a/freevideo_engine/fp8_ops.py b/freevideo_engine/fp8_ops.py
index af59251..f13136a 100644
--- a/freevideo_engine/fp8_ops.py
+++ b/freevideo_engine/fp8_ops.py
@@ -5,6 +5,9 @@ import torch
import triton
import triton.language as tl
+from .triton_compat import activate
+activate()
+
from src.models.ops import fp8_linear as official
from .lora_online import apply as apply_lora, quantized as lora_quantized
diff --git a/freevideo_engine/kernel_capabilities.py b/freevideo_engine/kernel_capabilities.py
index e6ce866..0f1f35a 100644
--- a/freevideo_engine/kernel_capabilities.py
+++ b/freevideo_engine/kernel_capabilities.py
@@ -10,7 +10,7 @@ from .paths import data_root
PACKAGES = ('torch', 'triton', 'triton-windows', 'diffusers', 'sageattention', 'flash-attn', 'flash-attn-4')
COMPUTE_FILES = ('attention.py', 'probe.py', 'fp8_gemm.py', 'fp8_ops.py', 'weight_only.py',
- 'kernel_capabilities.py', 'doctor.py', 'fa4_guard.py', 'runtime.py',
+ 'kernel_capabilities.py', 'doctor.py', 'fa4_guard.py', 'triton_compat.py', 'runtime.py',
'head_chunk.py', 'blocks.py', 'packing.py', 'dependencies.json')
diff --git a/freevideo_engine/launcher/Main.qml b/freevideo_engine/launcher/Main.qml
index 230498c..2507870 100644
--- a/freevideo_engine/launcher/Main.qml
+++ b/freevideo_engine/launcher/Main.qml
@@ -212,11 +212,12 @@ ApplicationWindow {
id: failureBody; x: 18; y: 18; width: parent.width - 36; spacing: 10
FText { text: s.failure.title || t("Something went wrong", "出现问题"); color: theme.danger; font.weight: Font.DemiBold; Layout.fillWidth: true }
FText { visible: !!(s.failure.detail || s.failure.action); text: s.failure.detail || s.failure.action; color: theme.text; Layout.fillWidth: true }
- RowLayout {
+ Flow {
Layout.fillWidth: true; spacing: 8
FButton { visible: s.failure.kind === "download"; text: t("Change source", "切换下载源"); onClicked: { settingsTab = "downloads"; settingsOpen = true } }
- FButton { objectName: "copyError"; text: t("Copy details", "复制详情"); onClicked: backend.copy(s.error) }
+ FButton { objectName: "copyError"; text: t("Copy full details", "复制完整详情"); onClicked: backend.copy(s.error) }
FButton { objectName: "showError"; text: errorDetailsOpen ? t("Hide details", "收起详情") : t("Show details", "查看详情"); flat: true; onClicked: errorDetailsOpen = !errorDetailsOpen }
+ FButton { objectName: "exportError"; text: t("Export redacted report", "导出脱敏报告"); enabled: s.report.status !== "running"; onClicked: backend.exportReport() }
}
ScrollView {
visible: errorDetailsOpen; Layout.fillWidth: true; Layout.preferredHeight: Math.min(160, errorText.implicitHeight+10); clip: true
@@ -225,6 +226,15 @@ ApplicationWindow {
}
}
+ FText {
+ visible: s.report.status !== "idle"; Layout.fillWidth: true; font.pixelSize: theme.micro
+ color: s.report.status === "error" ? theme.danger : theme.muted
+ text: s.report.status === "running" ? t("Exporting full logs…", "正在导出完整日志…") :
+ s.report.status === "error" ? t("Export failed: ", "导出失败:") + s.report.error :
+ t("Report saved locally: ", "报告已保存到本机:") + s.report.path +
+ (s.report.collection_errors ? t("\nSome diagnostics were unavailable; see manifest.json in the ZIP.", "\n部分诊断信息未能收集,原因记录在 ZIP 内的 manifest.json。") : "")
+ }
+
ColumnLayout {
objectName: "comfyPage"
visible: s.page === "comfy"; Layout.fillWidth: true; spacing: shortWindow ? 14 : 20
@@ -538,10 +548,15 @@ ApplicationWindow {
onActivated: backend.terminal(s.logs[currentIndex].path)
}
Item { Layout.fillWidth: true }
- FButton { text: t("Copy", "复制"); flat: true; implicitHeight: 28; implicitWidth: 64; leftPadding: 8; rightPadding: 8; font.pixelSize: theme.micro; onClicked: backend.copy(s.log) }
- FButton { text: t("Clear", "清空"); flat: true; implicitHeight: 28; implicitWidth: 64; leftPadding: 8; rightPadding: 8; font.pixelSize: theme.micro; onClicked: backend.clearTerminal() }
FButton { text: "×"; Accessible.name: t("Close terminal", "收起终端"); flat: true; implicitWidth: 30; implicitHeight: 28; leftPadding: 4; rightPadding: 4; onClicked: terminalOpen = false }
}
+ Flow {
+ Layout.fillWidth: true; spacing: 6
+ FButton { text: t("Copy full log", "复制完整日志"); flat: true; implicitHeight: 28; leftPadding: 8; rightPadding: 8; font.pixelSize: theme.micro; onClicked: backend.copyLog() }
+ FButton { text: t("Export report", "导出报告"); flat: true; implicitHeight: 28; leftPadding: 8; rightPadding: 8; font.pixelSize: theme.micro; enabled: s.report.status !== "running"; onClicked: backend.exportReport() }
+ FButton { text: t("Clear", "清空"); flat: true; implicitHeight: 28; implicitWidth: 64; leftPadding: 8; rightPadding: 8; font.pixelSize: theme.micro; onClicked: backend.clearTerminal() }
+ }
+ FText { Layout.fillWidth: true; font.pixelSize: theme.micro; color: theme.muted; text: t("Recent output is shown here. Copy or export to get the full redacted log.", "这里显示最近的输出;复制或导出可获取完整脱敏日志。") }
ScrollView {
id: terminalScroll; Layout.fillWidth: true; Layout.fillHeight: true; clip: true
TextArea {
@@ -687,7 +702,16 @@ ApplicationWindow {
ColumnLayout {
id: settingsError; x: 14; y: 14; width: parent.width - 28; spacing: 8
FText { text: s.failure.title + "\n" + (s.failure.action || s.failure.detail); color: theme.danger; font.pixelSize: theme.micro + 1; Layout.fillWidth: true }
- FButton { text: t("Copy details", "复制详情"); implicitHeight: theme.heightSm; font.pixelSize: theme.micro + 1; onClicked: backend.copy(s.error) }
+ Flow {
+ Layout.fillWidth: true; spacing: 8
+ FButton { text: t("Copy full details", "复制完整详情"); implicitHeight: theme.heightSm; font.pixelSize: theme.micro + 1; onClicked: backend.copy(s.error) }
+ FButton { text: t("Export redacted report", "导出脱敏报告"); implicitHeight: theme.heightSm; font.pixelSize: theme.micro + 1; enabled: s.report.status !== "running"; onClicked: backend.exportReport() }
+ }
+ FText {
+ visible: s.report.status !== "idle"; Layout.fillWidth: true; font.pixelSize: theme.micro; color: theme.muted
+ text: s.report.status === "running" ? t("Exporting full logs…", "正在导出完整日志…") :
+ s.report.status === "error" ? s.report.error : t("Saved: ", "已保存:") + s.report.path
+ }
}
}
}
diff --git a/freevideo_engine/launcher_session.py b/freevideo_engine/launcher_session.py
index 8db8b19..39f226e 100644
--- a/freevideo_engine/launcher_session.py
+++ b/freevideo_engine/launcher_session.py
@@ -2,6 +2,7 @@
import locale
import os
from pathlib import Path
+import threading
import time
from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
@@ -42,6 +43,7 @@ class Session:
self.token = ''
self.error = ''
self.notice = ''
+ self.report = dict(status='idle', path='', error='')
self.compatibility = dict(available=False, level=0, automatic=False)
self.probe = Probe()
self.tail = Tail()
@@ -289,6 +291,39 @@ class Session:
Store(root).acknowledge(installed_identity(root), self.compatibility['notice']['id'])
self.notice = ''
+ def full_log(self):
+ from .diagnostics import read_complete
+ from .failure_details import redacted_launcher_error
+ if self.tail.path is None:
+ return self.tail.text
+ raw, _ = read_complete(self.tail.path)
+ return redacted_launcher_error(raw.decode('utf-8-sig', errors='replace'),
+ [(self.token, '<REDACTED>')] if self.token else [])
+
+ def export_report(self, output):
+ if self.report['status'] == 'running':
+ return
+ from .diagnostics import collect, Redactor
+ root = self.engine_root()
+ # Capture the failure and selected logs before another action changes
+ # the screen. Collection does not need a working Python/GPU runtime.
+ notes = self.snapshot()['error']
+ logs = tuple(path for _, path in self.controller.terminal_sources())
+ replacements = [(self.token, '<REDACTED>')] if self.token else []
+ self.report = dict(status='running', path=str(output), error='')
+
+ def work():
+ try:
+ result = collect(root, root / 'machine.json', None, Path(output),
+ complete=True, extra_files=logs, notes=notes)
+ self.report = dict(status='complete', path=str(output), error='',
+ collection_errors=len(result['errors']))
+ except Exception as error:
+ self.report = dict(status='error', path=str(output),
+ error=Redactor(replacements).text(str(error)))
+
+ threading.Thread(target=work, name='freevideo-export-report', daemon=True).start()
+
def dismiss_update(self):
self.update_snoozed = True
if self.updater and self.updater.state['status'] == 'downloading':
@@ -391,8 +426,7 @@ class Session:
self.tail.read(final=not self.controller.terminal_running(selected))
def snapshot(self):
- from .diagnostics import Redactor
- from .failure_details import launcher_failure
+ from .failure_details import launcher_failure, redacted_launcher_error
from .launcher_copy import display, progress_view, source_name
zh = self.language.startswith('zh')
row = self.controller.state
@@ -403,7 +437,8 @@ class Session:
shortcut = row.get('shortcut') or {}
if shortcut.get('status') == 'failed':
errors.append(shortcut.get('error', ''))
- error = Redactor([(self.token, '<REDACTED>')] if self.token else []).text('\n'.join(str(e) for e in errors if e))
+ error = redacted_launcher_error('\n'.join(str(e) for e in errors if e),
+ [(self.token, '<REDACTED>')] if self.token else [])
by_id = {r['id']: r for r in self.model_groups}
ready = bool(row.get('selection', {}).get('ready') or row.get('status') == 'open')
models = []
@@ -458,6 +493,7 @@ class Session:
page=self.page, status=row.get('status', 'idle'), busy=self.controller.busy or self.importer.busy,
offline=dict(progress_view(self.importer.state, zh), runtime=bool(self.form['offline_runtime']), models=len(self.form['offline_models'])),
selected=bool(self.selected), error=error, notice=self.notice, compatibility=self.compatibility,
+ report=dict(self.report),
models=models, overall=overall, progress=progress, detail=clean(progress.get('detail', '')),
progress_text=progress_text(progress, self.language.startswith('zh')),
elapsed=duration(time.monotonic()-self.started) if self.started else '', summary=' · '.join(estimate),
diff --git a/freevideo_engine/modern_launcher.py b/freevideo_engine/modern_launcher.py
index 84b47f7..26a80a2 100644
--- a/freevideo_engine/modern_launcher.py
+++ b/freevideo_engine/modern_launcher.py
@@ -143,6 +143,22 @@ def create_ui(session, *, show=True):
def copy(self, value):
app.clipboard().setText(value)
+ @Slot()
+ def copyLog(self):
+ self.invoke(lambda: app.clipboard().setText(session.full_log()))
+
+ @Slot()
+ def exportReport(self):
+ if session.report['status'] == 'running':
+ return
+ path, _ = QFileDialog.getSaveFileName(None, session.t('Export redacted report', '导出脱敏报告'),
+ 'freevideo-diagnostics-' + time.strftime('%Y%m%dT%H%M%SZ', time.gmtime()) + '.zip',
+ 'ZIP (*.zip)')
+ if path:
+ if not path.lower().endswith('.zip'):
+ path += '.zip'
+ self.invoke(session.export_report, path)
+
@Slot(str)
def link(self, value):
from .windows_ux import open_browser
diff --git a/freevideo_engine/triton_compat.py b/freevideo_engine/triton_compat.py
new file mode 100644
index 0000000..6b82ec2
--- /dev/null
+++ b/freevideo_engine/triton_compat.py
@@ -0,0 +1,32 @@
+"""Windows Unicode environment compatibility at FreeVideo's Triton entry points."""
+from functools import wraps
+import os
+
+
+def activate():
+ """Recover Unicode knob values when the native getenv binding cannot decode.
+
+ triton-windows 3.7.1.post27 exposes narrow CRT getenv strings through a
+ UTF-8 pybind return value. A Chinese TRITON_CACHE_DIR on a GBK Windows
+ installation fails before a kernel can compile. Python's Windows
+ environment mapping already preserves the original Unicode value.
+ """
+ if os.name != 'nt':
+ return
+ from triton import knobs
+ native_getenv = knobs.getenv
+ if getattr(native_getenv, '_freevideo_unicode_env', False):
+ return
+
+ @wraps(native_getenv)
+ def unicode_getenv(key, *args, **kwargs):
+ try:
+ return native_getenv(key, *args, **kwargs)
+ except UnicodeDecodeError:
+ value = os.environ.get(key)
+ if value is None or value.isascii():
+ raise
+ return value
+
+ unicode_getenv._freevideo_unicode_env = True
+ knobs.getenv = unicode_getenv
diff --git a/freevideo_engine/weight_only.py b/freevideo_engine/weight_only.py
index 334de26..d471709 100644
--- a/freevideo_engine/weight_only.py
+++ b/freevideo_engine/weight_only.py
@@ -8,6 +8,9 @@ import torch
import triton
import triton.language as tl
+from .triton_compat import activate
+activate()
+
@triton.jit
def _decode_e4m3(bits):
diff --git a/web/error_panel.js b/web/error_panel.js
index 36ce7d4..e13abcb 100644
--- a/web/error_panel.js
+++ b/web/error_panel.js
@@ -1,8 +1,137 @@
// Shared by the Studio and graph view. Text only; never render exception HTML.
+const reports = new WeakSet();
+const captured = new WeakMap();
+const scalar = value => typeof value === 'string' ? value : typeof value === 'number' ? String(value) : '';
+const list = value => Array.isArray(value) ? value : [];
+const record = value => value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+
export function errorText(detail) {
- const cause = detail?.exception_message || detail?.message || 'FreeVideo generation failed.';
- const trace = Array.isArray(detail?.traceback) ? detail.traceback.join('') : '';
- return String(cause + (trace ? '\n\n' + trace : '')).slice(0, 65536);
+ if (typeof detail === 'string') return detail;
+ if (reports.has(detail)) return detail.details;
+ const response = record(detail?.response);
+ const error = response.error ?? detail?.error;
+ const rows = [scalar(error?.message) || scalar(error) || scalar(response.message)
+ || scalar(detail?.exception_message) || scalar(detail?.message) || 'FreeVideo generation failed.'];
+ if (scalar(detail?.node_id)) rows.unshift(`Node ${scalar(detail.node_id)} (${scalar(detail.node_type) || 'unknown'}):`);
+ if (scalar(detail?.exception_type)) rows.unshift(detail.exception_type);
+ if (scalar(error?.details)) rows.push(error.details);
+ for (const [id, node] of Object.entries(record(response.node_errors ?? detail?.node_errors))) {
+ rows.push(`Node ${id} (${scalar(node?.class_type) || 'unknown'}):`);
+ for (const reason of list(node?.errors))
+ rows.push(' - ' + [scalar(reason?.message), scalar(reason?.details)].filter(Boolean).join(': '));
+ }
+ const trace = list(detail?.traceback).map(scalar).join('') || scalar(detail?.traceback) || scalar(detail?.stack);
+ if (trace) rows.push('', trace);
+ return rows.join('\n');
+}
+
+function reportRedactor(detail, context) {
+ // Input values are used only to remove echoed private content. They are
+ // never included in the report, nor are workflow/inputs/extra_info objects.
+ const hidden = new Set(), seen = new WeakSet();
+ function remember(value) {
+ if (typeof value === 'string' && value) {
+ hidden.add(value);
+ hidden.add(JSON.stringify(value).slice(1, -1));
+ hidden.add(value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")
+ .replace(/\r/g, '\\r').replace(/\n/g, '\\n').replace(/\t/g, '\\t'));
+ for (const line of value.split(/\r?\n/)) if (line.trim()) hidden.add(line.trim());
+ if (/^\s*[\[{]/.test(value)) {
+ try { remember(JSON.parse(value)); } catch { /* ordinary prompt text */ }
+ }
+ } else if (value && typeof value === 'object' && !seen.has(value)) {
+ seen.add(value);
+ for (const item of Object.values(value)) remember(item);
+ }
+ }
+ remember(detail?.current_inputs);
+ for (const row of Object.values(record(context.snapshot?.output)))
+ for (const input of Object.values(record(row?.inputs))) {
+ // API links contain node IDs, not private input text.
+ if (Array.isArray(input) && input.length === 2 && Number.isInteger(input[1])) continue;
+ remember(input);
+ }
+ for (const node of list(context.graph?._nodes))
+ for (const widget of list(node.widgets)) remember(widget.value);
+ for (const widget of list(context.node?.widgets)) remember(widget.value);
+ for (const node of Object.values(record(detail?.response?.node_errors ?? detail?.node_errors)))
+ for (const reason of list(node?.errors)) remember(reason?.extra_info?.received_value);
+ const values = [...hidden].sort((a, b) => b.length - a.length);
+ return value => {
+ let text = scalar(value);
+ for (const secret of values) {
+ // Short widget values (e.g. "a") must not erase every occurrence
+ // inside exception names. Still remove standalone/quoted values.
+ if (secret.length >= 4) text = text.split(secret).join('<INPUT REMOVED>');
+ else {
+ const escaped = secret.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+ text = text.replace(new RegExp(`(^|[^\\p{L}\\p{N}_])${escaped}(?=$|[^\\p{L}\\p{N}_])`, 'gu'), '$1<INPUT REMOVED>');
+ }
+ }
+ text = text.replace(/\b(?:https?|wss?|ftp|file):\/\/[^\s<>"']+/gi, '<URL REMOVED>')
+ .replace(/\b(?:Bearer|Basic)\s+[A-Za-z0-9._~+/=-]+/gi, '<CREDENTIAL REMOVED>')
+ .replace(/\b(?:hf_|sk-|gh[pousr]_|github_pat_)[A-Za-z0-9_-]{8,}\b/g, '<CREDENTIAL REMOVED>')
+ .replace(/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g, '<CREDENTIAL REMOVED>')
+ .replace(/(["']?(?:[\w-]*(?:token|password|secret|credential|api[_-]?key)|authorization|cookie|username|hostname|computer_name)["']?\s*[:=]\s*)(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|[^\s,;}]+)/gi, '$1<REDACTED>')
+ .replace(/(["']?(?:prompt|negative_prompt|prompt_text|text)["']?\s*[:=]\s*)(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*')/gi, '$1<INPUT REMOVED>')
+ .replace(/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi, '<EMAIL REMOVED>')
+ .replace(/\b(?:\d{1,3}\.){3}\d{1,3}\b/g, '<ADDRESS REMOVED>');
+ // Keep traceback source basenames and line numbers, never drive names,
+ // home directories or private media filenames. Spaces in paths count.
+ text = text.replace(/(^|[^A-Za-z0-9_:/<>])((?:[A-Za-z]:[\\/]|\\\\[^\\/\s]+[\\/]|\/(?![\/\s]))[^\r\n"'<>;,\)\]]+)/gm, (_, prefix, path) => {
+ const source = path.replace(/\\/g, '/').match(/\/([A-Za-z0-9_.-]+\.(?:py|js|ts|mjs))(?=[:\s]|$)/);
+ return prefix + (source ? '<PATH>/' + source[1] + path.slice(path.indexOf(source[1]) + source[1].length) : '<PATH REMOVED>');
+ });
+ text = text.replace(/data:[^\s"'<>]+/gi, '<DATA REMOVED>');
+ return text;
+ };
+}
+
+export function createErrorReport(detail, context = {}) {
+ if (reports.has(detail)) return detail;
+ if (captured.has(detail)) return captured.get(detail);
+ const clean = reportRedactor(detail, context);
+ const nodeIdentifier = value => /^\d+(?::\d+)*$/.test(scalar(value)) ? scalar(value) : clean(scalar(value));
+ const response = record(detail?.response);
+ const sourceNodes = record(response.node_errors ?? detail?.node_errors);
+ const nodes = Object.entries(sourceNodes).map(([id, node]) => ({
+ id: nodeIdentifier(id), type: clean(scalar(node?.class_type)),
+ errors: list(node?.errors).map(reason => ({
+ type: clean(scalar(reason?.type)), message: clean(scalar(reason?.message)),
+ details: clean(scalar(reason?.details)), input: clean(scalar(reason?.extra_info?.input_name)),
+ })),
+ }));
+ const stage = context.stage || (Object.keys(response).length ? 'submission' : 'execution');
+ const nodeId = scalar(detail?.node_id) || (stage === 'submission' ? scalar(context.node?.id) : '');
+ const graphNode = context.graph?.getNodeById?.(nodeId);
+ const nodeType = scalar(detail?.node_type) || scalar(graphNode?.comfyClass || graphNode?.type);
+ if (!nodes.length && nodeId) nodes.push({id: nodeIdentifier(nodeId), type: clean(nodeType), errors: []});
+ const inputs = context.snapshot?.output?.[context.node?.id]?.inputs
+ || (nodeType === 'FreeVideoGenerate' ? detail?.current_inputs : null);
+ const settings = {};
+ for (const key of ['width', 'height', 'seconds', 'seed', 'two_pass']) {
+ const value = Array.isArray(inputs?.[key]) && inputs[key].length === 1 ? inputs[key][0] : inputs?.[key];
+ if (typeof value === 'boolean' || typeof value === 'number' && Number.isFinite(value)) settings[key] = value;
+ }
+ const progress = {};
+ for (const key of ['phase', 'stage']) if (typeof context.progress?.[key] === 'string') progress[key] = clean(context.progress[key]);
+ for (const key of ['done', 'total']) if (Number.isFinite(context.progress?.[key])) progress[key] = context.progress[key];
+ const report = {
+ schema: 'freevideo.error-report', schema_version: 1, created_at: new Date().toISOString(),
+ stage, message: clean(scalar(response.error?.message) || scalar(response.error) || scalar(response.message)
+ || scalar(detail?.exception_message) || scalar(detail?.message) || scalar(detail) || 'FreeVideo generation failed.'),
+ error_details: clean(scalar(response.error?.details)),
+ exception_type: clean(scalar(detail?.exception_type) || scalar(response.error?.type) || scalar(detail?.name)),
+ http_status: Number.isInteger(detail?.status) ? detail.status : null,
+ nodes, settings, progress, details: clean(errorText(detail)),
+ privacy: {local_only: true, workflow_and_inputs_included: false,
+ media_and_logs_included: false,
+ redacted: ['known input text', 'absolute paths', 'URLs', 'email addresses', 'common credentials'],
+ note: 'Review the report before sharing. It contains the reported error, not a full installation diagnostic bundle.'},
+ };
+ reports.add(report);
+ if (detail && typeof detail === 'object') captured.set(detail, report);
+ return report;
}
// Match explicit failure signatures, not a guessed GPU/RAM capacity. Keep the
@@ -10,6 +139,14 @@ export function errorText(detail) {
export function failureAdvice(value, t) {
const text = String(value).slice(0, 65536);
const row = (kind, title, summary, action) => ({kind, title: t(...title), summary: t(...summary), action: t(...action)});
+ if (/Prompt outputs failed validation|Required input is missing|Value not in list|Return type mismatch|Failed to validate prompt|value (?:\S+ )?(?:smaller|bigger) than/i.test(text))
+ return row('validation', ['Check the workflow inputs', '请检查工作流输入'],
+ ['ComfyUI rejected the workflow before generation. The affected nodes and reasons are listed below.', 'ComfyUI 在生成开始前拒绝了工作流,相关节点和具体原因列在下方。'],
+ ['Check the named inputs, connections and model choices. Copy the details or export the error report when asking for help.', '检查下方指出的输入、节点连接和模型选项;反馈时可复制详情或导出错误报告。']);
+ if (/FreeVideo resource planning could not admit/i.test(text))
+ return row('resources', ['The request exceeds available memory', '当前任务的可用内存不足'],
+ ['Resource planning could not fit this request within the available GPU or system memory.', '资源规划发现当前任务超出了可用显存或系统内存预算。'],
+ ['Close other memory-heavy applications, or select a lower resolution or shorter duration and retry. The details show which memory budget was insufficient.', '关闭其他占用内存的程序,或自行调低分辨率、缩短时长后重试。下方详情会指出不足的内存类型和差额。']);
if (/commit headroom exhausted|paging file is too small|WinError 1455/i.test(text))
return row('commit', ['Windows memory allocation limit reached', 'Windows 内存提交额度不足'],
['Windows cannot back another memory allocation, even if physical RAM is still available.', 'Windows 已没有足够的提交额度;这与物理 RAM 是否还有空闲是两回事。'],
@@ -26,7 +163,7 @@ export function failureAdvice(value, t) {
return row('disk', ['Disk space is insufficient', '磁盘空间不足'],
['FreeVideo could not write a required file.', 'FreeVideo 无法写入所需文件。'],
['Free space on the installation/output drive and retry. Keep model downloads and retained outputs if you want to resume or inspect them.', '清理安装目录或输出目录所在磁盘的空间后重试;保留模型下载和输出文件,便于续传或排查。']);
- if (/Model download paused|unexpected-transfer-size|ConnectionError|ConnectTimeout|ReadTimeout/i.test(text))
+ if (/Model download paused|unexpected-transfer-size|ConnectionError|ConnectTimeout|ReadTimeout|Every download source failed|All Git sources failed|All package sources failed|curl-28/i.test(text))
return row('download', ['Download needs attention', '下载未完成'],
['A transfer failed or its received data did not match the expected file.', '传输中断,或收到的数据与预期文件不一致。'],
['Check your connection or select another download source in Settings, then retry. Existing download fragments are retained.', '检查网络,或在设置中切换下载源后重试。已有下载片段会保留。']);
@@ -40,15 +177,16 @@ export function failureAdvice(value, t) {
}
let activeDialog = null;
-function showFailureDialog(value, t) {
+function showFailureDialog(report, t) {
// Both graph and Studio receive execution_error. Show one modal for that
// event, above the Studio modal if it is open, with keyboard dismissal.
- if (activeDialog?.open && activeDialog.freevideoError === value) return;
+ const identity = report.stage + '\n' + report.details;
+ if (activeDialog?.open && activeDialog.freevideoError === identity) return;
activeDialog?.close();
const dialog = document.createElement('dialog'); dialog.className = 'fv-failure-dialog';
- dialog.freevideoError = value;
+ dialog.freevideoError = identity;
dialog.setAttribute('aria-label', t('FreeVideo error', 'FreeVideo 错误'));
- const panel = createErrorPanel(t); panel.show(value, false);
+ const panel = createErrorPanel(t); panel.show(report, false);
const close = document.createElement('button'); close.type = 'button';
close.textContent = t('Got it', '知道了'); close.autofocus = true;
close.onclick = () => dialog.close();
@@ -63,10 +201,10 @@ export function createErrorPanel(t) {
if (!document.getElementById('freevideo-error-style')) {
const style = document.createElement('style'); style.id = 'freevideo-error-style';
style.textContent = `.fv-failure{border:1px solid var(--fv-danger,#dc7c7c);border-radius:var(--fv-r-md,12px);padding:12px 14px;margin:10px 0;text-align:left;min-width:0}
-.fv-failure[hidden]{display:none}.fv-failure-head{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:8px}
+.fv-failure[hidden]{display:none}.fv-failure-head{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:12px;margin-bottom:8px}.fv-failure-actions{display:flex;flex-wrap:wrap;gap:8px}
.fv-failure textarea{box-sizing:border-box;width:100%;height:180px;min-height:100px;resize:vertical;border:1px solid var(--fv-border,#45454a);border-radius:var(--fv-r-sm,8px);background:var(--fv-bg,#202126);color:var(--fv-ink,#eee);font:12px/1.5 monospace;padding:9px;white-space:pre-wrap}
.fv-failure button,.fv-failure-dialog>button{min-height:var(--fv-h-sm,32px);border:1px solid var(--fv-border,#45454a);border-radius:var(--fv-r-sm,8px);background:var(--fv-raised,#303138);color:var(--fv-ink,#eee);padding:5px 12px;font:inherit;font-weight:var(--fv-medium,500);cursor:pointer}
-.fv-failure p{font-size:14px;line-height:1.6;margin:8px 0}.fv-failure summary{cursor:pointer;margin-top:12px}
+.fv-failure p{font-size:14px;line-height:1.6;margin:8px 0}.fv-failure summary{cursor:pointer;margin-top:12px}.fv-failure .fv-failure-cause{white-space:pre-wrap;overflow-wrap:anywhere;max-height:240px;overflow:auto}.fv-failure .fv-failure-privacy{font-size:12px;color:var(--fv-muted,#bbb)}
.fv-failure-dialog{box-sizing:border-box;width:min(560px,94vw);max-height:88vh;overflow:auto;padding:22px 24px;border:1px solid var(--fv-border,#45454a);border-radius:var(--fv-r-lg,16px);background:var(--fv-bg,#202126);color:var(--fv-ink,#eee);box-shadow:0 24px 80px #0008}
.fv-failure-dialog::backdrop{background:#070a0db8;backdrop-filter:blur(6px)}.fv-failure-dialog>.fv-failure{border:0;margin:0 0 16px;padding:0}.fv-failure-dialog>button{display:block;margin-left:auto;background:var(--fv-accent,#6db8fa);border-color:var(--fv-accent,#6db8fa);color:var(--fv-bg,#111720);font-weight:var(--fv-semibold,600)}`;
document.head.append(style);
@@ -75,7 +213,16 @@ export function createErrorPanel(t) {
const head = document.createElement('div'); head.className = 'fv-failure-head';
const title = document.createElement('strong'); title.textContent = t('Generation failed', '生成失败');
const copy = document.createElement('button'); copy.type = 'button'; copy.textContent = t('Copy error', '复制错误');
+ const download = document.createElement('button'); download.type = 'button'; download.textContent = t('Export redacted report', '导出脱敏报告');
+ const actions = document.createElement('div'); actions.className = 'fv-failure-actions';
+ actions.append(copy, download);
const explanation = document.createElement('p'), action = document.createElement('p');
+ const location = document.createElement('p'), cause = document.createElement('p'); cause.className = 'fv-failure-cause';
+ const privacy = document.createElement('p'); privacy.className = 'fv-failure-privacy';
+ privacy.textContent = t('Known input text, paths and common credentials are removed. Export saves a local JSON file; review it before sharing.',
+ '已去除已知输入文本、路径和常见凭据。导出会保存为本地 JSON 文件,分享前可查看内容。');
+ const downloadStatus = document.createElement('p'); downloadStatus.setAttribute('role', 'status');
+ let currentReport = null;
const disclosure = document.createElement('details'), summary = document.createElement('summary');
summary.textContent = t('Technical details', '技术详情');
const details = document.createElement('textarea'); details.readOnly = true;
@@ -90,14 +237,52 @@ export function createErrorPanel(t) {
}
copy.textContent = copied ? t('Copied', '已复制') : t('Press Ctrl+C', '请按 Ctrl+C');
};
+ download.onclick = () => {
+ if (!currentReport) return;
+ let url, link;
+ try {
+ const payload = JSON.stringify(currentReport, null, 2) + '\n';
+ url = URL.createObjectURL(new Blob([payload], {type: 'application/json;charset=utf-8'}));
+ link = document.createElement('a'); link.href = url;
+ link.download = 'freevideo-error-' + currentReport.created_at.replace(/[:.]/g, '-') + '.json';
+ document.body.append(link); link.click();
+ downloadStatus.textContent = t('Report download started.', '已开始下载错误报告。');
+ } catch {
+ // Keep the same redacted JSON available even if downloads are
+ // disabled by the browser or the page is served over plain HTTP.
+ disclosure.open = true; details.value = JSON.stringify(currentReport, null, 2);
+ details.focus(); details.select();
+ downloadStatus.textContent = t('Download unavailable. Use Copy error to copy the report below.', '浏览器未能下载,请点击“复制错误”复制下方完整报告。');
+ } finally {
+ link?.remove();
+ if (url) setTimeout(() => URL.revokeObjectURL(url), 30000);
+ }
+ };
disclosure.append(summary, details);
- head.append(title, copy); element.append(head, explanation, action, disclosure);
- return {element, show(value, popup = true) {
- value = String(value).slice(0, 65536);
- const advice = failureAdvice(value, t);
+ head.append(title, actions); element.append(head, explanation, location, cause, action, disclosure, privacy, downloadStatus);
+ return {element, show(value, popup = true, context = {}) {
+ const report = createErrorReport(value, context); currentReport = report;
+ const advice = failureAdvice(report.details, t);
+ if (report.stage === 'submission' && advice.kind === 'unknown') {
+ advice.title = t('The task could not be submitted', '任务提交失败');
+ advice.summary = t('The task submission returned an error. Its details are shown below.', '提交任务时返回了错误,具体原因显示在下方。');
+ }
+ if (report.stage === 'queue' && advice.kind === 'unknown') {
+ advice.title = t('The queue operation did not complete', '队列操作未完成');
+ advice.summary = t('Check that ComfyUI is still running and connected, then retry.', '请确认 ComfyUI 仍在运行、连接正常后重试。');
+ }
title.textContent = advice.title; explanation.textContent = advice.summary; action.textContent = advice.action;
- details.value = value; disclosure.open = false; element.hidden = false;
+ const stage = report.stage === 'submission' ? t('Submitting task', '提交任务')
+ : report.stage === 'queue' ? t('Queue operation', '队列操作') : t('Executing workflow', '执行工作流');
+ location.textContent = stage + (report.http_status ? ` · HTTP ${report.http_status}` : '')
+ + report.nodes.map(node => ` · ${node.type || t('Node', '节点')} #${node.id}`).join('');
+ const reasons = report.nodes.flatMap(node => node.errors.map(error =>
+ `${node.type || t('Node', '节点')} #${node.id}${error.input ? ' · ' + error.input : ''}: ${error.message}${error.details ? ': ' + error.details : ''}`));
+ cause.textContent = reasons.length ? reasons.join('\n') : [report.message, report.error_details].filter(Boolean).join('\n');
+ details.value = report.details; disclosure.open = false; element.hidden = false;
+ downloadStatus.textContent = '';
copy.textContent = t('Copy error', '复制错误');
- if (popup) showFailureDialog(value, t);
- }, clear() { details.value = ''; element.hidden = true; }};
+ if (popup) showFailureDialog(report, t);
+ return report;
+ }, clear() { currentReport = null; details.value = ''; element.hidden = true; }};
}
diff --git a/web/freevideo.js b/web/freevideo.js
index 6d2253d..af5e22b 100644
--- a/web/freevideo.js
+++ b/web/freevideo.js
@@ -198,11 +198,13 @@ function resultPanel(node) {
node.onRemoved = function (...args) { progress.dispose(); return removed?.apply(this, args); };
const failure = createErrorPanel(text);
node.freevideoShowFailure = detail => {
+ const context = {stage: 'execution', node, graph: app.graph, progress: node.freevideoProgress};
node.freevideoStopProgress();
- node.freevideoFailure = errorText(detail); failure.show(node.freevideoFailure);
+ node.freevideoFailureReport = failure.show(detail, true, context);
+ node.freevideoFailure = errorText(node.freevideoFailureReport);
panel.append(failure.element); node.setSize([node.size[0], Math.max(node.size[1], node.computeSize()[1])]);
};
- node.freevideoClearFailure = () => { node.freevideoFailure = ''; failure.clear(); };
+ node.freevideoClearFailure = () => { node.freevideoFailure = ''; node.freevideoFailureReport = null; failure.clear(); };
const warning = el('div', '', 'fv-note');
const hasLoRA = () => node.inputs?.some(input => input.name === 'loras' && input.link != null);
const warn = () => {
@@ -323,7 +325,22 @@ api.addEventListener('freevideo_prewarm', event => {
});
api.addEventListener('execution_error', event => {
- app.graph?.getNodeById(event.detail?.node_id)?.freevideoShowFailure?.(event.detail);
+ // An upstream loader/media node can stop FreeVideo before its own node is
+ // entered. Retain that error even while the creative workspace is closed.
+ for (const node of app.graph?._nodes || []) {
+ if (!node.freevideoShowFailure) continue;
+ const pending = [node], seen = new Set();
+ while (pending.length) {
+ const current = pending.pop();
+ if (!current || seen.has(String(current.id))) continue;
+ seen.add(String(current.id));
+ for (const input of current.inputs || []) {
+ const link = input.link != null ? node.graph?.links[input.link] : null;
+ if (link) pending.push(node.graph?.getNodeById(link.origin_id));
+ }
+ }
+ if (seen.has(String(event.detail?.node_id))) node.freevideoShowFailure(event.detail);
+ }
});
api.addEventListener('executing', event => {
const id = typeof event.detail === 'object' ? event.detail?.node : event.detail;
diff --git a/web/studio.js b/web/studio.js
index dc77c31..6f370a7 100644
--- a/web/studio.js
+++ b/web/studio.js
@@ -1,4 +1,4 @@
-import { createErrorPanel, errorText } from './error_panel.js';
+import { createErrorPanel, errorText, createErrorReport } from './error_panel.js';
import { app } from '../../scripts/app.js';
import { api } from '../../scripts/api.js';
import { openSetup } from './setup.js';
@@ -257,7 +257,7 @@ export function openStudio(node) {
const prewarm = el('div', node.freevideoPrewarm || '', 'fv-prewarm');
output.append(status, stats, budget, links, prewarm);
const failure = createErrorPanel(t); output.append(failure.element);
- if (node.freevideoFailure) failure.show(node.freevideoFailure, false);
+ if (node.freevideoFailure) failure.show(node.freevideoFailureReport || node.freevideoFailure, false);
let result = node.freevideoLastResult || app.nodeOutputs?.[node.id]?.freevideo_summary?.[0];
function showResult(r) {
if (!r?.video || disposed) return; result = r;
@@ -279,6 +279,7 @@ export function openStudio(node) {
let busy = false, queued = false, cancelling = false, activePrompt = null, capturing = false;
let runMode = 'single', queueState;
if (!studioQueues.has(node)) studioQueues.set(node, createStudioQueue(api, node.id, {
+ formatError: (error, snapshot) => createErrorReport(error, {stage: 'submission', snapshot, node, graph: app.graph}),
// Direct snapshot submission still feeds the same graph result panel.
onResult: output => {
if (app.graph?.getNodeById(node.id) !== node) { node.freevideoLastResult = output.freevideo_summary[0]; return; }
@@ -337,7 +338,21 @@ export function openStudio(node) {
linked_seed: t('Use the seed in this panel for batch or loop generation.', '批量和循环生成需使用面板内的种子,请先断开种子输入的连接。'),
missing_node: t('This node is disabled or no longer in the workflow.', '该节点已禁用或已从工作流移除。'),
}[error?.message] || error?.message || String(error));
- function showQueueError(error) { status.dataset.error = 'true'; status.textContent = queueError(error); }
+ let lastQueueError = null;
+ function showQueueError(error) {
+ status.dataset.error = 'true';
+ // Polling and loop shutdown must not replace the original exception
+ // with a generic "loop stopped" notice or reopen a dismissed dialog.
+ if (['loop_stopped', 'queue_unavailable'].includes(error?.message)
+ && node.freevideoFailureReport && node.freevideoFailureReport.stage !== 'queue') return;
+ status.textContent = error?.schema === 'freevideo.error-report'
+ ? t('Submission failed. See the details below.', '提交失败,具体原因见下方。') : queueError(error);
+ const identity = error?.schema === 'freevideo.error-report' ? error : error?.message || error;
+ if (lastQueueError === identity) return;
+ lastQueueError = identity;
+ const report = failure.show(error, error?.schema === 'freevideo.error-report', {stage: 'queue', node, graph: app.graph});
+ node.freevideoFailureReport = report; node.freevideoFailure = errorText(report);
+ }
function updateRunButton() {
const submitting = capturing || queueState?.submitting;
generate.disabled = submitting || (runMode === 'loop' && queueState?.looping);
@@ -409,6 +424,7 @@ export function openStudio(node) {
const chosenMode = runMode, batchCount = chosenMode === 'batch' ? Number(count.value) : 1;
const originalSeed = value(node, 'seed'), seedMode = mode.value;
try {
+ lastQueueError = null; failure.clear(); node.freevideoFailure = ''; node.freevideoFailureReport = null;
capturing = true; updateRunButton(); status.dataset.error = 'false'; runOptions.open = false;
// Only serialization briefly locks the editor. Network submission
// and all GPU execution leave the next draft fully editable.
@@ -428,7 +444,7 @@ export function openStudio(node) {
set(node, 'seed', next); seed.value = next;
}
if (!queueController.state().error) status.textContent = '';
- } catch (error) { showQueueError(error); }
+ } catch (error) { showQueueError(createErrorReport(error, {stage: 'submission', node, graph: app.graph})); }
finally {
capturing = false;
for (const section of controls.querySelectorAll('.fv-section')) section.inert = false;
@@ -485,7 +501,7 @@ export function openStudio(node) {
cleanup.push(() => { window.removeEventListener('freevideo-media', mediaChanged); window.removeEventListener('freevideo-result', resultChanged); });
const listen = (type, handler) => { api.addEventListener(type, handler); cleanup.push(() => api.removeEventListener(type, handler)); };
listen('status', () => { syncQueue().catch(() => {}); });
- listen('executing', e => { const id = typeof e.detail === 'object' ? e.detail?.node : e.detail; if (String(id) === String(node.id)) { failure.clear(); node.freevideoFailure = ''; busy = true; queued = false; updateRunButton(); showProgress(node.freevideoProgress || {label: t('Preparing your video', '正在准备视频'), reset: true, new_request: true}); status.textContent = ''; } syncQueue().catch(() => {}); });
+ listen('executing', e => { const id = typeof e.detail === 'object' ? e.detail?.node : e.detail; if (String(id) === String(node.id)) { failure.clear(); node.freevideoFailure = ''; node.freevideoFailureReport = null; busy = true; queued = false; updateRunButton(); showProgress(node.freevideoProgress || {label: t('Preparing your video', '正在准备视频'), reset: true, new_request: true}); status.textContent = ''; } syncQueue().catch(() => {}); });
const progressChanged = e => {
if (String(e.detail.node) !== String(node.id)) return;
if (['failed', 'cancelled'].includes(e.detail.phase) || e.detail.result) {
@@ -511,14 +527,14 @@ export function openStudio(node) {
}
if (!seen.has(String(e.detail?.node_id))) return;
busy = cancelling = false; updateRunButton(); hideProgress(); status.dataset.error = 'true';
- node.freevideoFailure = errorText(e.detail);
- failure.show(node.freevideoFailure);
+ node.freevideoFailureReport = failure.show(e.detail, true, {stage: 'execution', node, graph: app.graph, progress: node.freevideoProgress});
+ node.freevideoFailure = errorText(node.freevideoFailureReport);
status.textContent = t('Generation stopped. See the explanation below.', '生成已停止,原因和处理建议见下方。');
});
listen('execution_interrupted', e => {
if (activePrompt ? e.detail?.prompt_id !== activePrompt : String(e.detail?.node_id) !== String(node.id)) return;
busy = cancelling = false; activePrompt = null; updateRunButton(); hideProgress();
- failure.clear(); node.freevideoFailure = ''; status.dataset.error = 'false'; status.textContent = t('Cancelled', '已取消');
+ failure.clear(); node.freevideoFailure = ''; node.freevideoFailureReport = null; status.dataset.error = 'false'; status.textContent = t('Cancelled', '已取消');
});
const escape = e => { if ((e.ctrlKey || e.metaKey) && e.key === 'Enter') { e.preventDefault(); generate.click(); } }; dialog.addEventListener('keydown', escape);
dialog.addEventListener('cancel', e => { e.preventDefault(); closeDialog(dialog); });
diff --git a/web/studio_queue.js b/web/studio_queue.js
index 737e57c..a1d1219 100644
--- a/web/studio_queue.js
+++ b/web/studio_queue.js
@@ -16,7 +16,8 @@ export function seededPrompt(snapshot, nodeId, seedIndex, seed) {
return prompt;
}
-export function createStudioQueue(api, nodeId, {random = randomSeed, pollMs = 2000, onResult = () => {}} = {}) {
+export function createStudioQueue(api, nodeId, {random = randomSeed, pollMs = 2000, onResult = () => {},
+ formatError = error => error} = {}) {
nodeId = String(nodeId);
let running = null, pending = [], submitting = false, loop = null, timer = null;
let refreshing = null, refreshAgain = false, lastError = null, disposed = false;
@@ -57,8 +58,15 @@ export function createStudioQueue(api, nodeId, {random = randomSeed, pollMs = 20
}
session.lastSeed = seed;
const prompt = seededPrompt(session.snapshot, nodeId, session.seedIndex, seed);
- const reply = await api.queuePrompt(0, prompt);
- if (!reply?.prompt_id) throw new Error('submit_failed');
+ let reply;
+ try {
+ reply = await api.queuePrompt(0, prompt);
+ if (!reply?.prompt_id) throw new Error('submit_failed');
+ } catch (error) {
+ // Format while the submitted snapshot is still available. The
+ // editor may already contain different text by the time it fails.
+ throw formatError(error, prompt);
+ }
remember(reply.prompt_id);
if (session.repeat) {
session.waiting = reply.prompt_id;