← вернуться к отчёту

Инструкция по работе с фотографиями

Подготовка каталога для silver.рф — пошагово

Что делает эта программа
Ты загружаешь справочник артикулов (Excel) → программа узнаёт какие артикулы существуют. Потом ты складываешь фото украшений в папку на компьютере. Программа отправляет на сервер только мини-копии 512 px (оригиналы НИКОГДА не покидают твой компьютер). Сервер с помощью ИИ раскладывает фото по категориям (главное каталожное, дополнительные ракурсы, фото на модели), нумерует их (TJR190_01.jpg, _03.jpg…). Результат: Оригиналы в исходной папке никогда не меняются — программа их только читает.

Содержание

  1. Установка программы
  2. Загрузка справочника артикулов (один раз)
  3. Подготовка папки с фотографиями
  4. Первый запуск и настройка
  5. Кнопка «Проверить наличие фото» (до SYNC)
  6. Кнопка SYNC и что ожидать
  7. Где смотреть результат
  8. Правки на сайте (если ИИ ошибся)
  9. Добавить новые фото / обновить справочник
  10. Очистка тестовых данных перед началом работы
  11. Решение проблем

1. Установка программы

1Скачай программу.

Открой в браузере: https://silver-report.6sl.ru/silver-sync.exe — файл сохранится в папку «Загрузки» (около 20 МБ).

2Перемести программу в удобное место.

Например, на рабочий стол или в папку C:\Silver\. Программа не требует установки — это самодостаточный файл, можно запускать прямо из «Загрузок».

3Двойной клик по silver-sync.exe.
Windows может показать синее окно «Защитник Windows предотвратил запуск…»
Это потому что у программы нет цифровой подписи (она не куплена в Microsoft Store). Это нормально:
  1. Нажми «Подробнее» (маленькая ссылка под основным текстом).
  2. Появится кнопка «Выполнить в любом случае» — жми её.
В следующие разы предупреждение больше не появится.
4Откроется окно «Silver Sync».

Если окно не появилось — проверь, не заблокировал ли антивирус. Добавь silver-sync.exe в исключения антивируса.

2. Загрузка справочника артикулов (один раз перед началом)

Программа сопоставляет фото с артикулами из справочника — Excel-файла со списком всех твоих артикулов. Без справочника она не знает, какие артикулы существуют, и не сможет ничего обработать.

Формат справочника

Обычный .xlsx, у первой строки заголовки колонок:

Один артикул = одна строка. Дубли в файле программа уберёт автоматически.

Как узнать, что сейчас на сервере

В любой момент нажми «Проверить справочник на сервере» (кнопка рядом с SYNC). Внизу окна появится строка вида:

На сервере сейчас: 1200 артикулов в справочнике, 350 обработано ИИ, 0 в очереди.

Это даёт понять, актуальная ли версия загружена. Сравни число с тем, сколько строк в твоём свежем Excel:

Как загрузить или обновить

1В окне Silver Sync нажми «Загрузить справочник артикулов (Excel)» (кнопка рядом с SYNC).
2Откроется диалог выбора файла. Найди свой whitelist.xlsx (или как ты его назвал), нажми «Открыть».
3Внизу окна появится сообщение вида:
Готово. В файле: 3000 артикулов. Было на сервере: 2950 → стало: 3000. Добавлено новых: 50. Уже было: 2950.
Если на сервере есть артикулы, отсутствующие в твоём свежем файле:
В логе появится дополнительная строка вида:
На сервере есть 12 артикулов, которых нет в твоём файле — они НЕ удалены. Чтобы убрать — напиши Вадиму. Примеры: A001, B002, …
Это не ошибка — просто информация. Программа никогда не удаляет артикулы сама (на них могут быть фото и история правок). Если они действительно больше не нужны — напиши Вадиму список, он удалит руками.
Когда обновлять справочник:
Если программа сказала «В файле найдены артикулы, которые сервер не примет»:
В сообщении будут указаны конкретные строки Excel и причина. Самая частая — «Excel превратил это в число с плавающей точкой (научная нотация)». Это значит, что артикул был длинным числом (типа 33402408212340…) и Excel автоматически сжал его до 3.34E+19, потеряв точность.

Как починить:
  1. Открой xlsx в Excel.
  2. Выдели колонку article целиком (клик по букве «A»).
  3. Правый клик → «Формат ячеек» → «Текстовый» → OK.
  4. Найди битые ячейки (там сейчас «3,34E+19» или похожее) и впиши артикул заново как обычный текст.
  5. Сохрани файл и попробуй загрузить снова в программе.
