# 증상별 문제 해결과 상담 안내

> 기준일: 2026-09-19
> 대상: 셀비 회원, AI 상담 답변 작성자, 고객 지원 담당자

이 문서는 안전하게 확인할 순서와 문의로 넘길 기준을 설명한다. 특정 PC에서 문제가 재현되었거나 해결되었다는 기록이 아니다. 사용자가 말한 증상만으로 원인, 이용권 상태, 공급자 잔액, 서버 장애를 확정하지 않는다.

## KB-FIX-001 · 상담을 시작할 때

한 번에 다음 정보 중 필요한 것만 확인한다.

- 운영체제와 셀비 버전: **설정 → 앱 정보**에서 확인.
- 실패한 화면과 누른 버튼: 예를 들어 `대본·음성 → 대본 생성`인지 `렌더링 → 영상 렌더링`인지 구분.
- 화면에 표시된 오류 문구: 키·토큰·계정 정보·파일 경로는 가리고 전달.
- 언제부터 발생했는지, 모든 프로젝트인지 특정 프로젝트인지, 한 번인지 반복인지.
- **설정 → 환경 검사** 결과 중 조치 필요 항목.

API 키, 쿠팡 Secret Key, 서비스 계정 JSON 원문, UUP 토큰, 비밀번호, 로그인 인증 코드, 개인 영상·음성·전체 프로젝트를 채팅에 요청하지 않는다. 처음부터 로그 전체를 붙여 넣게 하지 않는다. 보안 프로그램 전체 끄기, 프로젝트 폴더 삭제, 저장소 초기화, 기존 완성본 덮어쓰기를 일반적인 해결책으로 제시하지 않는다.

## KB-FIX-002 · 앱이 실행되지 않거나 설치가 안 됨

**증상**: 압축 파일을 받았지만 실행되지 않거나 빈 창·런타임 안내가 나온다.

**확인 질문**: Windows x64인지 macOS Apple Silicon인지, 압축을 풀었는지, 화면 문구가 실행 차단인지 WebView2 설치 실패인지 확인한다.

**안전한 단계**:

