Conflitos resolvidos juntando os dois lados: - db.py: v16 (detecção do jogo) e v17 (Equipe de IA) em sequência. - judge.py: a varredura exige os campos das duas frentes (screen_game_confidence/screen_evidence e lines). - proxy do painel: libera judge/report e sessions/id/game/detect. - skill: detecção do jogo vira a 1.55.0 (gotcha 180 → 186), acima da 1.54.0 das cinco frentes. Suíte do Clipador inteira passa; painel: tsc + 119 testes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
75 KiB
Clipador (clipper/) — cortes automáticos de live
Fonte completa: clipper/README.md. Ele cobre a arquitetura, as regras da heurística, o juiz, a API,
o .env e os limites. Este arquivo só diz onde mexer e o que não pode quebrar. Não copie o README para cá.
O que é
Serviço FastAPI local (Python 3.12, clipper/.venv) em 127.0.0.1:4520. Ele grava uma live (Twitch, YouTube
ou Kick) ou um VOD, lê o chat, transcreve pelo serviço de voz e pede o veredito a uma IA pela CLI. Depois
renderiza cortes verticais (1080×1920, padrão) ou horizontais (1920×1080, YouTube). Toda rota, exceto GET /health, exige X-Service-Key (CLIPPER_SERVICE_KEY de
clipper/.env; nunca copie a chave).
| O quê | Onde |
|---|---|
| Banco do Clipador | data/clipper/clipper.db (PRAGMA user_version 17, SCHEMA em clipper/app/db.py: v1 tabelas, v2 settings, v3 jogo/varredura/emotes/configuração do corte — colunas novas em sessions, channels.settings_json, chat.emotes, clips.learned, tabelas games e emotes; v4 edits (clip_id, project_json, rev, cover, exported_at, created_at, updated_at); v5 face_track; v6 games.notes_json/games.edited_at; v7 edits.origin (ai/user) + edits.ai_project_json; v8 clips.aspect (vertical/horizontal, padrão vertical, gravado no render); v9 sessions.capture_json (o que a captura gravou de fato; sessões antigas NULL); v10 tabela deleted_clips (marca do corte apagado, ON DELETE CASCADE com a sessão); v11 channels.monitor_paused_at/monitor_paused_session/language e sessions.language, padrão '' = CLIPPER_LANGUAGE; v12 games.profile_ai_json (perfil em inglês), translated_at, aliases_json; v13 clips.translation_json, fala do corte em frases + português; v14 vídeo de revisão × final (clips.review_dev_json, final_status/file/thumb/cover/error/at); v15 voice_chunks (impressão de voz); v16 detecção do jogo (sessions.game_status, game_detect_json; vem de outra frente, o doc DETECCAO-JOGO.md ainda não está nesta branch); v17 ai_calls, scene_notes, clips.owner_label/owner_note). Detalhes de v14–v15 em clipper-video.md, de v17 em clipper-ai-team.md. Migra ao subir o serviço. Nunca altere uma migração já aplicada (o banco real estava em v4 quando a v7 nasceu): coluna nova = ALTER numa versão nova |
Blocos gravados (.ts de 30 s + segments.csv) e frames |
data/clipper/sessions/<id>/ (frames em frames/) |
| Pesos do rastreio de reação (YuNet, MediaPipe, OpenSeeFace) | data/clipper/models/, fixados (URL imutável + sha256) em clipper/models.lock.json |
| Cortes prontos | output/clipper/<sessão>/clip-<id>.mp4 + clip-<id>.jpg |
| Arquivos do editor (proxy, TTS) | output/clipper/<sessão>/edit-<id>/ (narração em tts-<hash12>.wav) |
| Fontes empacotadas (ASS e prévia do painel) | assets/fonts/ plana (Luckiest Guy Apache-2.0; Bangers, Anton, Bebas Neue, Poppins ExtraBold OFL-1.1; licença ao lado de cada .ttf), fixadas em assets/fonts/fonts.lock.json (URL presa a commit do google/fonts + sha256 + family = nome dentro do arquivo). Fonte nova: arquivo na pasta + entrada no lock (gotchas, item 105) |
| Vínculo canal → conta (painel) | tabela account_channels em data/cenaforge.db (migração v3 do painel, panel/src/lib/db.ts; sem chave estrangeira para o canal) |
Onde mexer
| Mudança | Arquivo(s) | Também atualizar |
|---|---|---|
Captura (Streamlink → bomba Python → ffmpeg -f segment), linha do tempo, hora do chat, metadados (title/category) |
clipper/app/worker.py, sources.py |
clipper/tests/ |
Qualidade de gravação (capture.quality, argumentos do Streamlink, OPTIONS com GB/h, record_run → sessions.capture_json) |
clipper/app/capture.py; validação CAPTURE_QUALITIES em layout.py; gravação do 1º bloco em worker.py |
clipper/tests/test_capture_quality.py |
Busca de quadro dentro de bloco .ts (seek_args, grab_frame) e emenda de resolução/codec (uniform_segments) |
clipper/app/media.py; clipper/app/editor_render.py; face.grab_bgr e tamanho do quadro por bloco (_frame_size) em face.py |
gotchas, itens 107–108 |
Retomada de live (Engine.live_check, keep_live, RESUME_DELAYS_S, resume_interrupted), render que falha (recover_orphan_renders, ORPHAN_RENDER_S 300, MAX_RENDER_ATTEMPTS 3), cortes duplicados (SAME_PEAK_S 10, SAME_MOMENT_OVERLAP 0,6, KEPT_STATUSES/VETO_STATUSES, discard_pending_duplicates) |
clipper/app/worker.py |
clipper/tests/test_resume.py, clipper/tests/test_render_and_duplicates.py |
Apagar cortes (delete_clip, delete_many, select_ids, MAX_BATCH 500, recusas BUSY/PUBLISHED/CHANGED, marca marks/mark_spans, arquivos só dentro das pastas do Clipador) |
clipper/app/clip_delete.py; rotas em main.py (ClipsDeleteIn); marca lida em worker.py (veto depois do juiz) e na varredura (intel.py) |
clipper/tests/test_clip_delete.py; METHODS em panel/src/lib/clipper.ts; seção "Apagar cortes" abaixo |
Parar à mão e pausa do monitor (Engine.stop_session(id, pause_monitor=True), StopIn.pauseMonitor), idioma por fonte/sessão (check_language, visões de fonte/sessão/corte com language resolvido; Whisper e judge.output_language_note) |
clipper/app/worker.py, main.py, db.py (v11), judge.py; painel ACCOUNT_LANGUAGES em panel/src/lib/languages.ts |
clipper/tests/test_monitor_pause_and_language.py (9); seção "Parar é parar e idioma" abaixo |
Fonte em outro idioma (inglês): prompts *_EN, schemas com bloco pt, lang_key, translate_lines, translate_clip, voice_language, phrases, legenda Trans |
clipper/app/judge.py, intel.py (Intel.lang), worker.py, subtitles.py, scoring.py, layout.py, editor_render.py, editor_api.py (translation_for), main.py; painel clipper-client.ts, clipper-clip-dialog.tsx, clipper-clip-parts.tsx, clipper-clip-table.tsx, clipper-session-detail.tsx, clipper-cut-settings.tsx |
clipper/tests/test_english_source.py (9); seção "Fonte em inglês" abaixo |
Vídeo de revisão × final (dev_flags, render_clip_edit(dev=…), review_layers, render_final, drop_final, rota POST /v1/clips/{id}/final, publishFile) |
clipper/app/layout.py, editor_api.py, worker.py, main.py; painel panel/src/lib/publishing-rules.ts (clipPublishFile), publishing.ts (sendDue), clipper-clip-dialog.tsx, clipper-clip-table.tsx |
clipper/tests/test_final_render.py, publishing-rules.test.ts, publishing-db.test.ts; seção em clipper-video.md |
Dublagem em português (dev.dub*, TTS, cache, encaixe, duck) |
clipper/app/dub.py + editor_render.py (mistura) + serviço de voz POST /v1/synthesize |
clipper/tests/test_dub.py; clipper-video.md |
Falantes (streamer × otherN): impressão de voz, boca, legenda em duas linhas, GET /v1/sessions/{id}/speakers |
clipper/app/speakers.py, voiceprint.py, face.py (MouthMeter), subtitles.py, judge.py (_transcript); peso wespeaker_r34 em clipper/models.lock.json |
clipper/tests/test_speakers.py; clipper-video.md |
| Expressões, pose da cabeça e corpo do streamer; mapa de expressões | lógica clipper/app/reaction.py (label, body_moments, expression_map, extra_weights), E/S face.py (pose_from_matrix, reserva do YuNet); painel clipper-face-map.tsx |
clipper/tests/test_expressions.py; seção "Expressões" em "Rastreio de reação" abaixo |
Equipe de IA: papéis (judge.roles), juiz de contexto, linha do tempo JSON + mosaico (timelineJson), medição (ai_calls, GET /v1/judge/report), rótulo do dono |
clipper/app/roles.py, context_judge.py, timeline.py, report.py, judge.py, worker.py, intel.py; painel clipper-ai-team.tsx, clipper-judge.tsx, clipper-clip-parts.tsx |
clipper/tests/test_roles.py, test_context_judge.py; clipper-ai-team.md |
Chat (IRC anônimo da Twitch com CAP REQ :twitch.tv/tags → emotes nativos e room-id; Pusher da Kick, emotes [emote:id:NOME]) |
clipper/app/chat.py |
— |
Heurística: pesos, base de 3 min, mínimo proporcional (_required_messages), reações (min_reactions), chat fraco (sparse_rate 0,5 msg/s), momentos do chat/áudio/rosto (_chat_moments/_audio_moments/_face_moments; face_* em Params), pick_peaks, fit_window (duração de todo corte automático) |
Params e funções em clipper/app/scoring.py; alvo min_target em layout.py |
clipper/tests/test_scoring.py (regressões de falso positivo, chat fraco e rosto), test_duration_banner_fonts.py |
Rastreio de reação — E/S: backends (MediaPipe; plano B OpenSeeFace), download sob demanda com sha256, recorte FFmpeg 6 qps, laço face |
clipper/app/face.py (for_scoring, must_wait, view, reset); laço _face_loop e uso de must_wait na decisão do corte em worker.py; bancada clipper/tools/face_bench.py |
clipper/tests/test_face.py, clipper/models.lock.json, doc/FACE_BAKEOFF.md |
Rastreio de reação — lógica pura: sinal por segundo contra o neutro do streamer, rótulos, reaction_moments, summarize (linha do analista), locate_cam (câmera pelo rosto) |
ReactionParams e funções em clipper/app/reaction.py |
clipper/tests/test_reaction.py |
Emotes: catálogo 7TV/BTTV/FFZ (canal + global, TTL 1 h, fonte que falha é ignorada), emojis, peso aprendido (LEARN_UP/LEARN_DOWN 0,3/0,15) |
clipper/app/emotes.py; ingestão e aprendizado em clipper/app/intel.py (ingest_chat, learn_from_clip) |
clipper/tests/test_intel.py |
Detecção do jogo da live (check_game a cada GAME_CHECK_S 180, detect_game, detect_game_now, note_screen, canon, gather_evidence; regra pura Evidence/fuse/count_mentions/is_generic; sessions.game_status/game_detect_json) |
clipper/app/game_detect.py (regra) + intel.py (pistas e aplicação); judge.py (GAME_SYSTEM/GAME_SCHEMA, Judge.detect_game); main.py (session_view: gameStatus, gameDetect; PUT …/game, POST …/game/detect); painel clipper-games.tsx (SessionGame), clipper-client.ts (GameStatus, GameDetect, GAME_CLUE_LABEL, gameNeedsReview) — seção "Detecção do jogo da live" abaixo |
clipper/tests/test_game_detect.py; doc/clipador/DETECCAO-JOGO.md; ALLOWED em panel/src/lib/clipper.ts (gotchas, item 180) |
Contexto do jogo (screen_game da varredura, perfil pela web; clean_profile, save_profile, refine, delete_note; perfis bilíngues, add_game, delete_game, translate, aliases, import_seeds de clipper/app/seeds/games/*.json; contrato em doc/clipador/JOGOS.md), varredura (SCAN_*), webcam (detect_cam: YuNet local primeiro, IA só se não achar ou use_ai; CAM_RETRY_S 300), opções OPTION_DEFAULTS (inclui faceTrack) |
clipper/app/intel.py |
README do Clipador |
Juízes (analista + editor), prompts, glossário CHAT_GLOSSARY, linha "Rosto do streamer: …" do analista, schemas, chamada da CLI, pesquisa e refino do jogo (PROFILE_SYSTEM/research_game, REFINE_SYSTEM/refine_game), câmera, detecção do jogo pela tela (SCAN_SCHEMA exige screen_game_confidence high|medium|low e screen_evidence; Judge.detect_game(images, live_title) com 3 frames) |
clipper/app/judge.py; montagem dos 6 frames do analista (8 se o trecho passa de 80 s) em worker.py |
README do Clipador |
Hashtags da legenda (to_tag, fold, split_hashtags, compose, build_caption; MAX_TAGS 8, GAME_TAGS 3, MOMENT_TAGS 4) |
clipper/app/hashtags.py; uso em judge_clip de worker.py; campo hashtags em judge.py (VERDICT_SCHEMA, PROFILE_SCHEMA, Verdict.hashtags) e PROFILE_LISTS/clean_profile/Intel.session_game em intel.py — ver "Hashtags da legenda" abaixo |
clipper/tests/test_hashtags.py |
Configuração do corte: camadas padrão ← canal ← sessão ← projeto (DEFAULTS, merge, validate), format.aspect (ASPECTS, FRAME_SIZES, CANVAS_SIZES, aspect()), MODES (5 modos, inclui cam_only), resolved_mode (queda para blur sem câmera; full no horizontal), retângulos, legenda, crédito, duration (min_target), hook (HOOK_STYLES, HOOK_ANIMS, HOOK_FONT), capture; fontes empacotadas (PACKAGED_FONTS, font_files, ass_filter = ass= com fontsdir só se o ASS usar uma delas); cadeia de layout reutilizável layout_chain(settings, src, dst, tail, suffix, mode) (usada por video_filter e pelo editor) |
clipper/app/layout.py; rotas de settings em main.py (devolvem aspects, frames, fontFiles, hookStyles, hookAnims e captureQualities) |
clipper/tests/test_format_and_captions.py (o vertical precisa continuar batendo com clipper/tests/data/vertical_golden_sha256.json); modo novo também em LayoutMode/MODE_LABEL de panel/src/components/clipper-client.ts e resolvedMode de clip-editor-model.ts; grupo novo também em CutSettings (Aspect, aspectOf, withFormat para serviço antigo) |
Projeto de edição: modelo, tempo sessão↔saída, normalize_cuts, validate_project, auto_project (projeto da IA), pick_hook (texto do gancho), CAPTION_PRESETS, SUGGEST_SCHEMA/clean_suggestion |
clipper/app/editor.py |
clipper/tests/test_editor.py, clipper/tests/test_editor_layers.py; tipos espelhados em panel/src/components/clip-editor-model.ts |
Render do corte (ASS animado, gancho e tarja banner, textos, barra, chat na tela chat_events, filtergraph, trecho mudo, áudio, proxy, forma de onda, capa e capa no início) |
clipper/app/editor_render.py (render_project, build_filter, build_project_ass); cores ASS via layout.ass_color/ass_inline_color |
gotchas.md itens 57, 71, 74–78, 104–105 |
Reenquadramento do jogo (reframe.keys, perspective_filter) e camadas inseridas (kind: "inset", decoração numpy/OpenCV), EASES, MAX_KEYS 60, MAX_INSETS 12 |
clipper/app/reframe.py; validação em editor.py; grafo em editor_render.py |
clipper/tests/test_reframe_insets.py; interpolação espelhada em clip-editor-model.ts (easeAt, interpolate, reframeAt) — as duas precisam dar o mesmo valor; gotchas, item 106 |
Rotas do editor, ensure_edit, render_clip_edit, chat_for (mensagens da sessão para o chat na tela) |
clipper/app/editor_api.py; chamado por Engine.render_clip em worker.py |
ALLOWED e timeout em panel/src/lib/clipper.ts |
Legenda (tempo saneado: clean_words, group_words, caption_blocks; build_ass) e crédito — usada pelo render do editor e pelo worker, nos dois formatos |
clipper/app/subtitles.py (MIN_WORD_S 0,06, MIN_STEP_S 0,04). media.render_vertical ainda existe em media.py, mas não é mais usado pelo render de cortes |
clipper/tests/test_format_and_captions.py; gotchas.md itens 57–58, 70, 90 |
| Rotas HTTP | clipper/app/main.py (editor: editor_api.py) |
ALLOWED em panel/src/lib/clipper.ts (o proxy recusa caminho fora da regex) e o timeout por rota no mesmo arquivo |
Variáveis do .env |
clipper/app/config.py + clipper/.env.example |
tabela do README do Clipador |
Páginas /clipper/* (grupo de rotas panel/src/app/clipper/(studio)/, layout com ClipperProvider + ClipperShell) |
clipper-provider.tsx (dados + consulta periódica, useClipper()), clipper-shell.tsx (CLIPPER_SECTIONS, cabeçalho, bloco "Ao vivo agora · N"), páginas clipper-clips-page.tsx (+ clipper-clip-table.tsx ClipTable, clipper-clip-dialog.tsx ClipDialog, clipper-clip-parts.tsx), clipper-sessions-page.tsx, clipper-session-detail.tsx, clipper-channels.tsx (Fontes), clipper-games-page.tsx + clipper-game-dialog.tsx + clipper-game-parts.tsx + clipper-games.tsx (emotes), clipper-settings-page.tsx; peças compartilhadas em clipper-sessions.tsx (PlatformIcon, CutNow, RecordForm, relógio, sessionHealth) e utilitários da lista em clipper-queue.tsx; clipper-cut-settings.tsx modal do corte em 5 abas; clipper-judge.tsx; cliente clipper-client.ts. Mapa de rotas e papéis em panel.md |
panel.md |
Página do editor /clipper/edit/[clipId] |
panel/src/app/clipper/edit/[clipId]/page.tsx + panel/src/components/clip-editor*.ts(x) (papel de cada arquivo em panel.md); tokens --color-nle-* e bloco .nle em panel/src/app/globals.css |
panel.md |
| Ponte e proxy do painel | panel/src/lib/clipper.ts + panel/src/app/api/clipper/[...path]/route.ts |
— |
| Fontes (canais de live) nos canais de publicação | linkChannel/endChannel/accountsForChannel em panel/src/lib/accounts.ts; rotas panel/src/app/api/accounts/[id]/channels/; card "Fontes de corte" em account-manager.tsx. Na UI "Canais" virou "Fontes"; código e rotas seguem channels |
panel.md |
| Publicação dos cortes | despachante do painel lê GET /v1/clips com channel= (fontes, separadas por vírgula), status=ready,approved e ids=; aprova (PATCH status=approved) e marca published |
publishing.md |
Como os momentos nascem (resumo; regras completas no README)
sourcedo corte:chat,audio,face(rosto forte com apoio),ai(varredura) oumanual.- Chat: mínimo nos 8 s do pico = 3× a mediana recente, entre 4 (
min_peak_floor) e 12 (min_peak_messages), e ≥ 2 reações (texto ou emote) — ou o dobro do mínimo em mensagens. Emote soma bônus + peso aprendido do canal. - Áudio: sempre sem chat; também com chat fraco (<
sparse_rate0,5 msg/s). - Varredura (
scanEnabled,scanIntervalS180, 60–900): a IA vê até 7 frames + fala + chat + perfil do jogo e propõe 0–2 momentos; proposta com nota < 4 (SCAN_MIN_PROPOSAL) não vai aos juízes. Cada janela grava emsessions.memory_jsonproposals(quantas a IA propôs) ecreated(quantas viraram candidato) e loga "varredura <sessão> lo–hi s: N proposta(s), M candidato(s)": é por aí que se sabe se ela não propôs ou se foi barrada. - Aprendizado dos emotes: aprovar/rejeitar no painel = ±0,3/0,15 nos emotes de −10 s a +6 s do pico, uma vez por
corte (
clips.learned); a decisão da IA conta comfactor=0.5. Peso limitado a −1…3.
Juízes (decisão do usuário: pela CLI; chave de API só pelo cofre do painel)
- Provedores
codex(padrãogpt-6-luna; lista de~/.codex/models_cache.json),claude(haiku/sonnet/opus),gemini(Judge._gemini:gemini -p <instrução curta> -o json --approval-mode plan --skip-trust -m <modelo>, prompt completo pelo stdin, schema no prompt e JSON extraído deresponse; frames copiados para pasta temporária fora do repo, porque@arquivorespeita o.gitignore) ouoff(só a heurística). - IA reserva por chamada (18/11/2026):
clipper/app/ai_settings.pylêdata/ai/settings.jsone o cofredata/ai/vault.bin(DPAPI porctypes; só leitura, quem escreve é o painel). Falha de indisponibilidade (cota, 429, login, chave, rede, CLI fora) pausa a IA e a mesma chamada segue na próxima pronta daorder; erro de conteúdo não troca. Contrato:doc/ia.md; visão geral e armadilhas: ai.md. Teste:clipper/tests/test_ai_fallback.py. Só vale depois de reiniciar o Clipador (gotchas, item 144). Gemini com chave real e@arquivode imagem: não testados. - ANALISTA vê 6 frames (8 se o trecho passa de 80 s) + fala + chat + glossário e devolve
situation,what_happened,screen,speech,chat_meaning,confidence(0–1) e início/fim da ação. EDITOR vê só texto + a análise e escreve título, legenda, nota e corte. Os dois podem recuar atéduration.backtrackS(padrão 120 s) antes do candidato. PUT /v1/judge: provedor,model(editor),analystModel(vazio = o mesmo),minScore,scanEnabled,scanIntervalS,vision,camDetect,faceTrack,timelineJson,roles. Fica na tabelasettings, sem reiniciar; o.envsó dá o valor inicial.- Equipe de IA (18/11/2026): hoje são quatro papéis (varredura, analista, editor e o juiz de contexto), cada um com
provedor + modelo + raciocínio + instruções do administrador (
judge.roles), e a IA lê a live como linha do tempo JSON (timelineJson). Tudo em clipper-ai-team.md; o texto acima descreve o fluxo base analista → editor. - Codex: cada imagem com seu
-i, todas antes do-final;--searché opção global (antes deexec). - Custo fixo: cada chamada é um processo novo (2 por candidato).
codex_lean_overrides(search, config_file=None)emjudge.pyenxuga o Codex; o Claude leva--setting-sources project,local. Números e limites em token-economy.md; teste:test_codex_lean_overrides. Vale após reiniciar o Clipador (gotcha 136). - Chave de API do juiz vem só do cofre do painel (
authMode: "apiKey", variável só na chamada); não crie outro caminho de chave sem pedido do usuário. Corte manual é renderizado mesmo com nota baixa.
Hashtags da legenda (hashtags.py)
Pedido do dono (17/11/2026): a IA põe as # certas, do jogo e da missão. A legenda do corte = texto + hashtags + crédito,
montada por build_caption(text, tags, credit) (partes separadas por linha em branco; o crédito é "🎥 Créditos: link").
- Quem escolhe o quê: o sistema fixa o canal (nome do streamer) e as do jogo (até 3 de
profile.hashtags; sem perfil ou sem a seção, o nome do jogo). A IA escolhe só as do momento (2–4 no campohashtagsdo veredito: missão, atividade, evento, modo, lugar, item ou personagem, de preferência com termos do perfil; sem genéricas e sem repetir canal ou jogo).JUDGE_SYSTEMmanda acaptionsem hashtags;split_hashtagstira as que vierem no texto e as junta às do momento. compose(streamer, game, profile, moment): canal → jogo → até 4 do momento, sem repetidas (fold: sem #, acento e maiúscula), até 8.to_tag: "ROB RUN" →#ROBRUN, "perseguição policial" →#PerseguiçãoPolicial; sem letra →None.Verdict.hashtagsé tupla (padrão());_cleanaceita resposta semhashtags._MOMENT(varredura) não tem o campo. Sem juiz ou com o juiz falhando, ainda saem as tags do canal e do jogo.- Perfil do jogo:
PROFILE_SCHEMAganhouhashtags(3–6 que o público usa no TikTok, Shorts e Reels BR, a principal primeiro);PROFILE_SECTIONSganhou "Hashtags";clean_profilenormaliza comto_tag/fold.game_contexttambém passa asmechanicscomo termos para as tags do momento.Intel.session_game(session)devolve (nome, perfil) com o mesmo critério do contexto. - Painel: seção "Hashtags" (violeta, chips, editável, com chat) em
SECTIONSeProfileViewdeclipper-games.tsx;GameProfile.hashtags?emclipper-client.ts. Armadilha de perfil sem a seção e de cortes antigos: gotchas, item 144. - API:
GameRefineIn.sectionaceita"hashtags"(chat da seção) eGameProfileIn.hashtags(lista, máx. 20) existe; sem esse campo, salvar o perfil à mão apagaria as hashtags. Campo novo no perfil = acrescentar nos dois modelos demain.py. Teste:test_api_accepts_hashtags_in_profile_edit_and_section_chat. - Só vale depois de reiniciar o Clipador (gotchas, item 143). Limite: tags do momento dependem da CLI real; não testado com IA real.
Configuração do corte
GET/PUT /v1/channels/{id}/settings(padrão do streamer) e/v1/sessions/{id}/settings(settings_json, sobrescreve campo a campo). Modosauto|blur|cam_top|game_only|cam_only;cam/game= retângulos 0–1 do quadro original.cam_only= câmera do streamer na tela inteira;cam_topecam_onlysem câmera marcada caem emblur.format.aspect:vertical(padrão, 1080×1920) ouhorizontal(1920×1080, YouTube). No horizontal: quadro original inteiro (oulayout.gamerecortado para preencher);cam_onlycontinua valendo;auto/blur/cam_top/game_onlyviram quadro inteiro (resolved_mode=full). ASS num quadro lógico 2560×1440 → tamanhos em px do JSON saem a 75 %; legenda automática a 85 % da altura; crédito no canto direito. Tabela de tamanhos no README do Clipador.duration: padrão{minS: 60, maxS: 90, backtrackS: 120}; limitesminS5–120,maxS15–180,backtrackS0–120 eminS<maxS(senãoLayoutError). Para Shorts de terceiros, baixe o canal para ≤ 60 s. Todo corte automático sai com ≥minS+ 1 s e ≤maxS(layout.min_target=minS+ 1,1 s, porscoring.fit_window): heurística, varredura, juízes,auto_project(depois de silêncios e aparos), remoção de silêncio e "IA sugere". Faltando material, o corte cresce para trás (no começo da gravação, para a frente); gravação menor que o mínimo não inventa vídeo. "Cortar agora" e a edição à mão continuam livres. Não reintroduza ajuste de início/fim fora defit_window(gotchas, item 103).hook(estilo do gancho que o projeto da IA põe na abertura):{style: plain|banner, bg, color, font, anim: pop|fade|none|slide, seconds 1–8}; padrãobanner,#00FF00,#FFFFFF, Luckiest Guy,slide, 3 s. Tudo em ASS, sem filtro extra (entradaslideem duas camadas: gotchas, item 104).- Fontes (
caption.font,hook.font,fontdos textos): as do Windows (Arial Black, Arial, Impact, Verdana, Segoe UI Black, Trebuchet MS) e as empacotadas deassets/fonts/(sha256 conferido ao carregar). Nome = família de dentro do arquivo ("Poppins ExtraBold"). capture.quality:best(padrão) |1440p|1080p|720p|480p(teto), por canal e por sessão (não por corte); vale na próxima gravação ou retomada.CLIPPER_QUALITYnão é mais lida. Detalhes em "Qualidade de gravação" abaixo.GET …/settingsdevolveown,effective,defaults(comformat,durationehook),modes,fonts,fontFiles({família: "assets/fonts/…ttf"}),hookStyles,hookAnims,aspects,frames({vertical, horizontal: {width, height, canvasWidth, canvasHeight}}) ecaptureQualities([{id, label, maxHeight, gbPerHour, gbPerHourMax, hint}]). O formato do arquivo renderizado fica emclips.aspecte sai no JSON do corte (antes do 1º render,vertical).- Webcam:
POST /v1/sessions/{id}/detect-cam(YuNet local em 12 quadros, sem IA; a IA olha 3 frames só se o local não achar rosto evisionestiver ligada, ou com?ai=true) ou automática nos 2 primeiros blocos, secamDetect.cam_json.source=yunet|ai|manual. Prévia sem salvar (no formato efetivo):POST …/preview; quadro:GET …/frame?t=. - Jogo da sessão:
PUT /v1/sessions/{id}/gameconfirma o jogo (game_source = user; a troca automática vira só sugestão) ePOST …/game/detectroda a detecção ("Detectar agora"); regras em "Detecção do jogo da live". Emotes do canal:GET /v1/emotes?channel=twitch-<login>. - Timeouts do proxy do painel: 8 min para
games/*/(research|refine), 5 min paraclips/*/(proxy|preview-render|retranscribe|tts|suggest|waveform), 3 min paradetect-cam|preview|check, 30 s parasessions/*/face(/reset), 2 min o resto.
Qualidade de gravação (capture.py)
Fonte completa (tabelas de nomes de stream e de custo): seção "Qualidade de gravação" de clipper/README.md.
- Streamlink:
best(ignoraaudio_onlye*_portrait); teto =--stream-sorting-excludes >{teto}60combest,worst-unfiltered(sem nada abaixo do teto, pega a menor variante: nunca falha pela qualidade). Twitch combest/1440p:--twitch-supported-codecs h264,h265(o 2K vem em HEVC). AV1 não é pedido (FFmpeg local sem libdav1d). Sem opção de 30/60 qps (o topo é quase sempre 60 qps; o corte sai em 30 qps). - Gravado de fato:
ffprobedo 1º bloco de cada execução →sessions.capture_json→captureemGET /v1/sessions/{id}(quality,width,height,fps,codec,kbps,gbPerHour,fromIdx,runs,mixed);null= sessão antiga (≤ 720p). Painel: "gravando em L×A · fps" no cartão da sessão. - Medido (17/11/2026, trecho real do skipnho): disco/hora 720p60 1,5 GB, 1080p60 3,6 GB; 1440p60 4,7–4,9 GB/h só com blocos gerados do 1080p (nenhuma live 2K no ar). Render de 60 s com NVENC 6,2–6,7 s em qualquer resolução. A câmera recortada no vertical sai mais nítida em 1080p que em 720p; 2K ampliado não ganha nada.
- O que existe nas plataformas (17/11/2026): Twitch quase sempre até
1080p60(+*_portraitem 9 de 143 canais); Kick até1080p60; YouTube pelo Streamlink para em 1080p, até em live "4K". - Retomada pode trocar de qualidade: o render e o proxy uniformizam o trecho que atravessa a emenda (gotchas, item 108).
Retomada, render que falha e cortes duplicados (worker.py)
Regras completas em "Armadilhas já resolvidas" do README do Clipador.
- Retomada:
Engine.live_checkdevolvelive/offline("No playable streams…") /unknown(timeout, erro, JSON inválido).keep_livetenta de novo com esperasRESUME_DELAYS_S(0, 10, 20, 40, 60, 90, 120 s ≈ 5,7 min) antes de processar; enquanto tenta, a sessão ficainterrupted. Vale na subida e para a captura que cai no meio da live. Só processa depois de esgotar as tentativas ou de veroffline2 vezes seguidas; 3 retomadas seguidas sem bloco novo desistem.POST /v1/sessions/{id}/resumevale para qualquer live que não esteja gravando. - Render: qualquer exceção no render marca o corte
errorcom a mensagem e a fila segue.renderingórfão há mais de 5 min volta parapending; na 3ª vez viraerror. - Duplicados: o candidato guarda a janela original (
reasons.candidateStartS/EndS) e não nasce se o pico estiver a ≤ 10 s de outro corte ou sobrepuser o trecho final ou a janela original de qualquer corte (inclusivediscarded). O corte apagado conta como existente (marca emdeleted_clips, ver "Apagar cortes"). Depois do juiz, o trecho final é conferido contraVETO_STATUSES(=KEPT_STATUSESpendente/renderizando/pronto/ aprovado/publicado +rejected) e contra os apagados que estavam num desses estados: "mesmo momento" (pico a ≤ 10 s ou ≥ 60 % do trecho mais curto coberto) viradiscardedcom "Duplicado do corte N (mesmo momento | que você rejeitou | que você apagou)" (judge.duplicateOf). O descartado pela IA não veta o trecho final. "Cortar agora" (manual) só ganhajudge.warning. Antes de cada render,discard_pending_duplicatesusa o mesmo veto: tira da fila o pendente/renderizando igual a um corte pronto, aprovado, publicado ou rejeitado, a um apagado que estava num desses estados ou a um pendente mais antigo, com o mesmo motivo "Duplicado do corte N (…)". Descartado pela IA não veta; manual, exportado do editor e o que está renderizando agora nunca saem. Duplicados já prontos não são mexidos: rejeite ou apague à mão.
Apagar cortes (clip_delete.py)
Fonte completa: seção "Apagar cortes" e tabela "API" de clipper/README.md.
| Rota | Faz |
|---|---|
DELETE /v1/clips/{id}[?confirmPublished=true] |
200 {id, sessionId, status, removedFiles, left: [{file, reason}]}; 404 not_found; 409 {error, code} com busy_candidate, busy_rendering, published ou changed |
POST /v1/clips/delete {ids: [≤ 500]} ou {statuses, sessionId?}, confirmPublished? |
200 {requested, remaining, deleted, failed: [{id, code, reason}]}; 400 sem os dois, com os dois ou sessionId com ids; 422 acima de 500 ou estado inválido |
- Recusa
candidate,renderinge opendingque o motor já pegou (engine._rendering, sob o mesmoengine.lockdo render).publishedsó comconfirmPublished. Cada corte do lote segue as mesmas regras; recusado vai emfailed. - Some: linha em
clips,edits,clip-<id>.*/clip-<id>-*emoutput/clipper/<sessão>/, a pastaedit-<id>/e os quadros do juizframes/clip<id>-*.jpg. Os blocos.tsficam (são da sessão). Só apaga dentro deCLIPPER_OUTPUT_DIR/CLIPPER_DATA_DIR, com caminho resolvido; link ou junção some só o link; o que não pôde vai emleftcom o motivo. - O momento apagado não volta: a marca em
deleted_clips(pico, trecho final, janela original, estado) entra no anti-duplicado do candidato (find_new_clips), na varredura (mark_spans), no veto depois do juiz e na limpeza da fila antes do render (discard_pending_duplicates), nos dois só se o estado era deVETO_STATUSES. Não apague a marca para "liberar" o momento sem pedido. - Proxy do painel:
METHODSempanel/src/lib/clipper.tsaceita só POST emclips/deletee só GET/PATCH/DELETE emclips/{id}(outro método = 405). O painel manda os ids que está mostrando, nuncastatuses: corte que chega depois da confirmação não é apagado junto. UI em panel.md.
Rastreio de reação (rosto do streamer)
Fonte completa: seção "Rastreio de reação" de clipper/README.md; plano e licenças em doc/PLANO_RASTREIO_REACAO.md;
medições em doc/FACE_BAKEOFF.md. Roda no PC, sem IA. Opção faceTrack (padrão ligada; PUT /v1/judge).
- Stack (licenças livres para publicar): YuNet
face_detection_yunet_2026may.onnx(MIT,cv2.FaceDetectorYNdo OpenCV 5) acha a câmera; MediaPipe Face Landmarker (Apache-2.0, 478 pontos + 52 blendshapes) mede expressões; OpenSeeFace.onnx(BSD-2) é o plano B (só posição, sem expressões). Não use SCRFD/InsightFace, YOLO-Face, LibreFace, OpenFace 3.0 nem Py-Feat: licença incompatível com publicação. - Fluxo:
face.py(E/S) recorta a câmera +10 % pelo FFmpeg (~384 px, 6 qps,rgb24por pipe) → MediaPipe em modo VIDEO, um landmarker por bloco → tabelaface_track(statusdone/no_cam/error),cx/cy/sizeno quadro inteiro.reaction.py(lógica pura, sem cv2/mediapipe) faz o resto. Câmera trocada → série refeita. - Câmera pelo rosto (
locate_cam): grupo de rostos estável em ≥ 50 % dos quadros e confiança média do grupo ≥ReactionParams.min_cam_score(0,7). Webcam real dá 0,92–0,94; desenho de rosto em live sem câmera dá 0,61–0,66 (gotchas, item 92). Não baixe esse piso sem medir. - Sinal: z robusto de cada canal contra o neutro dos últimos 180 s do próprio streamer; rótulos
risada,grito,susto,choque,raiva,confuso. Ajuste porReactionParams(pisos por canal, pesos, limiares). - Expressões, cabeça e corpo (18/11/2026;
doc/clipador/EXPRESSOES.md, sem migração: os campos novos vão nodata_jsondeface_track, séries antigas continuam valendo):- Rótulos novos só a partir de blendshapes que já vinham:
gargalhada(risada + cabeça ≥ 20° para trás),alegria(só no mapa),medo,nojo,tristeza,espanto,tenso,bocejo. Além dos antigos (risada,grito,susto,choque,raiva,confuso). Pose (yaw/pitch/roll) vem da matriz de transformação facial do MediaPipe (output_facial_transformation_matrixes=True,face.pose_from_matrix). - Reserva do YuNet: quando o MediaPipe perde o rosto (streamer de perfil), o YuNet roda só nesse quadro (5,3 ms) e dá a
caixa da cabeça → corpo:
balançando,acenando,agitado,chegou perto,saiu do quadro(reaction.body_moments; "saiu" só com o campohead). Rastreio perdido nunca vira movimento. - Canais novos só dão nome, não criam picos:
ReactionParams.extra_weights= 0 (a intensidade alimenta nota e fonteface; mexer sem conjunto aprovado/rejeitado maior seria chute). Ligar um canal = dar peso lá e medir de novo. Única mudança nos picos: bocejo deixou de contar como grito. - Calibração (dados reais, 4 sessões): bocejos eram os maiores "gritos" (jawOpen ≥ 0,6 por 3 s);
noseSneerLeft/Right,cheekSquintLeft/Right,cheekPuffsão sempre ~0 no MediaPipe (nojo usa o lábio de cima); mão no rosto ainda engana a boca (tristeza/espanto/medo/raiva no mapa); cadeira vazia pode gerar "rosto fantasma"; balançar a 6 qps é movimento, não "não" literal. Série de 1,7 h: ~1,4 MB/h no banco; análise ~1 s. - API:
GET /v1/sessions/{id}/faceganhaexpr/bodypor segundo ebody: [{startS,endS,peakS,label,value}]; a linha "Rosto do streamer" do analista leva até 2 movimentos do corpo (com rosto de perfil: "sem expressão legível… saiu do quadro"). Painel: Mapa de expressões no modal do corte (clipper-face-map.tsx), chipFaceSignalcom os rótulos novos. - Não verificado: serviço real rodando o código novo; painel no navegador (só
tsc); câmera escura/minúscula além da do tfue.
- Rótulos novos só a partir de blendshapes que já vinham:
- Cortes: rosto reforça, não manda.
reasons.face+ bônus ≤ 0,6 em momentos do chat/áudio; fontefacesó com z ≥ 6 e apoio (áudio suavizado ≥ 1,5 ou ≥ 2 mensagens de reação). A decisão do corte espera o rosto do trecho (no máximo 2 blocos atrás da transcrição). O analista recebe a linha "Rosto do streamer: …" — exceto quando a série da sessão é do plano B OpenSeeFace (sem blendshapes): aíFaceService.summarynão manda linha. - Modelos:
setup.ps1passo 6b baixa e confere o sha256; o serviço baixa sob demanda se faltar. Falha de modelo não marca blocos: nova tentativa em 5 min. Modelo novo = entrada emclipper/models.lock.jsoncom URL imutável + sha256 + licença. - Dependências (
clipper/requirements.txt):mediapipe,opencv-contrib-python,numpy,onnxruntime— versões em tools.md. Nunca instaleopencv-python-headlessjunto (gotchas, item 80). - Rotas:
GET /v1/sessions/{id}/face?from=&to=(série,signal, picos, câmera, progresso) ePOST …/face/reset. Ambas na regexALLOWEDdo painel. - Bancada (lê o banco só para leitura, saída em
output/face-bench/):clipper\.venv\Scripts\python.exe clipper\tools\face_bench.py --session 3. Armadilhas: gotchas.md itens 79–84 e 92–95. - Instância de teste isolada (receita em "Variáveis" de
clipper/README.md):CLIPPER_PORT=4521,CLIPPER_DATA_DIR=output/<teste>/data,CLIPPER_OUTPUT_DIR=output/<teste>/clipsno ambiente (padrões:data/clippereoutput/clipper; as duas precisam ficar dentro do repo, senãoConfigErroremclipper/app/config.py), juizoff, e osqlite_sequencedesessionsdo banco novo em 90000 antes da 1ª sessão (gotchas, item 93). Cuidados com cópia do banco real: item 77.
Editor de cortes (/clipper/edit/<id>)
Fonte completa: seção "Editor de cortes" de clipper/README.md (campos do projeto, render, medições, limitações).
Pesquisa de referência (OpenCut, effectcraft, Descript, Submagic etc.; nenhum código copiado):
doc/clip-editor-research.md.
- Um caminho só de render:
Engine.render_clip(worker.py) →editor_api.ensure_edit(gera o projeto da IA se o corte não tem) →editor_api.render_clip_edit→editor_render.render_project(FFmpeg). Não reintroduza render que contorne o projeto de edição. - Formato: o projeto pode trocar o formato só daquele corte em
settings.format(mesma validação delayout.validate); projeto antigo semformatsegue canal/sessão. Export,preview-rendere capa saem no formato do corte (1080×1920 ou 1920×1080). O Programa do painel segue o formato do corte (tamanhos deframes; em 16:9 no horizontal). - Projeto da IA (
editor.auto_project): trechoaction_start_s − 0,8 s … reaction_end_s + 0,8 s, encaixado em palavras e depois emfit_window(≥minS+ 1 s, ≤maxS; o início só adianta se o mínimo continuar); tira vãos ≥ 2 s sem fala, quietos (< −38 dBFS) e a mais de ±3 s do pico; legenda Whisper presetpop(tempo saneado porsubtitles.py); gancho porpick_hook(regra abaixo) no estilo do grupohook; zoom 1,25× nopeak_s(no rosto emcam_top); capa no pico;meta.origin = "ai"com data, modelo e passos. A IA não propõe reenquadramento nem camadas inseridas (o analista não devolve região da tela). - Gancho (
editor.pick_hook): ohookdo analista só vale se tiver ≤ 8 palavras, ≤ 48 caracteres e nenhum tempo da gravação (3+ dígitos seguidos de "s"); senão vale o título do editor. Em qualquer caso a menção ao tempo ("Aos 5085s, …") é removida, a 1ª letra vira maiúscula e o texto para em palavra inteira até 60 caracteres. - Origem:
edits.ai_project_jsonguarda o projeto da IA ("Projeto da IA" no editor volta a ele). PUT do editor marcaorigin = 'user'. Rejudge (corte volta apending) apaga só edit de origemai; o do usuário fica. - Tempo:
cuts, palavras, textos, zoom, narração e capa em tempo da sessão; só o gancho em tempo de saída. - Validação forte em
validate_project(3–180 s, limites de quantidade, texto escapado no ASS, áudio só deassets/ou dos TTS do editor, nada vira shell). Campo novo no projeto = validação com valor padrão (projeto antigo continua abrindo) + teste emclipper/tests/+ tipo emclip-editor-model.ts. clip_viewdevolveedit: {updatedAt, exportedAt, cover, origin}(o painel decide "Editar"/"Continuar edição").
Campos das camadas (tabela completa do projeto em "Tempo e modelo do projeto" do README):
| Campo | Regra |
|---|---|
cuts[].mode |
layout só daquele trecho: um de MODES ou null (= o do corte) |
cuts[].muted |
trecho sem o áudio da live (volume=0 no trecho; narração e música continuam). normalize_cuts só junta trechos encostados com o mesmo mode e o mesmo muted |
overlays[].x (gancho e texto) |
posição horizontal 0,05–0,95; ausente = 0,5. y 0,04–0,96. No zoom, x/y (0–1) são o foco |
overlays[] hook/text: style, bg, color, font, anim |
opcionais. style plain (padrão) ou banner (tarja na largura toda, centrada em y, maiúsculas em até 2 linhas; a fonte diminui em vez de cortar palavra); font = uma de fonts; anim ganhou slide. Sem esses campos, renderiza idêntico ao de antes |
overlays[] kind: "inset" |
camada inserida: start/end (sessão), src {x, y, w, h} (recorte 0–1 do quadro original), x/y (centro na saída), size 0,1–1 da largura, border (#RRGGBB/null), borderW 0–40 (6), radius 0–200 (18), shadow (true), anim pop|fade|slide|none, keys opcionais [{t, x, y, size, ease}]. Até 12. Ordem do array = empilhamento: acima do vídeo e do zoom, abaixo do ASS (legenda, gancho, textos, chat). Não entra na capa |
reframe |
{keys: [{t, cx, cy, w, ease: smooth|linear|hold}]}, até 60, t em tempo da sessão, cx/cy/w (0,05–1) absolutos no quadro original; a altura sai da área do jogo do layout do trecho (nunca distorce). Com keys, layout.game é ignorado; não vale em cam_only; no blur, game_only e horizontal ocupa a tela toda. A capa usa a janela parada do instante dela |
chat |
chat da live na tela: enabled (padrão false), x 0–0,9 (borda esquerda), y 0,1–0,98 (base do bloco), width 0,25–0,96, lines 1–10, size 18–64, showUser. chat_events redesenha o bloco a cada mensagem; ele some 9 s depois da última (CHAT_HOLD_S) |
cover.atStart |
a capa também cobre os 2 primeiros quadros do MP4 (0 s). Exige cover.enabled; render_clip_edit gera a capa antes do vídeo e a passa como cover_file. preview-render também põe a capa quando fromS = 0 |
Editar com a mão (arrastar e aparar palavra, deslizar e dividir trecho, mover texto/legenda/chat no monitor, marcar a câmera só daquele corte): tabela "Mexer com a mão" do README; componentes e atalhos em panel.md.
Limites do editor (lista completa em "Limitações" do README):
- Uma trilha de vídeo só, sem B-roll. A timeline é o tempo da sessão: um pedaço não vai para outra camada nem toca fora da ordem da gravação. Não prometa reordenar trechos.
- A prévia do Programa é um canvas; a exata é
preview-render(no formato do corte). Legenda e recorte de câmera/jogo já saem como no render: blocos porcleanWords/groupWords/captionBlocks(porte desubtitles.py, constantes emCAPTION_TIMINGdeclip-editor-model.ts) e recorte porffmpegCropFill(arredondamento par do FFmpeg, tamanho da gravação desession.capture). Mudou constante ou regra emsubtitles.py, ou a cadeialayout_chain, mude o porte junto. Tarja a ~2 px do render (informado). - Reenquadramento no 9:16 com câmera em cima: a área do jogo é 1080×1268 (proporção ~0,85), então um inventário 16:10 não cabe inteiro; a janela mostra no máximo 0,48 da largura. No 16:9 cabe.
- Custo medido (corte 61, 60 s, NVENC): sem nada 6,1–6,2 s; com reenquadramento 7,1–9,5 s; com reenquadramento + 2 camadas 15,8–20,5 s.
- Campo novo (
cam_only,muted,chat,cover.atStart, texto comx,style/fontdo gancho,reframe,inset) só vale no serviço reiniciado (gotchas, item 73).
Rotas (todas com X-Service-Key; todas na regex ALLOWED):
| Rota | Faz |
|---|---|
GET/PUT/DELETE /v1/clips/{id}/edit |
projeto; PUT manda rev e recebe 409 se outro salvou antes |
POST …/proxy {lo,hi} · GET …/waveform?lo=&hi= |
prévia 480p (-g 15) e forma de onda (50 picos/s) da janela |
POST …/preview-render {fromS, durationS ≤ 10, project?} |
prévia real de poucos segundos |
POST …/export |
volta para a fila de render → ready |
POST …/retranscribe {startS, endS} (≤ 90 s) |
Whisper de novo no trecho |
POST …/tts {text, voice, speed} |
narração pelo serviço de voz (4510) |
POST …/suggest |
IA (Judge.ask) sugere gancho, título, início/fim, trechos mortos e zooms |
Teste local do editor sem tocar no serviço do usuário: instância na faixa 4500–4599 (ex.: 4521) sobre cópia do banco, com as regras do item 77 de gotchas.md. Teste de UI no painel do usuário sobre um corte real: intercepte as escritas (item 86) e ache as camadas do canvas pelo cursor (item 85).
Parar é parar e idioma (18/11/2026)
Texto completo no README do Clipador ("Parar é parar", "Idioma por fonte e por sessão").
- Parar à mão pausa o monitor da fonte.
POST /v1/sessions/{id}/stop(corpo opcional{"pauseMonitor": false}; padrãotrue) gravachannels.monitor_paused_at+monitor_paused_session; o monitor pula a fonte pausada. Limpam a pausa:PATCH /v1/channels/{id}com{"monitor": true},POST /v1/sessions(gravar pelo link) eresumepelo painel. Queda de live (captura cai sozinha) não passa pela pausa: continuakeep_live, na mesma sessão. Na UI: a fonte mostra "monitor pausado · você parou a sessão #N" com Religar; o diálogo de parar tem a opção de voltar a gravar sozinho (marcada = não pausa). - Idioma.
languageemchannelsesessions(pt-BR,en-US,es-419;''=CLIPPER_LANGUAGE), aceito emPOST/PATCH /v1/channelsePOST /v1/sessions; as visões de fonte, sessão e corte devolvem o idioma já resolvido. O Whisper usa o idioma da sessão (pela fronteiravoice_language, ver abaixo); espanhol mantém os prompts em português com a nota de idioma de saída; inglês tem juízes próprios (seção "Fonte em inglês"). No painel,accounts.language(migração v9 do painel, padrãopt-BR) e o aviso no diálogo Publicar quando o idioma do canal difere do idioma do corte. Versão do corte em outro idioma para publicar: ainda não existe; a tradução em português guardada é só para a equipe ler. - Sem reiniciar o Clipador as rotas novas não valem; o painel trata
language/pausa como opcionais e não quebra (gotchas, item 166).
Fonte em inglês (18/11/2026)
Fonte do contrato: doc/clipador/IDIOMAS.md; README do Clipador, "Idioma por fonte e por sessão". Decisão do dono: o
vídeo sai em inglês (título, legenda, hashtags, gancho) e a equipe vê tudo em português no painel.
- Regra:
judge.lang_key(language)="en"paraen-*, senão"pt";Intel.lang(session)resolve. Em inglês, analista, editor e varredura usamANALYST_SYSTEM_EN/JUDGE_SYSTEM_EN/SCAN_SYSTEM_EN,CLIP_GUIDE_EN,CHAT_GLOSSARY_ENeLABELSen nos montadores (parâmetrolangemJudge.analyze/judge/scan). Perfil do jogo no prompt =profileAi. - Tradução sem chamada extra: os schemas
*_ENexigem o blocopt(analista:what_happened,screen,speech,chat_meaning,hook; editor:title,caption,reason; varredura:summary_pteptpor momento). Vai emjudge_json.pt,memory[].summaryPt,reasons.proposalTitlePt/proposalReasonPt.analysis_blocktira optantes do editor. Campo novo no schema inglês = pôr optcorrespondente e mostrar no painel. - Fala traduzida:
Engine.translate_clip(clip_id, lo, hi, force)(chamada quando o corte é mantido) gravaclips.translation_json{language, startS, endS, model, lines: [{s, e, text, pt}]}; frases desubtitles.phrases(pausa > 0,7 s, fim de frase com 4+ palavras, 16 palavras ou 6 s) traduzidas porJudge.translate_lines.POST /v1/clips/{id}/translaterefaz (409 em fonte PT);clip_view.translation. - Legenda em português no vídeo (só para desenvolver):
dev.translation(padrãofalse;caption.translationé o legado, ainda lido) → estilo ASSTrans(metade do tamanho,&H00FFE79B) sob a legenda, seguindo o desvio do gancho; só entra no ASS quando ligado e há tradução (sem isso o ASS é idêntico ao de antes).editor_api.translation_foralimenta render e prévia. Entra só no vídeo de revisão: o final, gerado ao aprovar, sai sem ela (clipper-video.md; dublagem: mesma seção). - Heurística:
scoring.py(REACTION_PATTERNS,SPOKEN_REACTION) reconhece reação em inglês (lmao, lol, 💀, 😭, no way, bruh, holy, clutch, goated, clip that…).judge.output_language_noteagora é vazio também para inglês. - Voz:
worker.VOICE_LANGUAGES/voice_language()converteen-US→enees-419→esantes do Whisper (gotchas, item 173). - Começar uma fonte gringa: Fontes → idioma English (US); jogo com perfil em inglês e gírias do público gringo
(Jogos → "acrescente as gírias…", ou
POST /v1/games/{id}/translatese o perfil só existe em português); ligar "Tradução em português embaixo (teste)" (e, se quiser, "Dublagem em português (teste)") na configuração do corte do canal enquanto estiver testando. Fontes em teste (18/11/2026): twitch-tfue (ROB RUN) e twitch-maxylobes (GTA V Chaos Mod, en-US,dev.translation+dev.dubligados). - Painel: modal do corte com bloco "Em português" (título, legenda, "O que ele fala" frase a frase, botão "Traduzir a
fala"); lista com título traduzido (🇧🇷); resumo da sessão em português; switch em
clipper-cut-settings.tsx; Fontes: a coluna "Ao vivo" mostra "gravando #N" da sessão ativa e checagem do monitor com mais de 10 min vira "ao vivo há X" apagado (gotchas, item 174). - Medido (18/11/2026, sessão 15, twitch.tv/tfue, ROB RUN, 1080p60 h264, informado pelo coordenador): transcrição em
inglês ok; câmera pela YuNet em 12/12 quadros; corte manual 259 (30–100 s) com título, legenda e hashtags em inglês,
judge.ptem português, 27 frases traduzidas e vídeo 1080×1920 com inglês em cima e português embaixo. Não verificado por mim: o render real (só a suíte foi reexecutada); qualidade da tradução fora desse corte; espanhol ponta a ponta.
Detecção do jogo da live (18/11/2026)
Fonte do contrato: doc/clipador/DETECCAO-JOGO.md; seção "Contexto do jogo" de clipper/README.md. Decisão do dono:
ninguém precisa lembrar de dizer o jogo; o Clipador descobre sozinho e o usuário só confirma ou corrige.
- Quando:
Intel.check_gamea cadaGAME_CHECK_S180 s grava a categoria/título emsessions.game_detect_json(platform) e chamadetect_game. A varredura e "Detectar agora" gravam a tela comnote_screen(valeSCREEN_FRESH_S900 s). Chat e fala: últimosCHAT_WINDOW_S360 s e 12 blocos (SPEECH_SEGMENTS). - Pistas (
game_detect.Evidence; peso por fonteSOURCE_WEIGHT: categoria 0,55, tela 0,5, chat e fala 0,35, título 0,25; tela multiplica pela confiança high 1 / medium 0,7 / low 0,4). Cada fonte conta uma vez por jogo.fusejunta os pesos por ruído-ou e decidestatus:agreed(≥ 2 fontes e nota ≥ 0,6),probable(nota ≥ 0,34),conflict(2º colocado ≥ 0,34, vantagem < 0,25 e com fonte forte = categoria ou tela),unknown. Chat só conta com ≥ 2 mensagens citando o jogo. - Estados em
sessions.game_status:user(você confirmou) |agreed|probable|conflict|unknown(''= sessão antiga, ainda não checada). - Regras de troca (
detect_game):- Jogo confirmado por você (
game_source = user) nunca muda sozinho; se as pistas concordam em outro jogo por 2 checagens seguidas virasuggestione o painel pergunta. - Sem confirmação, trocar de jogo exige a categoria apoiando ou a mesma resposta em 2 checagens seguidas
(
state.pending.n); "Detectar agora" (immediate) pula a espera. - Conflito categoria × tela mantém o jogo atual e o painel pergunta (um botão por candidato).
- Categoria genérica ("Just Chatting", "IRL", "Só Bate-papo"…,
GENERIC_CATEGORIES) não é jogo: fica registrada, não conta.
- Jogo confirmado por você (
- Nomes:
canon(name)resolve categoria "Grand Theft Auto VI" e tela "GTA 6" para o mesmo id quando o jogo (ou um alias) está cadastrado.count_mentionscasa palavra inteira e confere duas leituras do texto: sem acento (slug) e comointel.game_idgerou o id, que não tira acento (Pokémon→pok-mon). - "Detectar agora" (
POST /v1/sessions/{id}/game/detect,detect_game_now): a IA vê 3 frames (−120, −60 e −6 s) e o título; sem IA ou sem visão (vision) responde erro de usuário. Leva de 10 s a 1 min. Resposta{result, session}. - API:
session_viewganhougameStatusegameDetect{checkedAt, candidates, suggestion, platform, screen}.PUT …/gameconfirma à mão e roda a detecção (limpa a sugestão). - Painel:
SessionGameemclipper-games.tsx: selo do estado, botão "Detectar agora", aviso de conflito, aviso de sugestão e "Como o jogo foi descoberto";gameNeedsReview(clipper-client.ts) é o queclipper-session-detail.tsxeclipper-sessions-page.tsxusam para chamar a atenção (serviço antigo semgameStatus: cai no cálculo porscreenGame). - Limites: chat e fala só reconhecem jogos já cadastrados em Jogos (
_mention_formslê a tabelagames); sem IA/visão não há pista de tela. Só vale com o serviço reiniciado (migração v16; gotchas, item 180).
Perfil do jogo (aba Jogos)
Fonte do contrato: doc/clipador/JOGOS.md; seção "Contexto do jogo" de clipper/README.md. Toda rota abaixo devolve a
lista inteira (mesma forma de GET /v1/games), exceto onde dito.
Dois idiomas. profile = português (o que o painel mostra); profileAi = inglês (vai nos prompts; null = não
traduzido, a IA usa profile); aiLanguage en-US; translatedAt; aliases (união dos dois perfis). Campos novos do
perfil: aliases (≤ 10), missions [{name, chapter, summary, completion_triggers ≤ 8 de 200 caracteres}] (até 120;
[] quando não há lista pública — a IA nunca inventa) e end_triggers (≤ 12, sinais gerais de fim de missão).
game_context (judge.mission_lines: MISSIONS_IN_PROMPT 25, MISSIONS_PROMPT_CHARS 1500) manda terminar o corte de
missão logo depois do gatilho de fim. Busca por nome casa id ou alias (categoria "Grand Theft Auto VI" e tela
"GTA 6" = mesmo jogo).
| Rota | Faz |
|---|---|
GET /v1/games |
perfis com status, error, model, researchedAt, editedAt, translatedAt, notes ([{text, at, section?}]), aliases, profile, profileAi |
POST /v1/games {name, notes?} |
cadastra (201, {games, id}, status pending) e pesquisa em segundo plano; 409 se o id ou um alias já existe |
DELETE /v1/games/{id} |
apaga o jogo (sessões não mudam; volta a ser pesquisado se o jogo reaparecer); 404 se não existe |
POST /v1/games/{id}/research |
refaz o perfil do zero pela web em inglês e traduz para português (RESEARCH_TIMEOUT_S 420); os pedidos guardados entram no prompt |
POST /v1/games/{id}/translate |
gera o inglês a partir do português (jogo de antes dos perfis bilíngues) |
PUT /v1/games/{id}?lang=pt|en |
grava a edição à mão no idioma lang (padrão pt) e traduz para o outro; sem IA, grava e deixa o outro desatualizado. Campos: name, summary, genre, mechanics, clip_worthy, avoid, jargon, news, hashtags, sources, aliases, missions, end_triggers |
POST /v1/games/{id}/refine |
{instruction, search, section, history} → {games, reply}. Aplica no inglês e responde em português. instruction 3–1500 caracteres; search padrão true (false = sem web, TIMEOUT_S 240); section "" | summary | clip_worthy | avoid | mechanics | news | jargon | hashtags | sources | missions | end_triggers | aliases (Literal em GameRefineIn de main.py, inválido dá 422); history [{role: "user"|"ai", text ≤1500}], máx. 20. A IA devolve o perfil inteiro + reply; guarda o pedido (com section) e marca edited_at |
DELETE /v1/games/{id}/notes/{index} |
esquece um pedido guardado (o perfil atual fica como está) |
-
Tradução que falha (ou IA desligada): a outra versão fica como estava (na pesquisa, as duas em inglês),
errorexplica etranslatedAtnão muda. Tradução nunca mexe em nome, hashtags, fontes e outros nomes, e é recusada se perder missões. -
Sementes:
clipper/app/seeds/games/*.json({name, aliases, researchedAt, sources, profileAi, profile}) é importado na subida só se o jogo não existe. Hoje:gta-vi.json(GTA VI lança 19/11/2026, sem lista oficial de missões; a semente traz 4 do vídeo "An Extended Look" com nomes descritivos não oficiais — pesquisar de novo depois do lançamento; gotchas, item 167). -
Proxy do painel (
panel/src/lib/clipper.ts):ALLOWEDaceitagames/<id>/(research|refine|translate|notes/n);METHODSdá GET/POST agamese PUT/DELETE agames/<id>; timeouts: 8 minresearch|refine, 5 mintranslateePUT, 30 sPOST games. -
clean_profile(intel.py) normaliza tudo que entra: apara, tira vazios e duplicados, no máximo 20 itens por lista. São guardados os últimos 30 pedidos. -
Pedido guardado sobrevive a "Pesquisar de novo" (
research_game(name, title, notes);PROFILE_SYSTEMmanda priorizar os pedidos sobre a pesquisa). Edição à mão não sobrevive. Por isso o painel pede confirmação quando háeditedAt. Para algo durar, prefira o pedido à IA. -
Refino (
judge.py):refine_game(name, profile, instruction, search, section, history)usaREFINE_SCHEMA(=PROFILE_SCHEMA+reply) ePROFILE_SECTIONS(chave → título). A IA vê só os últimos 8 turnos dohistory, 400 caracteres cada.REFINE_SYSTEMmanda mexer só na seção em foco e transformar pedido genérico em item concreto ("reação do streamer conta" → "Streamer grita, xinga ou ri alto logo depois de uma morte ou fuga").Intel.refine(...)(intel.py) devolve(profile, reply). -
Painel: lista em
/clipper/gamese modal por?game=ID(clipper-game-dialog.tsx,clipper-game-parts.tsx); o chatAiChattem a chave "Confirmar na web" desligada por padrão, embora a API usesearch=true. A conversa só existe enquanto o chat está aberto; o que fica salvo é o pedido (aba "Pedidos à IA", com X). TiposGame,GameProfile,GameMissionempanel/src/components/clipper-client.ts. Detalhes visuais em panel.md.
Regras
- Aprovar publica nas redes dos canais de publicação ligados à fonte (pelo despachante do painel; aprovar vale
para todas as redes). O painel marca o corte
publishedquando todos os jobs dele saíram. Exportar no editor volta o corte parapendinge cancela os jobs ainda não enviados (voltam quando o corte fica pronto de novo). Regras em publishing.md. Corte aprovado sem fonte ligada (ou em outra rede) sai pelo botão "Publicar" do cartão (clip-publish.tsx; empublishedvira "Publicar em outra rede"): ver publishing.md. - Direitos autorais. Todo corte leva o crédito do canal. Marque
authorizednos canais que autorizaram. - Mudança de código em
clipper/app/só entra no ar depois de reiniciar o serviço. Oscripts/dev.tssobe o uvicorn sem--reload(gotchas, itens 53 e 73). O painel é do usuário, então peça a ele que reinicie — e só com a suíte verde: reinício no meio de uma edição carrega código intermediário (gotchas, item 87). Agente que edita o serviço trabalha numa cópia e aplica emclipper/app/por edição pontual, nunca sobrescrevendo o arquivo inteiro: vários agentes e outras sessões mexem emclipper/ao mesmo tempo. - Nada de rede (APIs de emotes, CLI) na thread do chat: use
EmoteCatalog.cached()e baixe em thread à parte (gotchas, item 72). - Subprocesso sem shell. A CLI do Codex é chamada pelo
codex.js(gotchas, item 28).
Testes e evidência
Detecção do jogo da live (18/11/2026): suíte inteira do Clipador (cd clipper; .venv\Scripts\python -m pytest) →
exit 0, 440 testes (pontos contados na saída; o pytest.ini usa -q e não imprime a linha final; reexecutado nesta
manutenção); tests/test_game_detect.py tem 15 testes (o lote informou 14); npx tsc --noEmit -p panel → exit 0
(reexecutado). Não verificado: IA real em Judge.detect_game e nos prompts com os campos novos; o painel no navegador;
banco real em v16 (o serviço precisa reiniciar); o botão "Detectar agora" contra o serviço — o proxy do painel não tem
game/detect no ALLOWED (gotchas, item 186; já corrigido).
Bloco de 18/11/2026 (revisão × final, dublagem, falantes, expressões, Equipe de IA e proxy): informado pelo coordenador
(não reexecutado por mim): suíte inteira do Clipador passa; painel tsc + 119 testes. Testes novos: test_final_render.py,
test_dub.py, test_speakers.py, test_expressions.py, test_roles.py, test_context_judge.py. Medidas citadas (tempo da
dublagem, custo da voz, estabilidade dos falantes, tokens por hora) vêm dos docs de doc/clipador/ e estão nas seções
próprias. Não verificado: serviços reais com o código novo (precisam reiniciar), UI no navegador, juiz/dublagem/voz com IA e
TTS reais além dos cortes citados, banco real em v17. onnxruntime 1.32.0 e mediapipe 1.2.3 reconferidos no clipper/.venv.
O proxy do painel liberou POST clips/{id}/translate e GET sessions/{id}/speakers (sem isso o botão "Traduzir a fala"
dava 404; regex ALLOWED + METHODS em panel/src/lib/clipper.ts).
Fonte em inglês (18/11/2026): pnpm test:clipper → 346 passed (reexecutado nesta manutenção, 101 s); test_english_source.py
novo (9 testes) e ajustes em test_monitor_pause_and_language.py, test_render_and_duplicates.py, test_intel.py. Não
verificado: IA real com prompts em inglês (só o corte 259 informado), painel no navegador, pnpm typecheck, banco real em v13
(o serviço precisa reiniciar).
Perfis de jogo bilíngues, missões, cadastro e semente do GTA VI (18/11/2026): pnpm test:clipper → 335 passed
(reexecutado nesta manutenção, 108 s; bate com o informado); 10 testes em clipper/tests/test_game_profiles.py. Não
verificado: IA real na pesquisa, tradução e refino bilíngues; modal e lista no navegador; serviço real em v12 (precisa
reiniciar); pnpm typecheck e testes do painel.
IA reserva e Gemini no juiz (18/11/2026): pnpm test:clipper → 335 passed (reexecutado pela skill; test_ai_fallback.py novo).
Reformulação da interface e regras de pausa/idioma (18/11/2026): pnpm test:clipper → 287 passed (reexecutado
nesta manutenção; 9 testes novos em clipper/tests/test_monitor_pause_and_language.py). Não verificado: as páginas no
navegador e o banco real em v11 (o serviço precisa reiniciar).
Os testes não chamam a CLI de IA: FakeJudge.ask (clipper/tests/test_sources_and_api.py) sempre falha, e o serviço
segue pelo caminho de "IA fora". Juiz falso novo precisa cobrir ask também.
Hashtags da legenda (17/11/2026): pnpm test:clipper → 278 passed (reexecutado nesta manutenção; bate com o
informado). Testes novos em clipper/tests/test_hashtags.py. O perfil do ROB RUN no banco ainda não tem hashtags
(informado; não conferido no banco).
Apagar cortes, veto do rejeitado, varredura contada e prévia igual ao render (17/11/2026):
pnpm test:clipper→ 270 passed (medido na 1.29.1; o coordenador informou 269 — o disco já tinha outro teste novo; na 1.29.0 eram 268). Testes novos:test_clip_delete.py(14); emtest_render_and_duplicates.py, veto do rejeitado, contagem da varredura etest_queue_cleanup_uses_the_same_veto_as_the_judge(limpeza da fila).npx tsc --noEmit -p panel→ exit 0, sem erro (medido nesta manutenção; o lote informou erros de outra sessão emmontage-editor.tsx/lib/montage*.ts, já resolvidos quando rodei).- Banco real
data/clipper/clipper.dbemuser_version10 (lido só para leitura nesta manutenção). - Informado: diagnóstico "não sai corte" da sessão 3 (README, "Armadilhas já resolvidas"; gotchas, item 114);
legenda do painel em 22 conferências contra o Python; teste de ponta a ponta no corte 61 (projeto montado no editor,
capturado do PUT interceptado, render por
editor_render.render_project) com enquadramento, inserção e legenda iguais em 2/3,5/5/6,5/8 s; observador só leitura depois da retomada (01:30–01:46): corte 68 pronto e aprovado, 69 e 70 descartados, 71 pronto em 8 s.
Duração mínima, tarja do gancho, fontes, reenquadramento, camadas e qualidade de gravação (17/11/2026):
pnpm test:clipper→ 251 passed (medido nesta manutenção; bate com o informado). Testes novos:test_duration_banner_fonts.py(19),test_reframe_insets.py(10),test_capture_quality.py(17).npx tsc --noEmit -p panel→ exit 0 (medido nesta manutenção; uma 1ª rodada deu erro emconfirm-dialog.tsx, de outro trabalho que ainda estava sendo escrito, e passou depois que ele terminou).- Informado: medições de render, disco e nitidez acima e no README; prévia da tarja a ≤ ~2 px do render; interpolação
do painel ×
reframe.pyem 41 conferências.
Formato horizontal, legenda com fala rápida, retomada, render que falha e duplicados (17/11/2026):
pnpm test:clipper→ 170 passed enpx tsc --noEmit -p panel→ exit 0, ambos medidos nesta manutenção (o lote informou 169; o disco já tinha mudanças de outro lote em andamento). Testes novos:test_format_and_captions.py,test_resume.py,test_render_and_duplicates.py; o vertical bate com o SHA de referência (tests/data/vertical_golden_sha256.json).- Informado: render horizontal real 1920×1080 conferido no ffprobe; legenda medida numa cópia do banco (3 projetos, sessão 3 do skipnho): 63 de 286 eventos sobrepostos antes, 0 de 299 depois (README, "Tempo da legenda").
- Informado: capturas por CDP com as escritas interceptadas — modal "Configuração do corte" em 1920×1080 e 1366×768; aba Sessões sem mudança de posição/altura entre atualizações automáticas.
Redesenho do editor e camadas novas (16/11/2026):
pnpm test:clipper→ 136 passed na época enpx tsc --noEmit -p panel→ exit 0.clipper/tests/test_editor_layers.py(6 testes): projeto antigo ganha os padrões,cam_onlyenche a tela,mode/mutedsobrevivem sem juntar, texto comxe bloco de chat no ASS, capa no início, e um render real pelo FFmpeg com as camadas novas.- Informado pelo coordenador, Chrome sem janela por CDP em
/clipper/edit/25do painel, com as escritas interceptadas (nada gravado): palavra aparada pela direita 34→21 px e pela esquerda 21→12 px com a outra borda parada; mover −6 px com a largura igual; clique simples não move; Ctrl+Shift+clique divide (1→2 trechos) e Ctrl+Z desfaz; marcar a câmera mudou a área de "21% × 24% em 2%, 43%" para "25% × 35% em 5%, 45%"; câmera inteira e chat na tela aparecem na prévia.
Rastreio de reação (16–17/11/2026):
cd clipper; .venv\Scripts\python -m pytest→ 120 passed na época (2 execuções seguidas);npx tsc --noEmit -p panellimpo (informado). Versões instaladas noclipper/.venvconferidas (ver tools.md); os 4 pesos já estão emdata/clipper/models/.doc/FACE_BAKEOFF.md(cópia do banco, sessão 3 do skipnho): MediaPipe achou rosto em 97,8–100 % dos quadros dos 6 trechos, 5–7 ms/quadro; bloco de 30 s em 1,47 s de média (p95 2,05 s); 144/144 blocosdone, rosto em 85,1 % dos quadros; após calibração 114 picos, 0 no trecho calmo, 0 cortes novos de fonteface, 14 dos 21 momentos do chat comreasons.face. O rosto não separou aprovados de descartados nos cortes 10–13 — por isso é só reforço.
Rastreio de reação ao vivo (16–17/11/2026; seção "Testes de 17/11 — ao vivo" de doc/FACE_BAKEOFF.md):
cd clipper; .venv\Scripts\python -m pytest→ 170 passed enpx tsc --noEmit -p panel→ exit 0 (conferidos nesta manutenção).- Download real dos 4 modelos para pasta vazia (0,28–0,91 s cada), sha256 conferido, nenhum
.part; sha256 errado e URL 404 →FaceUnavailablecom.partapagado; arquivo corrompido → baixado de novo. - Plano B OpenSeeFace com pesos reais × MediaPipe (sessão 3, blocos 54/66/80): rosto 96,7–100 % × 94,4–100 %;
12,3–13,9 × 9,8–13,2 ms/quadro (FFmpeg + modelo ÷ 180);
sizedo OSF ~18 % menor; OSF dá sinal 0 (sem picos, sem erro). - Serviço real, instância 4521, twitch.tv/skipnho (sessão 90001, 722 s, 25 blocos, juiz
off): câmerayunetem 12/12 quadros, confiança 0,864; 25/25done, atraso de 0–1 bloco; 1,71 s/bloco (p95 2,20 s) com gravação + transcrição + chat juntos; fim do bloco → rosto gravado 1,4–9,4 s; CPU média 16,8 % de um núcleo, pico 90 % na reconstrução após reset; rosto em 99,8 % dos segundos;GET …/face200;POST …/face/reset200 (ocioso) / 202 (bloco em andamento), refez 19 blocos em ~45 s; 2 cortes do chat, um comreasons.facegrito z 12,7 (o outro, decidido durante a reconstrução, sem rosto, como desenhado). Queda dostart.batno meio → sessão retomada sozinha. - twitch.tv/lofigirl (sem câmera, sessão 90002): falso positivo achado e corrigido (gotchas, item 92); refeito →
hasWebcam: false, 8 blocosno_cam. - Painel em 127.0.0.1:4500/clipper sem erro de console; selo, interruptor e chip de reação vistos só com respostas GET alteradas no navegador (o serviço do usuário rodava o código antigo).
Editor de cortes, 1ª versão (16/11/2026):
pnpm test:clipper→ 120 passed na época.- Informado pelo coordenador, instância de teste em 127.0.0.1:4521 sobre cópia do banco (sessão 3 do skipnho, já
derrubada e cópia apagada): tempos na tabela "Medido" do README; export do corte 9 editado (início −20 s, 2 trechos
removidos, legenda
popcom palavra trocada e ênfase, gancho com caixa, zoom 1,5×, barra) = 55,6 s H.264 1080×1920 30 fps + AAC em ~9 s; corte 10 rejulgado pela IA real → projeto da IA → MP4 33,8 s em 24 s; quadros inspecionados; editor em tela cheia no Chrome sem janela sem rolagem nem erro de console;pnpm typecheckenpx tsc --noEmit -p panellimpos.
Chat por seção do perfil (16/11/2026, informado pelo coordenador, IA simulada em banco temporário): refine
com section=clip_worthy acrescentou o item, devolveu reply, recebeu 2 turnos de histórico e salvou a nota com
section; seção inválida recusada pelo pydantic; tsc --noEmit do painel limpo; import app.main ok; captura
de localhost:4500/clipper?tab=jogos com o chat aberto em "O que rende corte". IA real não testada (serviço
não reiniciado).
Perfil editável do jogo (informado pelo coordenador, banco temporário): migração até user_version 7,
save_profile deduplicou lista, refine guardou o pedido e marcou edited_at, a pesquisa recebeu as notas,
delete_note limpou; tsc --noEmit do painel limpo; import app.main ok. O serviço no ar precisa ser reiniciado
para migrar (o banco real estava em v4).
Fase 2 (17/11/2026):
pnpm test:clipper→ 46 passed (sem rede, juiz falso);pnpm typecheckenpx tsc --noEmit -p panellimpos. Conferido nesta manutenção.- Informado pelo coordenador, numa cópia do banco da live do skipnho (chat de ~0,15 msg/s):
- jogo ROB RUN pela categoria e perfil pesquisado (~15–35 s por jogo);
- webcam achada no canto inferior esquerdo (~5 s); render
cam_topde 59 s inspecionado; - varredura de 2 janelas sem falso positivo (~7 s por janela com
gpt-6-luna); - corte do lag: título "O lag jogou ele em três lugares ao mesmo tempo",
lag_ou_bug, confiança 0,93, início recuado 35 s, ~18 s nos dois juízes.
Fase 1 (16/11/2026, twitch.tv/alanzoka, sessão 2): 21 blocos (617,97 s), 490 mensagens, 4 cortes do chat aprovados
pelo codex:gpt-6-luna (notas 7,4–8,5) e 1 manual (nota 3,0) renderizado; clip-4.mp4 H.264 1080×1920 + AAC.
Não verificado:
- hashtags: juiz e pesquisa de jogo com a CLI real (o campo
hashtagsdo veredito e do perfil); UI da seção "Hashtags" contra o serviço reiniciado; - apagar: rota no serviço real do usuário; arquivo em uso no Windows (deve voltar em
left); pedido do editor em andamento gravando emedit-<id>/depois de apagar; relógio da sessão com movimento reduzido, aba escondida e larguras de 1024/1280; a faixa do topo (hojeclipper-shell.tsx) pode ainda mostrar odurationSreal (sem o relógio); - duração, gancho, reenquadramento, camadas e captura: live 2K real e HEVC real da Twitch pela captura; gravação longa em 1080p ou 2K com o serviço real; juiz e varredura reais com as durações novas; render real de um projeto feito no editor com reenquadramento e camadas comparado com a prévia (pendente, depois do reinício do serviço); camadas na capa (não entram por desenho);
- formato e retomada: juízes, varredura e "IA sugere" com a CLI real depois da mudança de prompts; retomada automática
contra live real; horizontal com NVENC e com fonte que não é 16:9; corte horizontal de ponta a ponta numa live;
gravação real do
formatpelo modal (as escritas foram interceptadas); - editor: música e efeitos com arquivo real (não há áudio em
assets/; só o filtergraph em teste unitário); arrastes com mouse humano (só por CDP, e nem todos: deslizar o corpo do clipe, arrastar texto/zoom/narração na timeline, mover texto/gancho/legenda/chat no Programa, "Editar"/"Ocultar" da transcrição, "Salvar projeto" e minimizar painéis não têm medição registrada); export real pelo serviço do usuário (4520) de um projeto comcam_only,muted,chatoucover.atStart— as escritas do teste de UI foram interceptadas, e o serviço precisa ser reiniciado para o código novo e a migração v7 (gotchas, item 73); - rastreio de reação: câmera em tela cheia, escura ou minúscula; GPU; live > 15 min (
LIVE_WINDOW_S900 s não foi ultrapassada); a linha "Rosto do streamer" chegando ao juiz analista ao vivo (juizoffno teste); interação real com o interruptorfaceTrackcontra o serviço novo (só com respostas simuladas no navegador); câmera que muda de lugar no meio da live. O serviço do usuário só pega a correção domin_cam_scoredepois de reiniciar ostart.bat; - editar/refinar perfil pela UI contra o serviço reiniciado;
refinecom IA real (com e semsearch); - a UI nova (modal do corte, aba Jogos e emotes) contra o serviço novo no ar — o serviço do usuário ainda roda o código antigo;
- juiz com a CLI do Claude (analista, editor, varredura, câmera e pesquisa);
- chat da Kick e lives do YouTube ponta a ponta; VOD; render com NVENC.