Skip to content
Merged
Show file tree
Hide file tree
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
2 changes: 2 additions & 0 deletions .github/RELEASE_POLICY.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
29 changes: 29 additions & 0 deletions .github/RELEASE_POLICY.ru.md
Original file line number Diff line number Diff line change
@@ -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`.
38 changes: 20 additions & 18 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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.
28 changes: 28 additions & 0 deletions AGENTS.ru.md
Original file line number Diff line number Diff line change
@@ -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 такую проверку не заменяет.
6 changes: 4 additions & 2 deletions RELEASE_NOTES.md
Original file line number Diff line number Diff line change
@@ -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.
7 changes: 7 additions & 0 deletions RELEASE_NOTES.ru.md
Original file line number Diff line number Diff line change
@@ -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.
Loading