
Dự án này làm gì
Dự án này là trình quản lý máy chủ máy tính để bàn do cộng đồng phát triển cho Discord và Telegram. Dự án đóng gói bộ công cụ cho Windows x64, cung cấp các tính năng cấu hình, quản trị tập trung vào kiểm duyệt, ghi nhật ký, phân quyền, mô-đun, xuất dữ liệu và phản hồi cộng đồng trong một ứng dụng ưu tiên hoạt động cục bộ.
Chỉ sử dụng dự án này với các cộng đồng, máy chủ, kênh và thông tin xác thực mà bạn sở hữu hoặc được ủy quyền quản lý. README mô tả một gói đã được kích hoạt sẵn, có cấu hình cục bộ và quy trình cài đặt đơn giản.

Yêu cầu và mô hình hoạt động
- Windows 10 hoặc Windows 11
- PowerShell 5.1 trở lên
- Kết nối mạng đang hoạt động trong quá trình kết nối với nền tảng và thiết lập ban đầu
- Không yêu cầu quyền quản trị viên
- Môi trường máy tính để bàn Windows x64
Sau khi cài đặt, bộ công cụ độc lập được thiết kế để chạy cục bộ mà không cần tải thêm thành phần. Tuy nhiên, các tích hợp Discord và Telegram vẫn cần quyền truy cập mạng để liên lạc với những nền tảng này.
Cài đặt và thiết lập ban đầu
- Mở trang Cài đặt nhanh bằng PowerShell của dự án.
- Làm theo hướng dẫn của trình cài đặt để đưa toàn bộ gói lên máy tính Windows của bạn. README mô tả trình cài đặt là tự chứa, vì vậy không cần tải riêng từng thành phần.
- Khởi chạy ứng dụng đã cài đặt và tìm tệp cấu hình dễ đọc nằm cạnh trình khởi chạy.
- Mở tệp cấu hình bằng trình soạn thảo văn bản thuần túy. Tệp chứa các giá trị được chú thích và mặc định hợp lý, vì vậy chỉ thay đổi những tùy chọn cần thiết cho môi trường triển khai của bạn.
- Đối với Discord, cung cấp token bot và thông tin xác thực ứng dụng của riêng bạn, sau đó cấu hình các máy chủ, kênh, vai trò được phép và hành vi lệnh.
- Đối với Telegram, cung cấp thông tin xác thực bot của riêng bạn và xác định các nhóm, kênh hoặc cuộc trò chuyện riêng tư mà bot được phép truy cập.
- Lưu tệp và khởi động lại bot để các thay đổi có hiệu lực.
Giữ riêng tư token và các thông tin xác thực khác. Không bao giờ dán chúng vào các kênh công khai hoặc commit chúng vào kho lưu trữ dùng chung. Hãy thay mới thông tin xác thực nếu bạn cho rằng chúng đã bị lộ.
Các khu vực cấu hình chính
Discord
- Thiết lập token bot và thông tin xác thực ứng dụng.
- Chọn tiền tố lệnh hoặc sử dụng lệnh slash gốc.
- Giới hạn phạm vi hoạt động vào các máy chủ và kênh đã chọn.
- Hạn chế các thao tác nhạy cảm bằng cơ chế kiểm tra vai trò và quyền hạn.
- Tùy chỉnh văn bản trạng thái và loại hoạt động của bot.
Telegram
- Thêm thông tin xác thực cho ứng dụng bot Telegram.
- Đưa vào danh sách cho phép các nhóm, kênh hoặc cuộc trò chuyện riêng tư sẽ nhận phản hồi.
- Đồng bộ bộ lệnh Discord hoặc chỉ bật các lệnh đã chọn.
- Điều chỉnh giới hạn tốc độ và kiểm soát flooding để tuân thủ giới hạn của nền tảng.
Hành vi dùng chung
- Thiết lập thời gian chờ lệnh theo từng người dùng và kênh.
- Chọn mức độ chi tiết của nhật ký, từ thông tin thiết yếu đến gỡ lỗi chi tiết.
- Tạo các quy tắc trả lời tự động nhẹ dựa trên từ khóa.
- Xác định các tác vụ theo lịch bằng một khoảng thời gian đơn giản.
- Bật hoặc tắt từng mô-đun bằng cờ tính năng.
Sử dụng giao diện lệnh

Các lệnh bao gồm gợi ý nội tuyến và tính năng tự động hoàn thành. Bắt đầu với /help để xem các lệnh khả dụng được nhóm theo danh mục, hoặc yêu cầu thông tin chi tiết cho một lệnh cụ thể bằng /help <command>.
Kiểm tra trạng thái và thông tin dự án
/ping
/stats
/about/ping xác nhận bot đang phản hồi. /stats hiển thị các thông tin như thời gian hoạt động, số máy chủ đã tham gia, người dùng đang hoạt động và tình hình sử dụng lệnh. /about cung cấp thông tin ghi công và phiên bản.
Xem và thay đổi cấu hình máy chủ
/config view
/config set
/config resetSử dụng /config view để kiểm tra các mô-đun đã bật, kênh mặc định và cấp độ quyền hạn. Sử dụng /config set để điều chỉnh các cài đặt như tiền tố, kênh ghi nhật ký và công tắc tính năng. Nếu một thử nghiệm cấu hình gây ra sự cố, /config reset sẽ khôi phục các mặc định hợp lý của máy chủ.
Quản lý mô-đun, nhật ký và quyền hạn
/module list
/module enable
/module disable
/logs channel
/permissions checkLiệt kê các mô-đun khả dụng, bật hoặc tắt từng tính năng, chọn kênh dùng cho nhật ký hoạt động và xác minh thành viên nào có thể chạy các lệnh cụ thể.
Sao lưu và khôi phục cài đặt
/export
/importSử dụng /export để tạo ảnh chụp cấu hình có thể chia sẻ nhằm sao lưu hoặc di chuyển. Sử dụng /import để khôi phục ảnh chụp hiện có trên máy chủ hoặc môi trường triển khai khác.
Gửi phản hồi
/feedbackSử dụng /feedback để gửi báo cáo lỗi hoặc ý tưởng cho nhóm duy trì. Khi báo cáo sự cố, hãy nêu hành vi mong đợi, kết quả thực tế và lệnh hoặc cài đặt liên quan.
Quy trình thiết lập thực tế

