lz1998/ricq

🚀 RICQ: Thư viện giao thức QQ Android bằng Rust

RICQ là phần triển dựng lại giao thức QQ Android bằng ngôn ngữ Rust, dựa trên dự án OICQ, tối ưu hiệu suất và tiết kiệm bộ nhớ.

RICQ là một thư viện giao thức cho phép phát triển ứng dụng QQ trên nền tảng Rust. Dự án hỗ trợ đầy đủ các chức năng như đăng nhập tài khoản, xử lý tin nhắn (văn bản, hình ảnh, âm thanh...), theo dõi sự kiện và thực hiện các thao tác trên QQ. Thiết kế modular với các thành phần như ricq (API bất đồng bộ), ricq-core (trình dựng và phân tích gói tin không IO) và ricq-axum-api (giao diện đăng nhập qua HTTP).

✨ Điểm nổi bật

• Đăng nhập đa dạng: Hỗ trợ đăng nhập bằng tài khoản mật khẩu, mã QR, cùng xác thực captcha và khóa thiết bị.
• Xử lý tin nhắn phong phú: Hỗ trợ tin nhắn văn bản, biểu tượng cảm xúc, @mention, trả lời, ảnh, âm thanh, tin đường dài và chia sẻ liên kết.
• Theo dõi sự kiện toàn diện: Bắt sự kiện tin nhắn nhóm/bạn bè, yêu cầu kết bạn, mời vào nhóm, thay đổi vai trò thành viên, giải tán nhóm và nhiều hơn nữa.
• Thao tác chủ động mạnh mẽ: Cho phép sửa đổi thông tin cá nhân, gửi tin, quản lý nhóm (cấm, kick, đặt quản trị viên), đặt tên nhóm, công bố và thiết lập trạng thái online.
• Tiết kiệm tài nguyên: Chạy trên Linux-musl với bộ nhớ chỉ 1.6MB, phù hợp triển khai trên môi trường nhúng hoặc thiết bị thấp cấu hình.
• Hỗ trợ Nightly Rust: Dự án yêu cầu công cụ Nightly để biên dịch nhờ tính năng ngôn ngữ tiên tiến.
• Tích hợp dễ dàng: Cung cấp HTTP API qua ricq-axum-api kết hợp giao diện ricq-react-ui để nhanh chóng triển khai.

💡 Vì sao đáng chú ý

RICQ nổi bật với thiết kế nhẹ lẹ và hiệu suất cao, cho phép chạy trên thiết bị có tài nguyên hạn chế như Raspberry Pi hoặc máy chủ nhỏ. Khác với các dự án QQ khác sử dụng ngôn ngữ giải thích hoặc framework nặng, RICQ lợi dụng Rust để tối ưu tốc độ đồng thời giảm tới mức tối thiểu.

Dự án phù hợp cho nhà phát triển muốn xây dựng bot QQ, công cụ quản lý nhóm hoặc dịch vụ tự động hóa dựa trên giao thức QQ Android. Nhờ cấu trúc modular, RICQ dễ dàng kết hợp với các framework khác như rust_proc_qq, Walle-Q hay pbrq thông qua FFI.

#QQ #Rust #QQBot #Protocol #OpenSource #TiniX