Вклад в Zoo Code

June 11, 2026 · View on GitHub

English • Català • Deutsch • Español • Français • हिंदी • Bahasa Indonesia • Italiano • 日本語

한국어 • Nederlands • Polski • Português (BR) • Русский • Türkçe • Tiếng Việt • 简体中文 • 繁體中文

Вклад в Zoo Code

Zoo Code — это проект, управляемый сообществом, и мы глубоко ценим каждый вклад. Чтобы упростить совместную работу, мы работаем на основе подхода «сначала задача», что означает, что все запросы на слияние (PR) должны быть сначала связаны с задачей на GitHub. Пожалуйста, внимательно ознакомьтесь с этим руководством.

Оглавление

Прежде чем вы начнете вносить свой вклад

1. Кодекс поведения

Все участники должны придерживаться нашего Кодекса поведения.

2. Дорожная карта проекта

Наша дорожная карта определяет направление развития проекта. Согласуйте свои вклады с этими ключевыми целями:

Надежность прежде всего

  • Обеспечьте постоянную надежность редактирования различий и выполнения команд.
  • Уменьшите количество проблемных моментов, которые отбивают желание регулярного использования.
  • Гарантируйте бесперебойную работу во всех локалях и на всех платформах.
  • Расширьте надежную поддержку для широкого спектра поставщиков и моделей ИИ.

Улучшенный пользовательский опыт

  • Оптимизируйте пользовательский интерфейс/опыт для ясности и интуитивности.
  • Постоянно улучшайте рабочий процесс, чтобы соответствовать высоким ожиданиям, которые разработчики предъявляют к инструментам повседневного использования.

Лидерство в производительности агентов

  • Создайте комплексные оценочные тесты (evals) для измерения реальной производительности.
  • Сделайте так, чтобы каждый мог легко запускать и интерпретировать эти оценки.
  • Поставляйте улучшения, которые демонстрируют явное увеличение оценочных баллов.

Упоминайте о соответствии этим областям в своих PR.

3. Присоединяйся к сообществу Zoo Code

  • Discord: Присоединяйся к нашему Discord.
  • Reddit: Присоединяйся к нашему Reddit.

Поиск и планирование вашего вклада

Типы вкладов

  • Исправления ошибок: решение проблем с кодом.
  • Новые функции: добавление функциональности.
  • Документация: улучшение руководств и ясности.

Подход «сначала задача»

Все вклады начинаются с задачи на GitHub с использованием наших простых шаблонов.

  • Проверьте существующие задачи: выполните поиск в задачах GitHub.
  • Создайте задачу, используя:
    • Улучшения: шаблон «Запрос на улучшение» (простой язык, ориентированный на пользу для пользователя).
    • Ошибки: шаблон «Отчет об ошибке» (минимальное воспроизведение + ожидаемый и фактический результат + версия).
  • Хотите над этим поработать? Напишите комментарий «Забираю» к задаче и напишите личное сообщение основной команде в Discord, чтобы вас назначили. Назначение будет подтверждено в ветке.
  • PR должны ссылаться на задачу. Несвязанные PR могут быть закрыты.

Решение, над чем работать

Сообщение об ошибках

  • Сначала проверьте существующие отчеты.
  • Создайте новую ошибку, используя шаблон «Отчет об ошибке» с:
    • Четкими, пронумерованными шагами воспроизведения
    • Ожидаемым и фактическим результатом
    • Версией Zoo Code (обязательно); поставщиком/моделью ИИ, если применимо
  • Проблемы с безопасностью: сообщайте в частном порядке через рекомендации по безопасности.

Процесс разработки и подачи

Настройка разработки

  1. Сделайте форк и клонируйте:
git clone https://github.com/YOUR_USERNAME/Zoo-Code.git
  1. Установите зависимости:
pnpm install
  1. Отладка: откройте в VS Code (F5).

Руководство по написанию кода

  • Один сфокусированный PR на функцию или исправление.
  • Следуйте лучшим практикам ESLint и TypeScript.
  • Пишите четкие, описательные коммиты со ссылкой на задачи (например, Исправляет #123).
  • Предоставляйте тщательное тестирование (npm test).
  • Перед отправкой выполните rebase на последнюю ветку main.

Подача запроса на слияние

  • Начните с черновика PR, если вам нужна ранняя обратная связь.
  • Четко опишите свои изменения, следуя шаблону запроса на слияние.
  • Ссылайтесь на задачу в описании/названии PR (например, «Исправляет #123»).
  • Предоставьте скриншоты/видео для изменений в пользовательском интерфейсе.
  • Укажите, необходимы ли обновления документации.

Политика запросов на слияние

  • Должен ссылаться на назначенную задачу GitHub. Чтобы вас назначили: напишите комментарий «Забираю» к задаче и напишите личное сообщение основной команде в Discord. Назначение будет подтверждено в ветке.
  • Несвязанные PR могут быть закрыты.
  • PR должны проходить тесты CI, соответствовать дорожной карте и иметь четкую документацию.

Процесс проверки

  • Ежедневная сортировка: быстрая проверка сопровождающими.
  • Еженедельный углубленный обзор: всесторонняя оценка.
  • Быстро итерируйте на основе обратной связи.

Требования к запросам на слияние

Запросы на слияние должны быть проверяемыми, протестированными и удобными для сопровождения. Перед открытием PR убедитесь, что:

  • Изменение ограничено конкретной задачей, ошибкой или улучшением.
  • Вы можете объяснить, что делает изменение и почему оно правильное.
  • Вы протестировали изменение локально там, где это практически возможно.
  • Вы готовы отвечать на отзывы по результатам проверки и вносить разумные последующие изменения.
  • PR не требует от сопровождающих существенной переработки, перепроектирования или принятия ответственности за реализацию перед слиянием.

Сопровождающие могут закрывать PR, которые являются неполными, слишком широкими, неактивными, не соответствующими направлению проекта или создающими непропорциональную нагрузку на проверку или сопровождение. Закрытие PR не является суждением о вкладчике; это решение сопровождающих о том, что изменение не может быть принято в его нынешней форме.

Вклады с использованием ИИ

Использование инструментов ИИ разрешено, но вкладчики несут полную ответственность за свои материалы.

Если вы используете инструменты ИИ для создания PR, вы должны:

  • Проверить и понять каждое существенное изменение.
  • Уметь объяснить реализацию и компромиссы своими словами.
  • Самостоятельно протестировать изменение. Если тестирование непрактично в вашей среде, объясните причину в описании PR и опишите, как проверяющие могут проверить изменение.
  • Убедиться, что сгенерированный код правильный, необходимый и совместимый с лицензией проекта.
  • Рассмотрите возможность раскрытия помощи ИИ в описании PR, когда она существенно повлияла на код, тесты или дизайн — это помогает проверяющим давать более качественную обратную связь.

Пожалуйста, не отправляйте изменения, сгенерированные ИИ, которые вы не понимаете или не можете поддерживать в ходе проверки. Сопровождающие могут закрывать PR, которые в значительной степени кажутся созданными с помощью ИИ, но лишены проверки человеком, четкого обоснования или последующей работы по проверке.

Юридические вопросы

Внося свой вклад, вы соглашаетесь с тем, что ваши вклады будут лицензироваться по лицензии Apache 2.0, в соответствии с лицензированием Zoo Code.