자세한 설정
처음이라면 쉬운 시작 안내만 따라 하세요.
> v1.2.0: 먼저 `START-PLATFORM.html`에서 macOS 또는 Windows(WSL2) 안내를 확인하세요.
# 유튜브 쇼츠 패키지 — 무인 쇼츠 공장
## 처음 시작: 5단계 온보딩
압축을 푼 뒤 **START-HERE.html**을 열어 환경 점검 → 설정 준비 → 오프라인 연습 → 실제 결과 검토 → 운영 체크리스트 순서로 진행하세요. `python3 onboarding.py status`로 터미널 진행 기록도 확인할 수 있습니다. 계정·구독·추가 비용은 [사용 가이드](docs/START-HERE.ko.md)에 정리했습니다.
```bash
python3 onboarding.py check
python3 onboarding.py init
python3 onboarding.py sample
python3 onboarding.py check --production
```
연습 결과는 모델이 생성한 운영 결과가 아닙니다. 실제 게시·발송·스케줄러는 자동으로 켜지지 않습니다.
한 사람이 맥 한 대로 매일 메인 채널 6편 + 서브 채널 2편을 사람 손 없이 올리는 실제 파이프라인을 그대로 묶었습니다. 감독 스크립트, 슬롯 계획, 소재 수집, 대본 엔진 체인, 코드로 강제하는 게이트, TTS·이미지·렌더, QA, 로그인된 브라우저로 스튜디오 예약 업로드, 원장, 성과→피드백→디자인 루프, 회고, 주간 트렌드 리뷰. 브랜드·계정 정보는 전혀 없고, 채널만 꽂으면 됩니다.
```
cron ─▶ 감독(가드+락+데드라인) ─▶ 다음 슬롯 ─▶ 형식 선택 ─▶ 벤치/레이더 ─▶ 컨텍스트(로컬 1회)
─▶ script.json (codex→claude→gemini→local) ─▶ 게이트(코드) ─▶ TTS→이미지→렌더 ─▶ QA ─▶ 스튜디오 예약 ─▶ 원장
◀─ 03:05/14:30 스튜디오 CSV ─▶ feedback ─▶ 디자인 50:50→75:25 ─▶ 23:20 회고 ─▶ 23:35 보고 ─▶ 월 04:00 트렌드
```
## 언제 뭐가 도나
| 시각 | 잡 | 결과 |
|---|---|---|
| 05:00 09:30 12:00 15:00 16:30 18:00 | 메인 채널 슬롯 | 07:00/11:30/14:00/17:00/18:30/20:00 공개 예약 1편씩 |
| 10:30 19:00 | 서브 채널 | 12:30 / 21:00 |
| 10분마다 | health | Ollama 죽으면 재시작 |
| 매시 :10 | recovery | 대본 단계 실패만 하루 1회 재시도 |
| 03:05 14:30 | performance | 스튜디오 CSV → 통계 → 피드백 → 디자인/포트폴리오 |
| 23:20 / 23:35 | 회고 / 보고 | 평소엔 결정적, 실패한 날만 클라우드 판단 |
| 월 04:00 | weekly | 벤치 + 트렌드 리뷰(로컬만) + 루프 |
## 사람이 할 일
`docs/HUMAN-STEPS.md`. 브라우저 프로필 로그인, 엔진 CLI 로그인, `.env`, 로컬 모델이 쓴 대본 검수, 그리고 주 1회 딱 하나의 결정(캡·슬롯·검색어·디자인). 업로드 양은 코드가 절대 바꾸지 않습니다.
## 하지 않는 것
- YouTube Data API 업로드(감사 전 프로젝트는 비공개로 잠김 → 브라우저 프로필의 스튜디오 UI 사용)
- 로컬 모델이 쓴 대본을 사람 확인 없이 올리기
- 근거 규칙 없이 디자인 트래픽 옮기기, 조회수 좋다고 `daily_cap` 올리기
- 제공자 쿨다운 초기화, 로그인 대행, "잡이 건강하다"는 약속 (영수증·로그·QA 결과만 보여줌)
## 구성
`bin/` 감독·단계 실행기·게이트·제작·업로드·성과·회고·트렌드·원장 + 공용 라우터/가드/로컬 에이전트 · `prompts/` 5종 · `config/` 5종 예시 · `jobs/` dagu 8개 + launchd · `skills/` 4개 · `docs/PIPELINE.md`(운영 방법 전체) · `docs/HUMAN-STEPS.md`.
동반 상품: Automation Kit(훅·MCP·스케줄러), Prompt Dex Skills(콘텐츠 프롬프트). 이 팩은 생산 라인, 그 둘은 공구함과 작가실입니다.