ErisPulse ErisPulse
Открыть интерактивную версию →
Разделы страницы
Описание полей Обязательные поля Дополнительные поля Шкала серьезности Классификация типов Шаблон записи Обзор статистики Исправленные ошибки [BUG-001] Повторная регистрация обработчиков событий приводит к многократной обработке событий [BUG-002] Ошибка типа пути конфигурации адаптера в команде Init [BUG-003] Командные события перестают работать после перезапуска [BUG-004] Обработчики событий жизненного цикла не очищаются [BUG-005] detail_type у Event.is_friend_add/is_friend_delete не соответствует стандарту OB12 [BUG-006] adapter.clear() не очищает _started_instances, что приводит к некорректному состоянию после перезапуска [BUG-007] command.wait_reply() использует устаревший asyncio.get_event_loop() [BUG-008] События отключения ботов дублируются в процессе shutdown [BUG-009] Синхронный доступ LazyModule к BaseModule приводит к незавершённой инициализации [BUG-010] Многопоточная запись в системе конфигурации приводит к потере данных [BUG-011] CTRL+C не останавливает программу в Windows [BUG-012] Код Python обновлённых модулей не вступает в силу после горячего перезапуска [BUG-013] Ошибка логики сортировки в стратегии загрузки модулей [BUG-014] Возврат None в middleware адаптера приводит к потере данных события [BUG-015] Путь к файлу конфигурации зависит от рабочего каталога [BUG-016] BaseStorage путает сохранённое значение None с отсутствием ключа [BUG-017] Флаг auto_accept WebSocket-маршрутов теряется после перезапуска службы [BUG-018] Конкурентные вызовы HTTP/WS-клиента приводят к падениям и утечкам соединений [BUG-019] Конфликт маршрутов при горячей перезагрузке адаптера приводит к неудаче перезагрузки [BUG-020] В режиме подпроцессов ep run <script> не находит подпакеты в каталоге скрипта [BUG-021] Конструктор SQL-запросов отклоняет корректные подстановочные знаки и выражения столбцов [BUG-022] _resolve_account() — регрессия разрешения аккаунтов (_accounts_data не заполняется) [BUG-023] Кэш адаптера не обновляется после изменения конфигурации аккаунтов, что приводит к неудаче разрешения аккаунтов [BUG-024] storage.set() при записи ключей с большими числовыми ID вызывает OOM Kill [BUG-025] Колбэк on_config_update не маршрутизируется ядром [BUG-026] Ошибка определения цели reply для событий notice/request [BUG-027] Задача очистки rate limit маршрутов использует фиксированное окно, из-за чего правила с длинными окнами не работают [BUG-029] Задача отслеживания конфигурации транслирует недозаписанный TOML и молча глотает исключения [BUG-030] Состояние гонки в конфигурационном watcher приводит к молчаливой потере данных при отложенной записи setConfig [BUG-032] Во время отложенного сброса конфигурации «чтение сразу после записи» получает старое значение [BUG-033] Ответы, ожидающие в wait_reply, голодают из-за обработчиков с высоким приоритетом [BUG-034] Runtime-привязки scope с persist=False молча затираются любой последующей записью конфигурации [BUG-035] Опции select и поля типа dict в панели конфигурации отображаются как [object Object] [BUG-036] Эпизодические сбои записи конфигурации (ENOENT) при совместном использовании каталога конфигурации несколькими экземплярами [BUG-037] Зарегистрированные имена подкоманд с пробелом никогда не могут быть вызваны [BUG-038] Runtime-привязки с persist=False попадают на диск попутно с персистентными записями, «воскресают» с диска после выгрузки модуля [BUG-039] Несогласованность чтения/записи при сосуществовании записи целой секции и точечной записи (потеря точечных переопределений) [BUG-040] Тихая потеря хвостовых аргументов команды при разбиении сообщения платформой на сегменты [BUG-041] Отклонённая команда повторно прогоняет всю цепочку через alt_message: дублированные ответы и двойное срабатывание побочных эффектов функции прав [BUG-042] wait_reply, зарегистрированный внутри обработчика команды, немедленно потребляется тем же триггерным сообщением [BUG-043] select(): многопутевое ожидание с одним ключом — более поздний путь молча отменяет более ранний [BUG-044] BaseConverter.at() создаёт устаревший сегмент «at» формата OB11, проверка mention во всём фреймворке его не распознаёт [BUG-045] На адаптерах без alt_message интерактивные примитивы вечно ждут до таймаута, проход команд не работает [BUG-046] Заголовки вложенных подтаблиц декларативных шаблонов конфигурации смещаются в таблицы верхнего уровня [BUG-047] Полная нумерация каталога сервисов пропускает лениво загружаемые модули [BUG-048] API запросов к входящим бесед теряет атрибуцию сообщений (sender и метаданные события) [BUG-049] Эхо self-сообщений бота во входящих записывается как user, загрязняя атрибуцию входящих [BUG-050] Выполнение epsdk restart внутри контейнера приводит к немедленному завершению контейнера
Статическое зеркало — интерактивная версия является основной Открыть интерактивную версию →

Трекер ошибок

Документация отслеживает известные ошибки ErisPulse SDK и их исправления, отсортированные по времени исправления.

Для читателя Никакое программное обеспечение не может быть идеальным, даже самые внимательные разработчики могут оставить небольшие ошибки. В этот трекер включены только проблемы, которые реально влияют на работу — те, что слишком незначительны, чтобы даже назвать их «легкими», здесь не представлены. Хотя в списке значится много пунктов «серьезного» уровня, цель публичной записи этих ошибок — сделать отслеживание и восстановление более плавным, а не вызывать беспокойство: возможность видеть, записывать и исправлять проблемы — это доказательство постоянного улучшения проекта. Не стоит беспокоиться, увидев этот список: это инструмент для диагностики, а не источник страха.

Как читать и правила поддержки

  • Каждая запись об ошибке содержит структурированные поля: описание проблемы, анализ корневой причины, диапазон версий, в которых она влияет, схему исправления и т.д. Рекомендуется перед обновлением проверить, охватывает ли «диапазон версий» используемую вами версию.
  • Если вы хотите добавить новую запись об ошибке, добавьте её в соответствующее место, следуя описанным ниже полям и классификации серьезности/типа.

Описание полей

Обязательные поля

Поле Описание
Проблема Внешнее проявление ошибки, наблюдаемое пользователем. Стремитесь указать сообщения об ошибках или типичные сценарии
Причина Анализ корневой причины, указывающий на конкретные дефекты кода (включая «цепочку корневых причин» для сложных сценариев)
Влияющие версии Затронутый диапазон версий, формат введено версия - исправлено версия (включая бета-версии с обеих сторон)
Исправленная версия Номер конкретной версии, в которой была исправлена ошибка
Содержание исправления Краткое описание исправления, включая ключевые изменения в коде
Дата исправления Дата публикации соответствующей версии исправления, в формате YYYY/MM/DD
Серьезность Отмечено в соответствии с «шкалой серьезности»
Тип Отмечено в соответствии с «классификацией типов», может быть комбинированным (например, адаптер / маршрутизация)

Дополнительные поля

Поле Описание Сценарии применения
Шаги воспроизведения Минимальный путь для воспроизведения ошибки Рекомендуется для сложных и случайных ошибок
Связанные Ссылки на соответствующие Issues / PR / Commit Добавляется при наличии внешних обсуждений
Регрессионное тестирование Позиция тестовых случаев для проверки исправления и предотвращения повторного появления Добавляется, когда написаны тесты pytest

Шкала серьезности

Идентификатор Уровень Критерии Типичные проявления
🔴 Серьезный Причина сбоя процесса, потеря или повреждение данных, полная недоступность основных функций, уязвимости безопасности OOM Kill, невозможность отправки сообщения, невозможность загрузки модуля, неудачное горячее перезагрузка
🟡 Средний Нарушение функциональности, но есть пути обхода, недоступность неосновных функций, случайные проблемы Неверное определение состояния, повторное срабатывание, истечение кэша, неточное сообщение об ошибке
🟢 Легкий Не влияет на основную функциональность, проблемы качества кода или пользовательского опыта, потенциальные риски, не проявившиеся Устаревший API, мертвый код, отсутствие предупреждения в журнале

Классификация типов

Тип Охват
Система конфигурации ConfigManager, чтение и запись конфигурации, схема конфигурации, горячая перезагрузка
Система событий Event модуль (command/message/notice/request/meta), распределение событий, регистрация обработчиков
Адаптер AdapterManager, BaseAdapter, разбор аккаунтов, состояние Bot, промежуточное ПО
Маршрутизация RouterManager, HTTP/WebSocket/SSE маршруты, ограничение скорости, CORS
Клиент HttpClient, ClientWebSocket, aiohttp обертка
Хранилище StorageManager, SQLite, SQL генератор, вложенные ключи
Загрузка Loader, LazyModule, ModuleInitializer, строгий режим, обнаружение модулей
CLI epsdk команда, init/run/install, анализ параметров, обработка сигналов
Рантайм sdk.run/restart/uninit, жизненный цикл, сигналы, подпроцессы

Шаблон записи

При добавлении новой записи об ошибке используйте следующий формат:

### [BUG-XXX] Заголовок

**Проблема**: Описание проблемы (сообщение об ошибке или типичная ситуация)
**Причина**: Анализ корневой причины
**Влияющие версии**: Введено версия - Исправлено версия
**Исправленная версия**: x.x.x
**Содержание исправления**: Описание исправления
**Дата исправления**: YYYY/MM/DD

<!-- Дополнительные поля -->
**Шаги воспроизведения**: (рекомендуется для сложных ошибок)
**Связанные**: (ссылки на Issues/PR)
**Регрессионное тестирование**: (путь к тестовому случаю)

**Серьезность**: 🔴 Серьезный | 🟡 Средний | 🟢 Легкий
**Тип**: Система конфигурации / Система событий / Адаптер / Маршрутизация / Клиент / Хранилище / Загрузка / CLI / Рантайм

Обзор статистики

Серьёзность Количество
🔴 Критические 17
🟡 Средние 28
🟢 Незначительные 3
Итого 48
Тип Количество
Система событий 13
Система конфигурации 14
Адаптеры 5
CLI 4
Хранилище 4
Система загрузки 4
Маршрутизация 2
Клиент 1
Среда выполнения 1

Примечание: один Bug может относиться к нескольким типам; в таблице выше учёт ведётся по основному типу. Примечание: номера BUG-028 / BUG-031 отсутствуют (признаны недействительными при регистрации; для сохранения стабильности существующей нумерации не переиспользуются и не перенумеровываются).


Исправленные ошибки

[BUG-001] Повторная регистрация обработчиков событий приводит к многократной обработке событий

Проблема: При регистрации обработчиков с помощью нескольких декораторов, таких как @message / @notice, одно и то же событие срабатывает многократно, что приводит к многократному выполнению команд и дублированию вывода журналов.

Причина: BaseEventHandler при регистрации обработчиков в шине событий адаптера не имел логики дедупликации; каждый декоратор монтируется в шину один раз, и при диспетчеризации событий вызывается многократно.

Затронутые версии: 2.2.0-dev.0 - 2.2.1-dev.0

Версия исправления: 2.2.1-dev.0

