Трекер ошибок
Документация отслеживает известные ошибки 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
Содержание исправления:
- Добавлен механизм файловой блокировки (
_file_lock) для обеспечения атомарности файловых операций - Запись во временный файл с последующим атомарным переименованием (
os.replace/os.rename) - Улучшена логика отмены и перепланирования таймера в
_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
Содержание исправления:
- ASGI-сервер переключён с Hypercorn на Uvicorn (изменение зависимостей в
pyproject.toml) - Сервер запускается напрямую через
uvicorn.Server._serve(), в обход контекстного менеджера обработки сигналовcapture_signals() - Плавная остановка реализуется через
server.should_exit = True, при таймауте фоновая задача отменяется - Модель запуска через подпроцессы и модуль очистки
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
Содержание исправления:
- Добавлена блокировка
_recv_lock, сериализующая все вызовыreceive()/receive_text()/receive_bytes() - Добавлена блокировка
_session_lockдля защиты создания session;_drain_sessions()переделана в асинхронный метод и действительно закрывает старые session - Рефакторинг порядка перехвата исключений в
request():asyncio.TimeoutError→aiohttp.ClientConnectionError(триггер пересоздания session) →aiohttp.ClientError→ClientError(проброс) →Exception - Исправлены обработка 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
Содержание исправления:
- При регистрации маршрутов через
current_ownerContextVar автоматически отслеживается связь принадлежностиowner → namespace - Добавлен
unregister_all_by_owner(owner); при остановке/перезапуске очистка выполняется одновременно по owner, охватывая мелкогранулярные пространства имён - Добавлен примитив
_stop_adapter(platform)(«остановка означает очистку»), связывающий остановку адаптера и освобождение его зарегистрированных ресурсов в одном вызове;restart()и повторные попытки запуска после неудачи проходят через этот вход - Добавлен 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 *—*— стандартный подстановочный знак SQLSELECT 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 изменена с режима белого списка на режим чёрного списка:
- Добавлена функция
_validate_select_column(), перехватывающая только опасные для SQL-инъекций символы (;'"--/**/\x00, перевод строки) - Разрешены любые корректные SQL-выражения столбцов (
*,table.*,table.column,COUNT(*),col AS aliasи т.д.) - Для имён столбцов 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
Содержание исправления:
- При предварительном создании промежуточных уровней всегда используется словарь; тип контейнера больше не угадывается по тому, является ли следующий сегмент числом
- При установке конечного значения обработка по индексу выполняется только если контейнер сам является списком и индекс меньше
STORAGE_MAX_LIST_INDEX(10000); слишком большие индексы безопасно пропускаются - Рекурсивная реализация заменена на итеративную, устранён потенциальный риск бесконечной рекурсии в исходном коде
- Добавлена константа
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— точное воспроизведение сценария OOMtest_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 невозможно диагностировать.
Причина: Наложение двух дефектов:
_load_configпри синтаксической ошибке TOML/ошибке прав перезаписываетself._cacheв{}, но фоновый поток отслеживания_watch_loopи путь таймаута кэша_check_cache_validityпосле вызова_load_config()выполняют_emit_config_updated()безусловно, транслируя «пустой кэш, возникший из-за неудачной загрузки» как реальное изменение.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
Содержание исправления:
_load_configизменена на возвратbool; при синтаксической ошибке TOML/ошибке прав/других ошибках сохраняется последний валидный кэш (больше не перезаписывается в{}), записывается только диагностический журнал и возвращаетсяFalse_watch_loopи_check_cache_validityгенерируютconfig.updatedтолько когда_load_config()возвращаетTrueexcept 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 (принудительный сброс на диск) позволяет обойти проблему. Проявляется так: конфигурация, записанная во время выполнения, теряется после следующего перезапуска, а конфигурация, сгенерированная по шаблону во время запуска, сохраняется.
Причина: Наложение двух дефектов:
- Логический дефект:
_watch_loopпри возвратеTrueиз_check_file_change()безусловно вызывает_dirty_keys.clear(), отбрасывая все ключи, ожидающие записи. Но_check_file_change()сравнивает mtime только через!=, и собственная запись на диск в_flush_configфреймворка также изменяет mtime — хотя_flush_configобновляет_config_mtimeпосле записи на диск, поток watcher между записью файла и присваиванием mtime (а также на файловых системах с крупной гранулярностью) всё ещё может наблюдать разницу mtime, ошибочно признавая её «внешним изменением» и очищая все ключи, ожидающие записи. - Дефект потоков:
_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
Содержание исправления:
- Добавлено поле
_last_self_write_mtime,_flush_configсинхронно записывает его после записи на диск;_check_file_changeпри изменении mtime сначала сравнивает с этим значением — при совпадении изменение определяется как собственная запись и возвращаетсяFalse _watch_loopудерживает_lockна всём протяжении; при реальном внешнем изменении_dirty_keysсохраняется (семантика merge), при следующем flush происходит слияние с внешним содержимым (грязные ключи приоритетны),clear()больше не вызывается- Пути
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 / развёртывание