From 143778924237a3625d95fe0b68b2ed15415623fc Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 15:55:32 +0300 Subject: [PATCH 1/3] docs: translate release policy --- .github/RELEASE_POLICY.md | 2 ++ .github/RELEASE_POLICY.ru.md | 29 +++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) create mode 100644 .github/RELEASE_POLICY.ru.md diff --git a/.github/RELEASE_POLICY.md b/.github/RELEASE_POLICY.md index 5c9bd02..3201d5c 100644 --- a/.github/RELEASE_POLICY.md +++ b/.github/RELEASE_POLICY.md @@ -1,5 +1,7 @@ # 4FusionLab — automatic runtime release policy +[Русская версия](RELEASE_POLICY.ru.md) + ## Trigger - A direct push to `main` or a PR merge into `main` is the only normal release event. PR checks, manual CI dispatch and version-tag pushes **do not** initiate publication. diff --git a/.github/RELEASE_POLICY.ru.md b/.github/RELEASE_POLICY.ru.md new file mode 100644 index 0000000..1aba806 --- /dev/null +++ b/.github/RELEASE_POLICY.ru.md @@ -0,0 +1,29 @@ +# 4FusionLab — политика автоматических релизов исполняемых компонентов + +[English](RELEASE_POLICY.md) + +## Запуск + +- Прямой push в `main` или объединение PR в `main` — единственное обычное событие релиза. Проверки PR, ручной запуск CI и отправка тегов версий **не** запускают публикацию. +- Перед публикацией сравнивайте `GITHUB_SHA` с последним **опубликованным** тегом GitHub Release, являющимся предком `main`. Если ZIP-релизов нет, используйте исходный диапазон push `github.event.before..GITHUB_SHA`. Удалённые и переименованные исполняемые файлы по-прежнему дают право на релиз. +- `.github/release-paths.txt` репозитория остаётся проверенным перечнем путей релиза. Изменения только README, руководств, тестов и CI **сами по себе не создают релиз**. Push только документации может восстановить ранее неудавшийся выпуск, если подходящие изменения после последнего опубликованного тега ещё не выпущены. +- Перед публикацией должны пройти все обязательные существующие проверки CI. При отказе проверки нет релиза, изменяемого тега и замены артефактов. + +## Версия и распространение + +- GitVersion.Tool **6.8.2** определяет числовую версию `MAJOR.MINOR.PATCH` по `GitVersion.yml` и полной истории Git. ZIP пакета, встроенный манифест Fusion (где применимо), автоматически созданный неизменяемый тег `vMAJOR.MINOR.PATCH` и GitHub Release соответствуют одному коммиту и версии. +- Конвейер создаёт тег **автоматически** при публикации GitHub Release. Участники никогда не создают и не отправляют теги релиза вручную. Существующий тег версии, указывающий на другой коммит, считается ошибкой; опубликованный релиз никогда не перезаписывается. +- При наличии используются проверенные заметки конкретной версии; иначе они автоматически создаются из истории Git. Подготовка файла заметок вручную только для выпуска изменения кода не требуется. +- Стабильные релизы становятся Latest. Предварительные выпуски никогда не становятся Latest. Проектные требования к нативной CAD-приёмке, тестам, подписанным архивам и контрольным суммам, совместимости ОС и публикации продолжают действовать. + +## Этот репозиторий + +Перечень исполняемых файлов: `RuEn/**` (включая поставляемые нативные бинарные DLL/dylib) и `scripts/package.py`. Изменения только нативных исходников или сценариев сборки не влияют на распространяемые бинарные файлы, пока последние не пересобраны и не закоммичены. Проверьте ZIP трёх платформ и целостность контрольных сумм. + +Если после последнего опубликованного релиза не изменились подходящие входные исполняемые файлы, CI может запуститься, но публикация пропускается, даже если GitVersion вычислит другую версию. После сбоя следующая отправка в `main` повторяет публикацию после успешного прохождения обычных проверок CI; опубликованные теги и артефакты никогда не перезаписываются. + +## Общие Actions релизов + +Переиспользуемые Actions GitVersion/изменений/заметок/ZIP только для чтения закреплены за коммитом `ad9d60ba4aabc494b4f2c85d6c566a50ca423751` репозитория `4FusionLab/.github`. RuEn сохраняет упаковку нативных DLL/dylib, ZIP нескольких ОС и workflow публикации неизменяемого GitHub Release. Неиспользуемые дублирующиеся помощники выведены из эксплуатации. + +**Платформа восстановления:** классификатор опубликованных релизов отдельно закреплён за `2e961620a068c3ad754f6e1be05fb6e4ac68e843` с `recover-unpublished: 'true'` и `github.token` только для чтения. Остальные общие Actions сохраняют проверенное закрепление `ad9d60ba4aabc494b4f2c85d6c566a50ca423751`. From 01668857fa7cd637772fe9f200495fd64f6a8e94 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:11:46 +0300 Subject: [PATCH 2/3] docs: provide bilingual release notes --- RELEASE_NOTES.md | 6 ++++-- RELEASE_NOTES.ru.md | 7 +++++++ 2 files changed, 11 insertions(+), 2 deletions(-) create mode 100644 RELEASE_NOTES.ru.md diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index c792398..659fdcd 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,5 +1,7 @@ # RuEn 1.0.0 -RuEn помогает использовать назначенные буквенные горячие клавиши Autodesk Fusion при русской раскладке. Релиз поддерживает macOS Apple Silicon и Windows x64 и включает универсальный архив с автоматическим выбором библиотеки и отдельные архивы для каждой платформы. +[Русская версия](RELEASE_NOTES.ru.md) -Папка и точка входа переименованы из RuEnProbe в RuEn; идентификатор manifest сохранён. При обновлении остановите старый аддин и отключите его автозапуск перед добавлением нового. Включите **Run on Startup** в Fusion. +RuEn helps you use assigned Autodesk Fusion letter shortcuts with the Russian keyboard layout. This release supports macOS Apple Silicon and Windows x64 and includes a universal archive that selects the library automatically, plus separate archives for each platform. + +The folder and entry point were renamed from RuEnProbe to RuEn; the manifest identifier is unchanged. When upgrading, stop the old add-in and disable its automatic startup before adding the new one. Enable **Run on Startup** in Fusion. diff --git a/RELEASE_NOTES.ru.md b/RELEASE_NOTES.ru.md new file mode 100644 index 0000000..8968f64 --- /dev/null +++ b/RELEASE_NOTES.ru.md @@ -0,0 +1,7 @@ +# RuEn 1.0.0 + +[English](RELEASE_NOTES.md) + +RuEn помогает использовать назначенные буквенные горячие клавиши Autodesk Fusion при русской раскладке. Релиз поддерживает macOS Apple Silicon и Windows x64 и включает универсальный архив с автоматическим выбором библиотеки и отдельные архивы для каждой платформы. + +Папка и точка входа переименованы из RuEnProbe в RuEn; идентификатор manifest сохранён. При обновлении остановите старый аддин и отключите его автозапуск перед добавлением нового. Включите **Run on Startup** в Fusion. From 8ff2aa5ff8e31d2bcd605a59ccc54fa9222462d3 Mon Sep 17 00:00:00 2001 From: Pavel Kuznetsov Date: Sat, 7 Nov 2026 16:53:09 +0300 Subject: [PATCH 3/3] docs: provide bilingual agent instructions --- AGENTS.md | 38 ++++++++++++++++++++------------------ AGENTS.ru.md | 28 ++++++++++++++++++++++++++++ 2 files changed, 48 insertions(+), 18 deletions(-) create mode 100644 AGENTS.ru.md diff --git a/AGENTS.md b/AGENTS.md index 0a8c9d1..65aa6e7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,26 +1,28 @@ -# Разработка RuEn +# RuEn development -RuEn обеспечивает русскую раскладку для существующих клавиатурных сокращений Autodesk Fusion. +[Русская версия](AGENTS.ru.md) -## Общие правила 4FusionLab +RuEn supports the Russian keyboard layout for existing Autodesk Fusion keyboard shortcuts. -- Общие стандарты: 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 фиксируй, что действительно тестировалось и на какой ОС. +## Shared 4FusionLab rules -## Платформенная совместимость +- Shared standards: https://github.com/4FusionLab/.github/blob/main/AGENTS.md; shared CI model: https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md. +- Communicate with the user and make plans in Russian; use English for Fusion command names, code and UI. Retain separate README.md and README.ru.md where the project has them. +- Inspect current code and `git status` before changes; preserve unrelated work. Use Conventional Commits; small PRs with tests are preferred, while direct pushes to `main` are allowed by the existing policy. +- Do not change the Fusion manifest UUID, command IDs, OS support or distribution structure without a separate task and migration plan. Keep secrets, personal CAD files, tokens and unauthorized external services out of the repository. +- Where shippable runtime exists, release is triggered only by a push/merge to `main` affecting `.github/release-paths.txt`. CI checks code, GitVersion.Tool 6.8.2 determines the version, and GitHub automatically creates the tag and Release. **Never create or move release tags manually**, or overwrite published ZIPs. +- README, docs, tests, CI settings and `AGENTS.md` must not independently trigger a release. Pin shared Actions to an **immutable commit SHA** from `4FusionLab/.github`, not `@main`. +- Unit tests and ZIP checks are not live Autodesk Fusion tests. For API/UX changes record what was actually tested and on which OS. -- `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. +## Platform compatibility -## Проверка +- `RuEn/RuEn.py` and `RuEn/hotkeys.py` handle registered Fusion shortcuts; native `RuEn/libruen_v2.dylib` (macOS Apple Silicon) and `RuEn/ruen_filter.dll` (Windows x64) are included in the package. +- `native/ruen_filter.cpp` and `scripts/build_macos.sh`, `scripts/build_windows.ps1` are the native library build sources. Changes to them do not themselves alter the shipped product: rebuild and verify the corresponding DLL/dylib first. +- `QTCanvas` uses internal Qt API; document the risk of incompatibility with Autodesk Fusion versions and do not claim this is a public stable SDK. +- Do not change established user hotkey mappings, modifier combinations or filter enable/disable behavior without tests. Do not change the existing UUID after RuEnProbe. + +## Verification - `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 такую проверку не заменяет. +- `python scripts/package.py --version X.Y.Z`; output is universal/macos/windows ZIPs and SHA-256, not a new DLL/dylib compilation. +- Qt and keyboard behavior require native tests on the relevant platform; Linux CI does not replace them. diff --git a/AGENTS.ru.md b/AGENTS.ru.md new file mode 100644 index 0000000..04c3327 --- /dev/null +++ b/AGENTS.ru.md @@ -0,0 +1,28 @@ +# Разработка RuEn + +[English](AGENTS.md) + +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 такую проверку не заменяет.