Cadeia de Análise de Arquivos de Competição

Use esta habilidade apenas como uma especialização downstream depois que $ctf-sandbox-orchestrator já estiver ativa e tiver estabelecido suposições de sandbox, propriedade de nós e prioridades de evidências. Se isso ainda não aconteceu, retorne para $ctf-sandbox-orchestrator primeiro.

Use esta habilidade quando a parte difícil for seguir um arquivo desde a entrada até cada limite de parser, extrator, conversor ou desserializador que importa.

Responda em chinês simplificado, a menos que o usuário solicite explicitamente o inglês.

Início Rápido

1. Preserve o upload original e cada artefato derivado separadamente.
2. Mapeie a cadeia em ordem: entrada, armazenamento temporário, extração de arquivo, conversão de formato, chamada de parser, desserialização e consumidor final.
3. Registre nomes de arquivos, suposições de MIME, extensões, caminhos temporários e escolhas de parser antes de modificar qualquer coisa.
4. Separe a validação visível para o cliente do comportamento do parser de backend.
5. Reproduza a menor cadeia de processamento de arquivos que produz o ramo ou artefato decisivo.

Fluxo de Trabalho

1. Mapear Entrada e Derivação de Arquivos

• Registre a forma da requisição, nomes multipart, tipo de conteúdo, nome do arquivo, caminhos temporários, staging do upload e chaves de armazenamento.
• Anote cada artefato derivado: membro de arquivo extraído, preview convertido, thumbnail gerado, documento temporário ou objeto desserializado.
• Mantenha o arquivo original e cada derivado rotulados separadamente.

2. Rastrear Limites de Parser e Conversão

• Mostre qual parser, conversor, extrator ou desserializador é executado em cada etapa.
• Registre decisões específicas do parser impulsionadas por extensão, MIME, bytes mágicos, esquema, nomes de membros de arquivo ou metadados incorporados.
• Distinga sucesso de parsing, sucesso de preview, sucesso de conversão e aceitação de lógica de negócios.

3. Reduzir à Cadeia de Arquivos Decisiva

• Comprima o resultado para a menor sequência: upload -> artefato derivado -> limite de parser -> efeito resultante.
• Declare claramente se a fraqueza decisiva reside no manuseio de arquivos, inferência de MIME, conversão de arquivos, resolução de caminhos ou desserialização.
• Se a cadeia se tornar principalmente um problema genérico de worker assíncrono após o enfileiramento, passe para a habilidade de fila ou worker mais específica.

Leia esta Referência

• Carregue references/file-parser-chain.md para a lista de verificação de entrada, lista de verificação de parser e empacotamento de evidências.

O Que Preservar

• Uploads originais, arquivos derivados, caminhos temporários, chaves de armazenamento, nomes de parsers e etapas de conversão
• O limite exato onde o comportamento de backend diverge da validação visível para o usuário
• Uma sequência mínima e reproduzível de processamento de arquivos que atinge o efeito decisivo