Guia oficial do wizard
BundleWeave PRO Logo

Passo 5 — Exclusões e Segurança

Aprenda a montar filtros confiáveis, reduzir ruído no bundle e evitar exportações grandes ou perigosas sem sacrificar o controle do projeto.

Resumo rápido

match_case

Cada linha da skip list é testada contra o nome do item e também contra o caminho completo.

account_tree

Se uma pasta casar com a regra, aquele ramo inteiro deixa de ser lido.

visibility_off

Itens pulados podem aparecer como placeholder na árvore ou ficar totalmente ocultos.

warning

Safety Scan limita profundidade, quantidade de arquivos e tamanho total. Path Guard bloqueia roots e pastas críticas.

find_in_page

1. O que casa com a regra

O motor usa padrões no estilo fnmatch. Uma regra pode casar com o nome isolado do arquivo ou da pasta, ou com o caminho completo.

folder_off

2. O que acontece depois

Se uma regra atingir uma pasta, o BundleWeave PRO interrompe a leitura daquele nó. Tudo que estiver dentro dela é implicitamente ignorado.

database

3. O que entra no bundle

Arquivos de texto elegíveis entram no bundle. Binários e formatos não suportados podem aparecer só como referência, se essa opção estiver ativada.

Regras práticas para usar no dia a dia: Amplo suporte ao padrão fnmatch.

Use nomes exatos para exclusões cirúrgicas. Use wildcards para tipos de arquivo, padrões recorrentes ou filtros amplos.

arrow_downward Ver exemplo visual

Exclusão direta por nome

Quando você quer tirar uma pasta ou arquivo específico do bundle, prefira o nome exato do nó.

Recomendado

ui node_modules .git

Quando usar

Quando a sua intenção é bloquear uma pasta inteira em qualquer ponto da árvore, sem depender de barras ou caminhos completos.

Wildcards para extensões e famílias de arquivo

Quando o alvo é um padrão repetido, use wildcards simples. Eles são ideais para testes, locks, imagens, artefatos de build e segredos recorrentes.

*.log

Ignora todos os arquivos de log.

*.test.*

Ignora múltiplas variantes de arquivos de teste.

*.png

Evita anexar imagens binárias ao bundle.

*.key

Ajuda a bloquear chaves e arquivos sensíveis.

Padrões amplos e flexíveis

Padrões como *cache* ou **cache** funcionam como filtros amplos por substring. Eles são úteis quando você quer pegar múltiplas variações, mas podem excluir mais conteúdo do que o esperado.

*cache* **cache** *secret*

Use esse estilo quando sua meta é abrangência, não precisão. Para excluir uma pasta específica, continue preferindo o nome exato.

Regra de bolso

radio_button_checked

Quer bloquear uma pasta específica? Use nome exato.

radio_button_checked

Quer bloquear uma família de arquivos? Use wildcards por extensão.

radio_button_checked

Quer pegar qualquer ocorrência de um termo? Use padrão amplo com cautela.

Exemplo visual

Abaixo, um projeto genérico antes do filtro e as regras aplicadas no Passo 5.

Rules

ui *.png .env *.test.*

Leitura do motor

A pasta ui é removida como ramo inteiro; logo.png e app.test.ts são filtrados por padrão; .env sai por nome exato.

Antes

demo-project/
├── src/
│   ├── main.py
│   ├── ui/
│   │   ├── App.tsx
│   │   └── theme.css
│   ├── app.test.ts
│   └── helpers.py
├── assets/
│   └── logo.png
├── docs/
│   └── manual.md
└── .env

Depois

demo-project/
├── src/
│   ├── main.py
│   └── helpers.py
├── assets/
│   └── logo.png [Skipped/Binary]
├── docs/
│   └── manual.md
└── .env [Skipped]

Se a visibilidade de ignorados estiver em “Ocultar completamente”, os placeholders acima desaparecem da árvore.

Safety Scan e Path Guard

O Passo 5 não serve apenas para excluir ruído. Ele também protege contra exportações acidentais muito grandes, profundas ou perigosas.

Max Files

Interrompe a operação quando a contagem de arquivos de texto elegíveis ultrapassa o limite configurado.

Max Size (MB)

Evita bundles gigantescos quando o tamanho acumulado do conteúdo ultrapassa o teto definido.

