Communitygithub.com

Chengfeng Cut — tira tropeços do vídeo falado

Edita material bruto falado para a câmera em chinês sem tocar no arquivo: transcrição palavra por palavra, correções por dicionário, cinco varreduras para tropeços e frases repetidas, tabelas de resumo e revisão humana no Studio. Gera um único registro de cortes revisado (Cuts + EDL) usado pelas etapas de legenda e exportação.

O que é Chengfeng Cut — tira tropeços do vídeo falado?

Short-form Editing, passo 1 (cortar): video-skill-ku-chengfeng-cut, do plugin Codex chengfeng-videocut. Transcrever → corrigir termos → cinco varreduras de objetivo único (lapsos, recomeços, repetições) → tabela resumo e de frases duplicadas → revisão no Studio → aprende suas preferências. Nenhum arquivo é cortado até a exportação, então tudo é reversível.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-cut

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 / --transcript devem 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:H apenas se o usuário explicitamente solicitar proporção especial
  • Para projetos padrão existentes, primeiro inspect para confirmar e reutilizar, não crie projectId duplicado; 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 escrever project.json primeiro
  • O serviço deve ser confirmado pelo script como healthy=true, runtimeMode=launchd (macOS) ou runtimeMode=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 de transcript.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-v2 sã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 manualmente initialization.baselineCutWordIds (o produto automaticamente incorpora a linha de base de pausa)
  • reasons são persistidos, escritos honestamente; o produto cortará partes mencionando palavras não deletadas
  • Não escreva diretamente cut-selection.json, project.json ou 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 get novamente, confirme cut_review_ready e 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=true use o navegador embutido do Codex para abrir studio.url, então pare o avanço automático, espere o usuário marcar palavras, restaurar, salvar
  • Antes de abrir, compare estritamente productUrl com #project/<projectId> e o projectId da readback, e vincule stage=cut_review_ready com as três revisões——ok=true do 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.html antigo, 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 automaticamente
  • runtime_unhealthy: Não reinstale em loop
  • service_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.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

Habilidades Relacionadas