Содержание исправления: Оптимизирован BaseEventHandler, чтобы гарантировать регистрацию обработчика для каждого типа события в адаптере только один раз, предотвращая повторные срабатывания.

Дата исправления: 2025/08/18

Критичность: 🔴 Критическая

Тип: Система событий


[BUG-002] Ошибка типа пути конфигурации адаптера в команде Init

Проблема: При интерактивной инициализации с помощью команды ep init выбор настройки адаптера вызывает ошибку типа:

Интерактивная инициализация завершилась ошибкой: unsupported operand type(s) for /: 'str' and 'str'

Причина: В версии 2.3.7 при изменении путей файлов конфигурации типы параметров методов оказались несогласованными. _configure_adapters_interactive_sync принимает параметр типа str, но внутри использует оператор / объекта Path для конкатенации путей.

Затронутые версии: 2.3.7 - 2.3.9-dev.1

Версия исправления: 2.3.9-dev.1

Содержание исправления: Тип параметра метода _configure_adapters_interactive_sync изменён с str на Path; при вызове теперь передаётся объект Path напрямую.

Дата исправления: 2026/03/23

Критичность: 🟡 Средняя

Тип: CLI


[BUG-003] Командные события перестают работать после перезапуска

Проблема: После вызова sdk.restart() команды, зарегистрированные через @command, перестают срабатывать: после отправки команды бот не отвечает.

Причина: После очистки шины событий в adapter.shutdown() состояние _linked_to_adapter_bus у BaseEventHandler не сбрасывается в False, из-за чего метод _process_event считает, что обработчик уже смонтирован в шину адаптера, и пропускает повторное монтирование.

Затронутые версии: 2.2.x - 2.4.0-dev.2

Версия исправления: 2.4.0-dev.3

Содержание исправления: Введено отслеживание состояния _linked_to_adapter_bus; после отключения от шины в _clear_handlers() при следующем register() выполняется автоматическое повторное монтирование, что подходит для сценариев shutdown/restart.

Дата исправления: 2026/04/09

Критичность: 🔴 Критическая

Тип: Система событий


[BUG-004] Обработчики событий жизненного цикла не очищаются

Проблема: После sdk.restart() старые обработчики событий жизненного цикла продолжают существовать и срабатывать повторно, из-за чего одно и то же событие обрабатывается несколько раз.

Причина: Словарь lifecycle._handlers никогда не очищался при uninit(), поэтому после restart старые обработчики сосуществуют с новыми.

Затронутые версии: 2.3.0 - 2.4.0-dev.2

Версия исправления: 2.4.0-dev.3

Содержание исправления: В конце процесса очистки Uninitializer (после отправки всех событий) словарь lifecycle._handlers очищается.

Дата исправления: 2026/04/09

Критичность: 🟡 Средняя

Тип: Среда выполнения


[BUG-005] detail_type у Event.is_friend_add/is_friend_delete не соответствует стандарту OB12

Проблема: Event.is_friend_add() проверяет detail_type == "friend_add", а Event.is_friend_delete() проверяет detail_type == "friend_delete", однако стандарт OneBot12 определяет значения detail_type как "friend_increase" и "friend_decrease". Это не совпадает со значениями, используемыми декораторами on_friend_add/on_friend_remove в notice.py, из-за чего при срабатывании обработчиков, зарегистрированных через декораторы, соответствующие методы проверки is_friend_add()/is_friend_delete() возвращают False.

Причина: В wrapper.py использовались нестандартные наименования, тогда как в notice.py использовались корректные наименования по стандарту OB12.

Затронутые версии: С момента внедрения по настоящее время

Версия исправления: 2.4.2-dev.1

Содержание исправления: Значение сопоставления is_friend_add() изменено с "friend_add" на "friend_increase", а is_friend_delete() — с "friend_delete" на "friend_decrease".

Дата исправления: 2026/04/13

Критичность: 🟡 Средняя

Тип: Система событий


[BUG-006] adapter.clear() не очищает _started_instances, что приводит к некорректному состоянию после перезапуска

Проблема: Метод AdapterManager.clear() очищает _adapters, _adapter_info, обработчики и _bots, но пропускает набор _started_instances. Если вызвать clear() во время работы адаптера, в _started_instances останутся висячие ссылки, что приводит к ошибочной оценке состояния после перезапуска.

Причина: При добавлении _started_instances в 2.4.0-dev.1 соответствующая очистка в clear() не была реализована.

Затронутые версии: 2.4.0-dev.1 - 2.4.2-dev.0

Версия исправления: 2.4.2-dev.1

Содержание исправления: В метод clear() добавлен вызов self._started_instances.clear().

Дата исправления: 2026/04/13

Критичность: 🟡 Средняя

Тип: Адаптер


[BUG-007] command.wait_reply() использует устаревший asyncio.get_event_loop()

Проблема: Метод CommandHandler.wait_reply() использует asyncio.get_event_loop() для создания future и получения временных меток; этот метод устарел в Python 3.10+, в асинхронном контексте следует использовать asyncio.get_running_loop(). Это не согласуется с get_running_loop(), используемым в методе wait_for() того же файла wrapper.py.

Причина: При разработке использовался устаревший API; впоследствии добавленный wait_for() использовал корректный API, но ретроспективное исправление старого кода не выполнялось.

Затронутые версии: 2.3.0-dev.0

Версия исправления: 2.4.2-dev.1

Содержание исправления: Два вызова asyncio.get_event_loop() в command.py заменены на asyncio.get_running_loop().

Дата исправления: 2026/04/13

Критичность: 🟢 Незначительная

Тип: Система событий


[BUG-008] События отключения ботов дублируются в процессе shutdown

Проблема: При вызове adapter.shutdown() для закрытия всех адаптеров _update_bot_status() многократно отправляет события отключения ботов в процессе завершения работы, из-за чего одна и та же группа ботов несколько раз помечается как офлайн и несколько раз вызываются события жизненного цикла adapter.bot.offline.

Причина: Система отслеживания статуса ботов, добавленная в 2.4.0-dev.1, не устанавливала флаг «идёт завершение работы» во время shutdown(), поэтому _update_bot_status() не могла отличить обычное отключение от каскадного отключения в процессе завершения работы.

Затронутые версии: 2.4.0-dev.1 - 2.4.2-dev.1

Версия исправления: 2.4.2-dev.1

Содержание исправления: В AdapterManager добавлен флаг _is_being_shutdown, который устанавливается в True в начале shutdown() и сбрасывается в конце; _update_bot_status() проверяет этот флаг и пропускает повторную отправку событий в процессе завершения работы.

Дата исправления: 2026/04/21

Критичность: 🟡 Средняя

Тип: Адаптер


[BUG-009] Синхронный доступ LazyModule к BaseModule приводит к незавершённой инициализации

Проблема: Когда пользователь обращается к атрибутам лениво загружаемого BaseModule в синхронном контексте, модуль инициализируется асинхронно через loop.create_task() без ожидания завершения, из-за чего при доступе к атрибуту инициализация может быть не завершена, что вызывает состояние гонки.

Причина: _ensure_initialized() для BaseModule вызывает loop.create_task(self._initialize()) и немедленно возвращается, не гарантируя завершения инициализации.

Затронутые версии: 2.4.0-dev.0 - 2.4.2-dev.1

Версия исправления: 2.4.2-dev.2

Содержание исправления: В синхронном контексте инициализация BaseModule теперь выполняется через asyncio.run(self._initialize()), гарантируя завершение инициализации перед возвратом. Свойства прозрачного проксирования сохранены: пользователю не нужно ощущать различия между синхронным и асинхронным режимами.

Дата исправления: 2026/04/21

Критичность: 🟡 Средняя

Тип: Система загрузки


[BUG-010] Многопоточная запись в системе конфигурации приводит к потере данных

Проблема: В многопоточной среде, когда несколько потоков одновременно вызывают config.setConfig(), операция чтения-модификации-записи в _flush_config() не является атомарной, что может привести к потере части записей.

Причина: Хотя _flush_config() использует RLock, между чтением и записью файла нет файловой блокировки, а таймер в _schedule_write может срабатывать несколько раз, вызывая перезапись.

Затронутые версии: 2.3.0 - 2.4.2-dev.1

Версия исправления: 2.4.2-dev.2

Содержание исправления:

  1. Добавлен механизм файловой блокировки (_file_lock) для обеспечения атомарности файловых операций
  2. Запись во временный файл с последующим атомарным переименованием (os.replace/os.rename)
  3. Улучшена логика отмены и перепланирования таймера в _schedule_write

Дата исправления: 2026/04/21

Критичность: 🔴 Критическая

Тип: Система конфигурации


[BUG-011] CTRL+C не останавливает программу в Windows

Проблема: При прямом запуске python main.py в Windows нажатие CTRL+C не завершает программу. После нормального запуска программы и вывода информации о маршрутизирующем сервере CTRL+C полностью не реагирует, процесс можно завершить только принудительно через диспетчер задач. При запуске через epsdk run остановка работает нормально — но epsdk run работает через модель подпроцессов.

Причина: Функция serve() ASGI-сервера Hypercorn внутри регистрирует собственный обработчик SIGINT через signal.signal(SIGINT, handler), переопределяя стандартный механизм обработки KeyboardInterrupt в Python. При запуске Hypercorn как фоновой задачи через asyncio.create_task() внутренний процесс shutdown Hypercorn не может корректно запуститься (поскольку он ожидает режим worker_serve), в результате сигнал CTRL+C поглощается Hypercorn без каких-либо действий по очистке.

Затронутые версии: 2.3.6 - 2.4.2

Версия исправления: 2.4.3-dev.0

Содержание исправления:

  1. ASGI-сервер переключён с Hypercorn на Uvicorn (изменение зависимостей в pyproject.toml)
  2. Сервер запускается напрямую через uvicorn.Server._serve(), в обход контекстного менеджера обработки сигналов capture_signals()
  3. Плавная остановка реализуется через server.should_exit = True, при таймауте фоновая задача отменяется
  4. Модель запуска через подпроцессы и модуль очистки runtime/cleanup.py удалены одновременно (механизм очистки подпроцессов больше не нужен)

Дата исправления: 2026/04/28

Критичность: 🔴 Критическая

Тип: CLI / Среда выполнения


[BUG-012] Код Python обновлённых модулей не вступает в силу после горячего перезапуска

Проблема: После мягкого перезапуска sdk.restart() новый код модулей/адаптеров, обновлённых через epsdk install (например, новые API-маршруты), не вступает в силу — продолжает работать логика старой версии. Для загрузки актуального кода требуется полный перезапуск процесса.

Причина: _do_restart() при повторной инициализации вызывает entry_point.load(), но эта функция возвращает кэшированный объект модуля старой версии из sys.modules, а не перезагружает с диска.

Затронутые версии: Ранние версии - 2.4.3-dev.1

Версия исправления: 2.4.3-dev.1

Содержание исправления: После uninit() и перед init() очищается кэш загруженных пакетов модулей/адаптеров в sys.modules, благодаря чему entry_point.load() загружает актуальный код с диска. Добавлены вспомогательные методы _collect_top_level_modules() и _invalidate_module_cache(), определяющие имена модулей верхнего уровня через top_level.txt или значение entry-point.

Дата исправления: 2026/05/03

Критичность: 🔴 Критическая