Max Dir Depth

Ajuda a impedir árvores excessivamente profundas, loops ou estruturas acidentalmente enormes.

Path Guard

Bloqueia por padrão roots de disco e diretórios críticos, como C:\ e C:\Windows.

Quando um limite dispara

A exportação é abortada de forma segura. Em vez de gerar um bundle incompleto ou custoso demais, o sistema grava um pequeno arquivo explicando o motivo da interrupção.

# 🛑 SAFETY LIMITS TRIGGERED

Reason: ...

The operation was aborted to prevent accidental system overload, massive token burn, or memory exhaustion.
Recomendação opcional

Assistência opcional com IA para modularizar o projeto

Em projetos grandes ou heterogêneos, você pode usar um snapshot da árvore do repositório com uma LLM de sua preferência para gerar uma primeira proposta de regras do Passo 5. Esse uso ajuda na modularização e na redução de ruído, mas não substitui a etapa de sanitização do conteúdo final.

Esse fluxo é assistido e revisável. O objetivo não é substituir seu critério técnico, e sim acelerar a criação de uma skip list inicial que depois pode ser refinada diretamente no BundleWeave PRO. Credenciais, segredos e conteúdo sensível dentro de arquivos incluídos devem ser tratados separadamente no Content Redactor.

Quando vale a pena

auto_awesome

Monorepos, stacks híbridas ou bases com muitos diretórios auxiliares.

auto_awesome

Quando você quer modularizar dumps por objetivo: arquitetura, runtime, UI, integrações ou documentação.

auto_awesome

Quando o filtro manual ficaria repetitivo, demorado ou amplo demais.

info

Importante: filtro não é redaction

O Passo 5 ajuda a decidir o que entra ou não entra no bundle. A sanitização do texto final pertence ao Passo 6, com o Content Redactor. Use os dois em conjunto quando precisar modularização, redução de ruído e revisão de conteúdo sensível SEMPRE revise novamente senhas, segredos e outras informações sensíveis antes de usar o arquivo gerado.

Fluxo sugerido

1

Gere um snapshot da árvore e defina o objetivo do dump.

2

Peça à LLM apenas uma skip list inicial para preservar o núcleo e reduzir ruído.

3

Revise as regras, adapte ao projeto e só então aplique no Passo 5.

Exemplo de pedido

Analise o snapshot da árvore do repositório no idioma do usuário e gere apenas uma skip list otimizada em padrão fnmatch, pronta para uso, excluindo ruído sem ferir a arquitetura: use nomes exatos para remover pastas ou arquivos específicos, wildcards para famílias recorrentes de arquivos e padrões amplos com cautela; considere que cada regra pode casar tanto com o nome do item quanto com o caminho completo, e que, se uma pasta casar, todo o ramo deve ser ignorado. Remova testes, docs não essenciais, assets binários, caches, logs, builds, locks, artefatos temporários, segredos e redundâncias, mas preserve lógica central, módulos funcionais, runtime, providers, adapters, fluxo de execução e tudo que sustente entendimento estrutural do sistema.
Na dúvida, preserve código relevante e exclua apenas ruído.

x Você é responsável por revisar o arquivo final. ProtectPath e Content Redactor reduzem riscos, mas NÃO garantem a remoção completa de conteúdo sensível. SEMPRE revise novamente senhas, segredos e outras informações sensíveis.

Acknowledgements & Third-Party

BundleWeave PRO features a GitHub Linguist-style statistical output, inspired by the open-source Linguist project by GitHub. The underlying engine also leverages the capabilities of Python, Tcl/Tk, and Pillow.

Checklist rápido antes de gerar

check_circle

Use nomes exatos para exclusões cirúrgicas.

check_circle

Use wildcards para extensões, testes, locks e artefatos recorrentes.

check_circle

Deixe o Safety Scan ligado na maior parte dos casos.

check_circle

Deixe o Path Guard ligado para evitar roots e pastas críticas.

check_circle

Ative a referência de binários quando quiser contexto estrutural sem embutir o conteúdo.

check_circle

Revise o resultado final antes de compartilhar com terceiros ou com uma IA.

Precisa de ajuda?

Suporte técnico

Se algo não estiver claro, envie um relato curto com prints e o comportamento observado. Isso acelera muito o diagnóstico.

besttoolsforever@outlook.com