Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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 такую проверку не заменяет.
Loading