Программа ничего не отправит на сервер, пока в файле есть проблемные строки — это страховка, чтобы в БД не попадал мусор.
Первый раз справочник грузится перед началом работы. Потом — каждый раз, когда у тебя меняется Excel (новые артикулы, переименования).

3. Подготовка папки с фотографиями

Создай папку, куда будешь складывать все фото украшений. Например: C:\Silver\input\.

Как должны называться файлы

В имени файла обязательно должен быть артикул — он же есть в Excel-файле каталога. Программа ищет артикул в имени файла.

Структура папок внутри input

Может быть любая. Программа сканирует все подпапки рекурсивно. Можно складывать всё в одну папку или раскладывать по серии, ракурсам — без разницы.

Поддерживаемые форматы

Фото: .jpg, .jpeg, .png, .tif, .tiff, .webp, .heic
Видео: .mp4, .mov и др. (видео ИИ не классифицирует — они помечаются как «видео» и попадают в архив артикула без обработки)

4. Первый запуск и настройка

В окне «Silver Sync» три поля. Заполняешь один раз, программа запомнит на следующий запуск.

1«Папка с фото»

Нажми «Обзор…» справа. Выбери ту папку, в которую складываешь фото украшений (например, C:\Silver\input\).

2«Адрес VPS»

Уже заполнено: https://silver-report.6sl.ru. Ничего не меняй.

3«Токен»

Это пароль для связи программы с сервером. Получи от Вадима (передаст отдельно). Введи в поле — можно вручную, можно через кнопку «Вставить» справа (если скопировал из мессенджера).

Кнопка «Вставить» подтягивает содержимое буфера обмена — это нужно потому что Windows не всегда даёт делать Ctrl+V в этом поле при русской раскладке.

5. Кнопка «📋 Проверить наличие фото» (до SYNC)

1Загрузи свежий справочник (кнопка «Загрузить справочник артикулов»). Без свежего справочника проверять нечего.
2Нажми 📋 Проверить наличие фото. Программа просканирует папку с фото и сверит с твоим Вайтлистом. Без отправки чего-либо на сервер, только локально, быстро (секунды).
3Получи Excel со списком артикулов БЕЗ фото. Файл сохраняется рядом с папкой фото (в её родительской папке). Имя: <имя_папки_фото>_не_найдены.xlsx.

Пример: если папка с фото C:\Users\Admin\Downloads\Renamer_test_7_all\, то Excel ляжет в C:\Users\Admin\Downloads\Renamer_test_7_all_не_найдены.xlsx.

4Ищи недостающие фото (на Я.Диске, в архивах). Найденное докладывай в папку с фото — потом запусти SYNC. Можешь хоть несколько раз нажимать «Проверить» — программа каждый раз перезаписывает xlsx.
Зачем это нужно: SYNC долгий (несколько часов на тысячах артикулов). Лучше до него увидеть, для каких артикулов вообще нет фото в папке, и не запускать ИИ зря. После того как найдёшь недостающее — жми SYNC.
Формат Excel — две колонки: article, type. Тот же формат, что и в твоём исходном whitelist'е. Если найдёшь фото для части артикулов — можешь дать этот xlsx как новый whitelist и загрузить только их.

6. Кнопка SYNC и что ожидать

1Нажми SYNC.

В нижней половине окна пойдут строки лога. Время от времени появляются строки «HTTP Request: …» — это нормально, программа разговаривает с сервером.

2Этапы и сколько они занимают:
Если в конце SYNC появится N артикулов не обработались ИИ со списком артикулов и причиной — это значит ИИ временно не справился с этими артикулами (перегрузка API, тайм-аут, проблема с конкретным фото). Эти артикулы пока не появятся в дашборде. Что делать: нажми SYNC ещё раз через 1-2 минуты — программа повторит запрос. Обычно со второй или третьей попытки проходит. Если не проходит много раз подряд — сообщи Вадиму, он разберётся.
Сколько ждать?
ИИ обрабатывает каждый артикул ≈ 30–90 секунд. На 100 артикулов — около часа. На 3000 артикулов (полный каталог) — несколько часов. Окно программы можно не закрывать и не трогать — пусть работает в фоне. На статус повлиять нельзя, ИИ работает на сервере.
Можно ли закрыть программу пока она работает?
Если уже все фото загружены (этап status: …) — да, окно можно закрыть, ИИ продолжит работать на сервере. Когда вернёшься — нажмёшь SYNC снова, программа скачает план и сделает __renamed__. Если ещё идёт upload (этап batch …) — лучше дождаться done. или хотя бы конца текущей пачки.

