일본어 웹소설과 만화를
읽기 위한 상세 사용설명서

01 · START

먼저 사용할 경로를 고르세요

PMT는 한 제품 안에서 웹소설과 만화를 다루지만, 처음 필요한 준비물은 서로 다릅니다. 아래 세 경로 중 자신에게 맞는 것부터 시작하면 됩니다.

처음 5분 권장 설정

02 · INSTALL

설치와 지원 환경

Chrome판과 Firefox판은 같은 제품 원칙을 공유하지만 별도 브라우저 포트입니다. 한쪽의 설치 파일을 다른 브라우저에 불러오지 마세요.

PC Chrome 테스트 빌드 설치

1. 제공받은 ZIP의 압축을 풀고, 선택할 폴더 바로 안에 manifest.json이 있는지 확인합니다.
2. Chrome 주소창에 chrome://extensions를 입력합니다.
3. 오른쪽 위의 개발자 모드를 켭니다.
4. 압축해제된 확장 프로그램을 로드합니다를 누르고 해당 폴더를 선택합니다.
5. AI Web Translator PMT를 도구 모음에 고정합니다.

Android Firefox에 제공받은 서명 XPI 설치

확장 버전이 이 설명서의 기준 버전과 다를 수 있습니다. 설치 전에 파일명·배포 출처·버전을 확인하고, 최신 서명 파일이 제공되지 않았다면 임의의 unsigned ZIP/XPI를 일반 Firefox에 설치하지 마세요.

1. 공식 배포 경로에서 받은 PMT signed .xpi를 휴대폰에 저장합니다.
2. Firefox 메뉴에서 설정 → Firefox 정보로 이동합니다.
3. Firefox 로고를 빠르게 5번 탭해 확장 디버그 메뉴를 활성화합니다.
4. 설정으로 돌아가 Install Extension from File 또는 파일에서 확장 설치를 선택합니다.
5. 저장한 XPI를 고르고 권한 확인 화면에서 추가를 누릅니다.

Firefox 버전과 언어에 따라 메뉴 이름이 조금 다를 수 있습니다. Mozilla의 파일 설치 안내도 함께 참고하세요.

설치 직후 확인

• 확장 이름이 AI Web Translator PMT인지 확인합니다.
• Firefox 진단 시 Gecko ID는 ai-web-translator-pmt@example.local입니다.
• 설정 화면이 열리고 웹소설·만화 탭이 모두 보이는지 확인합니다.
• 비밀값을 넣기 전 테스트용 새 브라우저 프로필인지 확인합니다.

03 · CONNECTION

Direct와 Local Server의 차이

Direct는 웹소설을 빠르게 시작하는 경로이고, Local Server는 만화 로컬 처리와 서버 기능을 사용하는 경로입니다. Direct는 오프라인 모드가 아닙니다.

데이터 흐름

웹소설 Direct

웹소설·만화 Local Server

Windows PMT 서버 연결

04 · WEB NOVEL

웹소설 한 화를 번역해서 읽기

처음에는 자동번역을 끈 상태에서 후보 수와 번역 범위를 확인하고 수동 번역을 실행하는 것을 권장합니다.

패널 버튼 빠른 참조

05 · SCOPE & SITES

번역 범위와 지원 사이트

범위를 넓힐수록 읽기와 무관한 UI, 추천, 광고 후보가 섞일 가능성과 provider 사용량이 증가합니다.

우선 최적화 사이트

06 · READING

ReaderMode, 보관함과 여러 회차

PMT의 목표는 번역 한 번으로 끝나는 것이 아니라, 번역한 회차를 자연스럽게 이어 읽고 다시 찾는 것입니다.

여러 회차를 처리할 때

1. 목차 페이지에서 재감지 후 작품과 회차가 올바르게 잡혔는지 확인합니다.
2. 처음에는 1~3화 정도의 작은 범위로 저장·번역을 시험합니다.
3. provider 비용·속도·결과를 확인한 뒤 범위를 넓힙니다.
4. 탭이나 MV3 worker가 중단되어도 체크포인트가 있으면 복구되지만, 결과가 provider에 도착했는지 불확실한 요청은 중복 과금을 막기 위해 수동 재시도가 필요할 수 있습니다.
5. 브라우저 데이터를 지우기 전 중요한 작품은 txt로 내보냅니다.

