Skip to content

v8inject v0.8.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 14:49
· 2 commits to main since this release

Релиз стабилизации: закрыты все 58 находок полного ревью кода
(docs/AUDIT.md, §9) — 10 пакетов правок от крэш-безопасности
payload до движка хуков, плюс новые иконки GitBar из открытого набора
qtv8reader. Поведение пользователя почти не изменилось; изменилась
надёжность: сессии переживают таймауты, ответы всегда остаются валидным
JSON, хуки не портят регистры, git-операции ограничены по времени и объёму.

Что нового

  • Иконки GitBar из qtv8reader. 16×16 PNG из открытого MIT-набора
    metadata-icons (zerobig/vscode-1c-metadata-viewer), перекрашенного в
    палитру 1С и взятого из соседнего проекта fishca/qtv8reader. Панель и
    нативное подменю используют одни и те же глифы; исходники и атрибуция — в
    src/payload/icons/qtv8reader/.
  • Версионированный протокол (ABI 2). Блок разделяемой памяти несёт
    abiVersion, hostPid, respSeq; хост и payload проверяют сборку друг
    друга. Несовпадение — понятная диагностика с требованием перезапустить
    цель, а не тихая порча памяти. Все ранние отказы подключения называют
    причину (LastError).
  • trace с бюджетом ответа. Вместо «response too large» команда отдаёт
    столько записей, сколько влезает, с маркерами "truncated":true и
    "dropped":N; trace --clear корректно работает под живыми писателями.
  • Лицензии в релизном архиве. Zip теперь содержит LICENSE,
    THIRD-PARTY-NOTICES.md и LICENSES/ (Capstone — 3-clause BSD, иконки —
    MIT): тексты, обязательные для бинарной поставки.

Исправлено

Крэш-безопасность payload. scan целиком под SEH с проверкой vtable
перед QueryInterface; наблюдатель окон и x64-сканы кучи читают только
проверенную память; обход PEB-списка модулей ограничен и защищён от циклов;
PE-парсер не выходит за читаемые регионы и не оборачивает RVA; лог
инициализируется без гонок; цепочка кадров на x64 строится через
RtlVirtualUnwind, а не по rbp.

Жизненный цикл сессии. Таймаут больше не оставляет сессию занятой
навсегда: состояние возвращается в Idle, поздний ответ отбрасывается, а не
затирает следующий. Payload сам уходит, когда процесс-хост умер, и блок
переиспользуется без ALREADY_EXISTS. Close честно сообщает, если exit
встал в очередь за выполняющейся командой.

Инжект. Адрес v8i_probe берётся из таблицы экспорта образа, который
лежит в цели (дельта баз больше не применяется): повторное подключение и
несовпадение сборок диагностируются точно. Разрядность определяется по
машине процесса — 32-битная 1С на 64-битной Windows больше не считается
64-битной.

Маршал и нативное меню. Слот маршала заполняет единственная функция под
замком, у каждого запроса свой reqId: двойного выполнения команд
(выгрузка/коммит) не бывает, просроченные сообщения игнорируются. Хуки
обёрток getService ставятся только на точной сборке 8.3.27.2342 при
совпадении пролога; установка слотов — транзакция с откатом. Выключатель
[git] nativemenu читается из UTF-16 ini, который пишет сам payload.
Диагностические QI-ссылки освождаются, CBT-дамп ограничен и снимается после
первого окна.

JSON и диагностика. Ответы pe, menu, cmdinfo, around, xref
всегда валидный JSON: длинные имена не рвутся, кириллица не теряется,
висячих запятых нет. Ответ, не влезающий в блок, — честная ошибка с
размером, а не обрезанный документ. Длинная командная строка (до 4095
символов) доходит до команды целиком; строки лога не склеиваются.

Сканеры x64. heapobjects и byhwnd действительно находят объекты на
x64 (читается машинное слово, а не младшие 4 байта). Числовые аргументы
разбираются строго: -1, 0x, переполнение — ошибка; пределы отклоняются
явно, а не зажимаются молча; списки модулей снимаются один раз на команду.

GitBar. Путь из git status --porcelain берётся по двум колонкам
статуса — изменённые, но не проиндексированные файлы ( M) снова попадают
в add/commit. WM_QUIT доходит до цикла бара: закрытие Конфигуратора
завершает поток панели. Пишущие операции проверяют корень репозитория:
папка внутри чужого репозитория отвергается (файлы чужого проекта не уходят
в push). Git ограничен дедлайном и объёмом вывода, таймаут убивает всё
дерево потомков (credential helper/ssh), прерванный add не коммитится.
Патч истории — не больше 1 МБ / 20 с, с LRU-кешем.

