AI Web Translator PMT 웹소설 사용 설명서

1. 처음 사용하는 순서

가장 먼저 아래 순서대로 설정하면 됩니다.

1. Firefox에 AI Web Translator PMT 확장을 설치합니다.
2. 확장 아이콘을 눌러 설정 화면을 엽니다.
3. 웹소설 설정에서 번역 연결 방식을 고릅니다.
4. 번역 provider와 API key를 입력합니다.
5. 웹소설 페이지를 엽니다.
6. 화면 오른쪽의 PMT 버튼을 누릅니다.
7. 페이지 재감지를 누른 뒤 번역을 누릅니다.
8. 번역이 끝나면 (원) / (재) 버튼이나 원문/번역 전환을 사용합니다.
9. 저장된 회차는 소설 보관함에서 다시 읽거나 txt로 내보낼 수 있습니다.

처음에는 아래 설정을 권장합니다.

Firefox Android에 설치하기

PMT를 Android Firefox에서 사용하려면 서명된 .xpi 파일이 필요합니다. 배포 페이지에서 받은 signed .xpi 파일을 휴대폰에 저장한 뒤 아래 순서로 설치하세요.

1. Android에서 Firefox를 엽니다.
2. 오른쪽 아래 또는 오른쪽 위의 메뉴 버튼을 누릅니다.
3. 설정을 엽니다.
4. 아래쪽의 Firefox 정보로 들어갑니다.
5. Firefox 로고를 빠르게 5번 탭합니다.
6. 숨겨진 메뉴가 열렸다는 안내가 나오면 설정 화면으로 돌아갑니다.
7. Install Extension from File 또는 파일에서 확장 설치를 누릅니다.
8. 휴대폰에 저장해 둔 PMT signed .xpi 파일을 선택합니다.
9. 권한 확인 화면이 나오면 Add 또는 추가를 누릅니다.
10. 설치가 끝나면 확장 목록에서 AI Web Translator PMT를 확인합니다.

공식 Mozilla 안내도 같은 절차를 설명합니다.

• Mozilla Extension Workshop - Install add-on from file on Android
• Mozilla Support - Find and install extensions on Firefox for Android

설치 후에는 확장 설정을 열고 Direct (Hosted) 또는 Local Server 연결을 설정하면 됩니다.

2. 설정 화면

설정 화면에서는 연결 방식, 번역기, API key, 번역 범위, Prompt, 캐시를 관리합니다.

2.1 연결 방식 고르기

웹소설은 두 가지 방식으로 번역할 수 있습니다.

Local Server를 사용할 때는 PC에서 PMT 서버를 켜고 아래 값을 맞춰야 합니다.

Android Firefox에서 PC 서버를 사용할 경우, 휴대폰에서 PC 주소에 접근할 수 있어야 합니다. 같은 Wi-Fi 또는 Tailscale 같은 연결이 필요합니다.

2.2 웹소설 번역기 설정

웹소설 설정에서 아래 항목을 설정합니다.

3. 번역 범위

웹소설 번역 범위는 세 가지입니다.

처음에는 본문번역을 사용하세요. 전체번역은 편할 수 있지만, 번역량이 늘어나 비용과 시간이 더 많이 들 수 있습니다.

4. Prompt Block

Prompt Block은 번역기의 말투와 규칙을 정하는 기능입니다.

일반 사용자는 기본값 그대로 사용해도 됩니다. 이름, 말투, 용어 번역을 더 고정하고 싶을 때만 수정하세요.

Prompt Block에서 바꾸는 것은 번역 지시문입니다. API key나 서버 연결값을 바꾸는 곳이 아닙니다.

4.1 언제 수정하면 좋은가

아래 같은 문제가 반복될 때 Prompt Block을 수정하면 효과가 있습니다.

예를 들어 이런 내용을 추가할 수 있습니다.

4.2 블록 항목 설명

Prompt Block을 펼치면 각 블록에 여러 입력칸이 보입니다.

role은 대부분 system으로 두면 됩니다. user와 assistant는 예시 대화처럼 특수한 구성을 만들 때만 사용하세요.

4.3 좋은 Prompt 작성법

Prompt는 길게 쓰는 것보다 고정하고 싶은 규칙을 짧고 분명하게 쓰는 편이 좋습니다.

좋은 예:

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

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

문체:
- 대사는 자연스러운 한국어 구어체로 번역한다.
- 원문에 없는 설명을 덧붙이지 않는다.
- 문단 순서를 유지한다.

피하는 것이 좋은 예:

