Tài liệu IRC · Nâng cao
Lệnh CAP: liệt kê và thương lượng phần mở rộng
CAP là lệnh thương lượng các tiện ích mở rộng IRC. Nó cho phép trình khách bật những cơ chế mà mình hỗ trợ. Hướng dẫn IRCv3 CAP giải thích các bước chuyển trạng thái; trang này giúp nhận diện cú pháp trong nhật ký.
Đội ngũ Dialova · Đã kiểm tra ngày
Cú pháp và tham số #
CAP <LS [302] | LIST | REQ :<kha-nang> | END>| Tham số | Ý nghĩa |
|---|---|
| LS 302 | Yêu cầu danh sách theo cơ chế công bố hiện đại, gồm giá trị và phản hồi có thể chia thành nhiều phần. |
| REQ | Yêu cầu bật các khả năng đã chọn; ACK hoặc NAK trả lời yêu cầu. |
| LIST / END | LIST mô tả các khả năng đang bật; END kết thúc việc tạm dừng đăng ký kết nối. |
Ví dụ có giải thích #
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS :message-tags server-time
C: CAP REQ :server-time
S: :irc.example CAP Alice ACK :server-time
C: CAP ENDBiệt danh, tên máy và nội dung trong ví dụ đều là giả định. Trình khách có thể trình bày phản hồi dễ đọc hơn các dòng giao thức bên dưới.
Phản hồi và lỗi có thể gặp #
| Phản hồi | Giải thích |
|---|---|
| CAP LS | Danh sách được cung cấp; dấu * ở phần trung gian cho biết còn phần tiếp theo. |
| CAP ACK / NAK | Chấp nhận bật hoặc từ chối yêu cầu. |
| CAP LIST | Danh sách khả năng đang bật. |
| Lỗi | Nguyên nhân thường gặp |
|---|---|
| 410 | Lệnh con CAP không hợp lệ theo triển khai. |
| 421 | Máy chủ cũ không nhận diện CAP. |
Quyền hạn, khả năng tương thích và lưu ý #
Công bố LS không bật gì cả. Trình khách chỉ được dùng một khả năng sau khi đã bật thành công. CAP END không gửi tin nhắn vào kênh: đó là một bước của quá trình kết nối.
CAP cũng có thể dùng sau khi đăng ký kết nối. Tuy nhiên, cần diễn giải lệnh con, phiên bản được công bố và thông báo NEW/DEL theo đặc tả. Giá trị của khả năng, chẳng hạn sasl=PLAIN, không phải tên của nó.
Câu hỏi thường gặp #
Vì sao CAP không có dấu /? Đây là giao thức; giao diện xử lý lệnh ở bên trong.
CAP và 005 ISUPPORT có giống nhau không? Không: ISUPPORT mô tả thuộc tính và giới hạn; CAP bật các tiện ích đã được thương lượng.
Nguồn và kiểm chứng
Ví dụ dùng biệt danh và tên miền giả định, trừ các điểm kết nối được nêu rõ. Phần mở rộng và cấu hình riêng của một mạng được chỉ ra trong nội dung.
- Modern IRC — đặc tả giao thức máy khách ↗Nguồn đặc tả · tham khảo ngày 2026-10-29
- IRCv3 — thương lượng khả năng máy khách ↗Nguồn đặc tả · tham khảo ngày 2026-10-29