github.com/hisacat/AIDungeon-Extension
hisacat/AIDungeon-Extension
Contribute to hisacat/AIDungeon-Extension development by creating an account on GitHub.
github.com
첫 빌드 (프로토타입: 0.0.1-alpha)가 릴리즈되었습니다. [다운로드]
이는 AI던전의 GUI 확장 프로그램으로써, 번역 기능을 포함한 추가 기능을 제공합니다.
실행에 앞서, 사용중인 chrome에 맞는 chromedriver가 필요합니다. [설치 가이드]
프로그램을 실행하면, Chrome창이 열리며, 여기서 AIDungeon의 플레이가 감지되면,
번역된 텍스트를 출력하며 동작을 시작합니다.
하단의 텍스트박스는 기본적으로 AIDungeon과 동일한 UX를 제공합니다.
현재 지원하는 커맨드 목록 : Do, /Say, /Story, /Redo, /Undo, /Retry
지원 예정 커맨드 목록 : /Remember, /Alter
입력 텍스트 번역 관련
Enter를 누르면 영어로 번역됩니다.
Ctrl+Enter로 텍스트를 전송할 수 있습니다.
Shift+Enter로 개행합니다.
키 바인딩(단축키 변경)은 지원 예정입니다.
알려진 버그
Action 수가 많은 게임 로드시, 번역 순서가 꼬입니다. (중간것부터 번역하거나 할 때가 있음)
원인 파악은 완료했으며, 수정중에 있습니다.
동작이 되지 않을 경우
일반적으로, 가장 자주 발생할만한 문제는 웹페이지의 구조 변경으로 인해, 새 XPath가 필요한 경우입니다.
이 경우, 업데이트를 기다리시거나 Github 페이지를 참조하여 XPath를 직접 수정해주세요.
XPath문제가 아닌 경우엔, 업데이트를 기다려 주세요.
또한, 프로그램 실행 시 생성되는 log.txt를 전달해주시면 원인 파악에 도움이 됩니다.
동작 원리
AIDungeon Extension은 Chrome의 로그로부터 AIDungeon의 WebSocket 내용을 모니터링하여 데이터를 분석합니다.
텍스트 입력 등의 인풋 동작의 경우, XPath로 WebElement를 찾아 클릭이나 키를 보내는 등의 조작을 시뮬레이션합니다.
이로 인해 WebSocket 데이터의 변조는 일어나지 않습니다.
번역 기능의 경우, headless(창이 보여지지 않음)옵션으로 실행된 Chrome 클라이언트에서 Google translator의 번역 결과를 파싱합니다.
라이센스
이 프로그램은 오픈소스로, MIT라이센스에 따라 개발되었으며,
사용시의 불이익에 대해서는 책임지지 않습니다.
마치며
최근에 일이 바빠서 좀 급하게 마무리한 감이 많습니다.
잔버그가 꽤 있을 것이라 생각됩니다 (길게 테스트해보지 못했음)
작업 현황은 트렐로에서 확인 가능합니다.
드래곤 많이 사랑해주세요