Релиз 0.13.8¶
Дата выхода: 11 ноября 2026.
Релиз 0.13.8 завершает волну 0.13.x и приносит две вещи, которых не было в 0.13.4: инстанс теперь можно поставить «на автозапуск» одной командой, а обновление версии выполняется из самой платформы — с выбором канала.
Заметки кумулятивные: версии 0.13.5–0.13.7 в npm не публиковались (выходили только беты во внутреннем реестре), поэтому документ описывает всю волну целиком.
Что входит в релиз
Заметки кумулятивные: 0.13.5–0.13.7 отдельными пакетами не выходили, и публикуется только 0.13.8. Полный список коммитов и исправлений — в релизах репозитория (зеркало GitVerse: gitverse.ru/itphx/synth/releases).
Сервис инстанса: работает всегда¶
Раньше «инстанс всегда поднят» означало systemd-юнит, написанный руками. Теперь
это штатная процедура: synth service install создаёт userspace-сервис
(systemd --user), включает автозапуск и поднимает инстанс.
synth service install # поставить сервис и запустить
synth service status # состояние: unit, автозапуск, PID, health
synth service logs -f # журнал сервиса
synth service restart # перезапуск
synth service uninstall # снять unit (данные остаются)
- Автозапуск и «живучесть». Unit ставится в
~/.config/systemd/user/(или$XDG_CONFIG_HOME/systemd/user/), включается в автозапуск, аloginctl enable-lingerпозволяет сервису жить без активной сессии пользователя — после перезагрузки машины инстанс поднимается сам. - Перезапуск без супервизора. Unit настроен на graceful restart: процесс завершается с кодом 75, systemd поднимает его заново. Ручной «наблюдатель» процесса больше не нужен.
- Без секретов в unit. Ключи и токены в unit и env-файл не попадают: env-файл
создаётся с правами
0600и содержит только параметры запуска. Ключ доступа создаёт сам сервер в каталоге данных, команда печатает путь к нему, а не значение. - Аккуратно с чужим unit. Если unit создан не этой командой, он не
перезаписывается — нужен явный
--force. Посмотреть, что будет записано, можно без установки:synth service install --print-unitили--dry-run. Unit, созданный установщиком офлайн-поставки, тоже считается «чужим». - Только Linux + systemd. На других платформах команда сообщает о неподдерживаемости, а не изображает сервис.
Пример: поставьте сервис на рабочей машине — после перезагрузки инстанс поднимется сам, а перезапуск из интерфейса («Настройки → Обслуживание») будет подхвачен systemd.
Обновления и каналы¶
Теперь платформа умеет обновлять себя: synth update показывает текущую и
целевую версию, --check — только проверяет, --apply — устанавливает.
synth update --check # что доступно (ничего не ставится)
synth update --channel stable # проверка по стабильному каналу
synth update --apply # установить найденную версию
synth update --to 0.13.8 --apply # конкретная версия
synth update --channel beta --check # что доступно в бета-канале
- Каналы.
stable— обычные релизы,beta— предрелизные сборки из внутреннего реестра,auto(по умолчанию) — канал выводится из установленной версии: беты остаются на бета-канале, стабильные сборки — на стабильном. - Возврат на стабильный канал. Переход
beta → stable— это понижение версии, поэтому он требует подтверждения. Данные при этом не откатываются: откат пакета и откат данных — разные операции. - Автопроверка выключена по умолчанию. Инстанс не ходит в реестры без
явного согласия владельца — это важно для закрытого контура. Включить её можно
в интерфейсе (Настройки → Панель управления → Обновления) или в
конфигурации; результат проверки кэшируется на сутки, ошибка — на час. Явная
проверка (
--check) кэш игнорирует всегда. - Своё хранилище пакетов.
--registry <url>переопределяет реестр канала — так обновляются инстансы за прокси или в закрытом контуре. Токен для чтения внутреннего реестра не нужен. - После обновления — перезапуск. Если инстанс работает как сервис,
обновлённый пакет подхватится после
synth service restart.
Пример: переведите стенд на беты — synth update --channel beta --check, затем
synth update --channel beta --apply; вернуться на стабильную линию можно
командой synth update --channel stable --apply с подтверждением.
Инстанс из чата: команда /instance¶
Агент теперь может сам разобраться в инстансе, в котором работает: что это за установка, где её данные, какие MCP-серверы подключены, какие проекты и сессии доступны.
- Команда
/instance. Встроенный сценарий самопомощи: агент отвечает на вопросы об инстансе, MCP-реестре, проектах и сессиях прямо в чате. - Инструменты
synth_*. Чтение —synth_info,synth_mcp_list,synth_mcp_test; изменение реестра —synth_mcp_add,synth_mcp_update,synth_mcp_remove,synth_mcp_enable,synth_mcp_reconnect. В режиме плана изменяющие инструменты заблокированы. - Проекты и сессии. Агент видит список проектов и сессий (в том числе удалённых в гибридном режиме — с пометкой источника), может открыть проект и присоединиться к нему.
- Без секретов. Ответы содержат адреса и статусы, но не ключи, заголовки авторизации и содержимое переменных окружения: ссылка на сервер с учётными данными в ответе редактируется.
Пример: спросите агента «покажи, какие MCP-серверы подключены и почему второй не активен» — ответ придёт в чате, без обращения к API вручную.
Реестр MCP — источник истины¶
Реестр MCP-серверов переехал в ядро, поэтому он одинаково работает в
standalone и в серверном режиме, а настройки из config.yaml больше не
теряются.
- Реестр доступен в standalone. Управление серверами (добавление, проверка, включение, удаление) работает без серверного бэкенда.
- Сидирование из конфигурации. Серверы, описанные в
config.yaml, переносятся в реестр при старте (один раз на имя) и остаются в нём: правка реестра больше не стирает конфигурацию. - Единый источник для менеджера. Список активных серверов берётся из реестра — тем же кодом, что и в серверном режиме.
- CLI для реестра.
synth mcp list | add | test | remove | reconnect— тонкий клиент к реестру локального инстанса. Ключ доступа читается внутри процесса и не печатается.
Пример: synth mcp add --name playwright --type http --url http://127.0.0.1:8931/mcp
— сервер появится в реестре и станет доступен для включения в проекте.
Подтверждения прав: понятно и устойчиво¶
Полоса подтверждения переработана: теперь в ней видно, что именно вызвало вопрос, и её не теряет перезапуск инстанса.
- Человеческая причина. Вместо технического текста для модели полоса показывает, какой участок команды или пути вызвал вопрос, и подсвечивает его. Команда показана отдельным блоком, остальные параметры — списком; прежний технический текст спрятан в свёрнутые «Технические детали».
- Индикатор в дереве. Сессия, ждущая подтверждения, помечается в дереве сессий — цветом и подписью, а не только цветом.
- Грант каталогом. Когда вопрос вызван динамикой в пути, разрешение можно
выдать «каталогом»: агент получает доступ к этому каталогу на сессию, а не
разовое разрешение на один вызов. Такой грант не снимает запреты: правила
deny, защищённые пути и опасные операции остаются в силе. - Переживает перезапуск. Ожидание подтверждения хранится на диске. После перезапуска инстанса полоса восстанавливается с пометкой «Инстанс был перезапущен…», а ответ «разрешить» действует в рамках одобренного: для доступа к каталогу вне рабочего каталога это грант каталогом, а для изменения или удаления данных, защищённого пути и смены рабочего каталога постоянное правило не выдаётся и вопрос повторится.
Пример: агент выполняет cd "$HOME/work" — раньше это приводило к повторным
вопросам, теперь переменные среды разрешаются, а вопрос задаётся только когда
цель действительно неразрешима.
Поиск и чтение: контекст больше не заливает¶
Был случай, когда один поиск по проекту принёс в модель 243 КБ текста: подошёл минимизированный source map, где вся строка — 236 тысяч символов. Теперь инструменты поиска и чтения ограничены так, чтобы контекст оставался рабочим.
- Предел длины строки. Строка совпадения (и строка файла при чтении) обрезается до 2000 символов; в выводе видно, что строка усечена.
- Общий предел вывода. Результат любого инструмента ограничен общим бюджетом (по умолчанию 2000 строк или 51 200 байт). Инструмент не может этот предел отменить — раньше мог.
- Исключения для поиска. Поиск по совпадениям не заходит в зависимости и
артефакты сборки (
node_modules,dist,build,out,coverage,.venv,__pycache__,.next,.turbo,.cache, файлы*.map,*.min.jsи lock-файлы). Явный путь важнее исключения — если вы ищете внутри такой папки, поиск идёт как обычно. - Ничего не теряется молча. Исключённые совпадения считаются и показываются отдельной пометкой: «в результат не попало N совпадений».
Пример: тот же поиск по проекту теперь возвращает около двух тысяч символов вместо двухсот сорока килобайт — контекст сессии не вырастает в разы.
Также в волне 0.13.5–0.13.7¶
Коротко о крупном, что вошло в ту же волну:
- SSH-доступ к удалённым хостам. Per-agent ключи хранятся в зашифрованном
виде; два режима — инструменты (
ssh,rsyncв рабочем окружении) и агентный режим с пробросом ключа в вызов. - Параллельные вызовы инструментов в одном шаге. Независимые вызовы выполняются одновременно, порядок в истории остаётся прежним.
- Сжатие контекста на границе шага. Длинный ход сжимается не в конце, а между шагами — окно не переполняется в середине работы.
- Список задач у саб-агента. У дочерней сессии свой список дел, он не смешивается со списком родителя.
- Рабочая панель. План, задачи, журнал и инварианты собраны в одном месте с компактными списками и редакторами.
- Гибридный режим. Локальные сессии могут использовать MCP-серверы сервера; публикация проекта показывает прогрест в процентах; списки при недоступном сервере деградируют явно, а не «висят».
Исправления¶
- Профиль в локальном режиме. Сохранение и чтение профиля владельца в standalone больше не теряются.
- Серверный сбой провайдера больше не «съедает» ход. Сбой на стороне провайдера, пришедший в обёртке «400 — некорректный запрос», распознаётся как серверная ошибка и повторяется (3 попытки, паузы 5/15/30 секунд). Настоящие ошибки запроса — по-прежнему без повторов.
- Одна перезагрузка вместо двух. После обновления или перезапуска страница перезагружается один раз: раньше обновление и обработчик обновления перезагружали её по очереди.
- Мобильная полоса подтверждений. На телефоне запрос подтверждения показывается корректно и не перекрывает поле ввода.
- Одобрения команд.
cdс переменными окружения больше не даёт бесконечных ложных вопросов; «разрешить в сессии» работает для команды, а не только для пути; тела heredoc не попадают в список сохранённых правил. - Навыки. Скилл больше не помечается недоступным из-за того, что у агента нет лишних возможностей; в интерфейсе видно, каких именно не хватает.
- Мелочи. Локализован подзаголовок пустого экрана, исправлена причина вопроса из стандартного ввода, добавлена подсказка в опроснике.
Безопасность¶
- Грант не расширяет запреты. Разрешение «на сессию» снимает только
динамический вопрос;
deny, защищённые пути и опасные операции остаются запрещёнными. Если из команды нельзя надёжно вывести правило, выдаётся только разовое разрешение. Каждый выданный грант попадает в аудит. - Единая граница доступа. Все API под единой проверкой с закрытым списком публичных путей: маршрут, смонтированный без проверки, анонимным не становится. Регрессии ловят автоматические проверки.
- Роли API-ключа. Роли ключа задаются настройкой; по умолчанию — обычный пользователь, а не администратор. Сравнение ключа — постоянное по времени.
- Секреты MCP. Ответы о реестре не содержат заголовков авторизации и переменных окружения, а ссылки с учётными данными редактируются.
- Замечания аудита закрыты. В этой волне закрыты P0-замечания внутреннего аудита 0.13.4 — среди них единая граница доступа, роль API-ключа по умолчанию и проверка реестра маршрутов. Критичных уязвимостей в продакшн-зависимостях нет.
- Аудит перед релизом 0.13.8. Внутренний аудит нашёл два дефекта волны, и
оба закрыты до выпуска: ответ «Разрешить» на восстановленное после перезапуска
подтверждение мог выдать слишком широкое постоянное правило (для команды
удаления — правило на все
rm), а общий предел вывода инструмента можно было отменить служебным флагом самого инструмента. Теперь грант считается по той же схеме, что и в обычном ходе, а предел вывода считается по фактическому размеру результата, и отменить его из инструмента нельзя. Для пользователя это значит, что перезапуск инстанса не расширяет выданные права, а один инструмент не может вывести в контекст больше положенного. Запись аудита приложена к релизу; финальный статус аудита фиксирует релизный гейт при тегировании.
Как обновиться¶
Перед обновлением
- PostgreSQL. Если инстанс работает на базе, выполните
synth migrateдо запуска новой версии. Повторный прогон безопасен. - Бэкап. Снимите резервную копию каталога данных, а для PostgreSQL — ещё и дамп базы.
- Схема данных. Добавлены миграции 031–034: политика SSH-ключей, режим
удалённого MCP, источник сессии и ожидания подтверждений. Для базы PostgreSQL
переход с 0.13.4 требует прогона
synth migrate. - Конфигурация. Новых обязательных полей нет; секция
updatesи параметры сервиса имеют значения по умолчанию — существующие конфиги остаются валидными.
# посмотреть, что доступно
synth update --check
# установить и перезапустить сервис
synth update --apply
synth service restart
synth --version
На бета-канале добавьте --channel beta; вернуться на стабильный —
synth update --channel stable --apply (понижение версии требует
подтверждения).
Тома с данными не затрагиваются — история и настройки сохраняются.
Известные ограничения
- Доступ к проекту для участников и групп (участники, группы, общая видимость) пока предложение, а не реализованная возможность: модель доступа обсуждается, и в 0.13.8 её нет.
- Перезапуск инстанса прерывает активный ход. После старта ход переигрывается, поэтому инструменты могут выполниться повторно.
- Новая версия сама не ставится. Автопроверка лишь сообщает о наличии обновления; установка всегда требует явной команды.
Что дальше¶
- Возможности — полный обзор платформы.
- CLI — сервис, обновления и реестр MCP из терминала.
- Обслуживание — сервис, перезапуск, обновление и откат.
- Режимы и права — подтверждения и гранты.
- MCP-инструменты — реестр и self-help.