07 · MANGA

만화 이미지 번역

만화는 Direct 모드로 처리하지 않습니다. 이미지 분석·OCR·인페인트·합성을 담당할 개인 Windows PMT 로컬 서버가 반드시 필요합니다.

이미지를 가져오는 방식

인쇄체 대사·캡션·표지는 핵심 품질 대상입니다. 손글씨, 장식 효과음, 세로쓰기, 작은 저해상도 글자는 상대적으로 OCR이 약할 수 있습니다. 결과가 불확실하면 원본 전환으로 반드시 확인하세요.

08 · SETTINGS

설정 화면 상세

일반 사용자는 연결·웹소설·만화 세 영역만 먼저 설정하고, Prompt Block과 request patch는 필요할 때 단계적으로 조정하세요.

Prompt Block 예시

Prompt Block은 자동 이름 메모리가 아니라 번역 요청에 넣는 수동 규칙입니다. 원문에 없는 설명을 만들거나 내용을 요약하라는 지시는 피하세요.

인명:
- ルナ = 루나
- カイト = 카이토

용어:
- 魔力 = 마력
- 冒険者ギルド = 모험가 길드

문체:
- 존댓말과 반말의 차이를 유지한다.
- 원문의 문단 순서와 정보를 생략하지 않는다.
- 원문에 없는 설명을 덧붙이지 않는다.

Provider request patch JSON

{
  "generationConfig": {
    "temperature": 0.4,
    "maxOutputTokens": 8192
  }
}

Prompt 설정 내보내기에는 API key가 포함되지 않습니다. 다른 기기에서 가져온 뒤 API key와 서버 비밀값은 별도로 입력해야 합니다.

09 · PRIVACY

개인정보와 권한

PMT의 데이터 경계는 개인 PC 로컬 비전 파이프라인 + 텍스트만 외부 LLM입니다. 다만 웹소설 Direct는 후보 텍스트를 선택한 provider로 직접 보냅니다.

브라우저 권한을 사용하는 이유

Chrome Manifest V3

Firefox Manifest V2

넓은 사이트 권한이 페이지 전체를 자동으로 외부 전송한다는 뜻은 아닙니다. 실제 처리는 활성화한 자동 번역 또는 사용자가 실행한 작업 후보로 제한됩니다. 자세한 정책은 개인정보 처리방침을 확인하세요.

10 · STORAGE

캐시, 보관 기간과 삭제

캐시는 재방문 속도와 중복 provider 사용을 줄이지만, 브라우저 프로필을 공유하거나 기기를 양도할 때는 직접 정리해야 합니다.

안전하게 삭제하는 순서

1. 필요한 소설 txt와 번역 이미지를 내보냅니다.
2. 소설·이미지 보관함에서 더 이상 필요 없는 항목을 삭제합니다.
3. 설정의 캐시·스토리지 정리 기능을 실행합니다.
4. 공용 PC라면 provider API key, 공유 키와 Pairing Token을 비웁니다.
5. 완전히 제거하려면 브라우저 확장 관리에서 PMT를 삭제합니다.

11 · TROUBLESHOOTING

문제가 생겼을 때

먼저 페이지 유형, 연결 모드, PMT 버전과 비밀값이 가려진 로그를 분리해서 확인하세요.

12 · STATUS & SUPPORT

현재 제한과 문제 신고

PMT는 주요 읽기 흐름을 구현했지만 사이트 구조와 OCR 결과에 영향을 받는 번역 리더입니다. 중요한 원문은 항상 원문 전환으로 확인하세요.

좋은 문제 신고에 필요한 정보

• Chrome/Firefox와 PMT 버전
• 문제가 발생한 URL과 페이지 유형: 검색·목차·본문·이미지 viewer
• Direct 또는 Local Server 모드
• 기대 동작과 실제 동작, 재현 순서
• API key·공유 키·Pairing Token을 가린 스크린샷과 디버그 로그

라이선스와 공개 상태

공개 서버 소스와 Windows 서버 배포의 현재 기준 라이선스는 AGPL-3.0-only입니다. Chrome 확장 자체의 독립 배포 라이선스는 정식 Store 배포 전에 확정해야 하며, 이 설명서 공개가 확장 바이너리·소스의 재배포 권한을 자동으로 부여하지 않습니다.