yinbaozong/rough-cut-wiki-video

Corte Bruto de Vídeo Wiki

Transforme um procedimento ordenado e uma pasta de gravações em um pacote de cortes brutos de tutorial não destrutivo. Aceite o texto do procedimento colado diretamente na conversa ou um arquivo UTF-8 local (texto/Markdown). Priorize evidências de fala local, recorra a nomes de arquivo, preserve todas as tomadas e use o procedimento fornecido—não narração improvisada—como fonte factual para legendas.

Fluxo de Trabalho

1. Pergunte pelo diretório de gravações e pelo procedimento ordenado. Aceite tanto o texto colado diretamente na conversa quanto um arquivo UTF-8 local (texto/Markdown); nunca exija um arquivo .md quando o texto colado estiver disponível. Não busque uma URL, a menos que o usuário peça explicitamente. Salve o texto colado sem alterações como wiki-source.md do trabalho antes de invocar a CLI.

2. Trate apenas ações ordenadas e filmadas como etapas da linha do tempo. Não peça ao usuário para adicionar listas de ferramentas, seções de preparação, contexto ou teoria que não foram filmados. Prefira Passo 1/2/3, Etapa 1/2/3 ou uma lista numerada. Mantenha observações essenciais dentro da ação onde elas se aplicam.

3. Localize este diretório da habilidade a partir do SKILL.md carregado; nunca assuma um caminho .codex, .claude ou .cursor.

4. Execute a verificação de capacidade:

   python scripts/roughcut.py doctor
   

5. Execute a análise. Use auto a menos que o usuário solicite processamento apenas por nomes de arquivo. No modo automático, extraia primeiro a trilha de áudio, transcreva com timestamps de palavras e teste se o rótulo falado está relacionado a uma etapa do procedimento antes de considerar o nome do arquivo:

   python scripts/roughcut.py run --media "E:\footage" --wiki "E:\job\wiki.md" --output "E:\job\output" --mode auto --preview
   

6. Inspecione review.md, edit-plan.json, evidências representativas e avisos. Melhore wiki-steps.json ou edit-plan.json apenas quando as evidências de gravação/procedimento suportarem a alteração. Nunca invente quantidades, objetos, ingredientes, peças, direções ou alegações de segurança.

7. Reexecute exportadores após uma mudança manual no plano (atualmente use run para reconstrução completa). Mantenha gravações ambíguas ou conflitantes e marque-as como 待確認; nunca descarte silenciosamente mídia de entrada.

8. No Windows, crie um projeto nativo do Jianying 10/11 a partir de edit-plan.json com o comando jianying10. Primeiro omita --user-data e valide em um diretório de teste. Antes de adicionar --user-data para registrar o projeto real, exija que o Jianying esteja completamente fechado. O exportador deve criptografar ambos os arquivos JSON do rascunho com videoeditor.dll local válido mais recente, fazer backup de root_meta_info.json e registrar uma entrada de página inicial correspondente. Nunca substitua um rascunho existente, a menos que o usuário autorize explicitamente.

Regras de Evidência

Use esta prioridade: correções do usuário; rótulo falado relacionado ao procedimento após o início; nome de arquivo significativo e número da parte; ordem do procedimento/OCR/contexto visual apenas para revisão. Um nome de arquivo de câmera como DJI_0001 não é um rótulo. Se a fala estiver vazia ou não relacionada a nenhuma etapa do procedimento, tente o nome do arquivo. Se nenhum dos dois fornecer evidência relacionada ao procedimento, pare em vez de adivinhar e peça ao usuário para gravar um rótulo de etapa falado ou renomear o arquivo. Preserve tomadas repetidas e ordene partes explícitas antes do tempo de gravação. Coloque outro material não correspondente no final da linha do tempo e liste etapas do procedimento não filmadas apenas no relatório.

Sinais de início são 321开始, 三二一开始, 321走 ou 开始/走 isolados. Sinais de fim são OK, 过, 可以, 好了 ou 结束 isolados. Não corte palavras no meio da frase como 可以安装 ou 开始拆卸. O final do arquivo é um término válido de tomada.

Legendas e Saídas

Crie legendas formais a partir do procedimento fornecido, polindo levemente a sintaxe para leitura natural. Mantenha nomes, contagens, direções e avisos declarados nas etapas. Use duas faixas independentes e removíveis: 文档字幕 e texto exato 待確認. Mantenha o áudio original e os arquivos 4K originais intocados.

O contrato de saída e as definições dos campos JSON estão em schemas.md. Leia usage.md para detalhes de plataforma/configuração e jianying10.md antes de registrar um projeto Jianying. Ao ajudar com convenções de captura, leia shooting-guide.md, filename-guide.md e wiki-format.md.

Tratamento de Falhas

Use apenas o modelo multilíngue small do faster-whisper. Não substitua por tiny. Se o small estiver ausente ou incompleto, pare a análise de fala e mostre o comando único scripts/download-model.ps1 ou scripts/download-model.sh para reparo. Para outras falhas de reconhecimento ou OCR, preserve toda a mídia, use as evidências restantes e registre a alternativa em review.md. Se o FFmpeg estiver ausente, ainda emita o plano, SRT, FCPXML e candidato a rascunho; omita a pré-visualização. Se a criptografia ou registro do Jianying falhar, preserve o rascunho de teste, diagnósticos, SRT, FCPXML e edit-plan.json; nunca substitua, faça downgrade ou desinstale automaticamente o Jianying do usuário.