Will Miao
1c017a8e27
Preview responses are cached for a day (Cache-Control: max-age=86400), so rewriting a preview file under the same path (e.g. delete + recreate an LM-managed workflow) kept showing the old image. Append the file's mtime as a query param in get_preview_static_url so any rewrite yields a fresh URL; the previews handler ignores the extra param.
2.3 KiB
Library Switching and Preview Routes
Deprecated: Multi-library support (and therefore library switching) is deprecated and will be removed in an upcoming release. The dynamic preview route described here will remain — it also serves single-library installations.
Library switching no longer requires restarting the backend. The preview thumbnails shown in the UI are now served through a dynamic endpoint that resolves files against the folders registered for the active library at request time. This allows the multi-library flow to update model roots without touching the aiohttp router, so previews remain available immediately after a switch.
How the dynamic preview endpoint works
config.get_preview_static_url()now returns/api/lm/previews?path=<encoded>&v=<mtime_ns>for any preview path. The raw filesystem location is URL encoded so that it can be passed through the query string without leaking directory structure in the route itself. Thevparameter carries the preview file's modification time so a rewritten preview (e.g. delete + recreate an LM-managed workflow) produces a fresh URL that bypasses the browser's day-long cache; the handler ignores it.【F:py/config.py†L398-L404】PreviewRoutesexposes the/api/lm/previewshandler which validates the decoded path against the directories registered for the current library. The request is rejected if it falls outside those roots or if the file does not exist.【F:py/routes/preview_routes.py†L5-L21】【F:py/routes/handlers/preview_handlers.py†L9-L48】Configkeeps an up-to-date cache of allowed preview roots. Every time a library is applied the cache is rebuilt using the declared LoRA, checkpoint and embedding directories (including symlink targets). The validation logic checks preview requests against this cache.【F:py/config.py†L51-L68】【F:py/config.py†L180-L248】【F:py/config.py†L332-L346】
Both the ComfyUI runtime (LoraManager.add_routes) and the standalone launcher
(StandaloneLoraManager.add_routes) register the new preview routes instead of
mounting a static directory per root. Switching libraries therefore works
without restarting the application, and preview URLs generated before or after a
switch continue to resolve correctly.【F:py/lora_manager.py†L21-L82】【F:standalone.py†L302-L315】