Хосты (CLI/GUI/агент). watch срабатывает на каждую выгрузку, а не
только на первую; кеш путей ограничен и переспрашивает неудачи. GUI:
модальные диалоги не съедают WM_QUIT, операции идут в рабочем потоке,
раскладка масштабируется под DPI (per-monitor v2), настройки сохраняются с
проверкой. Агент опознаёт процесс по pid + времени создания (переиспользованный
PID — новая 1С), транзиентные отказы ретраятся, автозапуск в реестре
закавычен и читается обратно.

Движок хуков. x64-трамплин сохраняет xmm0-xmm5 и возвращаемое значение
в rax; x86 — this в ecx для __thiscall и аргументы __fastcall,
кадр выровнен под конвенцию. Повторный хук на ту же цель отклоняется;
снятие восстанавливает байты, только если они ещё наши, и перестаёт писать
в трассу до восстановления. Кольцо трассы — 64-битные счётчики и
согласованное чтение записи; VEH больше не забивает лог штатными
SEH-зондированиями 1С; дизассемблер и xref читают только читаемые страницы.

CLI. attach читает строку целиком (консоль — UTF-16, pipe/файл —
UTF-8): длинная строка — одна ошибка, а не две команды. --pid работает в
любой позиции и не сдвигает аргументы. cmd, menu, menucmd, str
форвардятся из CLI; menucmd проверяет владельца окна.

Изменено

  • Нативный пункт меню строится только на 8.3.27.2342 (точный гейт по
    сборке и прологу); на прочих сборках, включая 8.3.27.1989, работает
    оверлей-меню GitBar. На x86 обёртки getService не хукаются (RVA
    откалиброваны на x64).
  • find --max ограничен 8192, heapobjects --count — 200000 и т.д.:
    значения сверх пределов отклоняются с JSON-ошибкой.
  • Иконки больше не рендерятся из Phosphor: tools/render_icons.cjs и
    src/payload/icons/phosphor/ удалены, новый tools/select_icons.py
    раскладывает готовые PNG по ролям.

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

  • 8.3.27.1989 (x86/x64) — команды дизайнера, GitBar-оверлей;
  • 8.3.27.2342 (x64) — нативное меню (точная сборка);
  • 8.5.1.1529 x64 — ранняя подписка WH_CBT.
    Прочие патчи семьи не проверялись.

Проверено

  • Release-сборки x64 и x86 (/W4 /WX) — без предупреждений; CTest 4/4 на
    каждой разрядности (cli_help, unit, hook_smoke, hook_stress).
  • unit: 162 теста / 1431 проверка на x64, 159 / 1389 на x86 (было
    60/856 и 59/827 до стабилизации). Ключевые регрессии проверены «на старом
    коде»: с откатом правок падают ровно тесты своего пакета.
  • Живые проверки на стенде (v8i_hook_target.exe) и файлах установленных
    платформ: смерть хоста, несовпадение сборок payload, гейт пролога,
    --pid, длинный ввод attach, владелец окна menucmd, упаковка zip с
    лицензиями. Подробности по каждому пакету — в
    docs/AUDIT.md, §9.9.

Установка

v8inject-v0.8.0-x64.zip / v8inject-v0.8.0-x86.zip — v8inject.exe,
v8inject-gui.exe, v8inject-agent.exe, v8i_payload.dll плюс тексты
лицензий. Распакуйте архив той же разрядности, что ваша платформа 1С, и
запускайте v8inject.exe, v8inject-gui.exe или v8inject-agent.exe из
каталога с v8i_payload.dll. Нативный пункт меню включён по умолчанию
(на 8.3.27.2342 x64); ключ [git] nativemenu=0 в
%APPDATA%\v8inject\gitbar.ini возвращает оверлей-реплику.

Лицензии

Иконки GitBar — metadata-icons из zerobig/vscode-1c-metadata-viewer
(MIT, Copyright (c) 2023 zerobig and contributors), взяты в перекрашенном
виде из fishca/qtv8reader; текст лицензии — в архиве под
LICENSES/icons/. Остальное — MIT, см. LICENSE; Capstone — 3-clause BSD
(LICENSES/capstone/). Полный перечень — THIRD-PARTY-NOTICES.md.