mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-09-05 08:10:14 +00:00
141 lines
10 KiB
Markdown
Generated
141 lines
10 KiB
Markdown
Generated
<div align="center">
|
||
<sub>
|
||
|
||
[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • [Italiano](../it/CONTRIBUTING.md) • [日本語](../ja/CONTRIBUTING.md)
|
||
|
||
</sub>
|
||
<sub>
|
||
|
||
[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • <b>Русский</b> • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)
|
||
|
||
</sub>
|
||
</div>
|
||
|
||
# Вклад в Roo Code
|
||
|
||
Roo Code — это проект, управляемый сообществом, и мы глубоко ценим каждый вклад. Чтобы упростить совместную работу, мы работаем на основе [подхода «сначала задача»](#подход-сначала-задача), что означает, что все [запросы на слияние (PR)](#подача-запроса-на-слияние) должны быть сначала связаны с задачей на GitHub. Пожалуйста, внимательно ознакомьтесь с этим руководством.
|
||
|
||
## Оглавление
|
||
|
||
- [Прежде чем вы начнете вносить свой вклад](#прежде-чем-вы-начнете-вносить-свой-вклад)
|
||
- [Поиск и планирование вашего вклада](#поиск-и-планирование-вашего-вклада)
|
||
- [Процесс разработки и подачи](#процесс-разработки-и-подачи)
|
||
- [Юридические вопросы](#юридические-вопросы)
|
||
|
||
## Прежде чем вы начнете вносить свой вклад
|
||
|
||
### 1. Кодекс поведения
|
||
|
||
Все участники должны придерживаться нашего [Кодекса поведения](./CODE_OF_CONDUCT.md).
|
||
|
||
### 2. Дорожная карта проекта
|
||
|
||
Наша дорожная карта определяет направление развития проекта. Согласуйте свои вклады с этими ключевыми целями:
|
||
|
||
### Надежность прежде всего
|
||
|
||
- Обеспечьте постоянную надежность редактирования различий и выполнения команд.
|
||
- Уменьшите количество проблемных моментов, которые отбивают желание регулярного использования.
|
||
- Гарантируйте бесперебойную работу во всех локалях и на всех платформах.
|
||
- Расширьте надежную поддержку для широкого спектра поставщиков и моделей ИИ.
|
||
|
||
### Улучшенный пользовательский опыт
|
||
|
||
- Оптимизируйте пользовательский интерфейс/опыт для ясности и интуитивности.
|
||
- Постоянно улучшайте рабочий процесс, чтобы соответствовать высоким ожиданиям, которые разработчики предъявляют к инструментам повседневного использования.
|
||
|
||
### Лидерство в производительности агентов
|
||
|
||
- Создайте комплексные оценочные тесты (evals) для измерения реальной производительности.
|
||
- Сделайте так, чтобы каждый мог легко запускать и интерпретировать эти оценки.
|
||
- Поставляйте улучшения, которые демонстрируют явное увеличение оценочных баллов.
|
||
|
||
Упоминайте о соответствии этим областям в своих PR.
|
||
|
||
### 3. Присоединяйтесь к сообществу Roo Code
|
||
|
||
- **Основной:** Присоединяйтесь к нашему [Discord](https://discord.gg/roocode) и напишите личное сообщение **Hannes Rudolph (`hrudolph`)**.
|
||
- **Альтернатива:** Опытные участники mogą напрямую взаимодействовать через [Проекты GitHub](https://github.com/orgs/RooCodeInc/projects/1).
|
||
|
||
## Поиск и планирование вашего вклада
|
||
|
||
### Типы вкладов
|
||
|
||
- **Исправления ошибок:** решение проблем с кодом.
|
||
- **Новые функции:** добавление функциональности.
|
||
- **Документация:** улучшение руководств и ясности.
|
||
|
||
### Подход «сначала задача»
|
||
|
||
Все вклады начинаются с задачи на GitHub с использованием наших простых шаблонов.
|
||
|
||
- **Проверьте существующие задачи**: выполните поиск в [задачах GitHub](https://github.com/RooCodeInc/Roo-Code/issues).
|
||
- **Создайте задачу**, используя:
|
||
- **Улучшения:** шаблон «Запрос на улучшение» (простой язык, ориентированный на пользу для пользователя).
|
||
- **Ошибки:** шаблон «Отчет об ошибке» (минимальное воспроизведение + ожидаемый и фактический результат + версия).
|
||
- **Хотите над этим поработать?** Напишите комментарий «Забираю» к задаче и напишите личное сообщение **Hannes Rudolph (`hrudolph`)** в [Discord](https://discord.gg/roocode), чтобы вас назначили. Назначение будет подтверждено в ветке.
|
||
- **PR должны ссылаться на задачу.** Несвязанные PR могут быть закрыты.
|
||
|
||
### Решение, над чем работать
|
||
|
||
- Проверьте [Проект GitHub](https://github.com/orgs/RooCodeInc/projects/1) на наличие задач «Задача [не назначена]».
|
||
- Для документации посетите [Документацию Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs).
|
||
|
||
### Сообщение об ошибках
|
||
|
||
- Сначала проверьте существующие отчеты.
|
||
- Создайте новую ошибку, используя [шаблон «Отчет об ошибке»](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) с:
|
||
- Четкими, пронумерованными шагами воспроизведения
|
||
- Ожидаемым и фактическим результатом
|
||
- Версией Roo Code (обязательно); поставщиком/моделью ИИ, если применимо
|
||
- **Проблемы с безопасностью**: сообщайте в частном порядке через [рекомендации по безопасности](https://github.com/RooCodeInc/Roo-Code/security/advisories/new).
|
||
|
||
## Процесс разработки и подачи
|
||
|
||
### Настройка разработки
|
||
|
||
1. **Сделайте форк и клонируйте:**
|
||
|
||
```
|
||
git clone https://github.com/ВАШЕ_ИМЯ_ПОЛЬЗОВАТЕЛЯ/Roo-Code.git
|
||
```
|
||
|
||
2. **Установите зависимости:**
|
||
|
||
```
|
||
pnpm install
|
||
```
|
||
|
||
3. **Отладка:** откройте в VS Code (`F5`).
|
||
|
||
### Руководство по написанию кода
|
||
|
||
- Один сфокусированный PR на функцию или исправление.
|
||
- Следуйте лучшим практикам ESLint и TypeScript.
|
||
- Пишите четкие, описательные коммиты со ссылкой на задачи (например, `Исправляет #123`).
|
||
- Предоставляйте тщательное тестирование (`npm test`).
|
||
- Перед отправкой выполните rebase на последнюю ветку `main`.
|
||
|
||
### Подача запроса на слияние
|
||
|
||
- Начните с **черновика PR**, если вам нужна ранняя обратная связь.
|
||
- Четко опишите свои изменения, следуя шаблону запроса на слияние.
|
||
- Ссылайтесь на задачу в описании/названии PR (например, «Исправляет #123»).
|
||
- Предоставьте скриншоты/видео для изменений в пользовательском интерфейсе.
|
||
- Укажите, необходимы ли обновления документации.
|
||
|
||
### Политика запросов на слияние
|
||
|
||
- Должен ссылаться на назначенную задачу GitHub. Чтобы вас назначили: напишите комментарий «Забираю» к задаче и напишите личное сообщение **Hannes Rudolph (`hrudolph`)** в [Discord](https://discord.gg/roocode). Назначение будет подтверждено в ветке.
|
||
- Несвязанные PR могут быть закрыты.
|
||
- PR должны проходить тесты CI, соответствовать дорожной карте и иметь четкую документацию.
|
||
|
||
### Процесс проверки
|
||
|
||
- **Ежедневная сортировка:** быстрая проверка сопровождающими.
|
||
- **Еженедельный углубленный обзор:** всесторонняя оценка.
|
||
- **Быстро итерируйте** на основе обратной связи.
|
||
|
||
## Юридические вопросы
|
||
|
||
Внося свой вклад, вы соглашаетесь с тем, что ваши вклады будут лицензироваться по лицензии Apache 2.0, в соответствии с лицензированием Roo Code.
|