6. Где смотреть результат

На компьютере: папка __renamed__

Рядом с твоей input-папкой появится __renamed__. Например, если input — C:\Silver\input\, то результат — C:\Silver\__renamed__\ (на одном уровне, не внутри input).

В этой папке — все отобранные ИИ фото, уже под финальными именами вида TJR190_01.jpg, TJR190_03.jpg, TJR221_01.jpg и т.д. Их можно загружать на silver.рф.

Важно: папка __renamed__ пересоздаётся целиком при каждом SYNC. Имена TJR190_01.jpg и т.п. — это не постоянные метки конкретных файлов, а «текущий топ» по версии ИИ плюс твоих правок. Если ты привязываешься к именам в каком-то внешнем процессе (загрузка на silver.рф), помни — они могут поменяться при пересборке артикула. Стабильным остаётся только префикс артикула.

На сайте: https://silver-report.6sl.ru

Это полный отчёт по каждому артикулу. Что видишь:

После SYNC обязательно обнови страницу!
В браузере: Ctrl+F5 (или Ctrl+R). Без обновления увидишь старую версию отчёта без новых артикулов.

7. Правки на сайте (если ИИ ошибся)

Если ИИ положил фото не туда или взял не то главное — это правится прямо на сайте, без перезапуска программы.

Внутри карточки артикула

Главное — лимит 1 фото на артикул. Если ставишь новое фото в «Главное», старое автоматически уезжает в «Отброшено». Так задумано — у каталога одно главное.

Что появится в шапке отчёта

Картинки на сайте обновляются сразу после каждого действия — фрагмент артикула пересобирается сервером. F5 не нужен.
А вот папка __renamed__ на твоём компьютере НЕ обновится автоматически. Чтобы получить файлы с новыми именами после правок — нажми SYNC ещё раз. Программа скачает обновлённый план и пересоберёт папку.

8. Добавить новые фото / обновить справочник

Как работает инкрементальный SYNC

Каждый SYNC делает три вещи:
  1. Сравнивает файлы в input-папке с тем, что уже на сервере, отправляет только новые (по содержимому файла, не по имени).
  2. Запускает ИИ на сервере — но только для артикулов, у которых что-то изменилось (новые фото, или ты дозалил фото к существующему).
  3. Перекладывает папку __renamed__ на твоём компьютере под актуальный план с сервера (целиком пересоздаёт).

Сценарии

Сценарий 1: ничего нового не добавлял, просто запустил SYNC.

Сценарий 2: положил новые фото нового артикула TJR300.

Сценарий 3: положил доп. фото к существующему артикулу TJR190 (раньше было 3 фото, добавил ещё 2).

Сценарий 4: сделал ручные правки на сайте (через reconciler), оригиналы не трогал.

Куда складывать новые фото

1В ту же input-папку, что и раньше — структура любая (подпапки или плоско). Главное: артикул в имени файла.
2Нажми SYNC. Программа сама поймёт, что новое (по содержимому файла), отправит только новое.
3Дождись done. в логе. На дашборде обнови (Ctrl+F5) — увидишь свежий результат. В __renamed__ — обновлённый набор файлов.
Важно про имена в __renamed__: они не привязаны к конкретным оригиналам. TJR190_01.jpg — это «текущее главное каталожное фото артикула TJR190», а не «всегда тот же самый файл». Если ИИ решит, что новое фото лучше, имя _01 переедет на него, а старое фото получит другой номер или станет дополнительным. Это нормально.
А если я заменил фото (новый файл с тем же именем)?
Программа смотрит на содержимое файла, не на имя. Если ты заменил TJR190.jpg на другое фото — оно считается новым, отправится, ИИ переобработает артикул TJR190.
Что если я удалил файл из input-папки?
На сервере фото останется (вместе с историей правок). Если хочешь полностью убрать артикул — напиши Вадиму, он почистит вручную.

Обновление справочника

Если в Excel-файле появились новые артикулы — просто нажми «Загрузить справочник артикулов (Excel)» ещё раз. Программа добавит только новые строки, старые не тронет.

Что НЕ делает обновление справочника: Если нужно изменить тип или удалить артикул — напиши Вадиму с описанием.

9. Очистка тестовых данных перед началом работы

