# 소개
'치지직 자동완성' 확장 프로그램은 미리 입력해둔 내용을 치지직 채팅에서 보여주고, 자동완성해주는 프로그램입니다.
원하는 템플릿이나, 방송인 관련 밈, 노래의 가사 등을 빠르게 칠 수 있게 도와줍니다.

의견 수집 및 별다른 이상이 없다는 판단이 든 후 기능을 일부 개선하여 확장 프로그램으로 다시 배포할 예정이머, 유저스크립트로 우선 배포합니다.
Mac OS 크롬 Tampermonkey 환경을 기준으로 테스트하여, 다른 환경에서 문제가 발생할 수 있습니다. 버그 제보 시 사용 중인 운영체제와 브라우저를 함께 써주세요.

# 설치


그 외로 본 프로그램과 관련은 없으나, 더 나은 치지직 사용 경험을 위해 다음과 같은 확장을 설치할 수 있습니다.
- Chzzk Latency Display (치지직 레이턴시 표시 & 정상화): https://chromewebstore.google.com/detail/bbcjmjholboggfggopgdhmakkopmichm
- 치즈 나이프 - 치지직 CHZZK 도구 모음: https://chromewebstore.google.com/detail/nfkfgkkhgglkgnlppncolmpekidapkjh
- 버퍼 - 치지직(CHZZK) 채팅창 기능 강화: https://chromewebstore.google.com/detail/gbgmenmdglilmbmemagekpeaodajbeei

단, '버퍼' 확장 프로그램의 경우 단축키가 겹치는 등 일부 문제가 발생할 수 있습니다.


# 사용법 및 기능

1. 설정 및 템플릿 추가


치지직 채팅 입력 칸에서 공백(스페이스)를 입력한 뒤, 설정을 클릭하거나 탭 키를 누르면 설정 팝업이 뜹니다.



설정에선 템플릿 추가, 채팅 쿨타임(최소 2초) 설정, 띄어쓰기 삭제 확률, 4글자 이상 연속한 자음/모음 및 특수문자 삭제 확률, 미리 띄울 다음 텍스트의 개수를 변경할 수 있습니다.



템플릿은 제목과 여러 줄의 텍스트로 이뤄집니다.
제목은 템플릿에 영향을 주지 않고 단순한 구분 용도입니다. 창팝 월드컵과 같이 '다 해줬잖아 - 인포딕'처럼 적는 게 편할 것으로 생각됩니다.

텍스트는 줄 단위로 구분되며, 빈 줄과 각 텍스트의 양옆 공백은 모두 무시됩니다.
자동완성 시 텍스트가 여러 개 중 랜덤으로 선택되게 하려면, 한 줄 안에서 구분할 텍스트 사이에 '|'를 넣어주세요.
예시: 억울하다 억울해 | 어구라다 어구래 | ㅇㄱㄹㄷ ㅇㄱㄹ

각 텍스트의 확률을 지정하고 싶다면, ':'로 구분해 확률(% 단위)을 표기해 주세요. 확률이 표기된 텍스트를 제외하고 남는 확률은 확률이 표기되지 않은 텍스트에 분배됩니다.
예시: 억울하다 억울해:50 | 억우랗다 억울해 | 억울하다 억우랳 | ㅇㄱㄹㄷ ㅇㄱㄹ:40
위 예시에서 '억울하다 억울해'는 50% 확률로 선택되며, ㅇㄱㄹㄷ ㅇㄱㄹ는 40% 확률로 선택됩니다. 나머지 10% 확률은 남은 텍스트 '억우랗다 억울해'와 '억울하다 억우랳'에 각각 5%씩 분배됩니다.

:0으로 설정할 경우 해당 텍스트는 선택되지 않지만 검색은 되기 때문에, 검색용 키워드를 추가하고 싶을 때 사용할 수 있습니다.
예시: Lost in the echoes of deceit | 로스트 인 더 에코스:0
위 예시는 'Lost'뿐만 아니라 'ㄹㅅㅌ' 등으로도 검색이 되지만, 항상 'Lost in the echoes of deceit'만이 선택됩니다.

