ZCode RU Patcher

Неофициальная русификация ZCode под Windows.
Патчер устанавливает русский интерфейс, сохраняет резервную копию и умеет откатывать изменения.

Скачать патч · Смотреть полное MP4-демо · Legal Notice · Официальный сайт ZCode

---

Скриншот русификатора

О проекте

ZCode RU Patcher - это компактный Windows-патчер для русификации ZCode. Он находит установленное приложение, создаёт резервную копию resources/app.asar, добавляет русский словарь и применяет дополнительные замены строк интерфейса.

Проект не связан с разработчиками ZCode и не является официальным продуктом Z.ai. Используйте патчер на свой риск и сохраняйте резервные копии важных данных.

Как установить

1. Установите ZCode с официального сайта.
2. Если требуется обновить IDE - обновите её перед установкой патча.
3. Скачайте патч из Releases, запустите его и пропатчите ZCode.
4. Дождитесь завершения процесса. Не запускайте ZCode и не мешайте патчеру, пока установка не закончится.

После каждого обновления ZCode патч придётся установить заново.

Что нового в v6.4.0

• Переведены карточки, фильтры, категории и действия каталога плагинов.
• Переведены описания навыков, субагентов и плагинов из кешей .zcode и .codex, включая источники Claude Code.
• Добавлен безопасный запасной русский текст для новых описаний, которые отсутствуют в статическом словаре.
• Исправлены смешанные русско-китайские строки: выбор проекта, режим разрешений, фоновая работа, таймеры и подписи задач.
• Исправлена упаковка внутреннего app.asar: в него включены node_modules/@electron/asar и все зависимости, необходимые для запуска патчера.
• В окне программы, свойствах EXE, имени файла и вложенном приложении указана единая версия v6.4.0.
• Патчер пересобран как ZCode-Ru-Patcher-v6.4.0.exe.

Полный changelog: CHANGELOG.md.

Что умеет

Автопоиск ZCode	Проверяет стандартные папки установки Windows и подставляет найденный путь.
Ручной выбор	Позволяет указать папку ZCode или файл app.asar вручную.
Русская локаль	Внедряет ru-RU.json и переключает интерфейс на русский язык.
Дополнительные замены	Переводит часть захардкоженных китайских и английских строк.
Безопасный откат	Создаёт app.asar.ru-backup и восстанавливает исходный файл из интерфейса.
Прогресс установки	Показывает этапы распаковки, патчинга и пересборки ASAR.

Скачать

Готовый патч находится в разделе Releases:

ZCode-Ru-Patcher-v6.4.0.exe

SHA256:

B45A931E5ED7BC7DF02151FEA04A5DD4AFBEFF1274BBAA4041F66636EF498AA0

Ссылка: https://github.com/Leostrange/zcode-ru-patcher/releases/tag/v6.4.0

Технологии

Слой	Используется
Desktop UI	Electron
Runtime	Node.js
Патчинг	@electron/asar, файловые API Node.js
Интерфейс	HTML, CSS, JavaScript
Установщик	NSIS
Платформа	Windows

Структура

main.js                  Electron main process и IPC
preload.js               Безопасный мост renderer -> main
renderer.js              Логика интерфейса, прогресса и кнопок
patch-core.js            Обнаружение ZCode, патчинг ASAR, откат
ru-RU.json               Русский словарь интерфейса
sfx_installer.nsi        Параметризованная NSIS-сборка self-extractor
build-patcher.nsi        Минимальный правильный NSIS self-extractor
assets/Russian_UI_ZCode.mp4
assets/Russian_UI_ZCode_preview.gif
assets/zcode-ru-patcher-screenshot.png

Запуск из исходников

npm install
npm start

Правильная сборка

Это патчер, а не обычный установщик. Его нельзя собирать как installer:

• не использовать InstallDir;
• не писать путь установки в реестр;
• не показывать страницы выбора папки;
• не распаковывать приложение в AppData\Local\ZCode-RuPatcher;
• не требовать RequestExecutionLevel admin без необходимости.

Правильная схема сборки:

1. NSIS работает как тихий self-extractor.
2. Payload распаковывается только во временный $PLUGINSDIR\app.
3. Запускается "$PLUGINSDIR\app\ZCodeRuPatcher.exe".
4. После завершения временная папка очищается.

Рабочий минимальный скрипт: build-patcher.nsi. Параметризованный вариант для подготовленного runtime:

makensis /DPATCHER_DIR="C:\path\to\prepared\patcher" sfx_installer.nsi

Лицензия

Исходный код патчера распространяется по лицензии MIT:

• LICENSE - оригинальный английский текст.
• LICENSE.ru.md - русский перевод.

Юридическое уведомление доступно в LEGAL_NOTICE.md. ZCode, Electron, Chromium, NSIS и другие сторонние компоненты распространяются на условиях их собственных лицензий. Этот репозиторий не передаёт права на ZCode и не включает официальную лицензию Z.ai.