diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..0a8c9d1 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,26 @@ +# Разработка RuEn + +RuEn обеспечивает русскую раскладку для существующих клавиатурных сокращений Autodesk Fusion. + +## Общие правила 4FusionLab + +- Общие стандарты: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; модель совместного CI: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md. +- Общайся с пользователем и составляй планы на русском; названия команд, код и пользовательский интерфейс Fusion — на английском. Сохраняй независимые README.md и README.ru.md, если это есть в проекте. +- Перед изменениями изучай текущий код и `git status`; сохраняй несвязанные изменения. Используй Conventional Commits; небольшие PR с тестами предпочтительны, но прямой push в `main` разрешён существующей политикой. +- Не меняй UUID Fusion manifest, IDs команд, поддержку ОС и структуру дистрибутива без отдельной задачи и миграционного плана. Никаких секретов, личных CAD-файлов, токенов или несанкционированных внешних сервисов в репозитории. +- Где есть распространяемый runtime, релиз запускает только push/merge в `main`, затронувший `.github/release-paths.txt`. CI проверяет код, GitVersion.Tool 6.8.2 вычисляет версию, GitHub автоматически создаёт тег и Release. **Никогда не создавай или не передвигай релизные теги вручную** и не перезаписывай опубликованные ZIP. +- README, docs, тесты, настройки CI и `AGENTS.md` сами по себе не должны запускать релиз. Общие Actions подключай по **неизменяемому commit SHA** из `4FusionLab/.github`, не по `@main`. +- Unit-тесты и проверка ZIP — не то же самое, что живые испытания Autodesk Fusion. Для API/UX фиксируй, что действительно тестировалось и на какой ОС. + +## Платформенная совместимость + +- `RuEn/RuEn.py` и `RuEn/hotkeys.py` обрабатывают зарегистрированные хоткеи Fusion; нативные `RuEn/libruen_v2.dylib` (macOS Apple Silicon) и `RuEn/ruen_filter.dll` (Windows x64) входят в пакет. +- `native/ruen_filter.cpp` и скрипты `scripts/build_macos.sh`, `scripts/build_windows.ps1` — исходники сборки нативных библиотек. Их изменения сами по себе ещё не меняют доставляемый продукт: сначала пересобери и проверь соответствующие DLL/dylib. +- Работа с `QTCanvas` использует внутренний Qt API; документируй риск несовместимости с версиями Autodesk Fusion, не утверждай, что это публичный стабильный SDK. +- Не меняй устоявшееся поведение пользовательских hotkey mappings, сочетаний с модификаторами и механизм включения/отключения фильтра без тестов. Не меняй существующий UUID после RuEnProbe. + +## Проверка + +- `python -m unittest discover -s tests -v` +- `python scripts/package.py --version X.Y.Z`; результат — universal/macos/windows ZIP и SHA-256, а не новая компиляция DLL/dylib. +- Для Qt и клавиатурного поведения нужны нативные проверки на соответствующей платформе; Linux CI такую проверку не заменяет.