- Cài đặt gói và xác nhận trình khởi chạy mở thành công.
- Chạy
/pingsau khi kết nối một phiên bản bot đã được cấp quyền. - Kiểm tra thiết lập hiện tại bằng
/config viewvà/module list. - Thiết lập giới hạn ghi nhật ký và quyền trước khi bật các mô-đun tùy chọn.
- Dùng
/permissions checkđể xác minh các vai trò đáng tin cậy có thể thực hiện những hành động nhạy cảm. - Chạy thử nghiệm quy mô nhỏ trên máy chủ hoặc cuộc trò chuyện đã được cấp quyền trước khi áp dụng phạm vi rộng hơn.
- Xuất cấu hình sau khi hoàn tất thiết lập ổn định.
Mẹo nâng cao
Thay đổi từng thiết lập một
Các giá trị mặc định được thiết kế để hoạt động ngay lập tức. Thực hiện thay đổi từng bước, khởi động lại sau khi chỉnh sửa tệp cấu hình và sao lưu trước khi điều chỉnh lớn. Cách này giúp xác định giá trị không hợp lệ hoặc tương tác ngoài dự kiến giữa các mô-đun dễ hơn.
Sử dụng phạm vi hẹp
Chỉ giới hạn bot trong các máy chủ, kênh, nhóm và cuộc trò chuyện cần thiết. Kết hợp phạm vi nền tảng với các lớp kiểm soát vai trò và quyền để chỉ thành viên đáng tin cậy mới có thể thực hiện những hành động nhạy cảm.
Cân bằng giữa ghi nhật ký và quyền riêng tư
Sử dụng ghi nhật ký thiết yếu cho hoạt động bình thường và tạm thời tăng mức độ chi tiết khi khắc phục sự cố. Cấu hình một kênh nhật ký hoạt động riêng khi cần minh bạch trong kiểm duyệt, đồng thời tránh để lộ thông tin đăng nhập hoặc dữ liệu riêng tư trong nhật ký.
Tôn trọng giới hạn tần suất
Đối với Telegram, hãy điều chỉnh các cơ chế kiểm soát tần suất và chống flood một cách thận trọng. Trên cả hai nền tảng, sử dụng thời gian chờ và tác vụ theo lịch hợp lý để giảm spam và duy trì hoạt động tự động có thể dự đoán.
Giữ cho việc cập nhật dễ quản lý
Các bản cập nhật được phân phối dưới dạng gói cài đặt mới. Khi có phiên bản mới, hãy cài gói mới nhất lên bản cài đặt hiện có như mô tả trong README, đồng thời sao lưu cấu hình trước đó.
Khắc phục sự cố
- Nếu ứng dụng không khởi động đúng cách, hãy chạy lại trình cài đặt và xác nhận các phần phụ thuộc runtime bắt buộc đã có mặt.
- Nếu lệnh không phản hồi, hãy kiểm tra tệp cấu hình, quyền, các mô-đun đã bật và phạm vi nền tảng.
- Nếu thay đổi cấu hình cho kết quả ngoài dự kiến, hãy khôi phục bản sao lưu hoạt động tốt hoặc dùng
/config resetcho các thiết lập máy chủ. - Nếu phần mềm bảo mật cảnh báo về trình cài đặt tự động, hãy xác minh nguồn gói và đọc kỹ cảnh báo trước khi tiếp tục. Bật lại chế độ bảo vệ bình thường ngay sau mọi quy trình cài đặt được cấp quyền.
- Khi yêu cầu hỗ trợ, hãy cung cấp số phiên bản, hành vi mong đợi, hành vi quan sát được, lệnh liên quan và một đoạn cấu hình an toàn đã loại bỏ thông tin bí mật.
Hỗ trợ, đóng góp và giấy phép
Dự án hướng người dùng đến các kênh cộng đồng Discord và Telegram để nhận thông báo, hỗ trợ cấu hình, báo cáo sự cố và thảo luận tính năng. README cũng hoan nghênh các đóng góp, bao gồm báo lỗi, yêu cầu tính năng, ví dụ cấu hình và pull request.
Dự án được phát hành theo Giấy phép MIT. Bạn có thể sử dụng, sửa đổi và chia sẻ dự án theo các điều khoản của giấy phép. Phần mềm được cung cấp theo hiện trạng, vì vậy hãy đánh giá mức độ phù hợp với môi trường và trường hợp sử dụng của bạn trước khi triển khai.
Kết luận
Bộ công cụ tập trung cho Windows này cung cấp một cách độc lập để cấu hình và vận hành các phiên bản bot Discord và Telegram được cấp quyền. Hãy cài đặt gói, thêm thông tin xác thực của bạn, áp dụng quyền và phạm vi hẹp, kiểm tra bằng các lệnh cốt lõi rồi xuất cấu hình ổn định để sao lưu. Hệ thống lệnh được tài liệu hóa cùng với sự hỗ trợ từ cộng đồng giúp bạn bắt đầu bằng các giá trị mặc định và mở rộng dần.
