Processamento em lote
Ações de pasta partilham seleção e progresso, mas mantêm escritas diferentes. A concorrência inicial é um. Usar pasta de teste própria, verificar âmbito e destinos e só depois ampliar.
Visão geral
Barra lateral e explorador oferecem links, conceitos, títulos, tradução, texto original e reparação Mermaid/fórmulas. Não há pesquisa genérica de pasta; títulos pode incluí-la opcionalmente.
Um lote não é transação da pasta inteira. Saídas já escritas ficam após falha de outra nota ou cancelamento.
Funcionamento
Execução
- Escolher tarefa e pasta contendo apenas o material pretendido.
- Recolher documentos elegíveis conforme extensões, perfis e exclusões de saída da tarefa.
- Aplicar fornecedor/modelo da tarefa e informar progresso, falhas e destinos.
- Rever relatório e resultados ao terminar ou cancelar.
Links, conceitos, títulos, texto original e reparações incluem subpastas por padrão. Tradução inclui apenas filhos diretos. Perfis avançados podem mudar âmbito/filtros com modo de desenvolvimento e seleção avançada ativos. Confirmar o perfil real.
Substituição de saídas
| Tarefa | Verificar antes de repetir |
|---|---|
| Links | Saídas separadas; sufixo, pasta e movimento da origem |
| Conceitos | Notas existentes podem receber backlinks; duplicados são separados |
| Títulos | Escreve nas fontes elegíveis e move para complete se livre |
| Tradução | Pode substituir tradução correspondente; _<language>.md por padrão |
| Mermaid / fórmulas | Modifica notas selecionadas; testar amostra e fazer backup |
Não há opção universal ignorar/anexar/substituir. Destino complete ocupado impede o movimento, não a geração anterior. Contagens de gerados e movidos são distintas.
Concorrência
Manter batchConcurrency: 1 até validar uma amostra. Algumas rotas exigem também enableBatchParallelism; tradução usa concorrência diretamente. Aumentar pressiona fornecedor, memória e servidor, sem garantir rapidez.
Intervalos API e entre grupos reduzem picos, sem garantir cumprimento de quotas ou isolamento de outros clientes.
Ajustes
| Ajuste | Padrão | Efeito |
|---|---|---|
batchConcurrency | 1 | Concorrência solicitada onde aplicável |
enableBatchParallelism | false | Agendamento paralelo suportado |
batchSize | 50 | Tamanho de grupos nas rotas agrupadas |
batchInterDelayMs | 1000 | Espera entre grupos quando aplicável |
apiCallIntervalMs | 500 | Intervalo de chamadas concorrentes |
folderTaskIncludeSubfoldersMode | legacy | Preservar âmbito inicial de cada tarefa |
enableStableApiCall | false | Modo estável explícito |
Modelos e contexto
Aplicam-se escolhas da tarefa individual; verificar antes de conteúdo privado. Pesquisa local em lotes por títulos usa um instantâneo de leitura criado no início. Alterações posteriores não entram silenciosamente; começar outro lote para as incluir.
Exemplo
Criar duas notas de títulos em trial-titles, sem documentos alheios. Executar Gerar em lote a partir dos títulos e rever conteúdo, trial-titles_complete e contagens de gerados/movidos/erros. Repetir a pasta não é retoma exata apenas do pendente.
Cancelamento e recuperação
Cancelar impede novo agendamento e propaga-se às chamadas suportadas. Pedidos/escritas já aceites podem terminar, com cobrança controlada pelo fornecedor. Esperar, comparar saídas e conflitos e conservar cópias de recuperação até revisão.
Conselhos
- Verificar documentos realmente selecionados por perfis.
- Reduzir concorrência e consultar quotas perante 429.
- Distinguir cancelamento, falha e conclusão.
- Manter amostra intacta e backup antes de modificar.