Три недели исправлений: как форк OpenResearch выдержал испытание реальными пользователями и обновлениями ZCode
Спустя две недели после запуска форка OpenResearch с тремя новыми кодинговыми агентами, разработчики занялись поддержкой. За три недели команда выпустила восемь обновлений, доработав интеграцию с ZCode, добавив поддержку русского языка и внедрив критические исправления, найденные независимыми аудитами.
# Три недели сопровождения форка OpenResearch: от ошибок входа до двух PR в upstream
Статья описывает процесс пост-релизной поддержки проекта OpenResearch. После запуска версии 0.3.2, где были добавлены агенты Kimi Code, MiniMax Code и ZCode, проект столкнулся с необходимостью постоянной адаптации к изменениям upstream и обратной связи от пользователей.
Хронология обновлений и статистика
С 28 сентября по 16 октября было выпущено восемь версий проекта, от v0.3.3 до v0.3.10. Основной фокус первых недель лежал на исправлении критических багов, сообщенных читателями, и синхронизации с исходным репозиторием (upstream).
Итоги этого периода впечатляют по объему автоматизированной работы: * Релизы: 8 выпусков за 19 дней. * Работа агента: 11 часов 16 минут чистого времени работы Claude, распределенное на 18 дней. * Изменения в коде: 33 коммита, 5258 добавленных и 1090 удаленных строк кода в 61 файле. * Тестирование: Добавлено 28 новых тестов. * Влияние на сообщество: Два успешных Pull Request (PR) отправлены в upstream: #600 с реализацией трёх агентов и #650 с русской локализацией интерфейса. * Экономия: Реальные затраты на API составили всего $32, тогда как цена по официальным тарифам могла бы превысить $230.
Сложности интеграции ZCode
Одной из главных задач стало исправление функционала агента ZCode. Уже через два дня после выхода статьи пользователь столкнулся с ошибкой выбора модели, что выявило фундаментальную проблему: десктопное приложение ZCode не передавало модели доступному рантайму OpenResearch. Это привело к серии последовательных исправлений, начиная с версии 0.3.3.
Проблемы возникали на стыке разных технологий: десктопное приложение Windows, командная строка и облачные сервисы. В версии 0.3.4 была добавлена возможность выбора модели для каждого отдельного чата, а в 0.3.7 устранена проблема гонки данных, когда одновременные чаты перезаписывали настройки друг друга.
Особое внимание уделено изменениям в версии ZCode 3.15. Обновление переключило аутентификацию с ключа плана на OAuth-токен, что сломало существующие логики входа. Разработчикам пришлось адаптировать запуск под псевдоконсоль (ConPTY) и использовать PowerShell для корректного перехвата вывода, который ранее терялся. Также была переработана интеграция с app-server ZCode, который использует закрытый протокол JSON-RPC по stdio. Без полного понимания протокола реализовать полноценные карточки подтверждения и режимы планирования (Plan) было невозможно.
Для корректной работы моделей, требующих API-ключей, была изменена архитектура хранения данных. Теперь ключи вводятся непосредственно в настройках провайдера внутри самого приложения ZCode, а OpenResearch получает доступ к ним автоматически, не храня их на стороне сервера.
Аудит, локализация и будущее
Качество интеграции повысилось благодаря независимому ревью проекта Greptile. Бот нашел критические ошибки, включая отсутствие блокировки режимов у других агентов и потерю контекста сессий, которые пропустили и разработчики, и сам агент Claude. После исправления замечаний Greptile поставил оценку 5/5.
Также в рамках этого этапа была завершена работа над русской локализацией интерфейса. Были переведены 1288 строк кода, подготовлен файл README на русском языке и добавлен выбор языка в настройках приложения. Эта работа была упакована в отдельный PR upstream.
Сопровождение форка требует постоянного внимания, так как каждый релиз основного проекта может создавать конфликты при слиянии или требовать догоняющих изменений в локализации и сборке UI.
Теперь в OpenResearch доступны три мощных кодинг-агента с уникальными сценариями использования: * Kimi Code: Поддержка режимов Ask, Auto, YOLO и Plan с моделями K2.8, K2.7 и K3. * MiniMax Code: Режимы Auto и Full access с моделями MiniMax-M3 и M2.7. * ZCode: Самый гибкий агент с поддержкой режимов Ask, Edit, Auto, Full access и Plan. Он умеет работать как с кодами доступа (Coding Plan), так и через API-ключи, предлагая пользователям выбор модели для каждого отдельного диалога.
Парадокс использования искусственного интеллекта в разработке заключается в том, что для создания качественного инструмента требуется значительный объем ручной работы по исправлению ошибок, которые выявляет сам же этот интеллект в реальных условиях.