Appearance Restore

Локальный помощник для восстановления оформления VS Code после обновления. Использует уже установленные Vibrancy Continued, Smooth UI, Doki Theme, Custom CSS and JS и, по отдельному выбору, Fix Checksums Next. Имеет собственную иконку и русский/английский интерфейс.

Установка и использование

1. В VS Code откройте Extensions: Install from VSIX и выберите собранный VSIX.
2. В палитре команд найдите Appearance Restore: Восстановить оформление (Restore Appearance в английском интерфейсе).
3. Выберите компоненты, подтвердите запуск и дождитесь окончания.
4. Если задан doki.sticker.path, кастомный стикер подключается автоматически из этого файла, без скачивания картинок Doki и без дополнительного диалога. Если кастомного пути нет, используется обычное восстановление Doki: дождитесь его сообщения и подтвердите завершение. При ошибке нажмите «Остановить».
5. Сохраните файлы, закройте все окна VS Code и откройте редактор заново.

Во время работы закрывайте уведомления сторонних плагинов о перезапуске, не запускайте перезапуск до окончания всех шагов.

После первого запуска помощник запоминает версии редактора и плагинов. При изменении версий появляется предложение восстановить оформление. Кнопка «Позже» откладывает напоминание на сутки. Автоматических патчей нет.

Что сохраняется

Перед запуском команд в globalStorage помощника создаётся отдельная копия основных файлов VS Code с их путями, версией редактора и SHA-256. Сохраняются также прежние CSS/JS-импорты пользователя. Изображение стикера встраивается в управляемый скрипт в globalStorage; исходный файл не меняется. Команда Appearance Restore: Открыть резервные копии открывает эту папку. Это снимок основных файлов, а не полный установщик и не гарантия отката всех изменений стороннего плагина. Старые копии автоматически не удаляются.

Помощник не заменяет файлы редактора самостоятельно, не восстанавливает старые файлы поверх новой версии, не запускает оболочки, не требует администратора, не отправляет данные и не перезапускает VS Code. Сторонние плагины могут показывать собственные запросы и уведомления.

Fix Checksums по умолчанию не выбран: он пересчитывает контрольные суммы, а не восстанавливает оформление. Его можно явно добавить последним шагом. Оформление нельзя гарантировать при несовместимости плагинов с новой версией.

Smooth UI и кастомный стикер

• Выберите Smooth UI в мастере. Он автоматически добавляет шаг Custom CSS, определяет активную установленную версию Smooth UI, заменяет её устаревшие импорты и подключает оба файла: CSS и JavaScript. Чужие импорты сохраняются.
• Используется тот же формат путей, что у самого Smooth UI: при следующем старте оно не добавит повторную копию JavaScript. Стили и код Smooth UI не изменяются. Его CSS может обращаться к внешним шрифтам, как и при обычной установке.
• Для локального стикера используются настройки User doki.sticker.path и doki.sticker.css. Поддерживаются PNG/JPEG/GIF/WebP до 16 МБ. Картинка не пересжимается, положение и размер берутся из безопасных CSS-свойств Doki.
• Для кастомного стикера сеть не нужна: это локальный слой совместимости через Custom CSS Loader, а не вызов сетевого установщика картинок Doki. Сам Doki может независимо обращаться к сети при собственной активации.
• Стикер не перехватывает клики. Он появляется после загрузки рабочей области и не дублируется при повторном выполнении скрипта.
• После команды Loader проверяется реальное содержимое workbench HTML: оба исходных файла Smooth UI и полный скрипт кастомного стикера должны быть встроены. При тихой ошибке Loader успех не отмечается. Если CSS ещё не применён, помощник отменяет собственное изменение импортов, не затирая чужие правки.

Переход с локальной версии на Marketplace

Если после перехода с zxckurayami-local на zxckurayami появилась ошибка отсутствующего doki-sticker-*.js, запустите восстановление и выберите Doki Theme. При заданном doki.sticker.path стикер будет создан из исходной картинки в новом хранилище. Для устаревших стилей выберите Smooth UI. Старое хранилище может уже отсутствовать: восстанавливать его вручную не требуется. Исправляются только созданные помощником файлы в хранилище прежнего издателя этого же профиля. Посторонние импорты и оригинальные изображения не изменяются. Обновление расширения само по себе не меняет настройки и не запускает восстановление.

Ограничения

• Помощник не устанавливает и не включает отключённые расширения.
• Нужна доверенная локальная рабочая область и доступная на запись установка.
• Workspace-настройки оформления не должны переопределять User-настройки.
• Custom CSS: разрешены существующие локальные CSS/JS file-URL без переменных. Удалённые импорты помощник не загружает. После подтверждения изменяются только User-импорты CSS/JS. Прежние значения сохраняются в manifest.json резервной копии; остальные настройки, CSS/JS и исходные картинки не меняются.
• Сбой или ручной перезапуск в середине операции может оставить restore.lock. В этом случае закройте все окна VS Code, удалите только restore.lock в globalStorage этого помощника и откройте VS Code заново. Не удаляйте backups.
• Восстановление не проверяет визуальное совпадение темы: это нужно проверить после полного перезапуска. Запущенные команды могут обрабатывать свои ошибки через собственные уведомления, не выбрасывая исключение в помощник.

Разработка

Runtime-зависимостей нет. npm test запускает проверки на Node.js. npm run package собирает локальный VSIX через официальный @vscode/vsce.

English

Run Appearance Restore: Restore Appearance, select installed components and confirm. Dismiss third-party restart notices until every step finishes. Doki's standard restoration runs in the background, so acknowledge that step only after it succeeds. A configured local Doki sticker is instead connected offline through Custom CSS automatically. Select Smooth UI to repair its current CSS/JS imports. Then save your work, close every editor window and reopen VS Code.

The helper detects editor/extension version changes, offers restoration and backs up critical editor files first. No automatic patching, shell commands, telemetry, extension installation or forced restarts. Fix Checksums is opt-in. Third-party compatibility and visual results cannot be guaranteed. For an interrupted operation, close all editor windows before removing only the helper's restore.lock; keep its backups. Never copy old editor files over a new version. User CSS imports can change only after confirmation, with their previous values saved in the backup manifest. Original image and Smooth UI files are unchanged.

After moving from the former local publisher to the Marketplace version, select Doki Theme to regenerate a custom sticker from doki.sticker.path, or Smooth UI to repair its generated imports. The old storage may already be deleted. Only known generated paths in the same profile are replaced; unrelated imports stay.