무조건 엄청 잘 번역해줘.
모든 걸 자연스럽게 알아서 고쳐줘.
내용이 어색하면 적당히 요약해줘.

특히 “요약해줘”, “줄여줘” 같은 지시는 웹소설 본문 누락으로 이어질 수 있으니 넣지 않는 것이 좋습니다.

Prompt 화면에서 할 수 있는 일:

• Prompt 블록 켜기/끄기
• 새 규칙 추가
• 기존 규칙 수정
• 프리셋 저장
• Prompt 설정 내보내기/가져오기
• 번역 요청 미리보기 확인

4.4 Prompt 설정 내보내기/가져오기

내보내기는 현재 Prompt Block과 일부 번역 설정을 JSON 파일로 저장합니다. 가져오기는 저장해 둔 Prompt 설정 JSON을 다시 불러옵니다.

이 기능은 아래 상황에서 유용합니다.

• 다른 기기에서도 같은 이름/용어 규칙을 쓰고 싶을 때
• 작품별 Prompt 세트를 따로 보관하고 싶을 때
• Prompt를 크게 수정하기 전에 백업하고 싶을 때
• 번역 설정을 다른 사람에게 공유하고 싶을 때

4.5 Provider request patch JSON

Provider request patch JSON은 Prompt 문장이 아니라, 번역 provider로 보내는 요청 옵션을 조정하는 고급 기능입니다.

일반 사용자는 비워 두는 것을 권장합니다. 번역 온도, 최대 출력 토큰 같은 provider 옵션을 직접 조절하고 싶을 때만 사용하세요.

JSON 입력 규칙:

• 반드시 { ... } 형태의 JSON object여야 합니다.
• 문자열은 큰따옴표 "를 써야 합니다.
• 주석을 넣을 수 없습니다.
• 마지막 항목 뒤에 쉼표를 붙이면 안 됩니다.
• 잘못된 JSON을 넣으면 설정 저장이나 미리보기가 실패할 수 있습니다.

Gemini에서 번역을 조금 더 안정적으로 만들고 싶을 때:

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

Gemini는 아래처럼 밑줄 형태로 적어도 내부에서 같은 의미로 처리합니다.

{
  "generation_config": {
    "temperature": 0.4,
    "max_output_tokens": 8192
  }
}

DeepSeek / OpenRouter 같은 OpenAI 호환 provider에서는 passthrough 안에 옵션을 넣는 방식이 안전합니다.

{
  "passthrough": {
    "temperature": 0.4,
    "max_tokens": 8192
  }
}

자주 쓰는 값:

처음 조정할 때는 temperature만 바꿔 보세요. 값을 너무 많이 한 번에 바꾸면 어떤 설정 때문에 결과가 달라졌는지 알기 어렵습니다.

번역 결과가 이상해졌다면 최근에 추가한 Prompt를 끄고 다시 번역해 보세요.

5. 웹소설 페이지에서 번역하기

웹소설 페이지를 열면 화면 오른쪽에 PMT 버튼이 나타납니다. 이 버튼을 누르면 현재 페이지 조작 패널이 열립니다.

자주 쓰는 버튼은 아래와 같습니다.

기본 사용 흐름:

1. 웹소설 본문 페이지를 엽니다.
2. 오른쪽 PMT 버튼을 누릅니다.
3. 페이지 재감지를 누릅니다.
4. 본문 블록 수가 잡히면 번역을 누릅니다.
5. 번역이 마음에 들지 않는 문단은 (재)로 다시 번역합니다.
6. 원문을 보고 싶으면 (원)을 누릅니다.

6. 원문 보기와 재번역

번역된 문단 옆에는 상황에 따라 (원) 또는 (재) 버튼이 표시됩니다.

페이지 전체를 다시 번역하고 싶으면 플로팅 패널의 재번역을 사용하세요.

7. ReaderMode

ReaderMode는 웹소설을 더 읽기 쉬운 화면으로 바꿔 주는 기능입니다.

주요 기능:

• 본문 중심 읽기 화면
• 이전화 / 목차 / 다음화 이동
• 원문/번역 전환
• 읽기 중 설정 패널 열기
• 일반 페이지로 돌아가기
• 저장소와 이어지는 회차 읽기 흐름

사용 방법:

1. 지원되는 웹소설 페이지를 엽니다.
2. 오른쪽 PMT 버튼을 누릅니다.
3. ReaderMode를 누릅니다.
4. 본문을 읽습니다.
5. 화면을 탭하면 상단/하단 조작부를 숨기거나 다시 볼 수 있습니다.
6. 읽기를 끝낼 때는 ReaderMode 해제 버튼으로 원래 페이지로 돌아갑니다.

