CLI-команды¶

RimLoc CLI — детерминированный/headless интерфейс того же Rust toolchain, который используется desktop-приложением.

PO — опционально

PO — формат обмена. Это не каноническая модель проекта RimLoc. Desktop workflow редактирует project state напрямую, а CLI умеет собирать мод и из готового Languages-дерева.

Типовые сценарии¶

Scan и validate¶

rimloc-cli scan --root ./Mods/MyMod --format json
rimloc-cli validate --root ./Mods/MyMod

Внешний CAT / PO handoff¶

rimloc-cli export-po --root ./Mods/MyMod --out-po ./work/MyMod.po --lang ru
rimloc-cli validate-po --po ./work/MyMod.po --strict
rimloc-cli import-po --po ./work/MyMod.po --mod-root ./work/MyMod-copy --lang ru --dry-run

Build без PO¶

rimloc-cli build-mod \
  --from-root ./work/MyTranslatedMod \
  --out-mod ./dist/MyTranslatedMod-RU \
  --lang ru \
  --dry-run

Это напрямую упаковывает уже существующее переведённое Languages-дерево.

Основные команды¶

Команда	Назначение
scan	найти translation units
validate	проверить XML/translation state
validate-po	проверить PO handoff
export-po / import-po	опциональный PO interoperability
build-mod	собрать translation-only мод из PO или Languages
diff-xml	source/translation diff и source changes
annotate	комментарии с source text
xml-health	проверки XML
morph	morphology providers
init	translation skeleton
lang-update	update language workflow

В binary есть и дополнительные advanced/developer команды (compare/doctor/schema/translate/wordinfo/version-diff/learning helpers). Отдельные страницы для них дополняются; текущая executable truth — rimloc-cli --help и rimloc-cli <command> --help.

Общие опции¶

Часто используются:

--ui-lang <LANG> — язык CLI;
--no-color — plain output;
--quiet — меньше служебного stdout.

Безопасность¶

Часть старых CLI-команд появилась до новой canonical project model. Для write-команд:

используйте копию или отдельный output;
сначала запускайте --dry-run, если он поддерживается;
держите game/Workshop source read-only;
проверяйте command-specific help.