Тип: Система загрузки / Среда выполнения


[BUG-013] Ошибка логики сортировки в стратегии загрузки модулей

Проблема: ModuleLoadStrategy предоставляет поле priority для объявления приоритета инициализации модуля, но в реализации стратегии загрузки была ошибка, из-за которой модули не инициализировались в ожидаемом порядке приоритета, а фактически загружались в порядке по умолчанию entry_points(). Когда между модулями существуют зависимости загрузки, через priority невозможно обеспечить правильный порядок инициализации.

Причина: В реализации стратегии загрузки логика сортировки была ошибочной: initialize_modules() не сортировала список модулей по priority.

Затронутые версии: 2.3.4 - 2.4.5-dev.2

Версия исправления: 2.4.5-dev.3

Содержание исправления: Перед обходом в initialize_modules() список модулей сортируется по priority по убыванию. Модули с одинаковым priority сохраняют исходный относительный порядок (стабильная сортировка).

Дата исправления: 2026/05/15

Критичность: 🟡 Средняя

Тип: Система загрузки


[BUG-014] Возврат None в middleware адаптера приводит к потере данных события

Проблема: При выполнении цепочки middleware OneBot12 в adapter.emit(), если какая-либо middleware возвращает None (например, забыт return data), все последующие middleware и все обработчики событий получают processed_data равным None, что полностью выводит из строя обработку события.

Причина: Реализация цепочки middleware processed_data = await middleware(processed_data) не проверяет, является ли возвращаемое значение None, и напрямую перезаписывает результат обработки предыдущего шага.

Затронутые версии: unknown - 2.4.5-dev.3

Версия исправления: 2.4.5-dev.4

Содержание исправления: Если middleware возвращает None, возвращаемое значение игнорируется, исходные данные продолжают передаваться дальше, и выводится журнал уровня warning.

Дата исправления: 2026/05/15

Критичность: 🔴 Критическая

Тип: Адаптер / Система событий


[BUG-015] Путь к файлу конфигурации зависит от рабочего каталога

Проблема: Путь к файлу конфигурации в ConfigManager по умолчанию является относительным — "config/config.toml" — и при выполнении разрешается через os.getcwd(). Если рабочий каталог изменяется во время работы (например, через os.chdir()), операции чтения/записи файла конфигурации указывают на неверное расположение, что приводит к потере конфигурации или чтению устаревших данных.

Причина: В __init__ относительный путь сохраняется напрямую без разрешения в абсолютный путь при инициализации.

Затронутые версии: 2.3.7 - 2.4.5-dev.3

Версия исправления: 2.4.5-dev.4

Содержание исправления: В ConfigManager.__init__(), если передан относительный путь, он автоматически разрешается в абсолютный через os.path.abspath().

Дата исправления: 2026/05/15

Критичность: 🟡 Средняя

Тип: Система конфигурации


[BUG-016] BaseStorage путает сохранённое значение None с отсутствием ключа

Проблема: BaseStorage.get_multi() / __getattr__() не могут различить два случая: «ключ не существует» и «значением ключа является None». Если пользователь явно сохранил None, при последующем чтении это обрабатывается как отсутствие ключа.

Причина: Логика получения значения напрямую использует value is None для проверки существования ключа; отсутствует отдельный маркер «отсутствует».

Затронутые версии: Ранние версии - 2.4.6-dev.6

Версия исправления: 2.4.6-dev.6

Содержание исправления: Введено sentinel-значение _SENTINEL для различения «ключ не существует» и «значение равно None», эти случаи больше не путаются.

Дата исправления: 2026/06/07

Критичность: 🟡 Средняя

Тип: Хранилище


[BUG-017] Флаг auto_accept WebSocket-маршрутов теряется после перезапуска службы

Проблема: После перезапуска службы (например, sdk.restart()) конфигурация auto_accept всех WebSocket-маршрутов возвращается к False; соединения, которые ожидали автоматического accept, переходят в подвешенное состояние, клиент долгое время не получает ответа, что проявляется как зависание WS-соединения.

Причина: _restore_routes_from_records() при восстановлении маршрутов из сохранённых записей жёстко задавала auto_accept как False, не считывая значение из исходной записи; кроме того, при расширении кортежа хранения маршрутов с двух элементов до трёх логика восстановления не была синхронно обновлена.

Затронутые версии: 2.3.8-dev.0 - 2.4.6-dev.6

Версия исправления: 2.4.6-dev.6

Содержание исправления: Кортеж хранения маршрутов расширен до (handler, auth_handler, auto_accept); _restore_routes_from_records() теперь считывает реальное значение auto_accept из записи вместо жёстко заданного False.

Дата исправления: 2026/06/07

Критичность: 🔴 Критическая

Тип: Маршрутизация


[BUG-018] Конкурентные вызовы HTTP/WS-клиента приводят к падениям и утечкам соединений

Проблема: HTTP- и WebSocket-клиенты в Core/client.py в сценариях конкурентного доступа имеют несколько дефектов стабильности, приводящих к утечкам соединений или падению процесса:

  • При конкурентном вызове ClientWebSocket.receive() из нескольких корутин aiohttp выбрасывает Concurrent call to receive() is not allowed
  • Конкурентные вызовы _get_http_session() / _get_ws_session() могут создавать несколько session, при этом _drain_sessions() не закрывает старые соединения, вызывая их утечку
  • Неверный порядок перехвата исключений в request(): except ClientConnectionError (исключение ErisPulse) никогда не срабатывает, ошибки соединений aiohttp перехватываются общим except Exception, в результате логика «повтора соединения + пересоздания session» (мёртвый код) никогда не выполняется
  • send_json() игнорирует параметр mode="binary"; _get_ws_session() не передаёт заголовки запроса по умолчанию

Причина: Первоначальная реализация клиента (2.4.6-dev.5) не имела защиты от конкурентного доступа и классификации исключений; наследование между иерархией исключений aiohttp и пользовательскими исключениями ErisPulse было обработано неправильно.

Затронутые версии: 2.4.6-dev.5 - 2.4.8

Версия исправления: 2.4.8

Содержание исправления:

  1. Добавлена блокировка _recv_lock, сериализующая все вызовы receive() / receive_text() / receive_bytes()
  2. Добавлена блокировка _session_lock для защиты создания session; _drain_sessions() переделана в асинхронный метод и действительно закрывает старые session
  3. Рефакторинг порядка перехвата исключений в request(): asyncio.TimeoutError → aiohttp.ClientConnectionError (триггер пересоздания session) → aiohttp.ClientError → ClientError (проброс) → Exception
  4. Исправлены обработка mode в send_json(), проброс заголовков по умолчанию в _get_ws_session(), состояние гонки в close(), повторный release() в HttpResponse.__aexit__

Дата исправления: 2026/06/12

Критичность: 🔴 Критическая

Тип: Клиент


[BUG-019] Конфликт маршрутов при горячей перезагрузке адаптера приводит к неудаче перезагрузки

Проблема: Когда сторонний модуль (например, Dashboard) инициирует горячую перезагрузку адаптера, или при повторной попытке запуска адаптера после неудачи, из-за того что старые маршруты, зарегистрированные ранее (например, onebot11_default), не были очищены, выбрасывается конфликт WebSocket-путь ... уже зарегистрирован, и перезагрузка завершается неудачей. Для восстановления требуется полный перезапуск процесса.

Причина: AdapterManager.shutdown() очищает маршруты только через unregister_all_by_namespace(platform), но адаптеры (например, OneBot11) регистрируют WS-маршруты с пространством имён onebot11_{account_name}; несоответствие гранулярности приводит к тому, что очистка становится пустой операцией. Путь повторной попытки запуска после неудачи также не очищал оставшиеся с прошлого раза маршруты.

Затронутые версии: Ранние версии - 2.4.9

Версия исправления: 2.4.9

Содержание исправления:

  1. При регистрации маршрутов через current_owner ContextVar автоматически отслеживается связь принадлежности owner → namespace
  2. Добавлен unregister_all_by_owner(owner); при остановке/перезапуске очистка выполняется одновременно по owner, охватывая мелкогранулярные пространства имён
  3. Добавлен примитив _stop_adapter(platform) («остановка означает очистку»), связывающий остановку адаптера и освобождение его зарегистрированных ресурсов в одном вызове; restart() и повторные попытки запуска после неудачи проходят через этот вход
  4. Добавлен API уровня фреймворка adapter.restart(platform); сторонние модули должны вызывать этот метод, а не напрямую управлять экземпляром адаптера

Дата исправления: 2026/06/12

Критичность: 🔴 Критическая

Тип: Адаптер / Маршрутизация


[BUG-020] В режиме подпроцессов ep run <script> не находит подпакеты в каталоге скрипта

Проблема: При запуске скрипта в режиме без горячей перезагрузки через ep r .\main.py, если скрипт содержит относительные импорты (например, from qg import ...), возникает ошибка No module named 'qg'. В режиме --reload всё работает нормально.

Причина: Режим без горячей перезагрузки напрямую вызывает runpy.run_path() для выполнения скрипта; эта функция не добавляет автоматически каталог скрипта в sys.path. Режим --reload запускается через подпроцесс subprocess.Popen, подпроцесс автоматически наследует текущий рабочий каталог, и sys.path[0] является каталогом скрипта, поэтому всё работает нормально.

Затронутые версии: 2.5.0 - 2.5.2-dev.0

Версия исправления: 2.5.2-dev.0

Содержание исправления: Перед вызовом runpy.run_path() каталог скрипта вручную вставляется в sys.path[0].

Дата исправления: 2026/06/27

Критичность: 🟡 Средняя

Тип: CLI


[BUG-021] Конструктор SQL-запросов отклоняет корректные подстановочные знаки и выражения столбцов

Проблема: _build_select_sql() в SQLiteQueryBuilder вызывает _validate_identifier() для всех столбцов SELECT; эта функция использует строгое регулярное выражение белого списка ^[a-zA-Z_][a-zA-Z0-9_]*$, из-за чего корректный SQL-синтаксис ошибочно признаётся небезопасным именем столбца:

  • SELECT * — * — стандартный подстановочный знак SQL
  • SELECT COUNT(*) — агрегатная функция
  • SELECT users.name — квалифицированное имя столбца
  • SELECT col AS alias — псевдоним столбца

При этом Select("*") используется такими модулями, как Cron, из-за чего выполнение on_load модуля завершается ошибкой, и модуль не может быть загружен.

Причина: В версии 2.4.6 была усилена защита от SQL-инъекций с введением проверки по белому списку _validate_identifier(). Эта проверка применялась ко всем именам столбцов без различения стороны чтения (SELECT/ORDER BY) и стороны записи (INSERT/UPDATE). Столбцы SELECT допускают сложные SQL-выражения и не должны ограничиваться простым белым списком идентификаторов.

Затронутые версии: 2.4.6 - 2.5.2-dev.1

Версия исправления: 2.5.2-dev.2