ReaderMode는 주로 아래 사이트에서 사용합니다.

로그인이 필요한 작품은 Firefox에서 먼저 해당 사이트에 로그인한 뒤 사용하세요.

8. 소설 보관함

번역한 웹소설은 소설 보관함에 저장됩니다. 나중에 같은 회차를 다시 찾거나, 저장된 번역본만 따로 읽을 때 사용합니다.

소설 보관함에서 할 수 있는 일:

• 저장된 작품 보기
• 작품 검색
• 최근 읽은 회차 확인
• 즐겨찾기 작품 모아 보기
• 작품별 회차 목록 열기
• 저장된 회차 읽기
• 저장된 회차를 txt 파일로 내보내기

하단 탭:

9. 작품 폴더와 회차 추가

작품을 누르면 작품 폴더가 열립니다. 작품 폴더에서는 저장된 회차와 아직 저장하지 않은 회차를 함께 볼 수 있습니다.

주요 기능:

여러 회차를 한 번에 추가하려면 API key와 네트워크 상태가 안정적이어야 합니다. 중간에 취소하면 완료된 회차만 저장됩니다.

10. 저장소 리더

저장소 리더는 저장된 회차를 읽는 화면입니다.

화면 구성:

본문을 탭하면 상단/하단 조작부를 숨기거나 다시 볼 수 있습니다. 긴 회차를 읽을 때는 조작부를 숨기면 화면을 더 넓게 쓸 수 있습니다.

11. 글자 크기와 테마

저장소 리더에서 Aa 버튼을 누르면 읽기 화면을 조절할 수 있습니다.

눈이 피로하면 종이 테마나 어둡게 테마를 사용해 보세요.

12. txt로 내보내기

저장된 회차는 txt 파일로 내보낼 수 있습니다.

사용 방법:

1. 소설 보관함을 엽니다.
2. 내보내기 화면을 엽니다.
3. 내보낼 작품이나 회차를 체크합니다.
4. 합본 txt 저장을 누릅니다.
5. 저장 완료 메시지를 확인합니다.

내보내기는 작품별 합본 txt를 만듭니다. 여러 회차를 선택하면 회차 순서대로 묶입니다.

Android Firefox에서는 저장 위치가 브라우저 다운로드 설정을 따릅니다. 저장이 보이지 않으면 Firefox 다운로드 목록을 먼저 확인하세요.

13. 캐시와 저장소 관리

PMT에는 캐시와 소설 보관함이 따로 있습니다.

소설 캐시 지우기를 해도 보관함의 작품이 바로 삭제되는 것은 아닙니다. 저장된 작품이나 회차를 지우려면 소설 보관함의 삭제 기능을 사용하세요.

캐시를 지우면 좋은 경우:

• 예전 번역 결과가 계속 다시 나올 때
• Prompt를 크게 바꿨는데 결과가 바뀌지 않는 것처럼 보일 때
• provider나 모델을 바꾼 뒤 새 결과로 다시 받고 싶을 때
• 오류가 반복되어 깨끗한 상태에서 다시 시도하고 싶을 때

14. 지원 사이트

웹소설 기능은 일반적인 일본어 본문 페이지에서도 동작할 수 있지만, 아래 사이트를 우선 지원합니다.

Pixiv의 이미지 작품 페이지는 웹소설 기능이 아니라 만화/이미지 번역 기능에 해당합니다.

15. 개인정보 처리 방침

AI Web Translator PMT는 일본어 웹소설과 만화 이미지를 번역해 읽기 위한 브라우저 확장 프로그램입니다.

PMT 개발자 또는 운영자는 사용자의 번역 데이터, API key, 보관함 데이터를 별도 서버로 수집하거나 저장하지 않습니다.

아래 데이터는 사용자의 브라우저, 사용자가 직접 실행한 로컬 PMT 서버, 또는 사용자가 선택한 외부 번역 provider에서 기능 실행을 위해 처리될 수 있습니다.

15.1 사용자 기기 또는 로컬 서버에서 처리되는 데이터

• 사용자가 설정한 서버 URL, 번역 설정, prompt 설정
• 사용자가 입력한 번역 API key
• 사용자가 번역 대상으로 선택한 웹페이지의 텍스트, 이미지 URL, 이미지, 링크, 페이지 제목
• 번역 캐시, 소설/만화 보관함, 디버그 로그
• 번역 또는 저장 대상 페이지 URL과 제목

