본문으로 건너뛰기
Dialova

IRC 문서 · 고급

IRCv3 메시지 태그와 메타데이터

메시지 태그는 IRC 메시지 앞에 시각, 계정이나 배치 참조 같은 메타데이터를 추가합니다. 모르는 태그를 화면에서 무시할 수는 있지만 형식은 올바르게 파싱해야 합니다.

Dialova 팀 · 확인일

태그 영역 읽기 #

태그 두 개를 포함한 서버 프레임
@time=2026-10-29T10:00:00.000Z;account=alice :Alice!u@cloak.example PRIVMSG #atelier :Bonjour

@로 시작해 이스케이프되지 않은 첫 공백에서 끝납니다. ;로 태그를 구분하고 = 뒤에 값이 올 수 있습니다. 순서는 의미 없고 키는 대소문자를 구분합니다. 영역을 분리하기 전 메시지 매개변수부터 나누지 마세요.

값은 한 번만 디코딩 #

전송 시 표현디코딩한 값
\:Point-virgule
\sSpace
\\Antislash
\r캐리지 리턴
\n줄바꿈

이스케이프는 태그 값에만 적용하고 본문 전체에는 적용하지 않습니다. 값은 UTF-8이며 빈 값과 값 없음은 동등합니다. 임의로 의미 차이를 만들지 마세요.

범용 기능과 개별 확장 #

message-tags는 전체 형식 지원과 클라이언트 전용 태그·TAGMSG를 제공합니다. server-time, account-tag와 batch도 태그 형식을 사용하지만 협상을 범용 기능과 혼동해서는 안 됩니다.

가상 클라이언트 태그: 특정 기능 효과를 가정하지 않음
C: CAP REQ :message-tags
S: :irc.example CAP Alice ACK :message-tags
C: @+example.org/note=안녕\\s여기 TAGMSG #atelier

+ 접두사는 클라이언트 태그입니다. 사용자의 주장을 서버가 인증한 정보로 만들지 않습니다. 서버가 알린 계정과 사용자가 임의로 보낸 텍스트는 구분해야 합니다.

크기 제한이 있는 메타데이터 #

태그는 기존 메시지 부분과 별도 크기 예산이 있지만 PRIVMSG 본문이 무제한은 아닙니다. 알 수 없는 태그, 잘못된 이스케이프와 중복 키는 규격대로 처리하세요. 모든 확장을 거부하거나 무제한 저장하는 파서를 피하세요.

출처와 확인

별도로 명시된 접속 지점을 제외하고 예시의 닉네임과 도메인은 가상입니다. 특정 네트워크의 확장 기능이나 설정은 본문에서 구분합니다.