# 셀비 AI 상담 학습 자료와 기능 안내

> 기준일: 2026-09-19
> 대상: 셀비 회원, AI 상담 구축 담당자, selvi.web 안내 편집자
> 기준: 앱 v0.1.150 소스와 같은 날 웹 구현. 운영 계정 상태·공급자 가격·최신 배포 여부는 별도 확인한다.

이 자료는 셀비가 **무엇을 하는지, 어디에서 어떻게 쓰는지, 어떤 제한이 있는지, 문제가 생기면 무엇을 확인하는지**를 설명한다. AI 채팅의 지식 검색 자료로 사용하거나 회원 안내를 작성할 때 참고할 수 있다. 문서를 올리는 것만으로 AI 모델이 영구 학습되거나 상담 서비스가 자동으로 연결되지는 않는다.

## 빠르게 사용하기

- 처음 쓰는 회원: [제품 소개와 첫 프로젝트](01-product-and-start.md)를 읽고 필요한 단계의 문서를 연다.
- AI 상담 구축: [AI 답변 규칙](10-ai-answer-policy.md)을 지침으로 설정하고, 01~09 문서를 지식 자료로 등록한다.
- 파일 하나로 등록: [통합 학습 자료](SELVI_AI_KNOWLEDGE.md)를 사용한다. 개별 파일과 통합 파일을 동시에 등록하면 같은 내용이 중복 검색될 수 있다.
- 웹 안내 수정: 이 자료의 해당 절을 먼저 수정하고 selvi.web 안내 문구와 공개 Markdown 사본을 함께 맞춘다.
- 문제가 생긴 회원: [증상별 문제 해결](08-troubleshooting.md)에서 증상을 고른다.

## 문서 목록

1. [제품 소개·설치·첫 프로젝트](01-product-and-start.md): 셀비·웹·UUP 역할, 환경 검사, 로그인, 화면 구조, 시작 경로, 저장.
2. [아이템 찾기·보관함·원본 영상](02-discovery-and-sources.md): 인스타 릴스, 유튜브 쇼츠, REDnote, 인기 검색어, 제품 분석, 5개·180초 제한.
3. [대본·음성·JSON](03-script-and-audio.md): 썰형 계열 7종, 언어·길이, 후킹·CTA, 장면 배치, Fish/Gemini TTS, 내 음성 파일, JSON 교환.
4. [비디오 편집·디자인·자막 지우기](04-video-and-design.md): 영상별 지우기 영역, 타임라인, 레이어, GIF, AI 이미지·영상, 스킨, 배경음악, 제목·자막.
5. [렌더링·썸네일·캐러셀](05-render-thumbnail-and-carousel.md): 검증된 MP4, SRT, 썸네일 앞장·커버, 카드뉴스와 이미지 ZIP.
6. [배포 준비·UUP 전달](06-publishing-and-uup.md): 토큰 연결, 다중 계정 전달, 초안·게시·예약 요청, 채널 조건, 상품 카드, 댓글 자동화, 전달·게시 상태.
7. [설정·계정·데이터](07-settings-account-and-data.md): 개인 자격 증명, 공용 선택의 의미, 보관·삭제, 이용 기간, 기기 변경, 전송·오류 보고·업데이트.
8. [증상별 문제 해결](08-troubleshooting.md): 확인 질문, 안전한 조치 순서, 재시도와 문의 기준.
9. [상담용 질문과 답변](09-faq.md): 짧게 답할 수 있는 대표 질문과 상세 자료 연결.
10. [AI 답변 규칙과 점검 질문](10-ai-answer-policy.md): 복사할 지침, 검색·답변 방식, 답변 금지 주장, 운영 연결 전 점검.

## 영상 한 편의 순서

1. **영상 준비**: 사용할 원본을 담고 구간과 원본 자막 지우기를 확인한다.
2. **대본·음성**: 대본을 작성하고 AI 또는 내 음성 파일을 연결한다.
3. **비디오**: 장면·레이어·스킨·배경음악·브랜드/광고를 조절한다.
4. **썸네일**: 필요한 경우 대표 이미지를 만든다.
5. **렌더링**: 제목·자막과 미리보기를 확인하고 완성본을 만든다.
6. **배포 준비·UUP 전달**: 게시 내용·계정·방식을 확인하고 UUP에 요청한다.

기본 구성으로 진행할 때 비디오와 썸네일 단계의 별도 편집은 생략할 수 있다. 로컬 완성본만 필요하면 렌더링에서 마쳐도 된다. 캐러셀은 이 여섯 단계와 별도의 메뉴다.

## 답변에서 지켜야 할 핵심 사실

- 새 원본은 프로젝트당 최대 5개, 각각 **180초 미만**이다. 정확히 3분도 거절하며 가져오기 전 길이가 기준이다.
- 현재 대본 모드는 썰형·고백형·타인반응형·반전형·질문훅형·비교형·시간압축형이다.
- `공용`은 등록한 Gemini API Key와 Google Vertex Key를 작업별로 선택하는 뜻이다. 무료 공용 키나 무제한 이용권이 아니다.
- 키 보관 방식은 종류와 운영체제에 따라 다르다. 쿠팡 키도 현재 기기의 보안 저장소에 보관하는 선택을 지원한다.
- 셀비에서 초안·즉시·예약 방식을 요청할 수 있다. 실제 SNS 업로드·게시와 댓글 자동화는 UUP가 수행한다.
- UUP 접수와 SNS 게시 성공을 구분한다. 오류 보고 전송과 문제 해결도 구분한다.
- 로컬 저장 제품이지만 로그인 확인·검색·AI·UUP·선택한 오류 보고에는 통신이 발생한다.
- 영상 사용 권리, 파트너스 승인, 수익·조회수, 공급자의 가격과 한도를 보장하지 않는다.

## 자료의 한계와 갱신

기능 설명은 기준일의 코드와 화면 문구를 확인한 결과다. 특정 회원의 계정 상태, 현재 외부 서비스 장애, 최신 결제 조건이나 개별 파일의 처리 성공은 이 문서에서 알 수 없다. 상담은 사용자가 보고 있는 버전·단계·오류 문구를 확인하고 설명한다. 메뉴가 다르면 업데이트 내역과 최신 도움말을 함께 확인한다.

공식 안내: [사용 가이드](https://selvi.kr/guide/studio), [자료실](https://selvi.kr/guide/knowledge), [업데이트 내역](https://selvi.kr/updates), [1:1 문의](https://selvi.kr/ask).

## 구현 근거

각 기능 문서 끝의 구현 근거는 유지보수 담당자가 사실을 재확인하는 위치다. 파일 이름은 프로그램 사용에 필요한 입력값이 아니다. 전체 동기화 절차와 내부 정정 기록은 비공개 저장소의 `MAINTENANCE.md`에서 관리한다.