Cortar Vídeo ao Vivo
De um vídeo para um livro de palavras deletadas revisado manualmente (Cortes + EDL), sem tocar nos arquivos de mídia. Sete etapas em linha:
0 Pronto Referência à verificação de prontidão de "Verificar Atualizações" (esta Skill não possui lógica de ambiente)
1 Criar projeto Vídeo real → Transcrição palavra por palavra na nuvem → Criar projeto no produto → Iniciar serviço → Ler status de volta
2 Corrigir palavras Dicionário corrige palavras erradas (um geral + um do usuário) → Gerar tabela de correções
3 Deletar palavras Ler preferências e regras → Cinco varreduras, cada uma apenas um tipo, apenas registra linhas
4 Resumir Tabela de resumo de deleções + Tabela de frases repetidas → Verificar auto-leitura conforme tabela
5 Revisar Enviar tudo → Duas tabelas apresentadas ao usuário → Abrir Studio para revisão pessoal
6 Revisar e passar bastão Comparar proposta e versão final → Arquivar três gavetas → Relatar quatro coisas
Não cortar mídia: Alterar o livro uma vez leva dezenas de milissegundos; cortar uma vez é um arquivo irreversível. Ao final desta Skill, não há novos vídeos no disco. A Skill faz julgamentos semânticos e organização; o Runtime do produto é o único escritor dos estados do projeto, Cortes e Studio.
Usuário fala apenas em três lugares: Escolher continuar ou recomeçar no projeto de mesma origem (apenas quando já cortado), revisão no Studio, confirmação de conclusão. O restante é sempre relatório unidirecional, sem parar para esperar resposta. O critério de conclusão de cada etapa é seu produto: se a tabela não saiu, não está concluído.
Primeiro, leia e execute o Contrato de Fase da Skill de Negócio. Correspondência entre etapas deste documento e fases do contrato: 1=preflight+Product state readback, 5=proposal+Product CAS, revisão=project-level review binding. As três fases seguintes do contrato (confirmação, execução, aceitação) pertencem à Skill de exportação.
As origens dos acidentes de cada regra estão no Livro de Acidentes——regras no texto principal, histórias lá.
0. Pronto
Primeiro, execute a "Verificação de Prontidão" do Verificar Atualizações——se as skills estão
atualizadas, se o Runtime é compatível; a raiz do plugin também é localizada lá (os <raiz-do-plugin> nos comandos deste documento substituem
esse caminho literal). Só continue se obtiver "Pronto"; se for "Nova sessão necessária" ou "Parar", siga sua disposição
(incluindo a proibição "Proibido criar interface substituta própria").
Se o resultado de prontidão for runtime.kind=desktop-managed, ele compartilha a mesma entrada estável e
serviço launchd/windows-task com a instalação CLI; continue diretamente; não procure diretório de instalação do Electron, instale outro Bun /
FFmpeg, ou inicie um segundo Runtime.
1. Criar Projeto: Entrada real → Transcrição → Criar Projeto no Produto
O que faz: Entrega o vídeo local real do usuário e a transcrição palavra por palavra na nuvem ao produto, cria o projeto atomicamente, inicia o serviço, lê o status de volta.
# Após transcrição palavra por palavra na nuvem (gerando candidatos de transcrição no diretório da tarefa):
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" project create "<diretório-do-projeto>" --video "<arquivo-de-vídeo-no-diretório-da-tarefa>" --transcript "<transcrição-palavra-por-palavra-no-diretório-da-tarefa>" --json
node "<raiz-do-plugin>/scripts/ensure-running.cjs" --json # Produto garante serviço residente (5190) declarativamente
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" workflow get "<diretório-do-projeto>" --json # Product state readback
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" cuts get "<diretório-do-projeto>" --json
Regras:
- Aceite apenas vídeos de fala ao vivo reais fornecidos pelo usuário ou projetos reais existentes; sem mídia real, pare, proibido usar exemplos, vídeos placeholder como substitutos
- A transcrição usa apenas o ASR na nuvem autorizado no ambiente atual; proibido reverter para ASR local; se nenhum ASR na nuvem estiver disponível, reporte
missing_cloud_transcription_adapter, não abra Studio, não falsifique transcrição --video/--transcriptdevem ser arquivos reais dentro do diretório da tarefa; não passe proporção de tela——o produto a derivará automaticamente do tamanho real do vídeo (Runtime 0.4.4+). Adicione--aspect-ratio W:Hapenas se o usuário explicitamente solicitar proporção especial- Para projetos padrão existentes, primeiro
inspectpara confirmar e reutilizar, não crieprojectIdduplicado; quando o mesmo vídeo já foi cortado, pergunte ao usuário: continuar de onde parou ou recomeçar (este é um dos três pontos de fala).project prepareé um compilador idempotente, usado apenas ao retomar de interrupção ou refresh explícito; se interrompido, basta reexecutar project createé a única entrada: não passe por biblioteca de mídia, sessão de upload ou Skill extra; Skill não deve escreverproject.jsonprimeiro- O serviço deve ser confirmado pelo script como
healthy=true,runtimeMode=launchd(macOS) ouruntimeMode=windows-task(Windows), versão compatível, URL canônico 5190 antes de continuar; falha passa erro estruturado e para, proibido reverter para foreground, mudar porta, matar processos desconhecidos - As duas readbacks devem apontar para o mesmo
projectId, salvar workflow stage e as três revisões de Project / Cuts / EditList; falta ou inconsistência para
2. Corrigir Palavras: Corrigir palavras, gerar tabela de correções
O que faz: Antes de qualquer julgamento de deleção, corrige palavras erradas pela transcrição usando dicionários——se a palavra estiver errada, o julgamento posterior estará errado; palavras erradas não são palavras extras, a deleção não pode corrigi-las.
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" transcript dictionary "<diretório-do-projeto>" --dictionary "<raiz-do-plugin>/references/ai-term-dictionary.md" --json
Use sua ferramenta de arquivos para verificar se $HOME/.chengfeng-videocut/dictionary.md existe; se existir, execute novamente
(medida transitória: CLI atualmente aceita apenas um arquivo, execute duas vezes; ele só pode complementar, não desfazer o anterior——
aguardando fusão completa de múltiplos dicionários com prioridade do usuário):
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" transcript dictionary "<diretório-do-projeto>" --dictionary "$HOME/.chengfeng-videocut/dictionary.md" --json
Produto: Tabela de correções——mesclar as listas applied retornadas das duas chamadas em uma pequena tabela (palavra original → corrigida para →
contexto), reportar ao usuário. Depois de corrigir, veja esta tabela——o dicionário também pode corrigir errado sem contexto; se vir algo errado, corrija o
dicionário, não aplique patches em outro lugar.
Somente se o dicionário não puder resolver e o autor tiver o roteiro em mãos, adicione um alinhamento de contexto:
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" transcript align "<diretório-do-projeto>" --script "<arquivo-do-roteiro>" --json # Apenas relata, não corrige
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" transcript correct "<diretório-do-projeto>" --file "<arquivo-de-correção>" --json
Regras:
- Apenas mude texto, não mude tempo, número de palavras, wordId——o produto compara timestamps palavra por palavra; se mexer, rejeita diretamente
- Apenas mude escrita, não mude significado——se realmente disse errado e repetiu, são frases truncadas ou reformulações, pertencem à deleção
- Se o dicionário não tiver e o roteiro não confirmar, não adivinhe: reporte para a pessoa preencher o dicionário. Colocar um nome inventado é pior do que deixar um nome ouvido errado
- Mantenha a fala coloquial chinesa como original: se disse "叉" ou "大模型", é o que ele disse
- O dicionário é uma barreira a ser passada a cada transcrição (a mesma faixa de áudio transcrita duas vezes dá resultados diferentes, veja o livro de acidentes)
Roteiro segmentado por pontuação: Cada palavra na transcrição tem pontuação; roteiro um parágrafo por vírgula, uma linha por frase; legenda
consome a mesma pontuação, ambos os lados com quebra consistente. Projetos antigos antes de 2026-07-28 não têm pontuação; execute
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" transcript regroup "<diretório-do-projeto>" --json para re-segmentar parágrafos (verifica id/tempo/texto
palavra por palavra inalterado, seguro para projetos já cortados); se realmente quiser pontuação, precisa retranscrever——a pontuação simplesmente não existia na transcrição antiga.
3. Deletar Palavras: Cinco varreduras, cada uma apenas um tipo
O que faz: Leia o material, depois leia a ordem de reprodução completa cinco vezes, cada vez com um critério. Ler com um critério de cada vez tem qualidade de julgamento muito superior a ler com seis critérios simultaneamente; cada rodada produz pouco e é verificável.
Primeiro, leia o material:
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" transcript playback "<diretório-do-projeto>" --json
Depois, use sua ferramenta de leitura de arquivos para ler $HOME/.chengfeng-videocut/cut-preferences.md (preferências do usuário,
ele disse; se o arquivo não existir, é novo usuário, pule).
Critérios em Regras de Deleção Semântica (princípios + casos). Prioridade dos materiais de ensino: Preferências do usuário > Casos do usuário > Casos gerais.
Rodada 1 Repetição Repetição entre frases, repetição dentro da frase (mais objetiva: duas vezes iguais)
Rodada 2 Frases truncadas e reformulações Falar pela metade e parar, reformular
Rodada 3 Erro e repetição Números errados, nomes próprios, palavras ditas erradas e corrigidas depois
Rodada 4 Engasgo em inglês Repetição de início de palavra / letra / sílaba
Rodada 5 Muletas e interjeições Mais subjetivo, de acordo com a densidade e tolerância da preferência do usuário
Ação fixa de cada rodada: consultar casos conforme tipo da rodada → quando encontrar um, registre uma linha (wordIds + tipo + risco) → não decida outros tipos. Em rodadas posteriores, pule palavras já marcadas; conflitos resolvidos no resumo.
Regras:
- Julgamento usa apenas a ordem de reprodução de
transcript playback, não monte você mesmo a partir detranscript.json—— "disse duas vezes" depende de serem adjacentes na reprodução; montar você mesmo pode ler números pulados como falta de conteúdo e erroneamente negar - Deleção tem apenas dois estados: "deletado / não deletado"; razão AI não forma terceiro estado "sugerir deletar"
- Erro, repetição, frase truncada: padrão deletar anterior, manter posterior; frases longas, frases inteiras, reformulações bifurcadas devem ser revisadas com alto risco
- Pausas comuns não são calculadas pela Skill: fusão de silêncios adjacentes e
natural-pause-v2são executados deterministicamente pelo produto
4. Resumir: Duas tabelas, só agir quando as tabelas saírem
O que faz: Mesclar as linhas das cinco rodadas em duas tabelas——este é o produto desta etapa e também o que o usuário vê.
Tabela de resumo de deleções (decisões de deleção item por item):
| # | Tempo | Tipo | Deletado | Restante lido | Risco | Base |
|---|---------|--------|-----------------------|------------------------|------|-----------|
| 1 | 00:12 | Repetição | 这个功能呢 | 这个功能它其实 | Baixo | Caso R2 |
| 2 | 02:31 | Reformulação | 比如我就让他跟踪 | 比如我让grok跟踪 | Alto | Caso R5 |
Tabela de frases repetidas (frases ditas várias vezes; a tabela palavra por palavra não mostra "quantas vezes gravou, qual manteve", e é exatamente isso que o usuário mais quer conferir):
| Frase (início) | Quantas vezes dita | Qual manteve | Quais deletou | Risco |
|----------------------|--------------------|---------------------|-----------------|------------------|
| Porque hoje tem… | 3 | 3ª vez 00:08 | 1ª, 2ª vezes | Baixo——três vezes basicamente iguais |
| A maioria dos Agentes pode pesquisar… | 2 | 2ª vez 04:40 | 1ª vez | Alto——duas vezes com diferenças, foco em ouvir |
Depois, auto-leitura: Leia o texto completo após deleção na ordem de reprodução conforme a tabela; cancele linhas que não soarem bem. Esta é a definição de re-verificação: AI olha novamente, não pergunta ao usuário; se não tiver certeza = não liste (dois estados).
5. Revisar: Só abrir Studio quando for revisão manual
O que faz: Enviar candidatos completos, apresentar as duas tabelas ao usuário, depois abrir a página de revisão do produto para o usuário revisar pessoalmente.
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" cuts get "<diretório-do-projeto>" --json # Pegar revisão do Cuts
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" cuts set "<diretório-do-projeto>" --file "<arquivo-de-proposta>" --expected-revision "<revisão-atual-do-Cuts>" --json
Candidato referencia apenas wordIds estáveis:
{
"schemaVersion": 1,
"cutWordIds": ["word-12", "word-13"],
"reasons": [
{ "wordIds": ["word-12", "word-13"], "kind": "repeat", "risk": "low" }
]
}
Regras de submissão:
- Candidato é a conclusão completa do julgamento desta rodada, não incremental——
cuts seté semântica de substituição; enviar incremental silenciosamente descartará a deleção semântica da rodada anterior (veja livro de acidentes); ao enviar candidato, proibido ler ou mesclar manualmenteinitialization.baselineCutWordIds(o produto automaticamente incorpora a linha de base de pausa) reasonssão persistidos, escritos honestamente; o produto cortará partes mencionando palavras não deletadas- Não escreva diretamente
cut-selection.json,project.jsonou logs de evento cuts get.data.revisioné a revisão do Cuts,workflow get.data.revisioné do projeto, proibido misturar- Após submissão bem-sucedida, veja obrigatoriamente
noLongerCut(número de palavras não mais deletadas desta vez): se diferente de zero e não for retirada intencional = submeteu incremental, volte e reenvie completo; também veja se ler"unknown" - Em seguida, imediatamente execute
workflow get+cuts getnovamente, confirmecut_review_readye as três revisões; inconsistência para, nunca escreva JSON diretamente ou sobrescreva automaticamente - Após submissão, deixe
<arquivo-de-proposta>no diretório da tarefa——a etapa 6 de revisão precisa dele (reasons são cortadas pelo produto após edição do usuário; reverter do livro após o fato não é confiável)
Depois, primeiro apresente tabelas, depois abra página: Envie as duas tabelas ao usuário, deixe ele entrar no Studio com as tabelas para revisão.
node "<raiz-do-plugin>/scripts/ensure-running.cjs" --json # Antes de abrir, garanta idempotente novamente
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" open "<diretório-do-projeto>" --json # Pegar URL do projeto retornado pelo produto
node "<raiz-do-plugin>/scripts/ensure-studio.cjs" --url "<URL-do-projeto-produto>" --view koubo --json # Portão de capacidade: confirmar que 5190 registrou visualização koubo
Regras:
- Só se o portão retornar
ok=trueuse o navegador embutido do Codex para abrirstudio.url, então pare o avanço automático, espere o usuário marcar palavras, restaurar, salvar - Antes de abrir, compare estritamente
productUrlcom#project/<projectId>e oprojectIdda readback, e vinculestage=cut_review_readycom as três revisões——ok=truedo portão apenas prova a capacidade do produto, não pode substituir o vínculo no nível do projeto; qualquer inconsistência execute readback novamente studio_capability_missing: Pare e explique incompatibilidade de versão, pode sugerir$chengfeng-report-bug; proibido assumir que nova interface existe só porque URL contém?view=koubo, proibido reverter para painel de tarefa antigo- Não tome "abrir estação de trabalho" como primeiro passo da tarefa; não acesse
review.htmlantigo, 8898/8899; não controle DOM do Studio, não modifique elementos de mídia diretamente; não crie trilha de áudio independente ou trilha de legenda placeholder
6. Revisar e Passar Bastão: Trabalho corrigido pelo usuário não deve ser descartado
Após o usuário concluir a revisão, primeiro leia de volta:
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" workflow get "<diretório-do-projeto>" --json
node "<raiz-do-plugin>/scripts/videocut-cli.cjs" cuts get "<diretório-do-projeto>" --json
Revisão (medida transitória, substituída após lançamento do comando cuts diff do produto): Compare o <arquivo-de-proposta> retido da etapa 5 com os cutWordIds finais lidos de volta——
- O que o usuário restaurou (presente no proposta, ausente na versão final) = AI deletou errado. Consulte a razão que você mesmo escreveu na proposta: em qual tipo errou?
- O que o usuário deletou a mais (presente na versão final, ausente no proposta, e também não na linha de base de pausa
initialization.baselineCutWordIds) = AI perdeu. Pergunte: a que tipo pertence, por que não foi identificado? (A linha de base só é usada aqui para filtrar palavras de pausa; ainda proibido mesclá-la na submissão)
Arquivar três gavetas:
- Diferença de gosto → Anexar a
~/.chengfeng-videocut/cut-preferences.md(markdown mantido pelo Agent, apenas anexa e reescreve sua própria seção; cria arquivo se não existir) - Erro de nome próprio → Anexar a
~/.chengfeng-videocut/dictionary.md(tabela de duas colunas, verificar duplicatas antes de anexar) - Lacuna de regra → Anotar uma linha na seção "Casos a serem atualizados" do arquivo de preferência; na terceira vez que ocorrer, reportar ao usuário, sugerir atualizar para caso geral (só mexer no repositório de skills após revisão humana)
- Também anotar zero diferença: arquivo de preferência registra uma linha de "Adoção total"
Relatar quatro coisas: Quantas palavras deletadas, quantos segundos a menos; estágio atual (deve ser cut_review_ready);
três revisões de projeto / Cuts / EDL; resumo da revisão (N itens na proposta, adotados X restaurados Y deletados a mais Z,
principal divergência em uma frase). Depois, diga ao usuário para executar a exportação.
Não exibir cartão de confirmação, não executar corte——O cartão de confirmação de corte físico pertence à Skill de exportação; aquele cartão deve congelar a revisão no momento em que o usuário pressiona confirmar.
return_cut_review: Primeiro execute node "<raiz-do-plugin>/scripts/ensure-running.cjs" --json novamente, depois retorne ao mesmo Studio para continuar revisão;
não acione revisão, revisão é feita apenas uma vez no final.
Níveis de relatório: Revisão estruturada do Produto é API/readback PASS; revisão real de quadro do navegador é visual frame PASS; se ninguém realmente ouviu, é human listening UNVERIFIED, não use reprodução, DOM, captura de tela ou detecção de mídia como substituto.
Recuperação e Falha
revision_conflict: Releia o estado, explique a edição que o usuário acabou de fazer, não sobrescreva automaticamenteruntime_unhealthy: Não reinstale em loopservice_identity_mismatch/service_port_conflict: Pare, não reverta para foreground, não troque de porta, não mate processos desconhecidos- Página fechada mas serviço ainda em execução: Leia workflow e continue do estado atual, não crie novo projeto
- Qualquer falha não pode ser relatada como "livro já escrito" como "já cortado"——até este ponto, nenhum arquivo de mídia foi gerado
Nota: Esta Skill aceita vídeo local real e transcrição palavra por palavra na nuvem diretamente no produto; este é o requisito do contrato preflight; ambos existirem realmente é pré-requisito para todos os julgamentos.