consent-recorder: operators (ADMIN_DISCORD_IDS) create an app key on the site; the app calls GET/POST /api/guilds with it to turn servers on/off. Turned-off servers are left immediately. recordingNow() now checks the user picked that server, so someone who only chose server A is not shown as recorded while sitting in a B channel the bot records for others. voice-changer: new "녹음 서버" dialog (record_servers.py), network in a worker thread, key saved in config/record-servers.json; upgrade cleanup list knows the new file. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
녹음 동의 사이트 + 따라가며 녹음하는 봇
본인이 직접 사이트에서 디스코드로 로그인하고 녹음 동의를 누른 사람만, 디스코드 음성채널에 따라 들어가 그 사람 목소리만 녹음합니다. 녹음은 나중에 그 사람 목소리 모델(RVC 등)을 학습하는 데이터로 씁니다.
동작
- 사이트 (
src/site.ts): 디스코드 로그인(OAuth2identify권한만) → 동의 문구 + 체크 3개(계정 주인 · AI 음성 모델 용도 이해 · 만 14세 이상)를 모두 직접 체크해야 동의. 녹음할 서버도 같이 고른다 (봇과 내가 함께 들어가 있는 서버만 보이고, 하나 이상 골라야 동의). 동의한 뒤에도 사이트에서 언제든 바꿀 수 있고, 뺀 서버에서는 바로 녹음을 멈춘다. 내 상태(동의 여부 · 지금 녹음 중인 채널 · 녹음 개수/길이), 동의 철회(녹음 파일 같이 삭제 기본), 녹음 파일만 삭제, 로그아웃. - 봇 (
src/bot.ts): 동의한 사람이 녹음할 서버로 고른 서버의 음성채널에 들어가면 따라 들어가고, 옮기면 따라 옮기고, 동의자가 모두 나가면 나간다. 서버마다 음성 연결은 하나라서 한 서버에서 동의자가 여러 채널에 흩어져 있으면 지금 채널 유지 → 방금 움직인 사람 → 동의자가 많은 채널 순으로 고른다 (src/follow.ts). - 녹음 (
src/recorder.ts): 디스코드가 사람별로 따로 보내는 음성 스트림 중 동의한 사람 것만 구독한다. 동의 안 한 사람의 소리는 받지도 저장하지도 않는다. 말이 0.8초 끊길 때마다 파일 하나(최대 30초, 0.5초 미만 버림), Opus 그대로data/recordings/<아이디>/<날짜>/<id>.ogg. 말하는 도중 철회하면 쓰던 파일도 버린다. - 운영자 (
ADMIN_DISCORD_IDS): 사이트에서 앱 연결 키를 만들고, 음성 변환기 앱의 "녹음 서버" 화면에서 그 키로 봇이 녹음할 서버를 켜고 끈다 (GET/POST /api/guilds,Authorization: Bearer <키>, 키는 해시로만 저장, 새로 만들면 예전 키는 무효). 끈 서버에서는 바로 나간다..env의ALLOWED_GUILD_IDS밖의 서버는 앱에서도 켤 수 없다. - 알림: 봇이 채널에 들어가면 그 채널 채팅에 녹음 안내(누구 목소리만 녹음하는지 + 사이트 주소)를 남기고, 봇 상태를 "🔴 동의한 사람 녹음 중"으로 바꾼다.
- 동의 기록:
consent_log테이블에 동의 · 철회 · 삭제 · 내보내기를 시각과 문구 버전으로 남긴다. 동의 문구를 바꾸면src/consent-text.ts의CONSENT_VERSION을 올린다 → 예전 동의자는 다시 동의할 때까지 녹음하지 않는다. - 보안: OAuth state 는 로그인을 시작한 브라우저 쿠키와 맞춰 확인, 동의 제출은 화면의 문구 버전이 지금 버전과 같을 때만, 세션 · state 는 해시로만 저장, 디스코드 액세스 토큰은 저장하지 않음, 모든 form 에 CSRF 토큰 + Origin 확인, 클릭재킹 차단(
frame-ancestors 'none',X-Frame-Options: DENY), https 쿠키는__Host-+ Secure. - 디스코드 음성 종단간 암호화(DAVE)는
@discordjs/voice0.19 +@snazzah/davey로 지원.
준비 (디스코드 개발자 포털)
- https://discord.com/developers/applications 에서 앱 만들기
- Bot 탭: 토큰 발급 →
DISCORD_BOT_TOKEN. Privileged Intent 는 필요 없음 - OAuth2 탭: Client ID / Client Secret →
DISCORD_CLIENT_ID/DISCORD_CLIENT_SECRET, Redirects 에<PUBLIC_URL>/callback추가 - 봇 초대: OAuth2 URL Generator 에서 scope
bot, 권한View Channels·Connect·Send Messages(녹음 안내용)
실행
cd consent-recorder
npm install
cp .env.example .env # 값 채우기
npm run build
npm start # 사이트 http://HOST:PORT + 봇
사이트는 기본 127.0.0.1:8787 에 뜬다. 바깥에서는 리버스 프록시(NPMplus 등)로 https 도메인을 붙인다 (PUBLIC_URL 은 https 여야 함).
학습 데이터 꺼내기
npm run cli -- status # 동의자 · 녹음 양
npm run cli -- export <디스코드 아이디> ./dataset # 48kHz 모노 wav, -18 LUFS 평준화 + 리미터 (ffmpeg 필요)
export 는 지금 동의 중인 사람만 내보낸다 (철회했거나 문구가 바뀐 사람은 거절). 철회한 사람의 이미 학습된 모델은 이 프로그램 밖에 있으므로 운영자가 직접 지워야 한다.
테스트
npm test # 가짜 디스코드 OAuth 서버로 로그인(state 쿠키) → 동의(문구 버전) → 철회/삭제, CSRF · 클릭재킹, 채널 고르기 · 정원 찬 채널 유지, 동의자만 녹음 · 삭제 시 진행 중 녹음 폐기