Когда ты только начал работать с программой — нормально загружать пробные фото пакетами, смотреть как ИИ их раскладывает, проверять reconciler-кнопки. Все эти тестовые фото и решения копятся на сервере и на дашборде. Перед началом «настоящей» работы их полезно стереть, чтобы реальный каталог не мешался с тестами.

1В окне Silver Sync нажми «🗑 Очистить тестовые данные (необратимо)» в нижнем ряду кнопок.
2Появятся два диалоговых окна подтверждения подряд. Программа предупредит, что операция необратима. Если уверен — нажми «Да» оба раза.
3За несколько секунд программа сделает всё сама, без твоего участия: Тебе никуда лезть руками не нужно — никаких системных папок, никаких ручных удалений. Внизу окна появится итог: «Готово. Удалено: фото N, решений M, превью K. Справочник остался: X артикулов. Локальный кэш и __renamed__ очищены.»

В редком случае (антивирус заблокировал файл, ОС не отдала) программа честно напишет «⚠ НЕ удалось локально удалить: кэш (полный путь). Закрой программу и удали вручную, иначе SYNC решит, что фото уже загружены.» — следуй инструкции «Программа говорит to upload: 0» ниже.
После очистки можно класть в input-папку реальные фото и жать SYNC — программа обработает их как новые, на дашборде появятся свежие карточки.
Если ты случайно нажал и пожалел — данные не восстановить. Просто загружай фото заново через SYNC. Все ручные правки в reconciler-UI тоже стираются.
Когда кнопка «Очистить» НЕ нужна:

10. Решение проблем

Программа не запускается / Windows блокирует

1. Защитник Windows: «Подробнее» → «Выполнить в любом случае» (см. п. 1.3).

2. Антивирус (Kaspersky, ESET и др.): добавь silver-sync.exe в исключения.

3. SmartScreen скачал какой-то «обрезок» — удали файл, скачай заново.

Сообщение «scanned N files / to upload: 0», хотя файлы новые

Программа думает, что все эти файлы уже отправлены раньше. Самое простое решение — нажми кнопку «🗑 Очистить тестовые данные» в Silver Sync. Она сделает всё автоматически: удалит данные с сервера, удалит локальный кэш и папку __renamed__. После этого жми SYNC — программа отправит все файлы как новые.

Если кнопка «Очистить» не помогла, или ты не хочешь удалять данные на сервере (нужно очистить только локальный кэш), сделай так руками:

  1. Закрой окно Silver Sync (важно: пока программа открыта, она держит файл).
  2. На клавиатуре нажми клавишу с логотипом Windows и одновременно клавишу R (это две физические клавиши: Win + R). Появится маленькое окно «Выполнить» внизу слева экрана.
  3. В этом окне в поле ввода напечатай или вставь точно следующее:
    %APPDATA%\Silver
    Это специальный путь Windows к скрытой системной папке. Сейчас введи именно так, со знаками процента.
  4. Нажми Enter или кнопку «ОК». Откроется Проводник Windows в нужной папке.
  5. В открывшейся папке найди файл cache.db. Правый клик по нему → «Удалить». Подтверди удаление.
  6. Закрой Проводник.
  7. Снова запусти silver-sync.exe (двойной клик).
  8. Нажми SYNC. Теперь программа отправит все файлы заново — они для неё все новые.
Где этот файл физически: C:\Users\<твой_логин>\AppData\Roaming\Silver\cache.db. Папка AppData по умолчанию скрыта в Проводнике — поэтому нужен трюк с Win+R. Сам Проводник её не покажет.
Ошибка «401 Unauthorized»

Токен неправильный или сервер обновил токен. Напиши Вадиму, попроси актуальный токен. Вставь в поле «Токен», нажми SYNC ещё раз.

Ошибка «413 Request Entity Too Large»

Это проблема настройки сервера. Сразу пиши Вадиму — он подкрутит лимит. Сам ничего сделать не можешь.

Ошибка «502 Bad Gateway» / «Connection refused» / «Timeout»

Сервер временно недоступен (рестарт, обновление и т.п.). Подожди 1–2 минуты, нажми SYNC ещё раз. Программа продолжит с того места, где остановилась.

SYNC висит часами на «pending=N» — N не уменьшается

1. Проверь интернет — пинг до silver-report.6sl.ru работает?

2. ИИ может быть перегружен (API Anthropic). Подожди ещё час.

3. Если уже сутки висит — напиши Вадиму. Что-то на сервере (нет API-ключа, не запущен grouper и т.п.).