Содержание исправления: Проверка столбцов SELECT/ORDER BY изменена с режима белого списка на режим чёрного списка:

  1. Добавлена функция _validate_select_column(), перехватывающая только опасные для SQL-инъекций символы (; ' " -- /* */ \x00, перевод строки)
  2. Разрешены любые корректные SQL-выражения столбцов (*, table.*, table.column, COUNT(*), col AS alias и т.д.)
  3. Для имён столбцов INSERT/UPDATE сохранена строгая проверка по белому списку (допускаются только простые идентификаторы)

Дата исправления: 2026/06/29

Критичность: 🔴 Критическая

Тип: Хранилище


[BUG-022] _resolve_account() — регрессия разрешения аккаунтов (_accounts_data не заполняется)

Проблема: После рефакторинга системы конфигурации в 2.5.2 мультиаккаунтные адаптеры, объявившие AccountConfigClass, при вызове методов, требующих отправки сообщений (таких как wait_reply, reply), выдают ошибку ValueError("AccountConfigClass не объявлен, невозможно разрешить аккаунт"). Даже при корректной настройке мультиаккаунтной информации адаптера разрешение аккаунтов по-прежнему завершается неудачей.

Причина: В 2.5.2-dev.5 _load_accounts() (отвечавшая за чтение конфигурации + валидацию + заполнение _accounts_data) была рефакторена в _ensure_accounts_exist() (только генерирует шаблон конфигурации), но _resolve_account() по-прежнему проверяет self._accounts_data is None. Поскольку _ensure_accounts_exist() больше не заполняет _accounts_data, атрибут всегда равен None, из-за чего _resolve_account() преждевременно возвращает (None, None), и разрешение аккаунтов полностью перестаёт работать.

Цепочка первопричины:

_load_accounts() удалена
  → __init__ больше не заполняет _accounts_data
    → _accounts_data всегда None
      → _resolve_account() проверяет _accounts_data is None → return (None, None)
        → места ниже по цепочке, вызывающие _resolve_account (например, call_api), получают None
          → возникает ошибка

Затронутые версии: 2.5.2-dev.5 - 2.5.2

Версия исправления: 2.5.3

Содержание исправления: В BaseAdapter.__init__ после _ensure_accounts_exist() восстановлено заполнение _accounts_data:

if self.AccountConfigClass is not None:
    self._ensure_accounts_exist()
    self._accounts_data = self.accounts  # восстанавливаем заполнение; источник данных — свойство accounts, читаемое в реальном времени

Логика _resolve_account() осталась без изменений, полная обратная совместимость:

  • адаптеры, не объявляющие AccountConfigClass: _accounts_data остаётся None → возвращает (None, None)
  • адаптеры, объявившие AccountConfigClass: _accounts_data заполнен → нормальное разрешение
  • адаптеры, переопределяющие _load_accounts или вручную устанавливающие _accounts_data: переопределяют после super().__init__(), имеют наивысший приоритет

Дата исправления: 2026/07/07

Критичность: 🔴 Критическая

Тип: Адаптер / Система конфигурации


[BUG-023] Кэш адаптера не обновляется после изменения конфигурации аккаунтов, что приводит к неудаче разрешения аккаунтов

Проблема: После изменения конфигурации аккаунтов мультиаккаунтного адаптера через Dashboard (например, заполнения token) адаптер продолжает использовать старый кэш; при вызове методов, связанных с отправкой сообщений, возникает ошибка Доступный аккаунт не найден (account_id=default). Для вступления новой конфигурации в силу требуется перезапуск процесса.

Причина: _accounts_data считывается из хранилища конфигурации только один раз в BaseAdapter.__init__ и больше не обновляется. AdapterManager._run_adapter() и restart() не перечитывают конфигурацию аккаунтов перед вызовом adapter.start(), из-за чего кэш расходится с фактической конфигурацией.

Затронутые версии: 2.4.6 - 2.5.4

Версия исправления: 2.5.4

Содержание исправления: В AdapterManager._run_adapter() и restart() перед вызовом adapter.start() выполняется обновление adapter._accounts_data = adapter.accounts, гарантирующее использование актуальной конфигурации при каждом запуске.

Дата исправления: 2026/07/09

Критичность: 🔴 Критическая

Тип: Адаптер / Система конфигурации


[BUG-024] storage.set() при записи ключей с большими числовыми ID вызывает OOM Kill

Проблема: При вызове storage.set() для записи вложенного пути ключей, содержащего большие чисто числовые сегменты (например, номер группы QQ 871684833), процесс уничтожается OOM Kill в контейнере (код выхода -9), служба сразу падает и не может восстановиться.

Причина: В рекурсивной реализации _set_nested_value чисто числовые сегменты вложенного пути ключей ошибочно распознаются isdigit() как индексы списка, что запускает current.extend([None] * (index - len(current) + 1)) — попытку выделить список из сотен миллионов элементов, мгновенно исчерпывая память.

Цепочка первопричины:

Путь ключей содержит чисто числовой сегмент (например, номер группы 871684833)
  → isdigit() ошибочно распознаёт его как индекс массива
    → extend([None] * (871684833 - len(current) + 1))
      → попытка выделить сотни миллионов элементов
        → исчерпание памяти → OOM Kill в контейнере (код выхода -9)

Затронутые версии: 2.5.1 - 2.5.5

Версия исправления: 2.5.5

Содержание исправления:

  1. При предварительном создании промежуточных уровней всегда используется словарь; тип контейнера больше не угадывается по тому, является ли следующий сегмент числом
  2. При установке конечного значения обработка по индексу выполняется только если контейнер сам является списком и индекс меньше STORAGE_MAX_LIST_INDEX (10000); слишком большие индексы безопасно пропускаются
  3. Рекурсивная реализация заменена на итеративную, устранён потенциальный риск бесконечной рекурсии в исходном коде
  4. Добавлена константа STORAGE_MAX_LIST_INDEX в Core/constants.py для централизованного управления безопасным пределом индекса

Дата исправления: 2026/07/10

Шаги воспроизведения:

# Срабатывает при записи вложенного пути ключей с большим числовым сегментом (например, номер группы QQ)
await sdk.storage.aset("groups.871684833.name", "некая группа")
# → память процесса мгновенно взлетает, происходит OOM Kill

Регрессионные тесты: в tests/unit/test_unit_storage.py добавлено 4 регрессионных теста

  • test_nested_key_numeric_segment_as_dict_key — точное воспроизведение сценария OOM
  • test_nested_key_numeric_segment_multiple — несколько последовательных числовых сегментов обрабатываются как ключи словаря
  • test_nested_key_existing_list_index_set_within_limit — запись по разумному индексу в существующий список
  • test_nested_key_list_index_safety_limit — проверка безопасного ограничения на слишком большие индексы

Критичность: 🔴 Критическая

Тип: Хранилище


[BUG-025] Колбэк on_config_update не маршрутизируется ядром

Проблема: Колбэк on_config_update(old, new) определён в базовых классах (BaseModule / BaseAdapter), но ядро фреймворка не связывает его с событиями изменения конфигурации. Фактическое поведение: срабатывает при изменении конфигурации через панель управления конфигурацией, но не срабатывает при ручном редактировании config.toml или вызове setConfig() из кода.

Причина: ConfigManager при изменении конфигурации генерирует события жизненного цикла config.set / config.updated, но отсутствует логика подписки, пересылающая эти события в методы on_config_update компонентов.

Цепочка первопричины:

Ядро не подписано на config.set / config.updated
  → события изменения конфигурации не пересылаются
    → on_config_update не вызывается
      → ручное редактирование файла / setConfig из кода не вызывает колбэк горячего обновления

Затронутые версии: Все версии

Версия исправления: 2.6.2

Содержание исправления: ModuleManager / AdapterManager регистрируют подписки на события config.set (покрывает путь setConfig() из кода) и config.updated (покрывает путь ручного редактирования файла); после сопоставления по префиксу ключа конфигурации вызывается on_config_update соответствующего компонента с передачей типобезопасного объекта конфигурации. Одновременно исправлена проблема, при которой _flush_config() после записи в файл не синхронизировала _config_mtime, из-за чего собственная запись фреймворка ошибочно распознавалась задачей отслеживания файлов как внешнее изменение и повторно вызывала config.updated.

Примечание о совместимости: Горячее обновление конфигурации теперь поддерживается централизованно ядром фреймворка. Логика, ранее вызывавшаяся от имени панели управления конфигурацией, удалена; после обновления фреймворка необходимо синхронно обновить панель управления конфигурацией, иначе возникнут повторные срабатывания (ядро и панель вызовут по одному разу). Сигнатура и семантика метода on_config_update остались без изменений, изменения в подклассах не требуются.

Дата исправления: 2026/07/23

Критичность: 🟡 Средняя

Тип: Система конфигурации


[BUG-026] Ошибка определения цели reply для событий notice/request

Проблема: При вызове event.reply() в событии группового уведомления (например, вступление участника в группу group_member_increase) сообщение отправляется в личные сообщения пользователя, вызвавшего событие, а не в группу, где произошло событие. Аналогично для событий уведомлений о друзьях цель ответа может быть перепутана.

Причина: infer_receive_type() возвращает detail_type события напрямую как тип беседы. Для событий message это корректно (значение detail_type — private/group — и есть тип беседы), но detail_type событий notice/request является семантическим подтипом (например, group_member_increase, friend_increase), а не типом беседы. Последующие convert_to_send_type() и get_id_field() не находят это значение в таблицах сопоставления и откатываются к значениям по умолчанию "user" / "user_id", из-за чего цель ответа перепутывается.

Цепочка первопричины:

событие notice, detail_type="group_member_increase"
  → infer_receive_type() возвращает напрямую "group_member_increase"
    → convert_to_send_type("group_member_increase") отсутствует в таблице сопоставления → откат к "user"
    → get_id_field("group_member_increase") отсутствует в таблице сопоставления → откат к "user_id"
      → target_id = event["user_id"]  ← личные сообщения нового участника (а не группа)

Затронутые версии: Все версии

Версия исправления: 2.7.0-dev.3

Содержание исправления: В infer_receive_type() добавлена проверка — detail_type возвращается напрямую только если он является известным типом беседы (стандартным или пользовательским); в противном случае корректный тип беседы выводится по полю ID (group_id / channel_id / user_id и т.д.).

Регрессионные тесты: tests/unit/test_unit_session_type.py → TestNoticeRequestTypeInference (10 тестов)

Дата исправления: 2026/07/29

Критичность: 🟢 Незначительная

Тип: Система событий


[BUG-027] Задача очистки rate limit маршрутов использует фиксированное окно, из-за чего правила с длинными окнами не работают

Проблема: При настройке ограничения частоты запросов (rate limit) маршрутов на длинные окна (например, 100/hour, {"requests": 100, "window": 3600}) ограничение фактически не работает — реальное поведение близко к 100/minute (за час может быть пропущено до примерно 6000 запросов), ожидаемая почасовая защита полностью отсутствует.

Причина: _apply_rate_limit разбирает фактическое window для каждого маршрута (до 3600 секунд), и проверка per-request действительно использует это окно; однако фоновая задача очистки _cleanup_expired_rate_limits использует фиксированную константу DEFAULT_RATE_LIMIT_WINDOW_SECS (60 секунд) как единый порог очистки для всех маршрутов. В результате в маршруте 100/hour отметки времени старше 60 секунд удаляются задачей очистки заранее, за часовой интервал никогда не накапливается близкое к 100 число записей, и ограничение существенно ослабляется.

Цепочка первопричины:

_apply_rate_limit разбирает window=3600 (100/hour)
  → проверка per-request хранит отметки времени в течение 3600s (корректно)
  → но _cleanup_expired_rate_limits очищает с фиксированным max_window=60s
    → все отметки времени старше 60s удаляются
      → в часовом окне всегда остаются только записи за последнюю 1 минуту
        → 100/hour фактически деградирует до ~100/minute (ослабление примерно в 60 раз)

Затронутые версии: 2.6.0-dev.0 - 2.7.0-dev.4

Версия исправления: 2.7.0-dev.5

Содержание исправления: Добавлен _rate_limit_windows: dict[str, int], записывающий фактическое окно каждого маршрута по store key; _apply_rate_limit записывает окно при первом создании записи; _cleanup_expired_rate_limits изменена на очистку по собственному окну каждого key (при отсутствии используется значение по умолчанию); при удалении записей очисткой и при stop() оба словаря синхронно поддерживаются.

Дата исправления: 2026/07/31

Регрессионные тесты: tests/unit/test_unit_router.py → TestRateLimit::test_cleanup_respects_per_route_window

Критичность: 🔴 Критическая

Тип: Маршрутизация


[BUG-029] Задача отслеживания конфигурации транслирует недозаписанный TOML и молча глотает исключения

Проблема: Когда пользователь вручную редактирует config.toml и сохраняет наполовину (возникает мгновенная синтаксическая ошибка), фоновый поток отслеживания конфигурации обнаруживает изменение mtime и перезагружает конфигурацию, но после неудачной загрузки всё равно генерирует событие config.updated с пустой конфигурацией {}, из-за чего on_config_update адаптеров/модулей получает пустую конфигурацию, ошибочно считает, что все элементы конфигурации очищены, и откатывается к значениям по умолчанию. Кроме того, цикл отслеживания глотает все исключения молча через except Exception: pass, и сбои watcher невозможно диагностировать.

Причина: Наложение двух дефектов:

  1. _load_config при синтаксической ошибке TOML/ошибке прав перезаписывает self._cache в {}, но фоновый поток отслеживания _watch_loop и путь таймаута кэша _check_cache_validity после вызова _load_config() выполняют _emit_config_updated() безусловно, транслируя «пустой кэш, возникший из-за неудачной загрузки» как реальное изменение.
  2. except Exception: pass в _watch_loop не записывает никаких журналов.

Цепочка первопричины:

Пользователь сохранил наполовину → синтаксическая ошибка TOML
  → _load_config() перезаписывает _cache = {}
    → _watch_loop безусловно вызывает _emit_config_updated(new_config={})
      → on_config_update адаптера/модуля получает пустую конфигурацию
        → ошибочное заключение, что конфигурация очищена, откат к значениям по умолчанию

Затронутые версии: 2.6.2-dev.1 - 2.7.0-dev.4

Версия исправления: 2.7.0-dev.5

Содержание исправления:

  1. _load_config изменена на возврат bool; при синтаксической ошибке TOML/ошибке прав/других ошибках сохраняется последний валидный кэш (больше не перезаписывается в {}), записывается только диагностический журнал и возвращается False
  2. _watch_loop и _check_cache_validity генерируют config.updated только когда _load_config() возвращает True
  3. except Exception в _watch_loop изменён на запись с уровнем warning (добавлен i18n-ключ core.config.watcher_error, синхронизирован для пяти языков)

Дата исправления: 2026/07/31

Регрессионные тесты: tests/unit/test_unit_config.py → test_malformed_toml_preserves_last_valid_cache, test_permission_denied_logs_clear_message (обновлены для проверки сохранения кэша + возврата False)

Критичность: 🟡 Средняя

Тип: Система конфигурации


[BUG-030] Состояние гонки в конфигурационном watcher приводит к молчаливой потере данных при отложенной записи setConfig

Проблема: Несколько пользователей сообщили, что после использования config.setConfig(key, value) (по умолчанию immediate=False) конфигурация их модулей не записывается в config.toml, тогда как конфигурация других модулей сохраняется нормально. Установка immediate=True (принудительный сброс на диск) позволяет обойти проблему. Проявляется так: конфигурация, записанная во время выполнения, теряется после следующего перезапуска, а конфигурация, сгенерированная по шаблону во время запуска, сохраняется.

Причина: Наложение двух дефектов:

  1. Логический дефект: _watch_loop при возврате True из _check_file_change() безусловно вызывает _dirty_keys.clear(), отбрасывая все ключи, ожидающие записи. Но _check_file_change() сравнивает mtime только через !=, и собственная запись на диск в _flush_config фреймворка также изменяет mtime — хотя _flush_config обновляет _config_mtime после записи на диск, поток watcher между записью файла и присваиванием mtime (а также на файловых системах с крупной гранулярностью) всё ещё может наблюдать разницу mtime, ошибочно признавая её «внешним изменением» и очищая все ключи, ожидающие записи.
  2. Дефект потоков: _watch_loop оперирует _write_timer/_dirty_keys без захвата _lock, существует состояние гонки данных с setConfig (пишет _dirty_keys под блокировкой) и _schedule_write (пишет _write_timer под блокировкой).

Цепочка первопричины:

Модуль A setConfig(immediate=True) → flush записывает на диск, mtime меняется
  → пользовательский модуль setConfig(immediate=False) → попадает в _dirty_keys, сброс на диск через 5s
    → watcher опрашивает, _check_file_change наблюдает разницу mtime от предыдущей собственной записи
      → _dirty_keys.clear() → ключи, ожидающие записи пользовательского модуля, молча отбрасываются
        → после перезапуска конфигурация отсутствует

Затронутые версии: 2.6.0 - 2.7.0

Версия исправления: 2.7.1

Содержание исправления:

  1. Добавлено поле _last_self_write_mtime, _flush_config синхронно записывает его после записи на диск; _check_file_change при изменении mtime сначала сравнивает с этим значением — при совпадении изменение определяется как собственная запись и возвращается False
  2. _watch_loop удерживает _lock на всём протяжении; при реальном внешнем изменении _dirty_keys сохраняется (семантика merge), при следующем flush происходит слияние с внешним содержимым (грязные ключи приоритетны), clear() больше не вызывается
  3. Пути getConfig/_check_cache_validity не затронуты (их reload и раньше не очищал грязные ключи)

Дата исправления: 2026/08/06

Регрессионные тесты: tests/unit/test_unit_config.py → test_self_write_not_detected_as_external, test_external_change_preserves_dirty_keys, test_flush_merges_dirty_with_external

Критичность: 🔴 Критическая

Тип: Система конфигурации


[BUG-032] Во время отложенного сброса конфигурации «чтение сразу после записи» получает старое значение

Проблема: После записи точечно-разделённого ключа через config.setConfig() (по умолчанию immediate=False, задержка сброса на диск около 5 секунд) немедленное чтение его родительского/предкового узла (например, после set_erispulse_section("scope.actions.MyModule", {...}) вызов get_erispulse_config()) возвращает старое значение; записанный дочерний ключ «исчезает» и становится видимым только после сброса на диск. Затрагиваются сценарии «запись-чтение-запись», такие как горячее обновление конфигурации области действия (выявлено на тест-кейсе /t_section тестового плагина 2.8.0).

Причина: setConfig сохраняет точечно-разделённые ключи в очередь на запись _dirty_keys в плоской форме, и только точный запрос ключа в getConfig попадает в очередь на запись; запросы по древовидному пути (getConfig("ErisPulse.scope")) идут только по дереву кэша, не накладывая значения, ожидающие записи — в период отложенного сброса на диск (только _flush_config объединяет грязные ключи в кэш и очищает очередь) образуется разрыв «чтение своей записи» (read-your-writes).

Затронутые версии: 2.6.0 - 2.8.0-dev.1

Версия исправления: 2.8.0-dev.1

Содержание исправления: В getConfig введена семантика наложения значений, ожидающих записи — ① точное попадание в ожидающий записи ключ возвращается напрямую (прежнее поведение без изменений); ② ожидающий записи ключ является предком запрашиваемого ключа → берётся самый длинный ожидающий записи предок, оставшийся путь разрешается в его поддереве значений; ③ ожидающий записи ключ является потомком запрашиваемого ключа → строится накладываемое поддерево (_dirty_overlay) и глубоко объединяется с поддеревом кэша (_deep_merge, приоритет у override, исходный объект кэша не изменяется). При отсутствии ключей, ожидающих записи, используется прежний быстрый путь с нулевыми дополнительными накладными расходами.

Дата исправления: 2026/09/04

Регрессионные тесты: tests/unit/test_unit_config.py → test_get_config_overlays_dirty_descendant, test_get_config_overlay_merges_with_cache_siblings, test_get_config_overlay_new_branch, test_get_config_dirty_ancestor_query, test_get_config_dirty_exact_key_still_wins

Критичность: 🟡 Средняя

Тип: Система конфигурации


[BUG-033] Ответы, ожидающие в wait_reply, голодают из-за обработчиков с высоким приоритетом

Проблема: Пока модуль вызывает wait_reply() и ожидает ответа пользователя, если ответное сообщение перехватывается обработчиком событий с более высоким приоритетом (mark_processed()), диспетчер команд при входе видит метку _processed и сразу возвращается; логика сопоставления ответов, находящаяся в конце диспетчера, никогда не выполняется — ожидающая сторона не получает ответ и может лишь ждать до таймаута, возвращающего None. Типичный сценарий срабатывания: боты с высокоприоритетными обработчиками сообщений (журналирование/аудит/перехват), у которых весь диалоговый интерактив хаотично выходит из строя.

Причина: Сопоставление ответов _check_pending_reply подвешено в конце _handle_message (выполняется только при отсутствии совпадения команды), а проверка _processed находится перед ней — порядок проверки перехвата и определения попадания ответа перевёрнут. Ожидание интеракции — это механизм продолжения сеанса уровня фреймворка, а не конкурирующий обработчик, и он не должен зависеть от перехвата другими обработчиками.

Затронутые версии: 2.2.0-dev.0 - 2.8.0-dev.1

Версия исправления: 2.8.0-dev.2

Содержание исправления: Определение попадания ответа перенесено на вход _handle_message (перед проверкой _processed, только для событий message): сначала предпринимается попытка завершить ожидающий диалог; при попадании событие помечается как обработанное, и проверки ниже естественно коротко замыкаются; при отсутствии попадания продолжается прежний процесс сопоставления команд. Одновременно цепочка определения делегирована новому менеджеру интерактивных сеансов (Core/Event/interaction.py), что попутно даёт возможности отмены по принадлежности и повторной проверки прав.

Дата исправления: 2026/09/08

Регрессионные тесты: tests/unit/test_unit_interaction.py (TestRegisterResolve попадание/непопадание/метка перехвата), tests/unit/test_unit_event.py (полная цепочка wait_reply)

Критичность: 🟡 Средняя

Тип: Система событий / Система команд


[BUG-034] Runtime-привязки scope с persist=False молча затираются любой последующей записью конфигурации

Проблема: записи во время выполнения, такие как scope.set_module(..., persist=False), изменяют только находящиеся в памяти self._data; однако scope подписан на события config.set / config.updated, и любая запись конфигурации в коде (например, когда какой-либо модуль при загрузке записывает свои настройки по умолчанию) вызывает полную пересборку дерева конфигурации scope из конфигурационного файла, при этом все ранее установленные runtime-привязки молча теряются (проверка откатывается к разрешению по умолчанию) без каких-либо записей в журнале. Сценарии, зависящие от runtime-привязок (переключатели Dashboard «только runtime», динамическое отключение модулей во время работы), откатывают поведение после записи конфигурации посторонним модулем.

Причина: цепочка первопричин: scope.set/delete(persist=False) пишет только в память (Core/scope.py) → любой setConfig вызывает событие config.set → _on_config_updated безусловно вызывает _load_config() → _apply_tree() полностью заменяет self._data = {...} → runtime-привязки, отсутствующие в конфигурационном файле, отбрасываются.

Затронутые версии: 2.8.0-dev.1 - 2.8.0-dev.2 Версия исправления: 2.8.0-dev.2 Содержание исправления: введён слой runtime-переопределений _runtime_overrides (включая маркер удаления): записи/удаления с persist=False фиксируются в слое переопределений, _apply_tree() после пересборки персистентного слоя воспроизводит их в порядке записи, runtime-правила остаются действительными после любой записи конфигурации; записи/удаления с persist=True очищают соответствующие записи переопределений (семантика пользовательской персистентности имеет приоритет); config.set фильтруется точно по key события, config.updated сравнивает старую и новую секции scope, пересборка выполняется только при фактическом изменении scope (попутно исключается сброс LRU-кэша проверок посторонними записями); добавлен unregister_by_owner() для резервной очистки вызывающей стороной при выгрузке модуля. В Core.Event.overrides runtime-переопределения с persist=False имели аналогичную проблему, исправлена синхронно той же архитектурой слоя переопределений. Дата исправления: 2026/09/09

Шаги воспроизведения: ① scope.set_module("testplat", blocked=["TestB"], persist=False) → проверка возвращает False; ② любой модуль выполняет config.setConfig("HelpModule", {...}) → происходит пересборка scope; ③ scope.is_allowed("testplat", None, "TestB") возвращает True (ожидается False). Связано: Issue #432 Регрессионный тест: tests/unit/test_unit_scope.py::TestRuntimeOverrideSurvival (выживание при посторонних записях / воспроизведение при пересборке дерева / маркер удаления / очистка при персистентности / точная инвалидация / очистка по owner)

Серьёзность: 🟡 средняя Тип: система конфигурации / runtime


[BUG-035] Опции select и поля типа dict в панели конфигурации отображаются как [object Object]

Проблема: в панели конфигурации WebUI выпадающий список опций поля select показывает [object Object] (например, динамически сгенерированные опции цветовых схем); поля типа dict без объявленного типа элемента управления (вложенные секции конфигурации, такие как stalker_mode, knowledge_base и т.д.) отображаются в текстовом поле как [object Object], их невозможно нормально просматривать и редактировать.

Причина: два независимых дефекта: ① i18n-парсер фреймворка _resolve_i18n_text восстанавливает только словари с ключом i18n; когда метка опции является словарём, содержащим только default (динамический текст без ключа i18n), она передаётся как есть, и на фронтенде строковое приведение esc(label) даёт [object Object]; ② ветка рендеринга Dashboard создаёт JSON textarea только для типа array, а значения dict попадают в ветку простого текстового ввода и преобразуются через String(). Кроме того, если модуль ошибочно объявит _schema_meta как обычное поле dataclass (без аннотации ClassVar), оно попадёт в schema как поле конфигурации, усугубляя путаницу.

Затронутые версии: 2.7.0 - 2.8.0-dev.2 Версия исправления: 2.8.0-dev.2 Содержание исправления: ① _resolve_i18n_text теперь поддерживает восстановление словарей, содержащих только default, в текст; ② пять мест фреймворка (schema/шаблон/значения по умолчанию/заполнение/валидация) единообразно исключают поля с префиксом подчёркивания (ошибочные объявления становятся безвредными); ③ резервный разбор объекта label опций select в Dashboard (приоритет default), поля dict/table рендерятся как JSON textarea (путь сохранения выполняет JSON.parse обратной записи с tp=object, полный round-trip). Дата исправления: 2026/09/09

Регрессионный тест: tests/unit/test_unit_config.py::TestResolveI18nDefaultOnlyDict, TestSchemaUnderscoreFieldExclusion

Серьёзность: 🟡 средняя Тип: система конфигурации


[BUG-036] Эпизодические сбои записи конфигурации (ENOENT) при совместном использовании каталога конфигурации несколькими экземплярами

Проблема: в сценариях Docker-развёртывания (несколько контейнеров монтируют один и тот же каталог конфигурации хоста) в журнале эпизодически появляются подряд две записи Failed to write configuration file ... [Errno 2] No such file or directory: '...config.toml.tmp' -> '...config.toml'. Данная запись конфигурации отбрасывается (старая конфигурация полностью сохраняется, потери конфигурации не наблюдалось), функциональность не затронута, но повторяющиеся предупреждения мешают диагностике, а ожидающие записи элементы конфигурации попадают на диск только при следующей записи.

Причина: цепочка первопричин: _flush_config / setConfigTemplate используют временный файл с фиксированным именем config.toml.tmp для нового содержимого, после write() без fsync сразу выполняется rename(). Когда два экземпляра ErisPulse используют один каталог конфигурации, open("w") экземпляра B может обрезать (truncate) временный файл, который в этот момент пишет экземпляр A → при rename в A цель уже забрана B или содержимое обрезано, возникает ENOENT (те самые две подряд идущие ошибки в журнале пользователя). В reported случаях проявлялось лишь предупреждение о сбое записи (старая конфигурация сохранялась); при ещё более крайнем чередовании таймингов rename может вывести пустой/полуцелый config.toml (потенциальный риск, в реальной среде пока не проявился). В сценарии с одним экземпляром отложенное выделение ext4 также создаёт окно сбоя «метаданные rename попадают на диск раньше блоков данных» (SIGKILL / отключение питания). _file_lock — это threading.RLock внутри процесса, он никак не ограничивает записи между процессами/контейнерами.

Затронутые версии: 2.2.0-dev.0 - 2.8.0

Версия исправления: 2.8.1

Содержание исправления: запись конфигурации единообразно сведена к _atomic_write_text(): mkstemp в том же каталоге создаёт уникальный для процесса временный файл (устраняет борьбу за фиксированное имя, при нескольких экземплярах деградирует до last-writer-wins, ENOENT больше не возникает) → по завершении записи flush + fsync принудительно сбрасывает данные на диск (устраняет окно «rename уже вступил в силу, данные ещё не на диске») → os.replace атомарно заменяет целевой файл (атомарно и на POSIX, и на Windows; в любой момент на диске либо целое старое содержимое, либо целое новое); на POSIX дополнительно выполняется fsync каталога конфигурации. Все три точки записи — _flush_config, setConfigTemplate и миграция конфигурации из корневого каталога — переключены; логика очистки в путях исключений переработана под уникальное имя временного файла. Добавлено обнаружение нескольких экземпляров: при запуске advisory lock (POSIX flock / Windows msvcrt.locking) эксклюзивно захватывает lock-файл каталога конфигурации .erispulse_config.lock; если он занят — выводится i18n-предупреждение (не блокирует запуск), блокировка автоматически освобождается ОС при завершении процесса, фантомных блокировок нет.

Дата исправления: 2026/09/13

Шаги воспроизведения: ① два контейнера монтируют один и тот же каталог config/ хоста и одновременно запускают ErisPulse; ② любой экземпляр инициирует запись конфигурации (например, модуль регистрирует конфигурацию по умолчанию); ③ в журнале наблюдается предупреждение о сбое записи ENOENT, данная запись отбрасывается (старая конфигурация сохраняется).

Связано: отчёт пользователя (контейнеры 1Panel ×2)

Регрессионный тест: tests/unit/test_unit_config_atomic_write.py (полная запись содержимого / отсутствие остатков временных файлов / при сбое записи исходный файл сохраняется / файл всегда валиден при параллельной записи двух экземпляров / создание lock-файла / предупреждение о нескольких экземплярах / атомарная запись при миграции)

Серьёзность: 🟢 незначительная

Тип: система конфигурации


[BUG-037] Зарегистрированные имена подкоманд с пробелом никогда не могут быть вызваны

Проблема: после регистрации подкоманды с много-токеновым именем команды, разделённым пробелами (например, @command("admin add")), команда нормально регистрируется и появляется в списке помощи, но при отправке пользователем /admin add бот никогда не отвечает — ввод сопоставляется родительской командой по токену как admin + аргумент ["add"]; если родительский токен тоже не зарегистрирован, ответа нет вообще. Обойти можно только при использовании точечной нотации (admin.reload, единый токен целиком).

Причина: цепочка первопричин: CommandHandler.__call__ сохраняет любое имя команды (включая форму с пробелами) как есть в плоский словарь self.commands → на этапе диспетчеризации _try_execute_command сопоставляет только по первому токену сообщения (cmd_name = parts[0]) → много-токеновое имя команды никогда не находится как ключ словаря. Предположения о пространстве имён команд на этапах регистрации и сопоставления не согласуются, и нет никаких предупреждений при регистрации (молчаливый отказ).

Затронутые версии: с момента введения командной системы - 2.8.0

Версия исправления: 2.8.1

Содержание исправления: слой сопоставления переведён на сопоставление по самому длинному префиксу: попытки начинаются с самого длинного кандидата (" ".join(parts[:n]), где n ограничено кэшем _max_name_tokens максимального числа токенов зарегистрированных имён команд/псевдонимов) с последовательным понижением, при попадании выполняется с оставшимися токенами в качестве аргументов, нижестоящие цепочки scope/ACL/переопределений/master/прав естественно действуют на полное имя команды. Сопутствующая семантика: при сосуществовании родителя и потомка ввод незарегистрированной подкоманды откатывается к родительской команде (историческое поведение сохранено); если подкоманда не объявила permission, права наследуются по родительской цепочке от ближайшего предка, объявившего права (защита родительской команды защищает все её подкоманды); при регистрации только одно-токеновых команд попадание происходит в первом же раунде, накладные расходы диспетчеризации не изменились. unregister / unregister_by_owner / полная очистка синхронно поддерживают кэш числа токенов.

Дата исправления: 2026/09/13

Шаги воспроизведения: ① регистрация @command("admin add") внутри модуля; ② отправка /admin add x; ③ до исправления — нет ответа (или одновременно зарегистрированная /admin перехватывает как аргументы), после исправления admin add срабатывает и get_command_args() возвращает ["x"].

Регрессионный тест: tests/unit/test_unit_command_subcommand.py (сопоставление по самому длинному префиксу / срабатывание только подкоманды / трёхуровневая вложенность / два режима чувствительности к регистру / одно- и много-токеновые псевдонимы / полное имя в полезной нагрузке события / полное имя в хуках жизненного цикла / шесть случаев наследования прав / ACL glob по полному имени / master / откат при разрегистрации и пересчёт кэша)

Серьёзность: 🟡 средняя

Тип: система событий


[BUG-038] Runtime-привязки с persist=False попадают на диск попутно с персистентными записями, «воскресают» с диска после выгрузки модуля

Проблема: runtime-привязки, записанные через scope.set(path, value, persist=False) (документация обещает: не записываются на диск, теряют силу при перезапуске процесса, очищаются при выгрузке модуля), при любой посторонней записи с persist=True (значение по умолчанию, например set_module модуля / сохранение конфигурации в WebUI) дифференциально записываются в пользовательский config.toml; после этого, даже если модуль выгружен и runtime-привязка разрегистрирована, при следующей перезагрузке конфигурации привязка «воскресает» с диска и продолжает действовать, сохраняется после перезапуска процесса — что противоречит семантическому контракту «runtime-привязки не записываются на диск» и крайне трудно поддаётся диагностике.

Причина: цепочка первопричин: ScopeManager.set() сначала записывает значение в дерево конфигурации в памяти _data (runtime-привязки тоже записываются прямо в _data) → ветка персистентности делает глубокую копию снимка всего _data и передаёт его в update_erispulse_config для дифференциальной записи на диск → в снимок примешиваются значения привязок с persist=False. delete(persist=True) имеет тот же источник: живая ссылка на _data (узел parent) передаётся в отложенную очередь грязных записей, и во время отложенной записи runtime-изменения соседних ключей под этим узлом записываются на диск вместе с ней; кроме того, пока живая ссылка задерживается в грязной очереди, существует окно перекрёстного загрязнения между записями.

Затронутые версии: 2.8.0-dev.2 - 2.9.0-dev.0

Версия исправления: 2.9.0-dev.2

Содержание исправления: введена персистентная база _persisted_tree (при пересборке дерева конфигурации обновляется деревом, загруженным с диска и прошедшим валидацию) как зеркало истинного состояния диска: set(persist=True) применяет данное изменение только к базе и затем отправляет дифференциал, runtime-привязки никогда не попадают в персистентное содержимое; «чтение сразу после записи» теперь восстанавливается напрямую из снимка финального состояния памяти, без пересборки через _apply_tree, чтобы не загрязнять базу. delete(persist=True) работает по той же методике: удаление применяется к базе, и глубокая копия поддерева базы передаётся слою персистентности; семантика полной замены set_action сначала удаляет по той же методике, затем записывает, старые ключи правил не остаются в персистентном содержимом.

Дата исправления: 2026/09/27

Шаги воспроизведения: ① внутри модуля выполняется scope.set("bots.p.debug_mode", {"blocked": ["X"]}, persist=False); ② инициируется любая персистентная запись (например, другой модуль вызывает set_module); ③ открывается config/config.toml, видно, что debug_mode записан (до исправления); ④ после выгрузки модуля (runtime-привязка разрегистрирована) инициируется перезагрузка конфигурации, scope.get("bots.p.debug_mode") по-прежнему возвращает привязанное значение.

Регрессионный тест: tests/unit/test_unit_scope.py::TestPersistBaseline (runtime-привязки не попадают на диск при посторонних персистентных записях / после выгрузки и разрегистрации перезагрузка конфигурации не воскрешает / delete отправляет поддерево базы без runtime-соседних ключей / замена set_action не оставляет остаточных ключей / настройка cache_size действует)

Серьёзность: 🔴 критическая

Тип: система конфигурации


[BUG-039] Несогласованность чтения/записи при сосуществовании записи целой секции и точечной записи (потеря точечных переопределений)

Проблема: в окне отложенной записи на диск при сосуществовании в одной секции записи целой секции (setConfig("Mod", {...}), например, запись обратно BaseModule.cfg) и точечной записи (setConfig("Mod.key", v), например, горячее обновление конфигурации / переопределение тестовыми инструментами) есть два варианта: вариант A (путь чтения) — getConfig("Mod") при чтении целой секции возвращает старый снимок целой секции, ожидающий записи, и не видит более поздних точечных переопределений (путь точечного чтения работает нормально); вариант B (путь записи, серьёзнее) — когда точечная запись идёт раньше, а запись целой секции позже (типичный тайминг: тестовый инструмент внедряет переопределение → модуль записывает обратно self.cfg = ...), flush применяет грязные ключи в порядке вставки, запись целой секции полностью заменяет секцию, точечное переопределение безвозвратно теряется на диске. В производственной среде триггером служит комбинация «горячее обновление конфигурации + запись обратно модулем во время работы», к тестовой среде отношения не имеет (выявлено по тестовому фидбеку ErisPulse-DailyCard).

Причина: сегмент ① в getConfig (точное попадание в _dirty_keys) делает преждевременный return self._dirty_keys[key], полностью минуя наложение потомков в _dirty_overlay сегмента ④; _flush_config применяет грязные ключи в порядке вставки _dirty_keys, и когда запись целой секции оказывается после точечной записи, точечное значение полностью заменяется. Кроме того: сегмент ① возвращает ссылку на исходный объект из грязной очереди, и изменение возвращённого dict вызывающей стороной на месте напрямую меняет состояние, ожидающее записи на диск.

Затронутые версии: 2.6.0 - 2.9.0-dev.2

Версия исправления: 2.9.0-dev.2

Содержание исправления: внутри грязного окна единообразно вводится семантика приоритета специфичности — точечные (более конкретные) ожидающие записи значения имеют приоритет над значениями целой секции (более широкими), пути чтения и записи на диск согласованы: ① getConfig после точного попадания в ожидающий записи ключ всё ещё накладывает ожидающие значения потомков из _dirty_overlay (для значений не-dict возвращается наложенное поддерево, согласовано со скалярными краевыми случаями ③+④); ② _flush_config сортирует грязные ключи по глубине пути при применении (целая секция/предки раньше, точечные/потомки позже, стабильная сортировка сохраняет тайминг записей одной глубины). Цена: в одном грязном окне (около 5 секунд) запись целой секции обратно не может перекрыть всё ещё висящую точечную запись — после исправления пути чтения цикл чтение-изменение-запись естественно несёт точечное значение, фактическое влияние минимально. ③ Возвращения getConfig, затрагивающие ожидающие записи значения (точное попадание / поддерево предка / наложенное слияние), переведены на изолированную копию copy.deepcopy, внутренние ссылки грязной очереди больше не утекают; быстрый путь без грязных ключей и поведение чистого чтения из кэша не изменились.

Дата исправления: 2026/09/28

Шаги воспроизведения: ① setConfig("FB.y", 1); ② setConfig("FB", {"z": 2}); ③ force_save() — до исправления на диске остаётся только [FB] z = 2 (y потерян), после исправления {"y": 1, "z": 2}; вариант A: после шагов ①② без записи на диск сразу getConfig("FB") — до исправления не содержит y, после исправления виден.

Регрессионный тест: tests/unit/test_unit_config.py::TestSectionAndDottedDirtyConsistency (оба порядка вставки варианта A / запись на диск варианта B не зависит от порядка / выживание в трёхуровневой смеси / изолированная копия / изоляция поддерева предка)

Серьёзность: 🟡 средняя

Тип: система конфигурации

[BUG-040] Тихая потеря хвостовых аргументов команды при разбиении сообщения платформой на сегменты

Проблема: когда платформа разбивает одно сообщение на несколько сегментов text (например, между /kick и аргументами находится сегмент mention, или сегментация от метода ввода), диспетчер команд берёт для сопоставления только первый сегмент text — /at @xxx 123 разбирается как at без аргументов, команда с объявленным args= сразу выдаёт «отсутствуют аргументы», без каких-либо следов. Причина: цикл извлечения текста в command.py после получения первого сегмента type=="text" выполняет break, остальные сегменты (включая все не-текстовые) отбрасываются. Затронутые версии: 2.6.0 (введение диспетчеризации команд) - 2.10.0 Версия исправления: 2.10.1-dev.0 Содержание исправления: текст команды теперь собирается по порядку сегментов из всех сегментов text, соединённых пробелами; прослойки mention/изображений больше не приводят к полной неразбираемости команды; попутно добавлена отказоустойчивость к деформированным сегментам (message как None/строка/не-dict сегменты больше не пробивают диспетчер насквозь). Регрессионный тест: tests/unit/test_unit_command_multiseg.py

Серьёзность: 🟡 средняя Тип: система событий

[BUG-041] Отклонённая команда повторно прогоняет всю цепочку через alt_message: дублированные ответы и двойное срабатывание побочных эффектов функции прав

Проблема: когда alt_message адаптера не совпадает с текстом сегментов сообщения (например, alt содержит префикс @текста), после того как совпавшая команда отклонена цепочкой scope/ACL/master/permission, диспетчер прогоняет всю цепочку заново через alt_message — пользователь получает два ответа «недостаточно прав», пользовательская функция прав (часто с побочными эффектами запросов к БД/счётчиками) вызывается дважды. Причина: путь отклонения return False и «команда не совпала» используют одно и то же возвращаемое значение, и диспетчер на этом основании считает возможным попробовать alt-фоллбэк; при этом событие уже было заявлено (claimed) до отклонения, и повторный прогон лишь дополнительно выполняет отправку ответа и проверку прав. Затронутые версии: 2.9.0 (формирование цепочки управления/прав) - 2.10.0 Версия исправления: 2.10.1-dev.0 Содержание исправления: обработка текста переведена на контракт из трёх состояний (unmatched/consumed/rejected) — после совпадения с зарегистрированной командой (независимо от отклонения) alt-откат больше не выполняется; alt-фоллбэк сохраняется только когда не совпала ни одна команда. Регрессионный тест: tests/unit/test_unit_command_multiseg.py::test_denied_command_not_rerun_via_alt

Серьёзность: 🟡 средняя Тип: система событий

[BUG-042] wait_reply, зарегистрированный внутри обработчика команды, немедленно потребляется тем же триггерным сообщением

Проблема: когда в теле выполнения команды вызывается wait_reply / регистрируется интерактивное ожидание, ожидание немедленно срабатывает на том же командном сообщении — первый вопрос интерактивного потока пропускается, «ответ пользователя» оказывается самим текстом команды (ответ мимо вопроса / загрязнение данных). Причина: _handle_message вызывает interaction.resolve дважды — в начале и в конце метода, и после выполнения команды второй resolve в конце срабатывает на ожидании, зарегистрированном заново во время выполнения; при выключенном cmdpass сценарий отсутствующего alt оценивался как пустая строка и пропускался напрямую, что усугубляло проблему. Затронутые версии: 2.8.0 (введение системы интерактивных сессий) - 2.10.0 Версия исправления: 2.10.1-dev.0 Содержание исправления: цепочка диспетчеризации сведена к единственному вызову interaction.resolve (в начале метода), повторный вызов в конце удалён; ожидания единообразно потребляются следующим сообщением. Регрессионный тест: tests/unit/test_unit_command_multiseg.py::test_wait_reply_not_consumed_by_command_trigger

Серьёзность: 🟡 средняя Тип: система событий

[BUG-043] select(): многопутевое ожидание с одним ключом — более поздний путь молча отменяет более ранний

Проблема: когда несколько ожиданий event.select() выводят один и тот же ключ сессии (тот же user с разными pattern, несколько ожиданий session и т.п.), позднее зарегистрированный путь отменяет ранее зарегистрированный как «конфликт», и select сразу выбрасывает InteractionCancelled вместо обещанного документацией возврата (None, None) по таймауту. Причина: каждый путь независимо вызывает interaction.register, взаимоисключающая семантика которого отменяет старое ожидание с тем же ключом, отправляя REASON_CONFLICT; утверждение в комментарии «многопутевость с тем же user не конфликтует из-за независимости копий событий» не соответствует действительности — копия меняет только user_id, а ключи многопутевого ожидания с тем же user полностью идентичны. Затронутые версии: 2.9.0 (введение select) - 2.10.0 Версия исправления: 2.10.1-dev.0 Содержание исправления: select переведён на агрегированное ожидание — все ожидания объединяются в единый элемент с пользовательским matcher (регистрация по множеству ключей, общий future), при попадании любого пути возвращается соответствующий индекс; многопутевое ожидание с одним ключом сосуществует естественно. Регрессионный тест: tests/unit/test_unit_command_multiseg.py::test_select_same_user_multi_branch

Серьёзность: 🟡 средняя Тип: система событий

[BUG-044] BaseConverter.at() создаёт устаревший сегмент «at» формата OB11, проверка mention во всём фреймворке его не распознаёт

Проблема: когда адаптер собирает входящее событие с помощью BaseConverter.at(), must_at_bot / has_mention() / on_at_message полностью слепы — команды с @бота молча перестают работать в группах. Причина: at() создаёт {"type": "at"} (форма OB11), тогда как вся проверка mention и сторона построения фреймворка (MessageBuilder/декораторы отправки) используют "mention" формата OB12, обе дорожки сосуществуют без каких-либо предупреждений. Затронутые версии: версия введения не ранее чем 2.5.0 - 2.10.0 Версия исправления: 2.10.1-dev.0 Содержание исправления: at() теперь создаёт {"type": "mention", "data": {"user_id": ...}} (имя метода сохранено как псевдоним, добавлен псевдоним mention). Регрессионный тест: tests/unit/test_unit_command_multiseg.py::test_converter_at_produces_mention

Серьёзность: 🟡 средняя Тип: адаптер

[BUG-045] На адаптерах без alt_message интерактивные примитивы вечно ждут до таймаута, проход команд не работает

Проблема: когда адаптер заполняет только сегменты message и не заполняет alt_message: confirm / choose / collect вечно ждут открытого текстового ответа пользователя (например, «да»); зарегистрированные команды в период ожидания так и не могут пройти насквозь и выполниться; Event.get_text() возвращает пустую строку, из-за чего примеры скаффолда молча перестают работать. Причина: все перечисленные пути напрямую берут строку alt_message без отката к сегментам сообщения — в рамках контракта фреймворка «alt_message — необязательное поле адаптера» заполнение одними лишь сегментами является легитимной формой. Затронутые версии: версии введения соответствующих интерактивных примитивов - 2.10.0 Версия исправления: 2.10.1-dev.0 Содержание исправления: единообразно применяется подход extract_text с приоритетом alt_message и откатом к сегментам text (пять точек получения значений/валидации интерактивных примитивов, определение cmdpass, Event.get_text()/get_message_text()). Регрессионный тест: tests/unit/test_unit_command_multiseg.py

Серьёзность: 🟡 средняя Тип: система событий

[BUG-046] Заголовки вложенных подтаблиц декларативных шаблонов конфигурации смещаются в таблицы верхнего уровня

Проблема: при первой генерации шаблона конфигурации для конфигурации, объявленной вложенными dataclass (поле dataclass, вложенное в ConfigClass), заголовок подтаблицы [Nested] оказывается на верхнем уровне файла, а не внутри секции компонента — адаптер при чтении cfg.<вложенное поле> не получает значения; в config.full.example такое же смещение. Причина: генератор шаблонов рендерит для вложенных dataclass относительные заголовки ([Nested]), тогда как семантика заголовков TOML — абсолютный путь от корня; старая реализация setConfigTemplate перемещала разобранные объекты таблиц в секцию компонента, а full.example собирал текст напрямую, и ни один из двух путей не заново заякорил относительные заголовки под путь компонента. Затронутые версии: 2.10.0 - 2.10.1 (рендеринг шаблонов вложенных dataclass введён в этих версиях) Версия исправления: 2.10.2 Содержание исправления: setConfigTemplate точно заново заякоривает заголовки по множеству путей подтаблиц, разобранных из шаблона ([Nested] → [ИмяКомпонента.Nested]); сторона генерации config.full.example теперь передаёт _prefix и напрямую создаёт абсолютные заголовки. Регрессионный тест: tests/unit/test_unit_config.py::TestTomlclassEngineMigration::test_template_write_idempotent_and_nested_anchored

Серьёзность: 🟡 средняя Тип: система конфигурации / адаптер


[BUG-047] Полная нумерация каталога сервисов пропускает лениво загружаемые модули

Проблема: полный каталог sdk.module.services() безусловно пропускает неинстанцированные (лениво загружаемые) модули — даже если модуль объявил meta.services, он не появляется в каталоге, и потребители, использующие каталог как точку входа для обнаружения (AI-агенты, help-модули и т.д.), не могут обнаружить их сервисы; точный запрос одного модуля services("Name") и топология get_topology() не затронуты. Причина: в ветке полной нумерации ModuleManager.services() для модулей без кэша контрактов (не загруженных) после разбора контракта на месте всё равно выполняется безусловный continue — по замыслу это должно было пропускать «модули без объявленных сервисов», фактически пропускались все незагруженные модули целиком; загруженные модули не затронуты, поскольку при загрузке пишут кэш контрактов. Затронутые версии: 2.9.0 - 2.10.1 (модульный RPC и каталог сервисов введены с 2.9.0) Версия исправления: 2.10.2 Содержание исправления: безусловный пропуск удалён, решение единообразно выносится по правилу «пропускать, только если результат разбора пуст»; для незагруженных модулей контракт разбирается на месте get_meta().services (та же методика, что и белый список module.call()), модули с объявленными сервисами попадают в каталог как обычно. Регрессионный тест: tests/unit/test_unit_module_rpc.py::TestServicesDirectory::test_lazy_declared_module_in_full_directory

Серьёзность: 🟡 средняя Тип: система загрузки

[BUG-048] API запросов к входящим бесед теряет атрибуцию сообщений (sender и метаданные события)

Проблема: записи, возвращаемые всеми интерфейсами запросов к входящим (get() / get_by_trace() / event.history()), содержат только role/text/ts/event_id — существующий в слое хранения столбец sender отбрасывается уровнем запросов, при воспроизведении группового чата сообщения разных участников неразличимы на уровне API (AI принимает участника B за собеседника A из предыдущего раунда); входящие записи к тому же не архивируют метаданные момента события, такие как никнейм, и при последующем обратном запросе получается «нынешний никнейм», а не «никнейм на тот момент». Причина: в комментарии при добавлении столбца sender в 2.8.0 прямо указывалось его назначение — «восстановление источника сообщения при воспроизведении», но ни Select, ни построение возвращаемых данных его не несли (упущение реализации); архивирование метаданных же вообще не проектировалось — у append() нет канала meta, в структуре таблицы нет соответствующего столбца. Затронутые версии: 2.8.0 - 2.11.0 (столбец sender введён с 2.8.0) Версия исправления: 2.11.1-dev.0 Содержание исправления: добавлен столбец meta (контракт белого списка: для входящих nickname/self_id/sub_type/message_id, для исходящих контекст отправки и module; старые таблицы мигрируют автоматически, при отсутствии поддержки ALTER в бэкенде — тихий откат к {}); append() получил параметр meta, проходящий через буфер в памяти и пакетную запись на диск; get / recent / get_by_trace / event.history единообразно возвращают sender + meta (при повреждении JSON — откат к {}). Связано: #467 (в той же партии #468 / #469 / #470) Регрессионный тест: tests/unit/test_unit_transcript_attribution.py::TestSenderMetaReadback / TestMetaMigration

Серьёзность: 🟡 средняя Тип: входящие беседы (inbox) / система хранения

[BUG-049] Эхо self-сообщений бота во входящих записывается как user, загрязняя атрибуцию входящих

Проблема: когда платформы/протоколы с включённым эхо сообщений (OneBot v11 report-self-message, Telegram outgoing и т.д.) сообщают о сообщениях, отправленных самим ботом, как о событиях message, во входящих всегда записывается role="user" — реплики самого бота неотличимы от реального ввода пользователя, нижестоящие модули обрабатывают реплики бота как пользовательский ввод (AI отвечает на «сказанное пользователем»), статистика по role искажается. Причина: точка автоматической записи входящих (Core/adapter.py) безусловно записывает role="user" для всех event_type == "message", не потребляя поле self для определения эха бота — при том, что логика автоматического обнаружения бота, следующая сразу за ней, уже потребляет то же самое поле (поле доступно в момент записи, но логика записи его упустила). Затронутые версии: 2.8.0 - 2.11.0 (автоматическая запись во входящие введена с 2.8.0) Версия исправления: 2.11.1-dev.0 Содержание исправления: перед записью эхо распознаётся по self.user_id == user_id и обрабатывается по новой настройке ErisPulse.transcript.self_echo в трёх режимах: "bot" (по умолчанию) — записывается role="bot" + sender=self_id + meta.self_echo=true; "skip" — не записывается; "user" — сохраняется старое поведение. Для платформ без эха (self отсутствует или не совпадает) поведение по каждому полю остаётся неизменным. Связано: #470 (опирается на столбец meta из #467 для хранения маркера self_echo) Регрессионный тест: tests/unit/test_unit_transcript_attribution.py::TestSelfEcho

Серьёзность: 🟡 средняя Тип: адаптер / входящие беседы (inbox)

[BUG-050] Выполнение epsdk restart внутри контейнера приводит к немедленному завершению контейнера

Проблема: когда фреймворк работает как главный процесс контейнера (PID 1) (официальный образ CMD ["epsdk", "run"] или скрипт прямого запуска), после установки компонента через ep i <пакет> и выполнения по подсказке epsdk restart контейнер сразу завершается и больше не поднимается — установленный новый компонент не вступил в силу, сервис прерван. Причина: реализация epsdk restart — «завершить работающий экземпляр + перезапустить с исходными параметрами» — перезапуск выполняется под управлением процесса epsdk CLI. В сценарии контейнера целевой экземпляр — это PID 1 (главный процесс контейнера), SIGINT/SIGTERM приводит к его завершению, что означает уничтожение всего PID namespace, CLI сам и дочерний процесс, ожидающий перезапуска, убиваются вместе, и перезапуск так и не может произойти. Затронутые версии: 2.11.0 - 2.11.2 (управление экземплярами через runtime.json введено с 2.11.0; в более ранних версиях команды restart не было) Версия исправления: 2.12.0-dev.0 Содержание исправления: когда epsdk restart обнаруживает в файле состояния pid == 1 (признак главного процесса контейнера), он больше не завершает процесс с перезапуском, а отправляет процессу фреймворка SIGUSR1, и фреймворк выполняет мягкий перезапуск на уровне компонентов внутри процесса (sdk.restart(): конвейер горячей перезагрузки модулей и адаптеров, entry-point недавно установленного адаптера вступает в силу немедленно во время работы); sdk.run() регистрирует обработчик SIGUSR1, обслуживающий этот канал. Сценарий перезапуска всего процесса передаётся перезапуску контейнера (docker restart / политика restart). Регрессионный тест: tests/unit/test_unit_cli_runtime.py::TestRestartContainerHot

Серьёзность: 🔴 критическая (перезапуск при контейнерном развёртывании означает прерывание сервиса) Тип: CLI / развёртывание