Справочник настроек

Синхронизация

#

PocketHook синхронизирует ваши беседы и настройки приложения между устройствами, используя ваш приватный аккаунт iCloud — без аккаунта PocketHook, без участия стороннего сервера.

Войдите в один и тот же аккаунт iCloud на вашем iPhone, iPad и Mac — и всё появится автоматически, без какой-либо настройки. Ваши данные остаются в вашей собственной приватной базе данных iCloud; серверы PocketHook никогда их не видят.

Настройки сервера

#

Основные параметры подключения к вашему серверу PocketHook.

URL сервера

#

HTTPS-эндпоинт, на который PocketHook отправляет ваши сообщения из чата. Принимаются только HTTPS-адреса — HTTP отклоняется из соображений безопасности. Это основной эндпоинт, который прослушивает ваш сервер.

Токен аутентификации

#

Bearer-токен, отправляемый в заголовке Authorization с каждым запросом. Ваш сервер может использовать его, чтобы убедиться, что запросы приходят с вашего устройства. Хранится безопасно в iOS Keychain — никогда в открытом виде.

Совместимость с OpenClaw

#

Включите, если ваш сервер использует платформу OpenClaw или любой OpenAI-совместимый Chat Completions API. При включении PocketHook отправляет сообщения в формате чата OpenAI и разбирает в ответе встроенные маркеры команд ([SHORTCUT:name], [DATA:{...}], [URL:...]). В запросы добавляется заголовок x-openclaw-agent-id.

Проверка соединения

#

Кнопка, отправляющая тестовый запрос на настроенный сервер. Показывает:

• Время ответа в миллисекундах
• Результат Health Check (если включён)
• Подробности ошибки, если соединение не удалось

Используйте её после изменения URL сервера или токена аутентификации, чтобы убедиться, что всё работает.

Сеть

#

Тонкая настройка тайм-аутов для разных типов операций.

Тайм-аут запроса

#

Сколько времени PocketHook ждёт, пока сервер начнёт отвечать на запрос. Если ваш сервер выполняет тяжёлую обработку (например, обращается к ИИ-модели), увеличьте это значение. Для простых вебхук-серверов значения по умолчанию в 5 секунд обычно достаточно.

Тайм-аут ресурса

#

Максимальное время для завершения всего ответа, включая передачу данных. Должно быть больше тайм-аута запроса. Увеличьте, если сервер возвращает большие объёмы данных или имеет медленную скорость передачи.

Health Check

#

Включает мониторинг состояния сервера. Когда активен, PocketHook во время проверки соединения отправляет GET-запрос на URL Health Check и показывает, сообщает ли сервер о своей работоспособности.

URL Health Check

#

Отдельный HTTPS-эндпоинт, возвращающий обычный текст true или false. Этот URL опрашивается во время проверки соединения, чтобы убедиться, что сервер работает. Полезно, когда основной API-эндпоинт закрыт аутентификацией, но нужна простая проверка состояния.

Автоматизация

#

Управляет тем, как PocketHook выполняет Быстрые команды iOS, запускаемые ответами сервера.

Быстрые команды iOS

#

Главный переключатель выполнения Быстрых команд. Когда он OFF, PocketHook по-прежнему показывает сообщения сервера, но игнорирует поля shortcut в ответах. Полезно для отладки или временного отключения автоматизаций.

Задержка между командами

#

Время ожидания между выполнением последовательных команд, когда сервер возвращает несколько автоматизаций в одном ответе. Увеличьте, если ваши команды зависят друг от друга (например, первая команда создаёт файл, который читает вторая).

Тайм-аут команды

#

Максимальное время ожидания завершения каждой отдельной команды, после которого PocketHook считает её просроченной. Долгим командам (например, обрабатывающим медиафайлы или делающим несколько API-вызовов) могут понадобиться все 5 минут.

Персональный интерфейс

#

Встройте собственный веб-интерфейс прямо в PocketHook.

Персональный интерфейс

#

