Skillget

zcode-ru-localization

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Fail
  • exec() — Shell command execution in patch.mjs
  • fs.rmSync — Destructive file system operation in patch.mjs
  • new Function() — Dynamic code execution via Function constructor in pipeline/03-extract-catalog.mjs
  • exec() — Shell command execution in pipeline/03-extract-catalog.mjs
  • process.env — Environment variable access in pipeline/05-next-version.mjs
  • network request — Outbound network request in pipeline/05-next-version.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Русификатор ZCode Desktop — неофициальная ru-RU локализация для любой версии. Unofficial Russian localization for ZCode Desktop.

README.md

-------> Russian | English | Spanish | Chinese | <-------

ZCode Desktop Russian Localization

Unofficial Russian (ru-RU) localization for ZCode Desktop, a GUI client for an
AI coding agent. The official app ships with English and Chinese only; this
project adds a full Russian UI: settings, menus, dialogs, tray, About window
(~4,900 strings).

Works with any version of the app: the installer extracts app.asar,
locates the needed files by code signatures, and applies patches. Untranslated
strings from newer versions simply show in English — nothing breaks.

Installation (automatic)

  1. Fully quit ZCode (including the tray icon).
  2. Download the archive from the Releases page (file
    zcode-ru-localization-vX.X.X.zip), unpack it, and run
    РусификаторZCode.exe.
  3. Pick your ZCode folder → click "Install Russian language".
  4. Start ZCode — the UI is now in Russian.

A GUI-free alternative is PowerShell:

powershell -ExecutionPolicy Bypass -File install-ru.ps1 [-InstallDir "C:\path\to\ZCode"]

Requirements: Node.js in PATH.

Rollback

Click "Rollback" in the program, or manually: delete resources\app and
rename resources\app.asar.orig back to resources\app.asar.

After updating ZCode

An app update restores English. Just run the installer again — it re-applies
the patch to the new version. Strings that are not yet translated show in
English.

How it works

  • Electron loads a resources/app directory instead of app.asar when it
    exists. The installer does not repack the archive; it places the patched
    folder next to it (the original is kept as app.asar.orig).
  • patch.mjs locates the message catalog by its signature
    g={"zh-CN":…,"en-US":…} (file names change between versions), injects the
    Russian catalog, adds ru-RU to validation schemas, language pickers, and
    the tray/About catalogs.
  • Before installing, the patcher syntax-checks the patched files; on any error
    the installation is aborted and the app remains untouched.

Contributing translations

All strings live in ru.json (key → text). Found an untranslated
string? Add the pair and rerun the installer. Never alter placeholder tokens
({version}, {count}).

Building the installer from source

The exe compiles with the .NET Framework compiler that ships with Windows —
nothing to install. Run Build.bat or:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe -nologo -target:winexe -out:"РусификаторZCode.exe" InstallRu.cs -r:System.Windows.Forms.dll -r:System.Drawing.dll

The exe expects patch.mjs, ru.json, and node_modules
(npm install @electron/asar) next to it.

Disclaimer

Unofficial project, not affiliated with the ZCode developers. Only
localization files on your machine are patched. The author is not liable for
any issues — you can always roll back (see above).

License

MIT

Reviews (0)

No results found