mirror of
https://github.com/RooVetGit/Roo-Code.git
synced 2026-08-28 05:27:24 +00:00
141 lines
6.8 KiB
Markdown
Generated
141 lines
6.8 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) • <b>Polski</b> • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)
|
|
|
|
</sub>
|
|
</div>
|
|
|
|
# Wkład w Roo Code
|
|
|
|
Roo Code to projekt społecznościowy i głęboko cenimy każdy wkład. Aby usprawnić współpracę, działamy w oparciu o [podejście „najpierw zgłoszenie”](#podejście-najpierw-zgłoszenie), co oznacza, że wszystkie [żądania ściągnięcia (PR)](#przesyłanie-żądania-ściągnięcia) muszą być najpierw połączone ze zgłoszeniem na GitHubie. Prosimy o uważne zapoznanie się z tym przewodnikiem.
|
|
|
|
## Spis treści
|
|
|
|
- [Zanim zaczniesz wnosić wkład](#zanim-zaczniesz-wnosić-wkład)
|
|
- [Znajdowanie i planowanie swojego wkładu](#znajdowanie-i-planowanie-swojego-wkładu)
|
|
- [Proces rozwoju i przesyłania](#proces-rozwoju-i-przesyłania)
|
|
- [Kwestie prawne](#kwestie-prawne)
|
|
|
|
## Zanim zaczniesz wnosić wkład
|
|
|
|
### 1. Kodeks postępowania
|
|
|
|
Wszyscy współtwórcy muszą przestrzegać naszego [Kodeksu postępowania](./CODE_OF_CONDUCT.md).
|
|
|
|
### 2. Mapa drogowa projektu
|
|
|
|
Nasza mapa drogowa wyznacza kierunek projektu. Dostosuj swój wkład do tych kluczowych celów:
|
|
|
|
### Niezawodność na pierwszym miejscu
|
|
|
|
- Zapewnij, że edycja różnic i wykonywanie poleceń są niezawodne.
|
|
- Zmniejsz punkty tarcia, które zniechęcają do regularnego użytkowania.
|
|
- Zagwarantuj płynne działanie we wszystkich lokalizacjach i na wszystkich platformach.
|
|
- Rozszerz solidne wsparcie для szerokiej gamy dostawców i modeli sztucznej inteligencji.
|
|
|
|
### Ulepszone wrażenia użytkownika
|
|
|
|
- Usprawnij interfejs użytkownika/doświadczenie użytkownika dla jasności i intuicyjności.
|
|
- Ciągle ulepszaj przepływ pracy, aby sprostać wysokim oczekiwaniom, jakie programiści mają wobec narzędzi codziennego użytku.
|
|
|
|
### Lider w wydajności agentów
|
|
|
|
- Ustanów kompleksowe wzorce oceny (ewaluacje) w celu pomiaru rzeczywistej produktywności.
|
|
- Ułatw wszystkim łatwe uruchamianie i interpretowanie tych ewaluacji.
|
|
- Dostarczaj ulepszenia, które wykazują wyraźny wzrost wyników ewaluacji.
|
|
|
|
Wspomnij o dostosowaniu do tych obszarów w swoich PR-ach.
|
|
|
|
### 3. Dołącz do społeczności Roo Code
|
|
|
|
- **Głównie:** Dołącz do naszego [Discorda](https://discord.gg/roocode) i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)**.
|
|
- **Alternatywa:** Doświadczeni współtwórcy mogą angażować się bezpośrednio za pośrednictwem [projektów na GitHubie](https://github.com/orgs/RooCodeInc/projects/1).
|
|
|
|
## Znajdowanie i planowanie swojego wkładu
|
|
|
|
### Rodzaje wkładu
|
|
|
|
- **Poprawki błędów:** rozwiązywanie problemów z kodem.
|
|
- **Nowe funkcje:** dodawanie funkcjonalności.
|
|
- **Dokumentacja:** ulepszanie przewodników i przejrzystości.
|
|
|
|
### Podejście „najpierw zgłoszenie”
|
|
|
|
Wszystkie wkłady zaczynają się od zgłoszenia na GitHubie przy użyciu naszych uproszczonych szablonów.
|
|
|
|
- **Sprawdź istniejące zgłoszenia**: Przeszukaj [zgłoszenia на GitHubie](https://github.com/RooCodeInc/Roo-Code/issues).
|
|
- **Utwórz zgłoszenie**, używając:
|
|
- **Ulepszenia:** szablon „Prośba o ulepszenie” (prosty język skoncentrowany na korzyściach dla użytkownika).
|
|
- **Błędy:** szablon „Zgłoszenie błędu” (minimalna reprodukcja + oczekiwane a rzeczywiste + wersja).
|
|
- **Chcesz nad tym popracować?** Skomentuj „Zgłaszam się” w zgłoszeniu i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)** na [Discordzie](https://discord.gg/roocode), aby zostać przypisanym. Przypisanie zostanie potwierdzone w wątku.
|
|
- **PR-y muszą być połączone зі zgłoszeniem.** Niepołączone PR-y mogą zostać zamknięte.
|
|
|
|
### Decydowanie, nad czym pracować
|
|
|
|
- Sprawdź [projekt na GitHubie](https://github.com/orgs/RooCodeInc/projects/1) pod kątem zgłoszeń „Zgłoszenie [Nieprzypisane]”.
|
|
- Aby uzyskać dokumentację, odwiedź [dokumentację Roo Code](https://github.com/RooCodeInc/Roo-Code-Docs).
|
|
|
|
### Zgłaszanie błędów
|
|
|
|
- Najpierw sprawdź istniejące raporty.
|
|
- Utwórz nowy błąd, używając szablonu [„Zgłoszenie błędu”](https://github.com/RooCodeInc/Roo-Code/issues/new/choose) z:
|
|
- Jasnymi, ponumerowanymi krokami reprodukcji
|
|
- Oczekiwanym a rzeczywistym wynikiem
|
|
- Wersją Roo Code (wymagane); dostawcą/modelem sztucznej inteligencji, jeśli ma to zastosowanie
|
|
- **Problemy z bezpieczeństwem**: Zgłoś je prywatnie za pośrednictwem [zaleceń dotyczących bezpieczeństwa](https://github.com/RooCodeInc/Roo-Code/security/advisories/new).
|
|
|
|
## Proces rozwoju i przesyłania
|
|
|
|
### Konfiguracja środowiska programistycznego
|
|
|
|
1. **Sforkuj i sklonuj:**
|
|
|
|
```
|
|
git clone https://github.com/TWOJA_NAZWA_UŻYTKOWNIKA/Roo-Code.git
|
|
```
|
|
|
|
2. **Zainstaluj zależności:**
|
|
|
|
```
|
|
pnpm install
|
|
```
|
|
|
|
3. **Debugowanie:** Otwórz za pomocą VS Code (`F5`).
|
|
|
|
### Wytyczne dotyczące pisania kodu
|
|
|
|
- Jeden skoncentrowany PR na funkcję lub poprawkę.
|
|
- Przestrzegaj najlepszych praktyk ESLint i TypeScript.
|
|
- Pisz jasne, opisowe commity odwołujące się do zgłoszeń (np. `Naprawia #123`).
|
|
- Zapewnij dokładne testy (`npm test`).
|
|
- Zrób rebase na najnowszą gałąź `main` przed przesłaniem.
|
|
|
|
### Przesyłanie żądania ściągnięcia
|
|
|
|
- Zacznij jako **wersja robocza PR**, jeśli szukasz wczesnej opinii.
|
|
- Jasno opisz swoje zmiany, postępując zgodnie z szablonem żądania ściągnięcia.
|
|
- Połącz zgłoszenie w opisie/tytule PR (np. „Naprawia #123”).
|
|
- Udostępnij zrzuty ekranu/filmy wideo dotyczące zmian w interfejsie użytkownika.
|
|
- Wskaż, czy konieczne są aktualizacje dokumentacji.
|
|
|
|
### Polityka dotycząca żądań ściągnięcia
|
|
|
|
- Musi odnosić się do przypisanego zgłoszenia na GitHubie. Aby zostać przypisanym: skomentuj „Zgłaszam się” w zgłoszeniu i wyślij wiadomość prywatną do **Hannes Rudolph (`hrudolph`)** na [Discordzie](https://discord.gg/roocode). Przypisanie zostanie potwierdzone w wątku.
|
|
- Niepołączone PR-y mogą zostać zamknięte.
|
|
- PR-y muszą przejść testy CI, być zgodne z mapą drogową i mieć przejrzystą dokumentację.
|
|
|
|
### Proces przeglądu
|
|
|
|
- **Codzienna selekcja:** Szybkie sprawdzanie przez opiekunów.
|
|
- **Cotygodniowy dogłębny przegląd:** Kompleksowa ocena.
|
|
- **Szybko iteruj** w oparciu o opinie.
|
|
|
|
## Kwestie prawne
|
|
|
|
Przesyłając wkład, zgadzasz się, że Twoje wkłady będą licencjonowane na podstawie licencji Apache 2.0, zgodnie z licencją Roo Code.
|