1. [selvi.kr](https://selvi.kr) 또는 [공식 공개 릴리스](https://selvi.kr/download)에서 운영체제에 맞는 파일을 받았는지 확인한다.
2. 압축을 완전히 풀고 추출한 앱을 실행한다. ZIP 내부에서 실행하지 않는다.
3. Windows WebView2 설치 안내가 나오면 설치 진행과 네트워크 상태를 확인한다. 셀비는 필요한 런타임의 자동 설치 경로를 제공하지만 조직 정책이나 네트워크 제한으로 실패할 수 있다.
4. 보안 차단 문구가 있으면 아래의 보안 차단 절차로 분리한다.

**중단·문의 조건**: 공식 파일인데도 시작 직후 종료되거나 런타임 설치가 반복 실패하면 OS·앱 버전과 오류 문구를 정리해 문의한다. 지원하지 않는 CPU·OS에서 정상 실행을 보장하지 않는다.

## KB-FIX-003 · Google 로그인 완료 후 앱이 열리지 않음

**증상**: 브라우저 로그인 뒤 앱으로 돌아오지 않거나 로그인 시간이 초과된다.

**확인 질문**: 브라우저 인증을 끝냈는지, 앱에서 시작한 로그인인지, 계정 선택 뒤 기기 확인 화면이 남아 있는지, 네트워크 연결이 가능한지 확인한다.

**안전한 단계**:

1. 앱과 브라우저에 남아 있는 안내를 확인한다. 기기 승인 화면이 있으면 본인이 시작한 요청인지 확인하고 완료한다.
2. 앱으로 돌아와 결과를 기다린다. 이미 시간이 초과되었다면 앱에서 로그인을 새로 시작한다.
3. selvi.kr에서 사용하는 것과 같은 Google 계정을 선택한다.
4. 회사·학교 네트워크에서만 실패하면 담당자에게 셀비 로그인 통신이 허용되는지 확인한다.

**중단·문의 조건**: 새 로그인에서도 동일 오류가 반복되거나 본인이 시작하지 않은 승인 요청이면 진행을 멈춘다. 인증 코드나 토큰을 상담자에게 보내도록 안내하지 않는다.

## KB-FIX-004 · 사용 기간이 없거나 로그인 화면으로 돌아감

**증상**: `사용 기간 없음`, `만료`, `차단`, 다른 기기 사용 안내 또는 연결 확인 안내가 표시된다.

**확인 질문**: 정확한 문구, 최근 다른 컴퓨터 로그인 여부, 같은 Google 계정 사용 여부, 현재 인터넷 연결을 확인한다.

**안전한 단계**:

1. 사용 기간 안내라면 **다시 확인**을 누르고 **selvi.kr 마이페이지 열기**에서 실제 상태를 확인한다.
2. 다른 컴퓨터 로그인으로 세션이 교체되었다면 사용할 컴퓨터에서 다시 로그인한다. 같은 계정의 데스크톱 세션은 새 로그인에 의해 교체된다.
3. 연결 확인 문제라면 인터넷을 복구한 뒤 상태를 다시 확인한다. 장기 오프라인 이용을 지원한다고 안내하지 않는다.
4. 기간 만료·권한 회수·차단이라면 로그인 반복으로 해결하려 하지 말고 이용 권한 문의로 연결한다.

**중단·문의 조건**: 마이페이지와 앱의 표시가 다르거나, 사용자가 다른 기기 로그인을 하지 않았는데 교체가 반복되거나, 차단·회수 안내가 계속되면 계정 지원이 필요하다. AI 상담은 사용 기간을 임의로 연장하거나 차단을 해제했다고 답하지 않는다.

## KB-FIX-005 · API 키를 저장했는데 계속 등록하라고 함

**증상**: 앱 재시작 뒤 키가 없어 보이거나 저장된 키를 읽을 수 없다는 안내가 나온다.

**확인 질문**: 어떤 공급자인지, 카드의 상태가 `미등록`인지 `등록됨`인지, 저장 시 `이번 실행만`을 골랐는지 확인한다.

**안전한 단계**:

1. **설정 → API 키 → 해당 공급자 카드**의 상태를 본다. 원문 입력칸은 저장 후 비어 보일 수 있다.
2. `이번 실행만`이었다면 다시 등록하거나 기기 보관 옵션을 선택해 저장한다.
3. 키 읽기 실패면 해당 카드에 새 값을 직접 입력해 교체한다. Vertex는 **JSON 파일 선택**으로 올바른 서비스 계정 파일을 다시 선택한다.
4. Gemini·Vertex·Fish Audio는 **연결 테스트**를 수행한다. YouTube·쿠팡은 이 버튼이 없으며 실제 조회 기능에서 확인한다.

**중단·문의 조건**: 저장소 접근 실패가 반복되면 OS 보안 저장소·권한 문제를 점검해야 한다. 공급자 키를 채팅에 붙여 넣어 검증하려 하지 않는다.

## KB-FIX-006 · Gemini·Vertex 연결 또는 AI 요청이 실패함

**증상**: 키 오류, 권한 없음, 모델 없음, 리전 오류, 할당량, 요청 제한, 서버 오류 등이 표시된다.

**확인 질문**: Gemini API Key인지 Google Vertex Key인지, 공용 모드에서 실제 선택한 쪽, 모델 이름, 오류 문구를 확인한다.

**안전한 단계**:

1. **설정 → API 키**에서 등록 상태와 선택 자격 증명을 확인한다. 두 키를 등록한 경우 **메인 자격 증명**도 확인한다.
2. 인증 오류면 해당 공급자 콘솔에서 키가 유효한지 직접 확인하고 필요할 때 교체한다.
3. Vertex이면 서비스 계정 프로젝트의 권한·API 사용 설정·결제 상태와 선택한 리전을 확인한다. 이를 셀비 이용권 문제로 단정하지 않는다.
4. 모델 관련 오류면 **Gemini 모델 → 모델 목록 새로고침** 후 사용 가능한 모델을 선택하고 **모델 저장**을 누른다. 이미지·영상·음성 모델은 해당 기능의 모델 선택도 따로 확인한다.
5. 할당량·요청 제한 안내면 공급자 콘솔의 실제 한도와 재시도 안내를 확인한다. 짧은 간격으로 계속 생성하지 않는다.
6. 네트워크나 일시적인 서버 오류면 연결을 확인하고 잠시 뒤 한 번 다시 시도한다.

**중단·문의 조건**: 연결 테스트는 성공하지만 특정 기능만 계속 실패하거나 올바른 권한을 확인해도 동일 오류이면 공급자·모델·작업 단계와 가린 오류 문구를 전달한다. 상담 AI가 계정 잔액을 조회하지 않았다면 “충전하면 해결된다” 또는 “무료 한도가 끝났다”고 확정하지 않는다. 키를 바꾸면 모든 제한을 우회할 수 있다고 안내하지 않는다.

## KB-FIX-007 · FFmpeg 또는 영상 처리 도구를 확인하라고 함

**증상**: 렌더링·영상 준비가 막히고 FFmpeg·ffprobe 없음, 검사 실패, 설치 중 또는 실행 차단 안내가 나온다.

**확인 질문**: **설정 → 환경 검사**에서 어느 항목이 조치 필요인지, 자동 설치 중인지, 실패 문구가 다운로드·검증·실행 단계 중 어디인지 확인한다.

**안전한 단계**:

1. **설정 → 환경 검사 → 다시 검사**를 누른다.
2. Windows x64·macOS Apple Silicon에서는 자동 설치가 시작되면 완료를 기다린다. 다운로드·검증 중에 반복 클릭하지 않는다.
3. 실패 뒤 **FFmpeg 다시 받기**가 표시되면 네트워크 상태를 확인하고 한 번 재시도한다.
4. 검사 시간 초과라면 보안 제품 검사가 진행 중인지 확인한 뒤 다시 검사한다.
5. 조직의 애플리케이션 제어 차단이라면 담당자에게 실행 허용 여부를 문의한다. 같은 파일을 계속 내려받는 것으로 정책 차단을 해결할 수는 없다.

**중단·문의 조건**: 무결성 검증 실패, 반복되는 실행 차단, 동일 설치 오류가 남으면 환경 검사 문구와 OS·버전을 전달한다. 출처 불명의 FFmpeg 파일을 받게 하지 않는다. 보안 프로그램 전체를 끄도록 안내하지 않는다.

## KB-FIX-008 · 영상 파일을 가져올 수 없음

**증상**: 3분 이상, 지원 형식 아님, 파일 없음, 읽기 실패 안내가 나온다.

**확인 질문**: 영상 길이, 가져오는 방식(파일 또는 다운로드), 오류 문구, 외장·네트워크 드라이브 연결 상태를 확인한다.

**안전한 단계**:

1. 소스는 **파일당 3분 미만**이어야 한다. 정확히 3분인 영상도 거절한다. 가져온 뒤 트림해서 제한을 피하는 방식은 지원하지 않는다.
2. 로컬 파일 가져오기에서 형식 안내가 나오면 H.264 비디오와 AAC 오디오를 포함하는 MP4인지 확인한다. 확장자만 `.mp4`로 바꾸는 것으로 코덱이 바뀌지는 않는다.
3. 원본 파일이 이동·삭제되었거나 드라이브가 분리되지 않았는지 확인한다.
4. 변환이 필요하면 원본을 유지하고 별도 사본을 만든 뒤 다시 가져온다. 다운로드 경로에서 앱이 변환하는 동작과 로컬 파일 가져오기의 형식 검사를 구분한다.

**중단·문의 조건**: 지원 길이·형식인 다른 파일은 되는데 특정 파일만 계속 실패하면 파일명·내용을 보내지 않고도 길이·해상도·코덱과 오류 문구로 먼저 상담한다. 개인정보가 포함된 원본 영상을 채팅에 올리도록 요청하지 않는다.

## KB-FIX-009 · REDnote 다운로드가 멈추거나 실패함

**증상**: 주소 처리 실패, 영상 없음, 다운로드 시간 초과, 로그인·CAPTCHA 요구, 다운로드 후 변환 대기.

**확인 질문**: 정상적인 개별 영상 공유 주소인지, 브라우저에서 영상이 보이는지, 앱의 현재 진행 문구가 다운로드인지 변환·검사인지 확인한다.

**안전한 단계**:

1. 개별 게시물의 공유 주소를 다시 확인한다.
2. 진행 문구가 변환·검사 단계이면 단순히 바이트 수가 늘지 않는다는 이유만으로 멈췄다고 판단하지 않는다.
3. 오류가 확정된 경우 취소 후 정상 브라우저에서 사용 권한이 있는 파일을 직접 저장할 수 있는지 확인하고 파일 가져오기를 사용한다.
4. 가져오는 파일에도 길이·형식 제한이 적용된다.

**중단·문의 조건**: 로그인·CAPTCHA가 필요하거나 플랫폼이 접근을 제한하면 우회 절차를 제공하지 않는다. 쿠키 추출, 계정 자격 증명 공유, 일괄 수집으로 해결하려 하지 않는다. 자세한 흐름은 [찾기와 소스](02-discovery-and-sources.md)를 따른다.

## KB-FIX-010 · 영상·음성 미리보기가 재생되지 않음

**증상**: `MEDIA_ELEMENT_ERROR`, `Format error`, 검은 화면, 음성 없음, 대표 프레임 표시 실패.

**확인 질문**: 원본 영상인지 생성 음성인지 완성본인지, 모든 프로젝트인지 특정 항목인지, 생성·변경 직후인지, 환경 검사 결과를 확인한다.

**안전한 단계**:

1. 현재 생성·변환·저장 작업이 끝났는지 먼저 확인한다.
2. **설정 → 환경 검사**에서 미리보기 서버·영상 처리 도구·저장소를 확인한다.
3. 해당 파일이 이동·삭제되지 않았는지 확인하고 화면을 다시 열어 한 번 재생한다.
4. 완성본 문제이면 **렌더링 → 저장 위치·완성본 → 기본 플레이어**로 열어 앱 미리보기 문제와 파일 문제를 구분한다.
5. 편집 이후 `기존 렌더 · 업데이트 필요`가 표시되면 현재 편집 내용을 반영하려면 다시 렌더링한다.

**중단·문의 조건**: 기본 플레이어에서도 실패하거나 재생 오류가 반복되면 파일을 지우거나 캐시 폴더를 임의로 정리하지 말고 재생 대상·실패 시점·오류 문구를 전달한다. 형식 오류라는 말만으로 영상이 손상되었다고 확정하지 않는다.

## KB-FIX-011 · 대본 생성이 실패하거나 내용이 맞지 않음

**증상**: 대본 생성 실패, 상품과 다른 설명, 원본 텍스트 추출 오류, 기대한 장면과 다른 구성.

**확인 질문**: 실패 알림인지 생성 결과의 품질 문제인지, 영상 준비와 상품명이 채워졌는지, 원본에 읽을 글자·들을 말소리가 있는지 확인한다.

**안전한 단계**:

1. 실패 알림이면 먼저 Gemini·Vertex 자격 증명·모델·네트워크 분기를 따른다.
2. 생성 결과의 품질 문제이면 **대본·음성**에서 상품명·작성 방향·장면 선택을 확인하고 필요한 내용을 구체적으로 수정한다.
3. 원본의 글자나 말소리 추출은 인식 결과를 직접 검토한다. 원본에 없는 정보가 자동으로 정확하게 생긴다고 기대하지 않는다.
4. 수익·효능·가격 등 사실 주장은 사용자가 검토하고 대본을 고친다.
5. 대본을 바꾼 뒤에는 해당 편집 내용에 맞는 음성을 다시 생성하고 완성본도 다시 확인한다.

**중단·문의 조건**: 간단한 요청에서도 같은 생성 오류가 반복되면 공급자·모델과 가린 오류 문구를 전달한다. 유료 요청이 될 수 있으므로 아무 설명 없이 반복 생성하게 하지 않는다. 자세한 옵션은 [대본과 음성](03-script-and-audio.md)을 따른다.

## KB-FIX-012 · TTS 음성이 생성되지 않거나 대본과 다름

**증상**: 합성 실패, 목소리 목록 불러오기 실패, 예전 음성 재생, 문장이 잘림, 너무 긴 음성.

**확인 질문**: Gemini TTS인지 Fish Audio인지, 목소리·모델 선택 여부, 마지막 대본 수정 뒤 다시 합성했는지, 모든 문장인지 특정 문장인지 확인한다.

**안전한 단계**:

1. **설정 → API 키**에서 실제 TTS 엔진이 사용하는 자격 증명을 확인한다.
2. **설정 → 대본과 음성** 또는 프로젝트 **대본·음성**에서 엔진·목소리를 확인한다. Fish는 사용할 수 있는 목소리 ID인지 확인한다.
3. 목록 조회 실패와 합성 실패를 구분한다. Gemini 목소리 목록 오류면 화면의 **목소리 목록 다시 불러오기**, Fish는 **목소리 목록 새로고침**을 사용한다.
4. 대본 수정 후 음성이 예전 내용이라면 새 대본으로 다시 생성하고 생성 완료 후 재생한다.
5. 길이 초과 안내가 나오면 대본을 줄이고 다시 합성한다. 현재 완성본 상한은 45초이며 실제 음성 길이·후킹·편집 구간을 함께 확인한다.

**중단·문의 조건**: 같은 짧은 문장도 계속 실패하거나 생성 성공 뒤 반복해서 잘못된 음성이 재생되면 엔진·모델·목소리 이름과 오류 문구로 문의한다. 계정의 잔액이나 유료 플랜 여부는 공급자 화면에서 확인해야 한다.

## KB-FIX-013 · 렌더링이 시작되지 않거나 실패함

**증상**: 렌더 전 확인 항목이 남아 있거나 영상 렌더링 실패, 쓰기 권한·디스크 부족, 완성본 길이 초과가 표시된다.

**확인 질문**: 시작 전 조건 미충족인지 진행 중 실패인지, **렌더 전 확인**의 어느 항목이 남았는지, 출력 폴더와 여유 공간을 확인한다.

**안전한 단계**:

1. 프로젝트 **렌더링 → 렌더 전 확인**의 실제 안내부터 해결한다.
2. 영상 처리 도구 안내면 **설정 → 환경 검사**를 수행한다.
3. 출력 폴더가 존재하고 쓰기 가능한지 확인한다. 외장 드라이브 연결과 여유 공간도 확인한다.
4. 길이 문제면 대본·생성 음성·트림 구간을 확인한다. 완성본 최대 45초를 넘지 않도록 편집하고 다시 합성·렌더링한다.
5. 실패 원인을 정리한 뒤 **다시 렌더링**을 한 번 실행한다. 완료 후 `검증된 완성본`인지 확인하고 재생한다.

**중단·문의 조건**: 같은 설정에서 실패가 반복되면 **렌더링 → 저장 위치·완성본 → 진단 내보내기**가 표시되는 경우 로컬 진단을 내보낼 수 있다. 상담 채팅에는 먼저 오류 문구만 전달하고, 전체 진단 파일 전송은 지원 담당자의 범위 안내와 민감정보 확인을 거친다. 렌더 완료 파일이 생겼다는 사실만으로 출력 검증까지 통과했다고 답하지 않는다.

## KB-FIX-014 · UUP 연결 또는 전달이 실패함

**증상**: 토큰 미등록·만료, 계정 목록 없음, 전달 실패, 진행 상태를 알 수 없음.

**확인 질문**: 연결 단계인지 자산 전달 단계인지, 전달 기록이 이미 생겼는지, 선택한 게시 계정·작업 방식, 오류 문구를 확인한다.

**안전한 단계**:

1. **설정 → UUP 전달**에서 토큰 연결 상태를 확인한다. 토큰 값은 채팅으로 보내지 않는다.
2. 만료·권한 안내라면 UUP에서 현재 연결 상태를 확인하고 화면 안내에 따라 다시 연결한다.
3. 검증된 최신 렌더가 필요한 안내라면 편집 변경을 반영해 다시 렌더링한다.
4. 이미 전달 기록이 생겼다면 해당 기록의 상태를 새로 확인하고 UUP 화면도 확인한다. 성공 여부를 모른 채 새 전달을 반복하지 않는다.
5. 전달 완료 뒤 게시·예약의 실제 결과는 UUP의 상태를 확인한다.

**중단·문의 조건**: 연결은 되지만 특정 계정·작업만 실패하거나 전달 결과가 불명확하면 기록 시각·상태·가린 오류 문구로 문의한다. `UUP 전달 완료`를 `SNS 게시 완료`로 바꾸어 답하지 않는다. 세부 정책과 화면은 [게시 준비와 UUP](06-publishing-and-uup.md)를 따른다.

## KB-FIX-015 · 프로젝트가 사라졌거나 저장 폴더 오류가 남

**증상**: 프로젝트 목록이 비어 있거나 저장 폴더를 찾을 수 없음, 제거한 프로젝트가 필요함.

**확인 질문**: 최근 저장 폴더를 바꿨는지, 외장 드라이브가 연결되어 있는지, 프로젝트 제거 또는 복구 보관함 비우기를 실행했는지 확인한다.

**안전한 단계**:

1. **설정 → 화면과 저장 → 저장소**에서 현재 폴더를 확인한다.
2. 기존 폴더가 다른 위치·드라이브에 남아 있는지 확인하고 올바른 저장 폴더를 선택한다.
3. 제거한 프로젝트라면 `셀비/복구 보관함`에 남아 있는지 확인한다. 앱이 아닌 OS의 일반 휴지통과는 다른 폴더다.
4. 복구 절차는 [설정과 데이터 보관](07-settings-account-and-data.md#5-저장소와-프로젝트-제거복구)을 따른다. 중복 폴더가 있으면 덮어쓰지 않는다.

**중단·문의 조건**: 영구 삭제했거나 드라이브 자체가 읽히지 않으면 셀비에서 복구를 보장할 수 없다. 빈 저장소 생성·재설치·기존 폴더 정리를 먼저 권하지 않는다.

## KB-FIX-016 · 업데이트가 대기하거나 실패함

**증상**: 새 버전 파일은 준비되었으나 재시작하지 않음, 네트워크 실패, 보안 차단, 재시작 실패.

**확인 질문**: **설정 → 앱 정보 → 앱 업데이트**의 상태와 대기 이유, 작업·다운로드 진행 여부, 미저장 설정·편집 여부를 확인한다.

**안전한 단계**:

1. 대기 중이면 진행 중인 작업을 완료하고 편집·설정 저장을 마친다. 앱이 보여 주는 대기 이유를 해결한다.
2. 파일 준비가 완료되면 **저장 후 재시작**을 사용할 수 있다.
3. 다운로드 네트워크 오류이면 연결을 확인한 뒤 **업데이트 확인**을 한 번 누른다.
4. 재시작 뒤 **설정 → 앱 정보**에서 실제 버전을 확인한다. 다운로드 완료만으로 설치 완료라 하지 않는다.
5. Windows 보안 차단이면 다음 절차로 분리한다.

**중단·문의 조건**: 서명·무결성 검증 오류, 반복되는 시작 실패, 버전 불일치가 남으면 오류 문구와 현재·대상 버전을 전달한다. 프로젝트 폴더를 지우거나 기존 앱 파일을 임의로 덮어쓰는 방법을 먼저 안내하지 않는다.

### Windows 보안 차단

**확인 질문**: 보호 기록에 표시된 정확한 파일·탐지 항목이 이번 셀비 업데이트와 일치하는지, 개인 PC인지 조직 관리 PC인지 확인한다.

**안전한 단계**: **앱 정보 → 보호 기록 열기**가 표시되면 해당 기록을 확인한다. Windows에서는 **Windows 보안 → 바이러스 및 위협 방지 → 보호 기록**에서도 볼 수 있다. 공식 셀비 다운로드인지와 해당 항목을 확인한 뒤 개별 항목 처리 여부를 판단한다. 조직 관리 PC의 허용은 담당자에게 요청한다. 조치가 끝났다면 앱의 **업데이트 확인**으로 다시 확인한다.

**중단·문의 조건**: 탐지 원인이 불명확하거나 파일 출처가 다르거나 조직 정책 차단이면 허용을 강요하지 말고 지원에 문의한다. “무조건 오탐이다”라고 보장하거나 보안 프로그램 전체를 끄고 폴더 전체를 제외하도록 안내하지 않는다.

## KB-FIX-017 · 자동 오류 보고와 실제 해결을 구분

**설정 → 앱 정보 → 오류 자동 보고**를 켜면 정제한 오류를 개발자 전용 목록으로 전송할 수 있다. 전송 성공은 항상 보장되지 않으며, 켜짐 표시만으로 접수 여부를 확정할 수 없다. 수집 범위와 끄는 방법은 [설정과 데이터 보관](07-settings-account-and-data.md#7-오류-자동-보고)을 따른다.

AI 상담은 확인한 범위 안에서 다음처럼 답한다.

- “이 문구는 저장 폴더를 읽지 못했다는 안내입니다. 설정 → 화면과 저장에서 기존 폴더와 드라이브 연결을 먼저 확인해 주세요.”
- “연결 테스트가 성공해도 선택한 영상 생성 모델의 권한까지 확인된 것은 아닙니다. 사용 중인 모델 이름과 비밀을 가린 오류 문구를 확인하겠습니다.”
- “새 버전에서 관련 변경이 있었더라도 현재 PC에서 해결된지는 재시도 결과가 필요합니다.”

접수 기록·실제 변경 내역·사용자 재시도 결과를 확인하지 않고 “버그를 수정했습니다”, “배포했습니다”, “오류를 완료 처리했습니다”라고 답하지 않는다.

## 구현 근거

증상 분류는 다음 구현·화면 문구에 근거한다. 원인별 절차는 안전한 확인 안내이며 모든 원인의 재현·해결을 의미하지 않는다.

- `frontend/src/main.ts` — `renderSettings`, `renderEnvironmentPane`, `credentialStatus`, `credentialCard`, `renderAppUpdate`, `errorReportingCard`, `renderGeminiVoiceField`; 영상 준비·대본·음성·렌더링 화면과 `delete-project`, `empty-trash` 액션.
- `frontend/src/state.ts` — `updateFailureGuidance`, `updatedAfterRestartNotice`.
- `app_auth.go` — `StartGoogleLogin`, `SignOut`, `GetAuthSession`, `startAccountRecheck`; `internal/auth/service.go` — `Refresh`, `snapshotLocked`, `clearSessionLocked`; `internal/auth/session.go` — `offlineGrace`.
- `selvi.web` 저장소의 `api/internal/auth/session.go` — `replaceDesktopSessions`.
- `app.go` — `SaveCredential`, `credential`, `TestProvider`, `DeleteProject`; 로컬 MP4 코덱 검증.
- `app_mediatools.go` — `mediaAutoInstallSupported`, `InstallMediaTools`, `mediaFixHint`; `app_update.go` — `securityBlockNotice`, 업데이트 진행·재시작 처리.
- `internal/project/store.go` — `Delete`, `EmptyTrash`; `internal/project/layout.go` — `TrashDir`.
- `app_uup.go` — `ConnectUUP`, `GetUUPConnection`, `PrepareUUPHandoff`, `SendUUPHandoff`, `RefreshUUPHandoff`.
- `app_errreport.go` — `newErrorReporting`, `errorReportAccount`; `internal/errreport/errreport.go` — `Report`.