Will Miao f5e983eaaa feat: optional centralized storage for sidecar metadata and previews (#1045) ...

Add an opt-in 'centralized' sidecar storage mode alongside the default
'alongside' layout. In centralized mode, .metadata.json sidecars and
preview assets live under a configurable root (sidecar_storage_path,
default <settings_dir>/sidecars), mirroring the library-relative
directory structure: <root>/<library>/<root_basename>/<rel_dir>/.

Backend:
- settings: sidecar_storage_mode / sidecar_storage_path with validation;
  changing either refreshes the preview allowlist
- config: centralized root added to preview-serving allowlist
- lifecycle: delete / move / rename / folder-rename / folder-delete and
  undoable-delete staging all operate on the mirror tree in centralized
  mode (model files themselves never move); EXDEV-tolerant cross-
  filesystem moves
- scanners: pending-hash filesystem scan walks the mirror tree in
  centralized mode; preview discovery reads from the sidecar dir;
  .civitai.info stays co-located in both modes
- migration: SidecarMigrationUseCase moves sidecars+previews between
  layouts both directions (keep-newer conflict resolution, preview_url
  rewriting, WebSocket progress), exposed as POST+GET
  /api/lm/sidecars/migrate with a mode guard (force=true for the
  settings-first flow)

Frontend:
- settings modal: sidecar storage section (mode select + path input with
  browse/validation), mode-change confirmation offering immediate
  migration (force=true), and a 'Migrate Sidecars Now' action
- i18n keys synced to all locales ([TODO: Translate] placeholders)

Docs: metadata-json-schema.md gains a storage-location section;
AGENTS.md records the sidecar_paths helper convention.

2026-09-26 10:00:58 +08:00

..

agent

fix: stop grouping HF/ModelScope models by repository

2026-09-25 23:29:30 +08:00

model_sources

fix: stop grouping HF/ModelScope models by repository

2026-09-25 23:29:30 +08:00

recipes

Support re-import for recipes without a source URL

2026-08-31 10:01:18 +08:00

use_cases

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

__init__.py

Reorganize python files

2025-02-24 20:41:16 +08:00

active_filters_store.py

fix(autocomplete): sync active filters via server-side store (#1091)

2026-09-02 14:33:44 +08:00

aria2_downloader.py

feat: support gated/private Hugging Face repos via access token

2026-09-25 18:44:06 +08:00

aria2_transfer_state.py

fix(download): restore aria2 resume lifecycle

2026-04-20 09:52:48 +08:00

auto_tag_service.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

autov3_backfill_service.py

refactor: route sidecar/preview path derivation through sidecar_paths helpers

2026-09-26 09:02:37 +08:00

backup_service.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

base_model_service.py

fix: stop grouping HF/ModelScope models by repository

2026-09-25 23:29:30 +08:00

batch_import_service.py

feat(recipes): explain empty LoRA lists with collapsible "Why no LoRAs?" panel

2026-08-30 16:28:41 +08:00

cache_entry_validator.py

feat(metadata): add CivitAI AutoV3 hash support across all storage layers

2026-08-08 14:30:34 +08:00

cache_health_monitor.py

feat(cache): add cache health monitoring and validation system, see #730

2026-02-02 08:30:59 +08:00

checkpoint_scanner.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

checkpoint_service.py

fix: expose source_model_id/source_version_id in model list payloads

2026-09-26 07:35:36 +08:00

civarchive_client.py

fix(recipes): enforce batch-import concurrency bound and harden ingest errors (#1085)

2026-08-27 07:58:48 +08:00

civitai_base_model_service.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

civitai_client.py

fix(download): save multi-variant files under raw stored filenames (#1100)

2026-09-06 22:23:48 +08:00

connectivity_guard.py

fix(network): scope connectivity cooldown by destination

2026-04-20 15:20:57 +08:00

custom_words_service.py

chore(logging): remove autocomplete debug logs (#895)

2026-04-15 20:42:55 +08:00

download_coordinator.py

fix(download): stop stale aria2 GIDs from spamming errors after queue clears

2026-08-25 08:19:54 +08:00

download_manager.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

download_queue_service.py

fix(download): stop stale aria2 GIDs from spamming errors after queue clears

2026-08-25 08:19:54 +08:00

download_routing.py

feat(backend): CivitAI download support for other model types with subtype routing

2026-09-12 15:56:47 +08:00

downloaded_version_history_service.py

fix(scanner): offload persisted-cache hydration from the event loop

2026-08-25 17:38:09 +08:00

downloader.py

feat(recipes): skip rate-limited batch-import items and register download 429s (#1085)

2026-08-27 10:08:32 +08:00

embedding_scanner.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

embedding_service.py

fix: expose source_model_id/source_version_id in model list payloads

2026-09-26 07:35:36 +08:00

errors.py

feat(agent): add LLM-powered metadata enrichment system with AgentCLI and PostProcessor

2026-07-02 21:27:01 +08:00

example_images_cleanup_service.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

llm_service.py

fix(llm): stop DeepSeek enrichment failing on json_schema rejection

2026-09-14 10:27:33 +08:00

lora_scanner.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

lora_service.py

fix: expose source_model_id/source_version_id in model list payloads

2026-09-26 07:35:36 +08:00

metadata_archive_manager.py

feat(downloads): expose throughput metrics in progress APIs

2025-10-13 14:39:31 +08:00

metadata_service.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

metadata_sync_service.py

refactor: route sidecar/preview path derivation through sidecar_paths helpers

2026-09-26 09:02:37 +08:00

model_cache.py

fix(scanner): serve folder tree from scan-recorded, persisted directory list (#1110)

2026-09-11 23:03:24 +08:00

model_file_service.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

model_hash_index.py

fix(recipes): reject the empty-hash placeholder when resolving LoRA hashes

2026-09-01 21:14:30 +08:00

model_lifecycle_service.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

model_metadata_provider.py

fix(download): save multi-variant files under raw stored filenames (#1100)

2026-09-06 22:23:48 +08:00

model_query.py

feat(ui): add hash search option and de-emphasized hash display in model modal

2026-08-23 10:09:55 +08:00

model_scanner.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

model_service_factory.py

feat(backend): add Other model type (VAE/upscaler/text encoder) scanner, service and routes

2026-09-12 11:25:51 +08:00

model_update_service.py

fix(update): align update-check summary count with Updates filter scope (#1083)

2026-08-25 20:36:46 +08:00

other_model_service.py

fix: expose source_model_id/source_version_id in model list payloads

2026-09-26 07:35:36 +08:00

other_scanner.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

pending_delete_service.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

persistent_model_cache.py

fix: stop grouping HF/ModelScope models by repository

2026-09-25 23:29:30 +08:00

persistent_recipe_cache.py

fix(cache): make shared cache state survive a second instance

2026-09-17 23:59:22 +08:00

preview_asset_service.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

rate_limit_coordinator.py

feat(services): add per-destination rate-limit gate for API traffic (#1085)

2026-08-27 09:53:07 +08:00

recipe_cache.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

recipe_fts_index.py

fix(cache): make shared cache state survive a second instance

2026-09-17 23:59:22 +08:00

recipe_scanner.py

fix(cache): make shared cache state survive a second instance

2026-09-17 23:59:22 +08:00

server_i18n.py

fix(types): resolve pre-existing basedpyright errors in py/ and standalone.py

2026-08-08 20:12:52 +08:00

service_registry.py

feat(backend): add Other model type (VAE/upscaler/text encoder) scanner, service and routes

2026-09-12 11:25:51 +08:00

settings_manager.py

feat: optional centralized storage for sidecar metadata and previews (#1045)

2026-09-26 10:00:58 +08:00

tag_fts_index.py

fix(cache): make shared cache state survive a second instance

2026-09-17 23:59:22 +08:00

tag_update_service.py

refactor: route sidecar/preview path derivation through sidecar_paths helpers

2026-09-26 09:02:37 +08:00

websocket_manager.py

feat(settings): filename templates for download and bulk rename (#1071)

2026-09-19 09:04:24 +08:00

websocket_progress_callback.py

feat(settings): filename templates for download and bulk rename (#1071)

2026-09-19 09:04:24 +08:00

wildcard_service.py

fix: re-run dynamic prompts fed through linked text inputs

2026-09-24 09:33:27 +08:00