자동완성 목록에서는 첫 번째 텍스트만 나타나며, 해당 텍스트를 선택 시 랜덤으로 완성됩니다.
텍스트가 선택된 후, 설정한 삭제 확률에 따라 특정 글자들이 랜덤하게 일부 삭제될 수 있습니다.
기능들을 적극 활용해 다양하고 자연스러운 템플릿으로 방송인 분들에게 재미를 선사해 주세요.


2. 템플릿 자동완성


치지직 채팅 입력 칸에서 글자를 입력하면 해당 글자들을 포함하는 후보들이 나타납니다.
초성으로도 검색 가능하며, 띄어쓰기를 하지 않아도 무방합니다.

이를 위/아래 방향키로 선택한 뒤 자동완성 키(기본은 탭)를 누르거나, 혹은 원하는 항목을 클릭할 시 자동완성이 적용되어 입력 창이 채워집니다.
ESC 키로 자동완성을 끄거나 켤 수 있습니다.
자동완성의 내용은 표시된 것과 같지 않을 수 있으며, '1. 설정 및 템플릿 추가'의 해당 부분을 참고해주시기 바랍니다.



자동완성 직후에는 채팅 쿨타임이 적용되어 자물쇠(+)가 뜨며, 해당 시간 동안은 자동완성이 불가능합니다.
비록 치지직 자체적으로 1초 이상의 쿨타임을 가지고 있지만, 이는 너무 작다고 판단되어 2초 이상의 쿨타임을 부여했습니다.
쿨타임은 설정 페이지에서 더 늘릴 수 있으나, 2초 미만으로는 설정할 수 없습니다. 도배로 보이지 않게 하기 위함이므로 양해 부탁드립니다.

또한 채팅 입력 칸이 빈 상태일 경우 마지막으로 자동완성된 텍스트의 다음 텍스트들이 후보로 표시됩니다.
다음 몇 줄까지 미리 띄울지는 설정의 다음 텍스트의 개수를 통해 조절할 수 있습니다.
텍스트를 전부 쓸 경우 다음 텍스트의 개수를 1로 설정해도 무방하나, 종종 텍스트를 띄엄띄엄 써야 하는 상황에선 2 이상의 값을 사용하는 게 편할 수 있습니다.

별도 조작을 하지 않은 상태에선 기본적으로 맨 위의 항목이 선택되며, 일치도가 높은 것이 위에 나타납니다.
일치도가 동일한 경우, 텍스트에서 먼저 나타나는 것이 위에 나타납니다.
바로 직전에 자동완성한 항목은 뜨지 않습니다.


# 참고

아직 테스트가 거의 되지 않은 상태이므로 버그가 발생할 가능성이 높습니다.
가급적이면 해적 내수용 방이나 템플릿 실수를 크게 해도 바로 넘어갈 수 있는 경우부터 시험해보는 것을 권장합니다.

똑같은 채팅을 서로가 다르게 치는 점 또한 즐거움의 일부입니다. 가급적이면 가사 단순 복붙 대신, 재밌는 템플릿을 직접 듣고 보고 만들어 사용해 주시면 감사하겠습니다.
확장 프로그램에 기본 템플릿을 넣지 않는 것 또한 동일한 이유에서인 만큼, 이 점 유의해서 더 즐거운 문화가 형성되면 좋을 것 같습니다.

또한, 너무 가사를 연속해서 이어 치는 것 역시 복붙이나 프로그램 사용으로 티가 나 보일 확률이 높습니다.
가급적이면 템플릿을 칠만한 알짜배기 부분만 적어두고 사용하거나, 아니면 쿨타임 및 다음 가사의 개수를 높게 설정하고 적당히 건너뛰며 치는 것을 권장합니다.


# 기타

본 프로그램은 치지직의 요청이 있을 경우 언제든지 삭제될 수 있습니다.
본 프로그램은 치지직의 정책을 준수합니다. 치지직의 정책을 위반하는 행위를 위해 사용할 수 없으며, 그러한 행동에 대한 책임은 사용자에게 있습니다.
본 프로그램은 무료로 배포되며, 어떠한 상업적 이용도 금지됩니다.