Начать с главного экрана
Выберите компьютер, агента, модель, режим и папку, прикрепите файлы и отправьте цель прямо в диалог или терминал.
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ · СПРАВОЧНИК
Всё необходимое, чтобы ваш компьютер всегда был под рукой.
Muqun подключает ваш смартфон напрямую к вашему собственному компьютеру или серверу. Узнайте, как установить и настроить Gateway, управлять терминальными пространствами, настроить агентов для кода — Antigravity, Claude Code, Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI Cursor FX Pi Qoder CLI и T3 Code — и работать с ними, устанавливать темы и устранять проблемы с подключением.
MUQUN / 4.0.0
Одно пространство — от первой цели до следующего изменения.
Нативные сеансы для Codex, OpenCode, DeepSeek Harness и T3 Code. Подтверждайте разрешения, следите за задачами и проверяйте diff прямо с телефона на своем компьютере.
Увидеть, что требует внимания
Карточки показывают активные задачи, прогресс, решения и недавнюю работу. Подзадачи остаются связанными с родительской работой.
Скажите и проверьте
Удерживайте Отправить для записи и добавления текста в черновик. Проверьте перед отправкой; настройте файловый или потоковый сервис распознавания.
Git в том же пространстве
Открывайте Changes и Lazygit вместе. Просматривайте связанные worktrees на совместимом Gateway, не меняя checkout терминала.
Прочитать перед загрузкой
Совместимые обновления показывают описание, ход загрузки и перезапуск после проверки. Позже откладывает запрос до следующего запуска.
Ответы не только текстом
Читайте нативные диаграммы и файлы, запускайте встроенное аудио по желанию. Оно останавливается при закрытии предпросмотра или начале диктовки.
Управлять временным хранилищем
Посмотрите доступные для очистки кэши и настройте автоматическую очистку в Storage.
Обновляйте через Google Play или App Store. Возможности агентов, задач и Git зависят от Gateway. Старые Gateways сохраняют поддерживаемые пути терминала и OpenCode.
muqun-gateway
Установите Gateway и подключите телефон.
Muqun взаимодействует с одной-единственной программой на вашем компьютере: Gateway. Вы устанавливаете её, запускаете и сопрягаете телефон один раз. Регистрация не требуется, и никакие ваши данные не проходят через наши серверы.
PRE-FLIGHT REQUIREMENTScheck before installing
- macOS или Linux на собственном компьютере (Windows пока не поддерживается).
- Установленный tmux или Herdr 0.7.5+ (Gateway управляет ими, а не заменяет их).
- Оба устройства в одной частной сети. Рекомендуется Tailscale (используйте Tailscale Serve, но не Funnel).
- Без учетных записей, без подписок и без сторонних ретрансляторов.
Запустите установщик на компьютере
Скрипт помещает единственный бинарный файл в ~/.local/bin/muqun-gateway, настраивает его и открывает экран сопряжения при первом запуске. Поддерживаются macOS и Linux (Windows пока не поддерживается).install curl -fsSL https://muqun.dev/gateway.sh | shЗапустите его одним из двух способов
Вы можете запустить процесс вручную или поручить операционной системе поддерживать его работу в фоне. Оба способа запускают Gateway; разница лишь в поведении при перезагрузке машины.Выберите только один вариант: при установленной службе команда stop будет немедленно отменена супервизором.Откройте менеджер сопряжения
Каким бы способом вы ни запустили Gateway, это следующий шаг. Менеджер — это полноэкранная панель в терминале, показывающая QR-код, активные процессы и все авторизованные устройства.pair muqun-gateway manageОтсканируйте QR и введите код
Отсканируйте QR-код в приложении Muqun. На экране компьютера появится короткий код формата XXXX-XXXX; ввод его в приложении завершает сопряжение. Одно лишь сканирование не выполняет привязку — код гарантирует, что телефоном управляете именно вы.
MANUAL ADDRESS PAIRING
Не удается отсканировать? Введите адрес Gateway в приложении вручную (он отображается в менеджере) и укажите тот же короткий код.
CODE VALIDITY & RETRIES
Код действует 5 минут и сгорает после 8 неверных попыток. Нажмите p в менеджере, чтобы сгенерировать свежий QR и код.
РЕКОМЕНДУЕМАЯ ЧАСТНАЯ СЕТЬ
Используйте Tailscale на обоих устройствах.
Мы настоятельно рекомендуем объединить телефон и компьютер с Gateway в одну сеть Tailscale tailnet. Это исключает проброс портов на роутере и скрывает Gateway от публичного интернета. Tailscale Serve позволяет добавить приватный адрес HTTPS (не используйте Tailscale Funnel с Muqun).
workspace · group.panel
Настоящий терминал.
Это реальный терминал на вашей машине, а не статичная запись. Gateway управляет tmux или Herdr, а приложение передает изображение без задержек — продолжайте с телефона именно то, что оставили на мониторе.
WORKSPACE ARCHITECTURE
Пространства, группы и терминалы
Три уровня: пространство · группа.панель. Пространство — это папка проекта, группа объединяет терминалы, а терминал — это один шелл. Muqun показывает терминалы по одному на весь экран, избегая нечитаемых делений мобильного экрана.
Переключение между уровнями
Смахните верхний заголовок влево или вправо для смены пространства. Кнопки над строкой ввода переключают терминалы текущей группы.
Список процессов и панелей
Боковая панель отображает все пространства, группы и терминалы. Долгое нажатие открывает безопасное закрытие окон.
CONTROLS, EDITORS & DEVELOPER TOOLS
Строка клавиш терминала
Полоса над вводом добавляет недостающие на клавиатуре телефона клавиши: Esc, Tab, ⌃C, стрелки, а также контекстные кнопки (⇧TAB и ⌃O в Claude Code, :w и gg в nvim). Отключается в Настройки → Терминал.
Поле ввода (Composer)
Моноширинный шрифт, поддержка многострочного ввода, клавиша Enter вставляет новую строку: отправка выполняется отдельной кнопкой во избежание случайных команд.
История вывода
Потяните вниз от верхнего края терминала, чтобы подгрузить историю. При отрыве от живого потока появляется кнопка для мгновенного возврата вниз.
Изменения Git (Changes)
Вид git для каталога панели — тот же лист, что и у сеанса агента; см. «Лист изменений» ниже. На кнопке число изменённых файлов, и она появляется, только если панель внутри git-репозитория и Gateway умеет отдавать diff.
Файлы (Files)
Просматривайте созданные файлы — изображения, код и документы — прямо в приложении.
Открыть в браузере
Укажите порт вашего локального сервера разработки, и Muqun откроет его через защищенный канал без выхода в открытый интернет.
Быстрые действия
Сохраненные команды, частые запросы и сочетания клавиш, отсортированные по частоте использования.
ЛИСТ ИЗМЕНЕНИЙ
Панели терминала и сеансы агентов используют один и тот же лист изменений. Он запускает git на хосте, в каталоге панели или сеанса.
Дерево
Изменённые файлы деревом папок, с числом файлов и итогами по строкам. Длинные имена сокращаются посередине, чтобы расширение оставалось видно, а глубокие папки перестают сдвигаться после трёх уровней.
Область
Меню сверху переключает между незафиксированными изменениями и сравнением с базой ветки — merge-base с origin/HEAD, а если его нет, с main или master.
Патч загружается при открытии файла
В списке нет diff, поэтому даже большое изменение открывается быстро. «Показать больше контекста» расширяет читаемый патч.
Отмена изменений
В меню … файла, после подтверждения: отслеживаемый файл восстанавливается, неотслеживаемый удаляется. Gateway отказывает, если репозиторий — это ваш домашний каталог, и для любого пути, ведущего за пределы репозитория, включая символическую ссылку наружу.
Со старым Gateway
Сравнение с базой и отмена изменений в терминале требуют Gateway с pane_vcs_files. Без него лист терминала показывает то же дерево незафиксированных изменений, и только.
КЛАВИАТУРА ПЛАНШЕТА И РАСШИРЕННЫЕ КЛАВИШИ
На планшете экранная клавиатура — это полная клавиатура: скрываемая полоса функциональных клавиш, цифровой ряд, залипающие ctrl, alt и shift (двойное касание фиксирует) и Home, End, Page Up и Page Down над стрелками. Сочетания за пределами классического набора — Ctrl+Enter, Shift+Enter, Ctrl+стрелки, Alt+буква, F-клавиши — отправляются, только если Gateway сообщает, что может их доставить.
Клавиши, которые не отправить
Клавиша, которую Gateway не может доставить, нарисована приглушённо и при нажатии сообщает об этом. Пока зажат модификатор, затемняются клавиши, недоступные в этом сочетании; отклонённое сочетание тоже расходует одноразовый модификатор.
Herdr
Доставляет любые сочетания. Настраивать нечего.
tmux
tmux 3.2 или новее с extended-keys on, и программа в панели должна запросить расширенные клавиши. Для Ctrl+Enter и Shift+Enter нужен ещё extended-keys-format csi-u.
Codex и Claude Code
Codex внутри tmux не получает Shift+Enter: для новой строки используйте ⌃J. Claude Code переводит строку по \, за которым следует Enter.
tmux set -s extended-keys ontmux set -s extended-keys-format csi-uОбе команды действуют сразу и до завершения сервера tmux. Чтобы сохранить их, запишите те же две строки без начального tmux в ~/.tmux.conf.
set -s extended-keys onset -s extended-keys-format csi-u●
Muqun работает в режиме безопасного наблюдения: открытие сессии не сбивает расстановку окон, а закрытие приложения не останавливает процессы.
muqun-gateway agent
Агенты.
Терминал — это оболочка, в которую вы печатаете. Сеанс агента — это разговор с агентом для кода, работающим на вашем компьютере: Antigravity, Claude Code, Codex, Cursor, DeepSeek Harness, FX, OpenCode, Pi, Qoder CLI или T3 Code. Приложение рисует его как сообщения, карточки инструментов и вопросы, а не как экран текста. Оба идут через один и тот же Gateway и одно сопряжение; различие в том, с кем Gateway говорит от вашего имени.
Терминал
tmux или Herdr на хосте. Приложение показывает то, что показывает панель, и отправленные клавиши — это ровно то, что получает программа. Поэтому работает любая программа, включая CLI-агентов, живущих прямо в терминале, вроде Claude Code.
Сеанс агента
Агент, с которым Gateway говорит через его собственный API. Каждый сеанс принадлежит одному агенту и всегда возвращается к нему. Рабочая панель — режимы, модели, слэш-команды, навыки, вложения, отмена, сжатие, фоновые задачи — показывает только то, что этот агент поддерживает.
АГЕНТЫ, КОТОРЫХ ПОДДЕРЖИВАЕТ 4.0
codex
Codex
Codex включён по умолчанию. Gateway автоматически обнаруживает codex в PATH, подключается к общему daemon (при необходимости запуская его) и использует локальные учётные данные из ~/.codex для нативных сеансов и инструментов.
opencode
OpenCode
OpenCode не требует настройки. Gateway подхватывает уже запущенную службу OpenCode или запускает её сам; нужен OpenCode 2. Доступна вся рабочая панель.
deepseek
DeepSeek Harness
DeepSeek Harness выключен, пока вы его не включите. Запустите Harness на хосте, затем укажите его Gateway. Режимы — это его собственные пресеты, выбираемые при создании сеанса; вложения попадают к нему как файлы на хосте.
t3
T3 Code
T3 Code выключен, пока у Gateway нет для него учётных данных. Gateway один раз сопрягается с T3 и хранит эти данные. Поддерживаются вложения, подтверждения и отмена; отмена в T3 откатывает целые ходы, поэтому приложение сначала спрашивает.
НАСТРОЙКА ИЗ КОМАНДНОЙ СТРОКИ
На компьютере, где работает Gateway. muqun-gateway agent проверяет каждого агента из вашей оболочки и выводит состояние, версию и адрес, а для неготовых — следующий шаг. Пока включённый агент недоступен, команда завершается с ненулевым кодом, так что её можно проверять и из скрипта.
Состояние каждого агента и следующий шаг.
muqun-gateway agentСопрягает T3 Code. На той же машине выпускает учётные данные через t3 auth session issue — добавьте --base-dir, если T3 хранит данные в другом месте. Для T3 на другом хосте выполните там t3 pair и передайте код через --token CODE.
muqun-gateway agent setup t3Находит запущенный DeepSeek Harness и включает его. Ищет на портах 3080 и 19387; если Harness в другом месте, укажите --endpoint URL.
muqun-gateway agent setup deepseekНичего не меняет. Показывает, какой исполняемый файл OpenCode взял бы Gateway, и его версию — нужна 2.x.
muqun-gateway agent setup opencodesetup записывает config.json и сообщает, нужно ли перезапустить работающий Gateway, чтобы он увидел изменения. Gateway, установленный как служба, перезапускается после подтверждения (--yes пропускает вопрос); иначе перезапустите его сами.
Вручную, в config.json
CONFIG.JSONТе же настройки — для тех, кто предпочитает писать их сам. Добавьте нужные блоки и перезапустите Gateway. Код из t3 pair записывается в pairing_token; при следующем запуске Gateway один раз обменяет его и больше в нём не нуждается. opencode.binary и codex.binary нужны, только чтобы закрепить конкретный исполняемый файл.
{ "opencode": { "binary": "/usr/local/bin/opencode" }, "codex": { "enabled": true }, "deepseek": { "enabled": true, "endpoint": "http://127.0.0.1:3080" }, "t3": { "enabled": true, "url": "http://127.0.0.1:3773", "pairing_token": "CODE-FROM-T3-PAIR" }}●
Учётные данные T3 хранятся в t3-credential.json в каталоге состояния Gateway — ~/.local/share/muqun-gateway/ в Linux — и доступны для чтения только вам. Если T3 отзовёт их или срок истечёт, снова выполните agent setup t3.
НА ТЕЛЕФОНЕ
Плитка для каждого агента
На главном экране — плитка для каждого агента, о котором сообщает Gateway, последний использованный первым. Если их больше трёх, остальные собраны в «Другие агенты». Если готовы несколько, «Новый сеанс» спросит, какой.
Вопросы приходят уведомлениями
Когда сеанс — в том числе сеанс субагента — просит заполнить форму, каждый сопряжённый телефон получает одно уведомление, что агенту нужен ваш ответ. Запросы разрешений приходят, как и раньше.
Нужна настройка
Gateway видит агента, но не имеет для него учётных данных. Плитка открывает инструкцию с точной командой для хоста — для T3 Code это t3 pair.
Нужно обновление
Агент говорит на более новом протоколе, чем знает этот Gateway. Обновите Gateway на том компьютере, повторно выполнив команду установки.
Не установлен, Не в сети
Агента нет на хосте или он не запущен. Плитка говорит, что именно, и открывает инструкцию по запуску для этого агента.
Старые Gateway
Gateway до 0.13 не предлагает multi_agent, поэтому приложение остаётся в режиме одного агента с OpenCode и сообщает, когда функции нужен более новый Gateway.
opencode serve --service
Агент OpenCode.
Интерфейс, спроектированный специально для OpenCode: быстрое переключение диалогов, карточки инструментов с наглядными diff и удобные формы подтверждения действий.
ЛОКАЛЬНАЯ РАБОТА · БЕЗ АККАУНТА
Ваш компьютер связывается с провайдерами напрямую.
Вход в систему не требуется. Muqun не хранит учетные записи и не запрашивает API-ключи. С провайдерами общается OpenCode на вашем компьютере. Gateway не пересылает ваши учетные данные.
ЧТО ТРЕБУЕТСЯ
- OpenCode 2.x на том же компьютере, где работает Gateway.
- Как минимум один настроенный провайдер в OpenCode (поддерживается фильтр бесплатных моделей).
- Запущенная служба OpenCode (Gateway запускает её сам или подключается к существующей).
- Актуальная версия Gateway с поддержкой интерфейса агента.
AGENT CAPABILITIES & WORKFLOW
Сессии и подагенты
Каждая сессия имеет собственный контекст. Если задача запускает подагентов, они отображаются с отступом под основной сессией для удобного чтения.
Проекты
Мгновенно меняйте проект (рабочий каталог) агента. Выбор проекта автоматически возобновляет последний активный диалог.
Модели и агенты
Список доступных моделей с указанием размера контекстного окна и метками Free. Переключение между ролями Build, Plan, Explore или вашими агентами.
Команды / и навыки
Введите / в поле ввода. Команды вроде /new, /models или /undo обрабатываются приложением; остальные выполняются на хосте.
Вложения и упоминания @
Отправляйте фотографии и файлы. При отправке метаданные EXIF удаляются. Символ @ позволяет быстро ссылаться на файлы проекта.
Разрешения и вопросы
Когда агент хочет выполнить команду или изменить файл, карточка предлагает: Разрешить, Разрешать всегда или Отклонить (доступно и на экране блокировки).
Фоновые задачи и очередь
Отправляйте долгие операции в фон. Новые сообщения могут вмешиваться немедленно или вставать в очередь выполнения.
Контекст и сжатие
Контролируйте заполнение контекстного окна, расход токенов и примерную стоимость. Автоматическая компактизация отмечается на временной шкале.
Отмена (Undo)
/undo возвращает проект к состоянию до вашего последнего сообщения; /redo восстанавливает отмену. Выполнено в виде команды для предотвращения случайных нажатий.
●
Вызовы инструментов отображаются в виде интерактивных карточек с unified diff, как и в разделе Изменения.
config.json
Настройка Gateway.
Большинству пользователей не требуется открывать конфигурацию. Она предусмотрена для особых случаев: смены порта, сохранения работы после перезагрузки или нестандартного пути к OpenCode.
Файл конфигурации
JSON SCHEMAФайл в формате JSON создается автоматически при установке. Редактируйте его вручную только при необходимости и перезапускайте Gateway после правок. В macOS он находится в ~/Library/Application Support/muqun-gateway/. Данные об устройствах и логи хранятся в ~/.local/share/muqun-gateway/.
~/.config/muqun-gateway/config.jsonCONFIGURATION KEYS REFERENCE
labelИмя, отображаемое в приложении для этого компьютера.
listenСокет привязки (хост и порт). По умолчанию 0.0.0.0:23847 (или 127.0.0.1, если опубликован локальный адрес).
public_urlАдрес, закодированный в QR-коде сопряжения. Рекомендуется менять его клавишей u в менеджере.
transport_encryptionШифрование передачи данных, по умолчанию required. Применяется к новым устройствам, не затрагивая уже привязанные.
sessionsПоддерживаемые терминальные движки (tmux, Herdr или оба). Управляется через muqun-gateway backend.
autostart_backendsДвижки, запускаемые вместе с Gateway. По умолчанию список пуст во избежание нежелательных запусков.
rich_agent_pushesПо умолчанию выключено. При включении текст вопросов агента попадает в уведомление (отображая данные терминала на экране блокировки).
opencode.autostartВключено по умолчанию: Gateway запускает OpenCode, если он еще не запущен. Отключается параметром "opencode": { "autostart": false }.
opencode.binaryПуть к исполняемому файлу OpenCode. Если не задан, поиск идет в ~/.opencode/bin или в системном PATH.
codexАгент для кода Codex. Включён по умолчанию (enabled: true); Gateway ищет codex в PATH и подключается к общему daemon. Используйте codex.binary для указания точного исполняемого файла или enabled: false для отключения.
deepseekDeepSeek Harness. Подключается, только если enabled равно true или задан endpoint; token и secret — если они нужны вашему Harness. Gateway никогда не сканирует порты в его поисках.
t3T3 Code. enabled, url (по умолчанию http://127.0.0.1:3773) и либо pairing_token из t3 pair, либо уже имеющийся token. runtime_mode задаёт политику разрешений; по умолчанию full-access.
ПОРТЫ И ПРИВЯЗКА
По умолчанию
Один TCP-порт: 23847.
Изменить
Выполните muqun-gateway setup --port N и перезапустите.
Интерфейс
127.0.0.1, если публикуется loopback, иначе 0.0.0.0.
В сети tailnet
Не требуется настраивать проброс портов на роутере.
ДВА РЕЖИМА ПОСТОЯННОЙ РАБОТЫ
DIRECT
Прямой запуск в фоне
Запуск
При ручном выполнении команды.
Остановка
muqun-gateway stop или при перезагрузке.
Автостарт после перезагрузки
Нет.
Удаление
Достаточно команды stop.
muqun-gateway startSERVICE
В качестве системной службы
Запуск
При входе в систему и после сбоев.
Остановка
Только через service uninstall.
Автостарт после перезагрузки
Да.
Удаление
service uninstall (сопряжения сохраняются).
muqun-gateway service installПользовательский сервис systemd в Linux, LaunchAgent в macOS. Без прав root и за пределами домашней директории.
КАК ЗАПУСКАЕТСЯ OPENCODE
- Проверяет наличие работающей службы OpenCode по адресу в ~/.local/state/opencode/service.json.
- Если найдена, подключается к ней напрямую, сохраняя все ваши текущие сессии.
- Если нет, запускает opencode serve --service и контролирует процесс, автоматически отслеживая смену портов.
●
OpenCode не установлен? Никаких подключений не произойдет; статус офлайн будет виден только на экране агента, терминал работает как обычно.
"opencode": { "autostart": false }МЕНЕДЖЕР СОПРЯЖЕНИЯ
Открывается командой muqun-gateway manage. Показывает активные процессы и устройства, поддерживая горячие клавиши:
p
Показать QR-код повторно для подключения еще одного устройства.
x
Отозвать доступ для выбранного устройства.
u
Изменить адрес в QR-коде (нажмите a для автоопределения).
s / t
Запустить или остановить Gateway не выходя из менеджера.
m / h
Добавить backend tmux или Herdr (f — по умолчанию, d — удалить).
e
Изменить режим шифрования для будущих подключений.
q
Закрыть менеджер (сессии терминала не прерываются).
Обратная совместимость
Приложение опрашивает Gateway о поддерживаемых функциях, не полагаясь только на номер версии, и мягко скрывает отсутствующие возможности. Старые версии Gateway продолжают работать как надежные терминалы. Только совместная работа агентов требует Herdr 0.9.0+ в сессии.
Обновление
Просто выполните ту же команду установки еще раз. Она обновит бинарный файл, сохранив ключи сервера, конфигурацию и привязанные устройства. При использовании службы выполните service install еще раз после обновления.
Журналы
DIAGNOSTICSВ прямом режиме и через LaunchAgent в macOS логи пишутся в ~/.local/share/muqun-gateway/gateway.log. В Linux с systemd логи доступны через journalctl. Для отладки задайте MUQUN_LOG=debug перед запуском.
journalctl --user -u dev.osuki.muqun-gatewaymuqun.dev/themes
Темы оформления.
Cover Courier — встроенная тема по умолчанию. Установите светлые и тёмные темы из каталога, файла или ссылки, чтобы вместе изменить изображения и цвета приложения и терминала.
Встроенная и импортированные темы
Выберите тему в Настройки → Оформление и режим Системный, Светлый или Тёмный. Обновления импортированных тем обновляют выбранную тему, сохраняя ваши настройки оформления.
Каталог тем
Просматривайте онлайн-каталог на muqun.dev. Загрузка начинается только при открытии темы с предварительным указанием размера пакета.
Формат темы
Файл .muqun-theme — это zip-архив с theme.json и папкой assets с изображениями. .muqun-theme.json — вариант без графики.
Возможности кастомизации
Тема задаёт цвета приложения, терминала и ANSI, изображения, значки и прозрачность. Сцена Home, фон страницы и оформление ввода Home имеют отдельные места с вариантами телефона/планшета и светлого/тёмного режима. Поддерживаются PNG, JPEG и WebP, но не внешние шрифты, SVG и анимации.
Ограничения размера
Манифест до 256 КиБ, до 32 изображений не более 8 МиБ каждое, и максимум 25 МиБ для архива темы.
Установка из файла
Откройте .muqun-theme через Файлы, AirDrop или меню «Поделиться», либо используйте «Импорт файла» в настройках тем.
Установка по ссылке
Укажите прямую ссылку или репозиторий GitHub. Домен источника изображений отображается перед загрузкой.
Установка из терминала
Нажмите на путь к файлу .muqun-theme в терминале, чтобы открыть карточку предварительного просмотра.
Предпросмотр перед применением
Тема временно применяется ко всему приложению, позволяя оценить дизайн до нажатия кнопки «Применить тему».
Прозрачность фона
Раздельная регулировка прозрачности интерфейса и терминала для создания красивых эффектов глубины.
Создание собственных тем
Темы описываются в виде файлов. Специальный встроенный навык агента позволяет создать тему по текстовому описанию.
Публикация в каталоге
Каталог открыт для Pull Request на GitHub. После слияния тема появляется на muqun.dev в течение нескольких минут.
Удаление тем
Смахните тему в списке для удаления. Меню Настройки → Память позволяет в один клик очистить неиспользуемые наборы.
when it does not connect
Устранение неполадок.
Почти все проблемы с подключением вызваны четырьмя причинами: Gateway не запущен, адрес недоступен, сопряжение сброшено или OpenCode выключен.
БЫСТРЫЕ ПРОВЕРКИ
Подключить компьютер
Установите Gateway (поддерживает tmux или Herdr), откройте панель менеджера, отсканируйте QR в Muqun и введите код подтверждения.
Проверить соединение
Убедитесь, что tmux или Herdr 0.7.5+ и актуальный Gateway запущены, а телефон и компьютер видят один частный IP-адрес.
Удалить устройство
Удалите сервер на главном экране Muqun, чтобы отозвать доступ телефона. Сделать это можно и через панель менеджера на ПК.
Обновить уведомления
Включите уведомления в системе и в Muqun. Откройте сервер заново, чтобы перерегистрировать токен в Gateway.
DIAGNOSTIC SOLUTIONS
Не удается выполнить сопряжение
Ошибка «Could not reach the gateway» означает, что телефон не может достучаться до адреса из QR-кода. Проверьте muqun-gateway status и убедитесь, что устройства в одном Wi-Fi или Tailscale tailnet. Gateway на 127.0.0.1 снаружи недоступен; исправьте это клавишей u в менеджере.
Код отклонен или просрочен
8-значный код действует 5 минут и сгорает после 8 неверных попыток. Нажмите p в менеджере для генерации нового кода. Символы 0, 1, I, L, O исключены во избежание путаницы.
Значение точки статуса
Заполненная точка означает полученный ответ (зеленый: ONLINE, серый: OFFLINE). Полый круг с надписью NOT CONNECTED говорит о том, что проверка еще не проводилась; просто нажмите на сервер.
Просит подключиться заново
Токен этого устройства был удален на Gateway или сброшен при очистке состояния. Достаточно отсканировать QR еще раз.
OpenCode не найден
Если на экране агента горит OpenCode service offline, запустите opencode serve --service на компьютере и нажмите Повторить. Если служба уже работает, укажите точный путь в config.json в параметре opencode.binary.
Модели неактивны или нет бесплатных
«Требуется настройка на хосте» значит, что провайдер не задан в OpenCode. Отключите фильтр «Только бесплатные», чтобы увидеть все доступные варианты.
Агент запрашивает выход из проекта
Карточки доступа за пределы проекта четко указывают полный путь. Внимательно проверяйте целевой путь перед подтверждением.
Нет кнопки «Изменения»
Она появляется, только если терминал внутри git-репозитория и Gateway достаточно новый, чтобы отдавать diff. Для сравнения с базой и отмены изменений нужен Gateway 0.13 или новее. Обновите его, повторно выполнив команду установки.
Требуется более новый Gateway
Старые версии Gateway сохраняют полноценную работу терминала. Для совместной работы агентов требуется Herdr 0.9.0+ в текущей сессии.
Компьютер работает через прокси
Ваш компьютер напрямую общается с провайдерами ИИ. Если для интернета нужен прокси, настройте его в OpenCode на хосте.
Терминал недоступен
Gateway работает, но ни один бэкенд терминала не запущен: tmux установлен, но сервера tmux нет, или Herdr не запущен. На экране перечислены бэкенды Gateway и их состояние; запустите любой, и терминал появится сам. Сеансы агентов тем временем продолжают работать.
«Этот терминал не может отправить ⌃↵»
Gateway отклонил сочетание. В tmux выполните tmux set -s extended-keys on, а для Ctrl+Enter ещё и tmux set -s extended-keys-format csi-u. Подсказка под сообщением повторяет объяснение самого Gateway.
Плитка агента пишет «Нужна настройка» или «Нужно обновление»
Выполните muqun-gateway agent на хосте: команда назовёт следующий шаг для каждого агента. «Нужно обновление» значит, что этот Gateway старше протокола агента — повторно выполните команду установки.
github · issues
Остались вопросы?
Создайте Issue на GitHub. Мы внимательно читаем все отзывы и учитываем их в новых релизах.
USEFUL REPORT CHECKLIST
Укажите версию приложения, версию Gateway и шаги, предшествовавшие сбою.
PRIVACY GUARANTEE
Конфиденциальность и безопасность
Служба поддержки никогда не запрашивает токены доступа, полные логи терминала, исходный код или QR-коды. Удаляйте конфиденциальные данные перед отправкой скриншотов или логов.