Сопряжение по HTTPS-адресу домашнего ПК, SHA-256 сертификата и коду.
Импорт строки musicbridge://pair?data=… из QR агента; камера пока не реализована.
Проверка закреплённого DER-сертификата до отправки кода и при следующих соединениях.
Хранение адреса, отпечатка и токена в Keychain только на этом устройстве.
Название, исполнитель, обложка, позиция, play/pause, следующий/предыдущий трек, перемотка ползунком, системная громкость и mute.
WSS-состояние, переподключение с задержкой, остановка сети в фоне и восстановление при возврате. Команды автоматически не повторяются.

Статус: первый вариант собирается в GitHub Actions на macOS, Xcode 16.4, Swift 6.1.2. Семь XCTest прошли на симуляторе iOS 18.5; проверка на физическом iPhone и соединение с Windows-агентом ещё не выполнены. Успешный запуск проверяет исходники коммита a761431.

Сборка на Mac

Открыть MusicBridge.xcodeproj в Xcode 16 или новее.
Выбрать схему MusicBridge и симулятор iPhone. Run запускает приложение, Test выполняет MusicBridgeTests.
Для физического iPhone выбрать свою Team в Signing & Capabilities. Сертификаты и provisioning profiles не хранить в Git. Bundle ID при необходимости сменить в tools/generate_project.py, затем повторно сгенерировать проект.
На ПК запустить агент с --tray --lan, открыть сопряжение. В приложении ввести адрес, отпечаток и код с экрана ПК. Разрешить доступ к локальной сети.

Проект уже сгенерирован и включён в Git; Python для обычной сборки не требуется. После добавления Swift-файлов выполнить python3 tools/generate_project.py. Структурная проверка на Windows/macOS: python tools/validate_project.py.

GitHub Actions

.github/workflows/ios.yml собирает приложение и выполняет XCTest на macos-15 при push в main, pull request или ручном запуске. Сохраняет лог, .xcresult и ZIP приложения для симулятора, который нельзя установить на физический iPhone. Apple ID и сертификаты для этой проверки не требуются. GitHub remote подключён: git@github.com:polskikh13/musicbridgeios.git. GitHub CLI установлен и авторизован; результаты доступны через gh run list --repo polskikh13/musicbridgeios и gh run view <run-id> --repo polskikh13/musicbridgeios --log-failed.

Основной origin: ssh://git@dev.yukinoki.ru:2222/musicbridge/ios.git. Отдельный remote github используется для Actions, основной origin сохранён. Отправка: git push origin main и git push github main. Код автоматически не зеркалируется между серверами. Локальная регрессионная проверка выбора симулятора: python tools/test_select_simulator.py.

Источники

План и ограничения — в PLAN.md. Копия протокола агента — в PROTOCOL.md.