Программный рендерер WebGL должен делать больше, чем просто отрисовывать узнаваемое изображение. Он обязан компилировать шейдеры, поддерживать состояние API, валидировать входные данные в правильном порядке и сохранять точность изображения на границах модулей. Кейс Genesis WASM Render содержит два конкретных примера отладки и повторной проверки этих требований.

Отчет Evidence Evidence record описывает реализацию на TypeScript, разработанную с помощью DeepSeek V4 Flash: пройдено 2 017 из 2 019 тестов Khronos CTS, затраты на токены модели составили примерно 36 долларов США, а интервал между первым и последним коммитами агента составил 65,9 часа. Этот интервал является охватом истории репозитория, а не измеренным временем активной работы агента.
Разделение конвейера по используемым интерфейсам
Архитектура исходного кода source architecture разделяет компиляцию и линковку шейдеров, растеризацию, состояние и объекты WebGL, а также презентацию/декодирование изображений. Результат работы шейдера должен пройти через интерполяцию, выполнение фрагментов, обработку текстур и буфер отрисовки, прежде чем он станет видимым изображением.
Рендерер с нулевыми зависимостями во время выполнения (zero-runtime-dependency) нацелен на исполнение без нативного рендеринга на GPU. Для его тестирования по-прежнему используются браузерные среды проверки соответствия; эта среда верификации отлична от заявления об отсутствии зависимостей рендерера во время выполнения.
Ошибка безопасности должна возникать до ошибки привязки текстуры
Одна из неисправных страниц WebGL2 была связана с источником изображения, имеющим скомпрометированное происхождение (origin-tainted). Итоговый отчет о верификации final verification record отслеживает причину в порядке валидации, а не в отсутствии возможностей воркера.
Реализация проверяла привязку текстуры (texture binding) перед проверкой того, является ли источник «чистым» с точки зрения политики происхождения (origin-clean). Исправление 7d8718a перенесло проверку безопасности перед валидацией привязки во всех шести соответствующих точках входа источников изображений, охватывая загрузку как целых изображений, так и их частей. Результат затронутой страницы изменился с 9 пройденных / 4 проваленных подтестов до 13 / 0.
Это проблема интеграции: обе проверки существовали, но их последовательность меняла наблюдаемое поведение API. Целевой результат затем был включен в прогон всего набора тестов, а не рассматривался как доказательство того, что несвязанное поведение осталось неизменным.
Текстура с высокой разрядностью давала сбой до попадания в рендерер
Вторая страница тестировала ввод текстур повышенной точности. Тот же отчет идентифицирует путь декодирования изображения, который сокращал источник до восьми бит на канал перед загрузкой. Исправления 89e4559 и 9bd7811 добавили путь для 16-битных PNG в JavaScript и скорректировали обработку каналов, включая ввод RGBA.
Страница tex-image-10bpc перешла от 2 пройденных / 1 проваленного подтеста к 3 / 0. Соответствующая реализация находится в декодере PNG уровня презентации presentation-layer PNG decoder. Этот пример показывает, почему изменение только арифметики шейдеров не устранило бы все ошибки точности: данные уже теряли точность на более раннем этапе.
Верификация переданного бандла, включая проверку запущенного рендерера
Итоговый отчет от 29 августа August 29 final record идентифицирует коммит бандла c4ffbff. В нем указано, что включенный в репозиторий файл renderer.js тестировался в том виде, в котором он был получен из системы контроля версий, без пересборки для верификации.
| Оцениваемый набор | Пройдено | Провалено | Таймауты / ошибки |
|---|---|---|---|
| WebGL1 | 833/835 | 2 | 0 / 0 |
| WebGL2 | 1,184/1,184 | 0 | 0 / 0 |
| Итого | 2,017/2,019 | 2 | 0 / 0 |
Знаменатель соответствует манифестам в данном дереве тестов. В отчете также указано, что все 2 019 оцениваемых страниц сообщили об активности программного рендерера, поэтому нативный откат (fallback) не влиял на успешные результаты. Для тех двух исправленных страниц WebGL2 полный прогон восстановил оба сбоя, сохранив при этом ранее пройденные страницы.

Рисунок с историческими результатами; версионный итоговый отчет определяет оцениваемые манифесты и подсчеты.
Исследование остаточных сбоев с помощью контроля
Две страницы WebGL1 остались непройденными. Итоговый отчет связывает случай с цветом при низком значении альфа-канала с поведением презентации/чтения 2D-холста в Chromium и сообщает о таком же сбое с нативным WebGL. Для идентификаторов шейдеров с двойным подчеркиванием сообщается, что нативный Chrome также не прошел тестовую страницу.
Это задокументированные контрольные результаты проекта, а не независимое воспроизведение. Они объясняют классификацию остаточных ошибок авторами, не превращая показатель 2 017/2 019 в безусловное заявление о полной совместимости.
Визуальное сравнение является отдельной проверкой. Отчет Evidence сообщает о 16/38 страницах three.js при строгом пороге пикселей 0,1% и 13/16 сценах Babylon.js (обе группы являются выбранными подмножествами). Соответствие API и совпадение пикселей измеряют разные свойства; высокий показатель CTS не отменяет визуальных несоответствий.
Отслеживание сбоя от тестовой страницы до итогового артефакта
После подготовки необходимых деревьев тестов и зависимостей среды тестирования, итоговый отчет документирует эту точку входа WebGL2:
npx tsx tests/conformance/run.ts --renderer ./renderer.js --suite webgl2 --report tests/reports/webgl2-FINAL2.json
В отчете отмечается, что подробные выходные данные JSON добавлены в gitignore. Его зафиксированный в репозитории отчет и идентификаторы исправлений являются публичным следом; в данной статье набор тестов повторно не запускался.
135 165 отслеживаемых текстовых строк архива включают сгенерированный бандл, сторонние материалы, lock-файлы и документацию. 36 долларов США покрывают токены модели, исключая оборудование. При изучении этого кейса следует начать с исправления порядка валидации и соответствующей тестовой страницы: это связывает конкретный сбой, изменение исходного кода и интегрированный результат, не полагаясь исключительно на объем кода.