# Đóng Góp cho Roo Code

Chúng tôi rất vui mừng vì bạn quan tâm đến việc đóng góp cho Roo Code. Cho dù bạn đang sửa lỗi, thêm tính năng, hay cải thiện tài liệu của chúng tôi, mỗi đóng góp đều làm cho Roo Code thông minh hơn! Để giữ cho cộng đồng của chúng tôi sôi động và thân thiện, tất cả thành viên phải tuân thủ [Quy Tắc Ứng Xử](CODE_OF_CONDUCT.md) của chúng tôi.

## Tham Gia Cộng Đồng của Chúng Tôi

Chúng tôi mạnh mẽ khuyến khích tất cả người đóng góp tham gia [cộng đồng Discord](https://discord.gg/roocode) của chúng tôi! Việc là một phần của máy chủ Discord của chúng tôi giúp bạn:

- Nhận hỗ trợ và hướng dẫn thời gian thực về đóng góp của bạn
- Kết nối với những người đóng góp khác và các thành viên nhóm cốt lõi
- Cập nhật về sự phát triển và ưu tiên của dự án
- Tham gia vào các cuộc thảo luận định hình tương lai của Roo Code
- Tìm cơ hội hợp tác với các nhà phát triển khác

## Báo Cáo Lỗi hoặc Vấn Đề

Báo cáo lỗi giúp cải thiện Roo Code cho mọi người! Trước khi tạo một vấn đề mới, vui lòng [tìm kiếm những vấn đề hiện có](https://github.com/RooVetGit/Roo-Code/issues) để tránh trùng lặp. Khi bạn đã sẵn sàng báo cáo lỗi, hãy truy cập [trang vấn đề](https://github.com/RooVetGit/Roo-Code/issues/new/choose) của chúng tôi, nơi bạn sẽ tìm thấy một mẫu để giúp bạn điền thông tin liên quan.

<blockquote class='warning-note'>
     🔐 <b>Quan trọng:</b> Nếu bạn phát hiện lỗ hổng bảo mật, vui lòng sử dụng <a href="https://github.com/RooVetGit/Roo-Code/security/advisories/new">công cụ bảo mật Github để báo cáo riêng tư</a>.
</blockquote>

## Quyết Định Làm Việc trên Cái Gì

Tìm kiếm đóng góp đầu tiên tốt? Kiểm tra các vấn đề trong phần "Issue [Unassigned]" của [Dự án Github Roo Code](https://github.com/orgs/RooVetGit/projects/1) của chúng tôi. Những vấn đề này được chọn lọc đặc biệt cho người đóng góp mới và các lĩnh vực mà chúng tôi muốn nhận được sự giúp đỡ!

Chúng tôi cũng hoan nghênh đóng góp cho [tài liệu](https://docs.roocode.com/) của chúng tôi! Dù là sửa lỗi chính tả, cải thiện hướng dẫn hiện có, hay tạo nội dung giáo dục mới - chúng tôi muốn xây dựng một kho tài nguyên do cộng đồng thúc đẩy giúp mọi người tận dụng tối đa Roo Code. Bạn có thể nhấp vào "Edit this page" trên bất kỳ trang nào để nhanh chóng đến đúng vị trí trong Github để chỉnh sửa tệp, hoặc bạn có thể đi trực tiếp vào https://github.com/RooVetGit/Roo-Code-Docs.

Nếu bạn đang lên kế hoạch làm việc trên một tính năng lớn hơn, vui lòng tạo [yêu cầu tính năng](https://github.com/RooVetGit/Roo-Code/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop) trước để chúng tôi có thể thảo luận xem nó có phù hợp với tầm nhìn của Roo Code không. Bạn cũng có thể kiểm tra [Lộ Trình Dự Án](#lộ-trình-dự-án) bên dưới để xem liệu ý tưởng của bạn có phù hợp với định hướng chiến lược của chúng tôi không.

## Lộ Trình Dự Án

Roo Code có một lộ trình phát triển rõ ràng hướng dẫn các ưu tiên và định hướng tương lai của chúng tôi. Hiểu lộ trình của chúng tôi có thể giúp bạn:

- Điều chỉnh đóng góp của bạn với mục tiêu của dự án
- Xác định các lĩnh vực mà chuyên môn của bạn sẽ có giá trị nhất
- Hiểu bối cảnh đằng sau một số quyết định thiết kế
- Tìm cảm hứng cho các tính năng mới hỗ trợ tầm nhìn của chúng tôi

Lộ trình hiện tại của chúng tôi tập trung vào sáu trụ cột chính:

### Hỗ Trợ Nhà Cung Cấp

Chúng tôi hướng đến việc hỗ trợ càng nhiều nhà cung cấp càng tốt:

- Hỗ trợ "OpenAI Compatible" linh hoạt hơn
- xAI, Microsoft Azure AI, Alibaba Cloud Qwen, IBM Watsonx, Together AI, DeepInfra, Fireworks AI, Cohere, Perplexity AI, FriendliAI, Replicate
- Hỗ trợ nâng cao cho Ollama và LM Studio

### Hỗ Trợ Mô Hình

Chúng tôi muốn Roo hoạt động tốt trên càng nhiều mô hình càng tốt, bao gồm cả mô hình cục bộ:

- Hỗ trợ mô hình cục bộ thông qua prompting hệ thống tùy chỉnh và quy trình làm việc
- Đánh giá hiệu suất và các trường hợp thử nghiệm

### Hỗ Trợ Hệ Thống

Chúng tôi muốn Roo chạy tốt trên máy tính của mọi người:

- Tích hợp terminal đa nền tảng
- Hỗ trợ mạnh mẽ và nhất quán cho Mac, Windows và Linux

### Tài Liệu

Chúng tôi muốn tài liệu toàn diện, dễ tiếp cận cho tất cả người dùng và người đóng góp:

- Hướng dẫn người dùng và hướng dẫn mở rộng
- Tài liệu API rõ ràng
- Hướng dẫn tốt hơn cho người đóng góp
- Tài nguyên tài liệu đa ngôn ngữ
- Ví dụ tương tác và mẫu mã

### Ổn Định

Chúng tôi muốn giảm đáng kể số lượng lỗi và tăng kiểm tra tự động:

- Công tắc ghi nhật ký gỡ lỗi
- Nút sao chép "Thông Tin Máy/Nhiệm Vụ" để gửi kèm với yêu cầu hỗ trợ/lỗi

### Quốc Tế Hóa

Chúng tôi muốn Roo nói ngôn ngữ của mọi người:

- 我们希望 Roo Code 说每个人的语言
- Queremos que Roo Code hable el idioma de todos
- हम चाहते हैं कि Roo Code हर किसी की भाषा बोले
- نريد أن يتحدث Roo Code لغة الجميع

Chúng tôi đặc biệt hoan nghênh những đóng góp thúc đẩy mục tiêu lộ trình của chúng tôi. Nếu bạn đang làm việc trên điều gì đó phù hợp với những trụ cột này, vui lòng đề cập đến điều đó trong mô tả PR của bạn.

## Thiết Lập Phát Triển

1. **Clone** kho lưu trữ:

```sh
git clone https://github.com/RooVetGit/Roo-Code.git
```

2. **Cài đặt các phụ thuộc**:

```sh
npm run install:all
```

3. **Khởi động webview (ứng dụng Vite/React với HMR)**:

```sh
npm run dev
```

4. **Gỡ lỗi**:
   Nhấn `F5` (hoặc **Run** → **Start Debugging**) trong VSCode để mở phiên mới với Roo Code được tải.

Các thay đổi đối với webview sẽ xuất hiện ngay lập tức. Các thay đổi đối với phần mở rộng cốt lõi sẽ yêu cầu khởi động lại máy chủ phần mở rộng.

Hoặc bạn có thể xây dựng một tệp .vsix và cài đặt nó trực tiếp trong VSCode:

```sh
npm run build
```

Một tệp `.vsix` sẽ xuất hiện trong thư mục `bin/` có thể được cài đặt bằng:

```sh
code --install-extension bin/roo-cline-<version>.vsix
```

## Viết và Gửi Mã

Bất kỳ ai cũng có thể đóng góp mã cho Roo Code, nhưng chúng tôi yêu cầu bạn tuân theo những hướng dẫn này để đảm bảo đóng góp của bạn có thể được tích hợp suôn sẻ:

1. **Giữ Pull Request Tập Trung**

    - Giới hạn PR vào một tính năng hoặc sửa lỗi duy nhất
    - Chia các thay đổi lớn hơn thành các PR nhỏ hơn, có liên quan
    - Chia các thay đổi thành các commit hợp lý có thể được xem xét độc lập

2. **Chất Lượng Mã**

    - Tất cả PR phải vượt qua kiểm tra CI bao gồm cả linting và định dạng
    - Giải quyết mọi cảnh báo hoặc lỗi ESLint trước khi gửi
    - Phản hồi tất cả phản hồi từ Ellipsis, công cụ đánh giá mã tự động của chúng tôi
    - Tuân theo các thực hành tốt nhất của TypeScript và duy trì an toàn kiểu

3. **Kiểm Tra**

    - Thêm kiểm tra cho các tính năng mới
    - Chạy `npm test` để đảm bảo tất cả các kiểm tra đều vượt qua
    - Cập nhật các bài kiểm tra hiện có nếu thay đổi của bạn ảnh hưởng đến chúng
    - Bao gồm cả kiểm tra đơn vị và kiểm tra tích hợp khi thích hợp

4. **Hướng Dẫn Commit**

    - Viết thông điệp commit rõ ràng, mô tả
    - Tham chiếu các vấn đề có liên quan trong commit bằng cách sử dụng #số-vấn-đề

5. **Trước Khi Gửi**

    - Rebase nhánh của bạn trên main mới nhất
    - Đảm bảo nhánh của bạn xây dựng thành công
    - Kiểm tra lại rằng tất cả các bài kiểm tra đều vượt qua
    - Xem xét các thay đổi của bạn cho bất kỳ mã gỡ lỗi hoặc bản ghi console nào

6. **Mô Tả Pull Request**
    - Mô tả rõ ràng những gì thay đổi của bạn làm
    - Bao gồm các bước để kiểm tra các thay đổi
    - Liệt kê bất kỳ thay đổi đáng kể nào
    - Thêm ảnh chụp màn hình cho các thay đổi UI

## Thỏa Thuận Đóng Góp

Bằng cách gửi một pull request, bạn đồng ý rằng đóng góp của bạn sẽ được cấp phép theo cùng giấy phép với dự án ([Apache 2.0](../LICENSE)).