> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 신입 번역가 가이드

> 중국어 장편 소설을 한국어로 번역하는 전체 흐름 — 설치부터 구독, 스킬 설치, 번역·윤문·수동 검수까지

<Info>
  적용 범위: 중국어 장편 소설 → 한국어 번역. 전 과정을 SoloEnt 데스크톱 클라이언트에서 진행하며, **번역 1회 + 윤문 1회** 로 구성됩니다.
</Info>

## 1. 다운로드 및 설치

<Steps>
  <Step title="클라이언트 다운로드">
    [https://soloent.ai/ko/download](https://soloent.ai/ko/download) 에서 사용 중인 운영체제(Windows / macOS)에 맞는 최신 버전 클라이언트를 내려받습니다.
  </Step>

  <Step title="설치 후 실행">
    설치하고 실행합니다. 처음 실행할 때 「Git이 설치되어 있지 않습니다」 라는 안내가 나와도 무시해도 됩니다. 번역 작업에는 영향이 없습니다.
  </Step>
</Steps>

## 2. 프로젝트 폴더 열기 / 만들기

<Steps>
  <Step title="프로젝트 폴더 준비">
    프로젝트 폴더를 새로 만들거나 기존 폴더를 엽니다(하나의 프로젝트 = 하나의 작품). 이때 **로컬 폴더 접근 권한을 허용** 해야 합니다.
  </Step>

  <Step title="프로젝트에 넣을 자료 준비">
    새 프로젝트인지 이어서 하는 작업인지에 따라 넣을 자료가 다릅니다.

    * 🆕 **새 프로젝트** → **중국어 원문**(원작 챕터 파일)을 넣습니다.
    * 🔄 **기존 프로젝트 이어하기** → **기존 자료**를 넣습니다: 용어집(glossary), 인물 카드, 관계 카드, 그리고 이미 작업한 한국어 번역문.
  </Step>
</Steps>

<Card title="첫 번째 프로젝트 만들기" icon="folder-plus" href="/ko/tips/create-project">
  프로젝트 생성과 폴더 권한에 대한 자세한 안내
</Card>

## 3. 로그인

<Steps>
  <Step title="계정으로 로그인">
    클라이언트를 열고 **Google** 또는 **Microsoft** 계정으로 로그인합니다(중국 네트워크 환경에서는 **Microsoft 쪽 연결이 더 안정적** 입니다).
  </Step>

  <Step title="클라이언트로 돌아오지 않을 때">
    브라우저 인증은 성공했는데 클라이언트로 돌아오지 않는다면, 페이지의 **Click here to open SoloEnt** 를 클릭합니다. 그래도 반응이 없으면 브라우저에서 **팝업과 리디렉션을 허용** 한 뒤 다시 시도하세요.
  </Step>
</Steps>

<CardGroup cols={2}>
  <Card title="로그인" icon="right-to-bracket" href="/ko/quickstart/login">
    로그인 절차 안내
  </Card>

  <Card title="로그인 문제" icon="circle-exclamation" href="/ko/troubleshooting/login">
    앱으로 돌아오지 못하는 등 로그인 문제 해결
  </Card>
</CardGroup>

## 4. 멤버십 구독

번역 과정에서 사용하는 상위 모델(**Gemini 3.1 Pro**, **GPT 5.6 Terra**)과 일부 스킬은 **구독 후에만** 사용할 수 있습니다. 작업을 시작하기 전에 해당 플랜을 먼저 개통하세요.

<Steps>
  <Step title="콘솔 열기 (둘 중 하나)">
    * 오른쪽 상단의 **계정 아바타 → Dashboard** 를 클릭해 웹 콘솔로 들어갑니다.
    * 또는 **설정 → API 설정** 에서 무료 모델 목록 아래의 **Upgrade subscription / VIP 업그레이드** 를 클릭합니다.
  </Step>

  <Step title="플랜 선택 및 결제">
    콘솔의 **Subscription Plan / 구독 플랜** 에서 플랜(**Lite / Pro / Max**)과 청구 주기(월간 / 연간)를 고른 뒤 **구독 변경** 을 클릭해 결제 화면으로 이동하고, **Stripe** 로 결제합니다(WeChat Pay, Alipay 지원).
  </Step>
</Steps>

<Warning>
  이 번역 워크플로의 **플랜 요구 사항**:

  * **translate-long-2**(새 프로젝트) → **Lite** 이상 필요
  * **translate-long-resume**(이어하기) → **Pro** 이상 필요
  * 상위 모델(Gemini 3.1 Pro, GPT 5.6 Terra)은 그에 상응하는 구독 한도가 필요합니다
</Warning>

<CardGroup cols={3}>
  <Card title="플랜 선택하기" icon="credit-card" href="/ko/subscription/choose-your-plan">
    플랜 비교
  </Card>

  <Card title="결제 완료하기" icon="wallet" href="/ko/subscription/make-the-payment">
    Stripe 결제 절차
  </Card>

  <Card title="구독 관리" icon="gear" href="/ko/subscription/manage-subscription">
    잔액·청구서·해지
  </Card>
</CardGroup>

## 5. 번역 스킬 설치

<Steps>
  <Step title="Marketplace에서 검색">
    오른쪽 상단의 **Marketplace(스킬 마켓)** 아이콘을 클릭하고, 한국어로 전환한 뒤 `번역` / `翻译` / `translate` 로 검색합니다(오른쪽 상단에서 중국어 또는 한국어로 언어 필터를 적용할 수 있습니다).
  </Step>

  <Step title="대상 프로젝트에 설치">
    **먼저 대상 프로젝트를 연 다음** **Install** 을 클릭해 스킬을 **현재 프로젝트** 에 설치합니다.
  </Step>
</Steps>

| 상황                 | 설치할 스킬                                         | 설명                                                                                   |
| ------------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------ |
| 🆕 새 프로젝트를 처음부터 번역 | **translate-long-2** (장편 소설 번역(중→한) 2.0)       | 원문 읽기 → 설정 추출 → 로컬라이제이션 방안 → 챕터별 번역                                                  |
| 🔄 기존 프로젝트 이어하기    | **translate-long-resume** (장편 소설 번역 이어하기(중→한)) | 기존 용어집 / 인물 카드 / 관계 카드 / 기존 번역문을 자동으로 인식하고, **원본 파일은 절대 수정하지 않으며**, 기존 번역문과의 연속성을 유지 |

<Card title="Marketplace(스킬 마켓)" icon="store" href="/ko/tips/marketplace">
  스킬 팩을 둘러보고 설치하는 방법
</Card>

## 6. 모델 선택 (각 단계 시작 전 반드시 확인)

대화창 아래의 **모델 이름** 을 클릭해 모델을 전환합니다.

* **사전 준비 → Gemini 3.1 Pro / Gemini 3.6 Flash**
* **번역 단계 → Gemini 3.1 Pro / Gemini 3.6 Flash**
* **윤문 단계 → GPT 5.4 / GPT 5.6 Terra**

<Warning>
  번역을 시작하기 전에 Gemini 3.1 Pro인지, 윤문을 시작하기 전에 GPT 5.6 Terra인지 반드시 먼저 확인하세요.
</Warning>

<Card title="API 설정" icon="key" href="/ko/quickstart/api-configuration">
  모델과 API Key 설정 방법
</Card>

## 7. 표준 프로세스: 번역 + 윤문 + 수동 검수

### A. 번역 (모델: Gemini 3.1 Pro)

<Steps>
  <Step title="사전 확인">
    원문(또는 이어하기용 자료)이 프로젝트에 들어가 있고, 모델이 **Gemini 3.1 Pro** 로 설정되어 있는지 확인합니다.
  </Step>

  <Step title="스킬 호출">
    대화창에서 해당 스킬을 호출합니다. 새 프로젝트는 **translate-long-2**, 이어하기는 **translate-long-resume** 를 사용합니다.
  </Step>

  <Step title="스킬 안내에 따라 진행">
    스킬의 안내에 따라 단계별로 진행합니다(원문 읽기 → 설정 / 용어 추출 → 로컬라이제이션 방안 → 챕터별 번역). 용어집, 인물 카드, 관계 카드는 **프로젝트 파일로 축적** 되어 이후 챕터와 새 창에서 재사용됩니다.
  </Step>

  <Step title="창 나누기">
    사전 준비 작업은 하나의 창에서 하고, 번역을 시작할 때는 새 창을 만듭니다(오른쪽 상단의 "+" 클릭). 창 하나당 3\~4개 챕터를 번역하고, 세션 창 길이가 200k를 넘지 않도록 권장합니다.
  </Step>

  <Step title="새 창에서 스킬 재활성화">
    새 창에서는 스킬을 다시 활성화해야 합니다. "스킬로 xxx장 번역 이어서 진행해 줘" 와 같이 요청하세요.
  </Step>
</Steps>

### B. 윤문 (모델: GPT 5.6 Terra)

<Steps>
  <Step title="일괄 번역 후 일괄 윤문">
    먼저 여러 챕터를 일괄 번역한 뒤, 모델을 전환하고 새 창을 열어 일괄로 윤문을 진행할 수 있습니다.
  </Step>

  <Step title="모델 전환">
    모델을 **GPT 5.6 Terra** 로 변경합니다.
  </Step>

  <Step title="새 창에서 스킬 재활성화">
    새 창에서는 스킬을 다시 활성화해야 합니다. "스킬로 xxx장 윤문해 줘" 와 같이 요청하세요.
  </Step>
</Steps>

### C. 수동 검수

윤문이 끝난 챕터를 처음부터 끝까지 통독하고, 다음 항목은 에디터에서 직접 수정합니다.

1. 지나치게 직역된 부분
2. 인물의 말투나 존댓말이 맞지 않는 부분
3. 문장 부호가 잘못된 부분
4. 처음 등장하는 고유명사에 요구된 표기가 누락된 부분

## 8. 컨텍스트 윈도우 관리 (필수 준수)

<Warning>
  * **세션 창 하나가 200k를 넘지 않도록 합니다.**
  * **일반적으로 3\~5개 챕터를 번역할 때마다 새 창을 여는 것이 좋습니다. 윤문은 상대적으로 더 많이 담을 수 있으며, 기준은 200k를 넘지 않는 것입니다.**
  * **새로운 작업으로 넘어갈 때는 새 창으로 바꿉니다.**
</Warning>

이유: 창이 지나치게 커지면 모델의 주의가 분산되고, 비용이 급증하며, 번역 품질이 떨어집니다.

<Card title="컨텍스트 윈도우를 현명하게 활용하기" icon="gauge" href="/ko/tips/context-window">
  컨텍스트 윈도우의 상한과 비용, 작업 분리 방법
</Card>