Показывает отдельную вкладку со встроенным веб-представлением. При включении в главной навигации появляется новая вкладка, где отображается ваша веб-страница. Страница предзагружается для мгновенного показа и поддерживает обновление жестом «потянуть вниз».

URL персонального интерфейса

#

URL, отображаемый во вкладке персонального интерфейса. Принимаются и HTTP, и HTTPS (рекомендуется HTTPS). Это может быть панель мониторинга, админ-панель или любая веб-страница, к которой вы хотите иметь быстрый доступ рядом с чатом.

Ссылки

#

Настройте, как PocketHook обрабатывает URL из ответов сервера.

Вкладка «Ссылки»

#

Показывает или скрывает вкладку «Ссылки» в главной навигации. При включении все URL, полученные из ответов сервера, сохраняются и отображаются в отдельной вкладке с расширенными превью ссылок, поиском и возможностью удаления.

Автооткрытие URL

#

Когда включено, PocketHook автоматически открывает URL из ответов сервера в вашем браузере по умолчанию. Когда выключено, URL по-прежнему сохраняются во вкладке «Ссылки» (если она включена), но не открываются автоматически.

Эта настройка намеренно привязана к устройству: вы можете захотеть, чтобы ссылки открывались автоматически на iPhone, но не на Mac. Нажатие на плашку ссылки под сообщением всегда открывает её, независимо от этой настройки.

Язык

#

Настройте язык приложения и диктовки.

Язык приложения

#

Переопределяет язык интерфейса приложения независимо от языка устройства. При выборе «Системный» PocketHook следует языковым настройкам iOS.

Язык диктовки

#

Язык голосовой диктовки (преобразования речи в текст) в поле ввода чата. Доступные языки:

Фоновые задачи

#

Периодическая проверка отложенных задач, даже когда приложение в фоне.

Фоновые задачи

#

Включает фоновый опрос. Когда активен, PocketHook периодически отправляет GET-запрос на URL опроса. Если ответ — true, при открытии приложения на основной сервер отправляется сообщение-запрос. Требуется разрешение на уведомления, чтобы сообщать вам об отложенных задачах.

Интервал проверки

#

Как часто PocketHook проверяет URL опроса в фоне. Более короткие интервалы означают более быстрое обнаружение отложенных задач, но расходуют больше батареи. iOS может корректировать фактическую частоту в зависимости от характера использования устройства.

URL опроса

#

HTTPS-эндпоинт, который PocketHook опрашивает с заданным интервалом. Должен возвращать обычный текст true (есть задачи) или false (задач нет). Это лёгкая проверка — сервер должен отвечать быстро, без тяжёлой обработки.

Agent Server: используйте https://your-host/jobs (подставьте свой хост и порт).

Сообщение-запрос

#

Сообщение, отправляемое на основной сервер, когда фоновая проверка находит отложенные задачи и приложение открывается. Ответ сервера появляется в чате как обычное сообщение. Настройте его, чтобы запускать нужное поведение на стороне сервера.

Управление данными

#

Отслеживайте и управляйте сохранёнными сообщениями.

Сохранённые сообщения

#

Показывает, сколько сообщений сейчас сохранено. Индикатор имеет цветовую кодировку:

• Зелёный — менее 70% ёмкости
• Оранжевый — 70–90% ёмкости
• Красный — более 90% ёмкости

При достижении лимита в 500 сообщений самые старые автоматически удаляются, освобождая место для новых.

Экспорт беседы

#

Кнопка, экспортирующая все сохранённые сообщения в файл JSON через системное меню «Поделиться» iOS. Файл можно сохранить, передать по AirDrop или отправить в любое приложение. Полезно для резервного копирования бесед или анализа истории сообщений.

Удалить все сообщения

#

Деструктивная кнопка, безвозвратно удаляющая все сохранённые сообщения. Требует подтверждения перед выполнением. Это действие нельзя отменить.

О приложении

#

Информация о вашей установке PocketHook (только чтение).