이 데이터는 기본적으로 확장 로컬 저장소, 브라우저 내부 처리, 또는 사용자가 직접 켠 로컬 PMT 서버에서 사용됩니다.

15.2 데이터 사용 목적

• 웹소설/만화 번역
• ReaderMode 표시
• 원문/번역 토글
• 번역 캐시와 보관함
• 서버 연결 테스트
• 오류 진단과 디버그 로그

15.3 데이터 전송

• 만화 이미지는 사용자가 설정하고 직접 실행한 로컬 PMT 서버로 전송되어 처리됩니다.
• 만화 이미지 자체는 외부 LLM 또는 외부 번역 provider로 전송하지 않습니다.
• 사용자가 direct 번역 provider를 선택한 경우, 번역에 필요한 텍스트와 API key가 해당 provider API로 전송될 수 있습니다.
• Local Server 모드에서 외부 번역 provider를 사용하도록 설정한 경우에도, 번역에 필요한 텍스트와 API key가 사용자가 설정한 provider API로 전송될 수 있습니다.
• 이러한 외부 provider 전송은 PMT 개발자 서버를 거치지 않습니다.
• 원격 실행 코드는 로드하거나 실행하지 않습니다.

15.4 데이터 판매, 광고, 추적

• 사용자 데이터를 판매하지 않습니다.
• 광고 목적, 추적 목적, 신용도 판단 또는 대출 목적에 사용하지 않습니다.
• 확장의 단일 목적과 관련 없는 용도로 사용자 데이터를 사용하지 않습니다.
• PMT 개발자 또는 운영자는 사용자의 번역 내용, API key, 보관함 내용을 열람하거나 수집하지 않습니다.

16. 자주 생기는 문제

PMT 버튼이 보이지 않음

• 페이지를 새로고침합니다.
• 확장이 켜져 있는지 확인합니다.
• Firefox에서 해당 사이트에 확장 권한이 허용되어 있는지 확인합니다.
• 웹소설 페이지가 아닌 검색/광고/로그인 화면인지 확인합니다.

본문 블록 수가 0개로 나옴

• 페이지 재감지를 다시 누릅니다.
• 본문이 완전히 로딩될 때까지 기다립니다.
• 로그인이 필요한 작품이면 먼저 로그인합니다.
• 탐색번역 또는 전체번역으로 범위를 바꿔 봅니다.

번역이 시작되지 않음

• API key가 입력되어 있는지 확인합니다.
• provider와 model 설정이 맞는지 확인합니다.
• 번역기 켜기/끄기가 켜져 있는지 확인합니다.
• Local Server 모드라면 PC 서버가 실행 중인지 확인합니다.
• 휴대폰에서 PC 서버 주소에 접속 가능한지 확인합니다.

번역 결과가 이상함

• (재)로 해당 문단만 다시 번역합니다.
• 페이지 전체는 재번역을 누릅니다.
• 최근에 추가한 Prompt Block을 끄고 다시 시도합니다.
• 번역 범위를 본문번역으로 낮춰 봅니다.

저장소에 회차가 보이지 않음

• 번역이 끝난 뒤 잠시 기다립니다.
• 소설 보관함을 닫았다가 다시 엽니다.
• 원본 페이지가 지원 사이트인지 확인합니다.
• 로그인 전용 작품은 로그인 상태에서 다시 번역합니다.

txt 저장 파일을 찾을 수 없음

• Firefox 다운로드 목록을 확인합니다.
• Android의 Downloads 폴더를 확인합니다.
• 저장 실패 메시지가 떴다면 회차 수를 줄여 다시 시도합니다.

17. 추천 사용 패턴

처음 읽는 작품

1. 원본 사이트에서 1화를 엽니다.
2. PMT → 페이지 재감지 → 번역을 누릅니다.
3. 번역 품질이 괜찮으면 ReaderMode로 읽습니다.
4. 마음에 드는 작품은 보관함에서 즐겨찾기합니다.

여러 회차를 이어서 읽기

1. 작품 목차 또는 저장소 작품 폴더를 엽니다.
2. 필요한 회차를 추가 번역합니다.
3. 저장소 리더에서 이전화/다음화로 이동합니다.
4. 읽기 설정에서 글자 크기와 테마를 맞춥니다.

번역 품질을 다듬기

1. 자주 틀리는 이름과 용어를 Prompt Block에 추가합니다.
2. 해당 회차를 재번역합니다.
3. 마음에 들지 않는 문단만 (재)로 다시 번역합니다.