feat(bulk): add "Download Example Images" to bulk select context menu (#923)

Allows downloading example images only for selected models instead of
the entire library. Reuses the existing /api/lm/force-download-example-images
endpoint which already accepts an array of model hashes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

locales/de.json

@@ -692,6 +692,7 @@
             "unfavorite": "Aus Favoriten entfernen",
             "deleteAll": "Ausgewählte löschen",
             "downloadMissingLoras": "Fehlende LoRAs herunterladen",
+            "downloadExamples": "Beispielbilder herunterladen",
             "clear": "Auswahl löschen",
             "skipMetadataRefreshCount": "Überspringen（{count} Modelle）",
             "resumeMetadataRefreshCount": "Fortsetzen（{count} Modelle）",

locales/en.json

@@ -692,6 +692,7 @@
             "unfavorite": "Remove from Favorites",
             "deleteAll": "Delete Selected",
             "downloadMissingLoras": "Download Missing LoRAs",
+            "downloadExamples": "Download Example Images",
             "clear": "Clear Selection",
             "skipMetadataRefreshCount": "Skip ({count} models)",
             "resumeMetadataRefreshCount": "Resume ({count} models)",

locales/es.json

@@ -692,6 +692,7 @@
             "unfavorite": "Quitar de favoritos",
             "deleteAll": "Eliminar seleccionados",
             "downloadMissingLoras": "Descargar LoRAs faltantes",
+            "downloadExamples": "Descargar imágenes de ejemplo",
             "clear": "Limpiar selección",
             "skipMetadataRefreshCount": "Omitir（{count} modelos）",
             "resumeMetadataRefreshCount": "Reanudar（{count} modelos）",

locales/fr.json

@@ -692,6 +692,7 @@
             "unfavorite": "Retirer des favoris",
             "deleteAll": "Supprimer la sélection",
             "downloadMissingLoras": "Télécharger les LoRAs manquants",
+            "downloadExamples": "Télécharger les images d'exemple",
             "clear": "Effacer la sélection",
             "skipMetadataRefreshCount": "Ignorer（{count} modèles）",
             "resumeMetadataRefreshCount": "Reprendre（{count} modèles）",

locales/he.json

@@ -692,6 +692,7 @@
             "unfavorite": "הסר ממועדפים",
             "deleteAll": "מחק נבחרים",
             "downloadMissingLoras": "הורדת LoRAs חסרים",
+            "downloadExamples": "הורד תמונות דוגמה",
             "clear": "נקה בחירה",
             "skipMetadataRefreshCount": "דילוג（{count} מודלים）",
             "resumeMetadataRefreshCount": "המשך（{count} מודלים）",

locales/ja.json

@@ -692,6 +692,7 @@
             "unfavorite": "お気に入りから削除",
             "deleteAll": "選択したものを削除",
             "downloadMissingLoras": "不足している LoRA をダウンロード",
+            "downloadExamples": "例画像をダウンロード",
             "clear": "選択をクリア",
             "skipMetadataRefreshCount": "スキップ（{count}モデル）",
             "resumeMetadataRefreshCount": "再開（{count}モデル）",

locales/ko.json

@@ -692,6 +692,7 @@
             "unfavorite": "즐겨찾기 해제",
             "deleteAll": "선택된 항목 삭제",
             "downloadMissingLoras": "누락된 LoRA 다운로드",
+            "downloadExamples": "예시 이미지 다운로드",
             "clear": "선택 지우기",
             "skipMetadataRefreshCount": "건너뛰기（{count}개 모델）",
             "resumeMetadataRefreshCount": "재개（{count}개 모델）",

locales/ru.json

@@ -692,6 +692,7 @@
             "unfavorite": "Удалить из избранного",
             "deleteAll": "Удалить выбранные",
             "downloadMissingLoras": "Скачать отсутствующие LoRAs",
+            "downloadExamples": "Загрузить примеры изображений",
             "clear": "Очистить выбор",
             "skipMetadataRefreshCount": "Пропустить（{count} моделей）",
             "resumeMetadataRefreshCount": "Возобновить（{count} моделей）",

locales/zh-CN.json

@@ -692,6 +692,7 @@
             "unfavorite": "取消收藏",
             "deleteAll": "删除已选",
             "downloadMissingLoras": "下载缺失的 LoRAs",
+            "downloadExamples": "下载示例图片",
             "clear": "清除选择",
             "skipMetadataRefreshCount": "跳过（{count} 个模型）",
             "resumeMetadataRefreshCount": "恢复（{count} 个模型）",

locales/zh-TW.json

@@ -692,6 +692,7 @@
             "unfavorite": "取消收藏",
             "deleteAll": "刪除所選",
             "downloadMissingLoras": "下載缺失的 LoRAs",
+            "downloadExamples": "下載範例圖片",
             "clear": "清除選取",
             "skipMetadataRefreshCount": "跳過（{count} 個模型）",
             "resumeMetadataRefreshCount": "恢復（{count} 個模型）",

static/js/components/ContextMenu/BulkContextMenu.js

@@ -4,6 +4,7 @@ import { bulkManager } from '../../managers/BulkManager.js';
 import { updateElementText, translate } from '../../utils/i18nHelpers.js';
 import { bulkMissingLoraDownloadManager } from '../../managers/BulkMissingLoraDownloadManager.js';
 import { showToast } from '../../utils/uiHelpers.js';
+import { getModelApiClient } from '../../api/modelApiFactory.js';
 
 export class BulkContextMenu extends BaseContextMenu {
     constructor() {
@@ -107,6 +108,13 @@ export class BulkContextMenu extends BaseContextMenu {
             downloadMissingLorasItem.style.display = currentModelType === 'recipes' ? 'flex' : 'none';
         }
 
+        const downloadExampleImagesItem = this.menu.querySelector('[data-action="download-example-images"]');
+        if (downloadExampleImagesItem) {
+            // Show on model pages (loras, checkpoints, embeddings), hide on recipes
+            const modelPages = ['loras', 'checkpoints', 'embeddings'];
+            downloadExampleImagesItem.style.display = modelPages.includes(currentModelType) ? 'flex' : 'none';
+        }
+
         const skipMetadataRefreshItem = this.menu.querySelector('[data-action="skip-metadata-refresh"]');
         const resumeMetadataRefreshItem = this.menu.querySelector('[data-action="resume-metadata-refresh"]');
 
@@ -235,6 +243,9 @@ export class BulkContextMenu extends BaseContextMenu {
             case 'download-missing-loras':
                 this.handleDownloadMissingLoras();
                 break;
+            case 'download-example-images':
+                this.handleDownloadExampleImages();
+                break;
             case 'clear':
                 bulkManager.clearSelection();
                 break;
@@ -277,4 +288,31 @@ export class BulkContextMenu extends BaseContextMenu {
 
         await bulkMissingLoraDownloadManager.downloadMissingLoras(selectedRecipes);
     }
+
+    async handleDownloadExampleImages() {
+        if (state.selectedModels.size === 0) {
+            return;
+        }
+
+        const hashes = new Set();
+        for (const filePath of state.selectedModels) {
+            const escapedPath = CSS.escape(filePath);
+            const card = document.querySelector(`.model-card[data-filepath="${escapedPath}"]`);
+            if (card?.dataset?.sha256) {
+                hashes.add(card.dataset.sha256);
+            }
+        }
+
+        if (hashes.size === 0) {
+            showToast('No valid model hashes found in selection', {}, 'warning');
+            return;
+        }
+
+        try {
+            const apiClient = getModelApiClient();
+            await apiClient.downloadExampleImages([...hashes]);
+        } catch (error) {
+            console.error('Bulk download example images failed:', error);
+        }
+    }
 }

templates/components/context_menu.html

@@ -71,6 +71,9 @@
     <div class="context-menu-item" data-action="auto-organize">
         <i class="fas fa-magic"></i> <span>{{ t('loras.bulkOperations.autoOrganize') }}</span>
     </div>
+    <div class="context-menu-item" data-action="download-example-images">
+        <i class="fas fa-download"></i> <span>{{ t('loras.bulkOperations.downloadExamples') }}</span>
+    </div>
     <div class="context-menu-item" data-action="add-tags">
         <i class="fas fa-tags"></i> <span>{{ t('loras.bulkOperations.addTags') }}</span>
     </div>