Закрыть окно и нажать SYNC заново всегда безопасно — программа подхватит план как только pending=0.

Папка __renamed__ пустая или её нет

1. Где смотришь? Папка лежит рядом с input-папкой, не внутри. Если input — C:\Silver\input\, то __renamed__ в C:\Silver\, не в C:\Silver\input\.

2. Дождался ли «done.» в логе? До этого папку не смотри — она пустая в процессе работы.

3. В логе была ошибка? Прокрути его вверх, найди красные строки или «sync failed».

Я отправил не те файлы / хочу начать заново

Нажми кнопку «🗑 Очистить тестовые данные (необратимо)» в Silver Sync. Программа сделает всё за тебя: удалит данные с сервера, локальный кэш, папку __renamed__. Справочник артикулов сохранится. Подробнее — в разделе «Очистка тестовых данных перед началом работы».

После очистки положи в input-папку правильные файлы и нажми SYNC.

Если кнопка не работает или ты хочешь дополнительно удалить и справочник тоже — напиши Вадиму.

Я хочу пересобрать только один артикул (добавил/удалил фото у него)

Просто положи/удали файл в input-папке и нажми SYNC. Программа поймёт изменения по этому артикулу и перезапустит ИИ только для него. Остальные не трогаются.

Внимание: если ты раньше делал ручные правки этого артикула на сайте (кнопками reconciler'а) — они сотрутся при переобработке. Придётся проставить заново. Это известный момент, без него никак.

Сайт открывается, но артикулов нет / отчёт пустой

1. Жми Ctrl+F5 — обнови без кэша.

2. Если всё равно пусто — возможно сервер ещё пересобирает отчёт. Подожди минуту, обнови.

3. Если в программе было «plan: 0 articles» — значит ни один артикул не дошёл до ИИ. Проверь имена файлов (должны содержать артикулы из справочника).

«Справочник пуст» / «total=0» / SYNC говорит «plan: 0 articles»

1. Загружен ли справочник? Открой сайт silver-report.6sl.ru, посмотри сколько артикулов в шапке. Если 0 — нажми в программе «Загрузить справочник артикулов (Excel)» и выбери свой xlsx.

2. Если справочник загружен, но фото не привязались к артикулам — проверь имена файлов. Артикул из справочника должен быть частью имени файла.

Ошибка при загрузке справочника: «Нет колонки 'article'»

В первой строке Excel-файла должна быть колонка с заголовком article (можно с большой или маленькой буквы). Если у тебя по-другому — переименуй колонку в Excel, сохрани, попробуй ещё раз.

Загрузил справочник, но «Добавлено: 0»

Это нормально, если все артикулы из Excel уже были на сервере. «Уже было: N» в сообщении подтверждает, что новых не нашлось.

Если ты ОЖИДАЛ, что добавятся новые — проверь Excel-файл. Возможно ты открыл не ту версию, или новые артикулы написаны с опечаткой и они не совпадают с уже существующими.

Программа показала «на сервере есть N артикулов, которых нет в твоём файле»

Это не ошибка, просто информация. Программа никогда не удаляет артикулы автоматически, потому что на них могут быть фото и история ручных правок.

Если эти артикулы действительно надо убрать (например, ты их давно списал из каталога) — напиши Вадиму со списком, он удалит их вручную из БД. До этого они останутся на сайте.

Хочу понять, какая версия справочника сейчас на сервере

В Silver Sync нажми «Проверить справочник на сервере» — внизу окна появится количество артикулов. Сравни с числом строк в свежем Excel.

Не могу скопировать токен через Ctrl+V

Используй кнопку «Вставить» справа от поля «Токен». Она работает в любой раскладке клавиатуры (русской/английской).

Файл с артикулом из справочника, но программа сказала «to upload» = 0

Возможно файл уже отправлялся раньше. Программа определяет «новизну» по содержимому файла, не по имени — если файл-копия уже на сервере, он не отправляется снова.

Это нормальное поведение. Артикул должен уже быть на сайте.

Я переименовал файл в input-папке — что будет?

Если содержимое то же самое — программа поймёт что это тот же файл и не будет переотправлять. Артикул на сайте останется как был.

Если ты переименовал и одновременно изменил содержимое (например, заменил фото) — программа считает что новое фото, отправит, ИИ переобработает артикул.


Если что-то непонятно или не получается — пиши Вадиму с описанием шага и (если есть) скриншотом окна программы или сайта.

← вернуться к отчёту