Панель анализа AI-сервисов
Необязательный модуль AIBudsAIDashboard запускает локальную веб-панель для просмотра отчётов AI-сессий на iOS-устройстве. Она помогает диагностировать AI-диалоги, аудиозапись, перевод и синхронный перевод без добавления экранов отчётов в приложение.
AI Dashboard — служебный инструмент. Она не настраивает поставщика, не запускает AI-сессии и не заменяет руководства по функциям.
Контролируемая сессия панели
Завершённый AI-процесс сохраняет отчёт, а локальный сервер для разработки делает его доступным браузеру в той же сети.
Архитектурные границы
Сервер работает внутри приложения. Его доступность зависит от жизненного цикла приложения, сетевой доступности, выбора порта, упаковки ресурсов и хранения отчётов.
Упаковка и жизненный цикл
Для прямой интеграции нужны AIBudsAIDashboard и веб-ресурсы AIBudsAIDashboard.bundle. AIBudsAllInOne также предоставляет методы жизненного цикла панели; используйте выбранную приложением модель владения и не запускайте оба варианта.
Запускайте сервер один раз владельцем приложения только для разработки и останавливайте после диагностики.
- Swift
- Objective-C
#if DEBUG
import AIBudsAIDashboard
if !AIDashboardSDK.isRunning {
let accepted = AIDashboardSDK.start(withPort: 3000)
if !accepted { print("AI Dashboard start was rejected") }
}
#endif#if DEBUG
@import AIBudsAIDashboard;
if (![AIBudsAIDashboardSDK isRunning]) {
BOOL accepted = [AIBudsAIDashboardSDK startWithPort:3000];
if (!accepted) {
NSLog(@"AI Dashboard start was rejected");
}
}
#endifОбъявления приведены в AIDashboardSDK.
Доступ и проверка
При запуске SDK записывает адрес панели в журнал. Откройте его в браузере, имеющем доступ к iOS-устройству. Возвращаемый Bool означает принятие команды, а не полную проверку работоспособности: публичный API не возвращает URL привязки, интерфейс, сведения о конфликте порта или ошибку сервера.
Проверьте состояние жизненного цикла, адрес в журнале, отсутствие предупреждений о bundle, доступность из браузера и наличие завершённого отчёта поддерживаемой AI-функции. Пустая панель может означать, что отчёты ещё не сохранены.
Безопасность и конфиденциальность
:::warning Только для разработки и контролируемой диагностики Текущая панель — локальный HTTP-сервис, публичный API которого не предоставляет настраиваемую авторизацию, TLS или ограничение интерфейса привязки. Отчёты могут содержать распознанный текст и чувствительные данные сессии. Не включайте панель в production без явного одобрения модели доступа и хранения службой безопасности и конфиденциальности. :::
- Разрешайте запуск только в debug- или внутренних сборках.
- Используйте доверенную изолированную сеть.
- Не публикуйте адреса или учётные данные в аналитике и журналах.
- Останавливайте сервер сразу после диагностики.
- Применяйте к отчётам политику хранения и удаления AI-данных.
Устранение неполадок
| Проявление | Что проверить |
|---|---|
| Запуск отклонён | Возможно, сервер уже работает; оставьте одного владельца жизненного цикла. |
| Ресурсы страницы отсутствуют | Убедитесь, что AIBudsAIDashboard.bundle включён в приложение. |
| Браузер не подключается | Проверьте адрес из журнала, порт, доступность и политику локальной сети. |
| Панель пуста | Завершите поддерживаемую AI-сессию и убедитесь, что отчёт сохранён. |
| Endpoint работает после диагностики | Остановите его тем же владельцем приложения, который запустил сервер. |