ZCode Russifier — русификатор ZCode Desktop

Русский | English

Неофициальный русификатор интерфейса ZCode Desktop (десктопное приложение ZCode для Windows). Приложение официально поддерживает только английский и китайский языки; этот скрипт добавляет русский, заменяя английские строки интерфейса на русские прямо внутри app.asar.

EN summary: unofficial Russian UI translation (russifier) for ZCode Desktop on Windows. It patches app.asar so the built-in English locale renders in Russian — 6100 of 6114 UI strings translated. Requires Node.js 18+: node russify.js. Rollback: update or reinstall ZCode.

Переведено 6100 из 6114 строк каталога интерфейса (v3.14.0) — по сути полный перевод. Не русифицированы намеренно только: названия тарифов (Lite, Pro, Max), подписи языков в переключателе и строки, уходящие модели (описания навыков, служебные промпты агента). Основные разделы:

• боковая панель, список задач и группы;
• чат: поле ввода, действия с сообщениями, приветствия, карточки предпросмотра;
• меню приложения, командный центр и палитра команд;
• режимы агента (План, Автоправки, Полный доступ и т.д.);
• настройки целиком: модели и провайдеры, MCP-серверы, Coding Plan и оплата, навыки, субагенты, плагины, команды, хуки, браузер, память, индексация, Computer Use;
• автоматизации (задачи по расписанию) и задачи простоя;
• мобильное удалённое управление, страница ботов (Telegram / Weixin / Feishu / вебхуки);
• карточки шаблонов автоматизаций и задач простоя (Standup Git Summary, Risk scan, Release brief и др. — приходят с сервера, русифицируются через словарь по заголовку и началу описания);
• SSH- и WSL-подключение, нативное меню, диалоги обновлений и «О программе».

Намеренно не переводятся: строки, которые отправляются модели (описания навыков, служебные промпты агента), чтобы не влиять на качество работы ИИ, а также названия тарифов и сервисов (Lite, Pro, Telegram и т.п.).

⚠️ Важно

• Русификатор — это модификация файлов приложения. Делаете на свой страх и риск.
• Автообновление ZCode затирает русификацию. После каждого обновления просто запустите скрипт ещё раз.
• Откат в любой момент: обновите или переустановите ZCode — установщик сам вернёт оригинальный app.asar.
• Проверено на версиях 3.11.2, 3.12.3, 3.14.0 и 3.14.1 (Windows x64). Скрипт ищет нужные чанки по маскам, поэтому часто подходит и для соседних версий; при существенных изменениях структуры он сообщит об этом.

---

Требования

• Windows
• Node.js 18 или новее (node -v — чтобы проверить)
• Установленный ZCode Desktop

Установка русского языка

Требуется Node.js 18+ (node -v — проверить). Скачайте репозиторий (кнопка Code → Download ZIP, распакуйте) или склонируйте:

git clone https://github.com/xISPx/zcode-russifier.git
cd zcode-russifier

Затем одна команда:

node russify.js

Скрипт сам найдёт ZCode в %LOCALAPPDATA%\Programs\ZCode, пропатчит app.asar и напечатает отчёт. Перезапустите ZCode — интерфейс станет русским.

Если ZCode установлен в нестандартное место, укажите путь вторым аргументом:

node russify.js "D:\Programs\ZCode"

Закрывать ZCode перед запуском не обязательно: скрипт умеет перезаписывать архив поверх работающего приложения (русский появится после перезапуска).

В Windows можно просто дважды щёлкнуть run.cmd — он делает то же самое, что и node russify.js (нужен Node в PATH).

Установщик .exe (для своих сборок)

Готовый .exe не распространяется. При желании его можно собрать самому по рецепту installer/russifier.sed — пакет собирается встроенным в Windows IExpress и включает свой node.exe, поэтому готовый установщик работает на машине без Node:

iexpress /N installer\russifier.sed

Как это работает

В приложении два языка интерфейса — en-US и zh-CN — и жёсткая логика «системный язык начинается на zh → китайский, иначе английский». Отдельного файла локали нет, строки вкомпилированы в минифицированный код. Поэтому русификатор:

1. разбирает заголовок app.asar и находит каталог строк рендерера (чанк IntlProvider-*.js), карту нативного меню и диалоги главного процесса;
2. заменяет английские значения на русские из папки translations (плейсхолдеры вида {count} проверяются — перевод с несовпадающими подстановками отбрасывается);
3. пересчитывает контрольные суммы SHA-256 изменённых файлов и дописывает их в конец архива, сохраняя позиции всех остальных файлов;
4. подменяет app.asar (если приложение держит файл — перезаписывает поверх, старая разметка остаётся совместимой).

Настройку языка в приложении менять не нужно: русифицируется именно английская локаль, она и включена по умолчанию.

Откат

Любой из способов:

• обновить ZCode (Справка → Проверить обновления) — установщик восстановит оригинальный архив;
• переустановить ZCode.

После обновления ZCode

Русификация слетит — это нормально. Скачайте актуальную версию репозитория и снова выполните node russify.js. Если разработчики существенно изменят внутреннюю структуру приложения, скрипт сообщит «не найден чанк…» — тогда потребуется обновление самого русификатора (следите за issues).

Структура репозитория

russify.js           — скрипт русификации (запускать его)
run.cmd              — то же самое двойным щелчком (нужен Node в PATH)
translations/        — словари перевода (JSON: ключ → русская строка)
installer/           — рецепт сборки setup-.exe (IExpress)
screenshots/         — иллюстрации для README

Словари можно пополнять: возьмите недостающий ключ из каталога (скрипт печатает общее число строк) и добавьте "ключ": "перевод" в любой JSON из translations/. Переводится только интерфейс; строки для модели сознательно оставлены английскими.

Частые проблемы

• «Не найден app.asar» — ZCode установлен в другое место, передайте путь аргументом.
• «Контрольные суммы не совпали» — версия приложения сильно отличается; заведите issue.
• После запуска ничего не изменилось — перезапустите ZCode полностью (иконка в трее → Выйти, затем запустить).
• Часть строк осталась английской — так и задумано: это бренды (Lite, Pro, Telegram…), подписи языков и служебные строки для модели, которые специально не русифицируются. Новые функции, добавленные разработчиками после релиза русификатора, появляются на английском до обновления словарей.

Лицензия

MIT. ZCode является товарным знаком своих владельцев; проект не связан с разработчиками ZCode.