Documentação de Uso

Esta documentação descreve a versão atual do plugin: após carregar o plugin (TFAITools.dll),a paleta lateral abre sozinha com a abertura de um projeto (ou digite TFAI para reabrir); as ações (LOGIN, WATCH, STAMP, CADINVENTORY, ASK, etc.) são botões nessa paleta ou comandos diretos no CAD.

Pré-requisitos

Baixe o TFAIToolsSetup.exe (v1.3.22.3),execute e o instalador baixa o plugin, verifica WebView2 e instala na pasta de plugins do CAD. Para remover, abra o mesmo instalador e clique em Desinstalar (ou TFAIToolsSetup.exe --uninstall).

O Setup desbloqueia as DLLs automaticamente. Se aparecer erro 0x80131515 / loadFromRemoteSources, feche o CAD, desbloqueie a DLL (Propriedades → Desbloquear) e abra o CAD de novo.

Requer WebView2 Evergreen Runtime, conta válida neste site e licença ativa.

Conta e licença

Use TFAI → botão LOGIN para vincular o plugin à sua conta do site. Os demais botões exigem licença ativa.

Fluxo recomendado: TFAI → LOGIN → demais ações na paleta.

Copiloto / linter em tempo real

O modo watch observa o fim de comandos de edição, aplica regras determinísticas no model space e, se houver token de IA, pode pedir uma explicação curta.

1. TFAI → LOGIN
2. WATCH na paleta (alterna ON/OFF)
3. Desenhe normalmente — alertas aparecem após ~1,5 s de debounce
4. SCAN para varredura manual; aba Alertas (ou botão ALERTS) para o painel

Regras gerais: comprimento ~0, geometria em Defpoints, layers genéricas (Layer* / 0),segmentos quase coincidentes.

Pacotes por disciplina (MEP / Estrutural / ANA Saneamento)

O SCAN/WATCH aplica pacotes por prefixo de layer. Alertas mostram as tags MEP, ESTRUTURAL ou ANA na aba Alertas.

MEP (defaults): layers que começam com MEP-, HVAC-, ELEC-, EL-, PLUMB-, HID-, FIRE-, SPRINK-. Regra: sobreposição de bbox entre layers MEP distintos (MEP_OVERLAP).

Estrutural (defaults):STR-, STRUC-, EST-, VIGA, PILAR, LAJE, FUND-. Regras: comprimento ~0 (STR_ZERO_LENGTH),sobreposição entre layers estruturais distintos (STR_OVERLAP),geometria pesada em Defpoints (STR_ON_DEFPOINTS).

ANA / Saneamento (defaults e COPASA): layers genéricas (AGUA, RDAGUA, …) e padrão COPASA de cadastro RDA (ex. Caratinga): BSRDATR05EQASPVZR-003 (= rede DN 50 mm PVC),BSRDAID10EQASFF… (FoFo),BSAATTR60EQASFF… (adutora). O código de 2 dígitos após o prefixo é DN/10; material vem colado após EQAS/EQTE (PV/FF/CA/FC). Regras: ANA_NO_DIAMETER, ANA_NO_MATERIAL, ANA_SHORT_SEGMENT, ANA_OPEN_NETWORK, ANA_UNITS.

Módulo ANA / MCPSB (Inventário Patrimonial de Saneamento)

Atende às exigências da Norma de Referência da ANA (Manual de Controle Patrimonial do Saneamento Básico — Lei 14.026/2020 / prazos 2030–2032):

• CADINVENTORY — Lê geometrias lineares (linhas e polilínias),calcula comprimentos reais em metros via INSUNITS, extrai DN e material das layers, aplica georreferenciamento (SIRGAS2000 / WGS-84) e exporta planilha CSV pronta para entrega regulatória.
• Suporte integrado a padrões de concessionárias (ex.: COPASA, SABESP, SANEPAR) para reconhecimento automático de redes, formatos e carimbos.

Automações de Produção (Carimbo e Articulação)

• STAMP — Preenchimento e formatação inteligente de carimbos/titleblocks (reconhece blocos CARIMBO, TITLE, SELO, FOLHA, COPASA, FRLEGEN*, FRFORM*). Pré-carrega dados existentes do bloco, permite edição rápida campo a campo e atualiza todos os layouts.
• ARTICULATE — Numeração sequencial de folhas e layouts de Paper Space (ex.: EST-01, HID-02) com suporte a ordenação por abas, posição geográfica (esquerda→direita / cima→baixo) ou alfabética, além de tabela de articulação opcional no Model Space.

Gestão de Projetos e Armazenamento

PROJECTMGR — Sistema de indexação e busca inteligente de arquivos DWG/DXF no Windows. Varrer pastas cadastradas, extrai metadados (disciplina, cliente, data, tamanho) e permite pesquisar e abrir arquivos diretamente pelo CAD sem depender do Windows Explorer.

Digitalização e Smart Tools

• DIGITIZE — Assistente de digitalização e vetorização de plantas e rascunhos escaneados. Oferece calibração geométrica de 2 pontos (calcula escala, rotação e translação para o comando ALIGN) e criação instantânea de 8 layers padrão de vetorização.
• TRACIMAGE — Vetoriza linhas sobre mapas, ortofotos ou imagens raster no desenho (ex.: eixos de vias, redes de água/esgoto, quadras e limites de lotes). Envia a imagem à IA (vision_trace) e cria polylines na layer DIGIT_VIAS_EIXO.
• SMARTINSERT — Catálogo e atalhos rápidos das ferramentas de produtividade do CAD / Express Tools (BURST, NCOPY, BCOUNT, EXTRIM, FLATTEN, OVERKILL, TXT2MTXT, TCOUNT, LAYDEL, LAYMRG) com contagem de frequência de uso.

Checklist de entrega (QA)

O botão CHECKLIST corre um pacote determinístico de QA com códigos CHK_* e score %: unidades (INSUNITS),layer de carimbo/título (inclui padrões COPASA FRLEGEN*/FRFORM*),XREF não resolvido, comprimento ~0, Defpoints, model vazio, layers Frozen/Off importantes e viewports em paper space quando há layouts. Bloqueantes = ERROR; avisos = WARN. O resumo do score aparece na aba Alertas.

Auto-fix sugerido

Um subconjunto de alertas traz Aplicar correção (só após clique; nunca automático): mover Defpoints → layer 0 ou último layer de utilizador; apagar comprimento ~0 (com confirmação); renomear/mover layer só com mapeamento exacto configurado. A DLL aplica com DocumentLock + uma transação (UNDO-friendly).

Diff visual entre revisões

A primeira SCAN da sessão grava automaticamente uma baseline. Use BASELINE (nota opcional) para forçar nova; DIFF gera DIFF_ADDED / DIFF_REMOVED / DIFF_CHANGED, destaca automaticamente adicionados/alterados, mostra status +N / −M / ~K e chips de filtro na aba Alertas. Removidos listam o handle (não dá para destacar entidade inexistente).

RAG de NBR / padrão do escritório

Com SETENDPOINT 0 (proxy),o ASK recebe trechos relevantes com citações (arquivo + seção),escopados à sua conta de cliente autenticado. Na paleta, a seção Normas / Exemplos permite: (1) Baixar exemplos — ZIP com arquivos didáticos nbr-exemplo-*.md e um README (não são texto legal completo de NBR); (2) enviar os seus .md / .txt / .pdf (após LOGIN),que ficam na sua pasta de cliente e são reindexados de imediato para o próximo ASK. Também pode gerenciar a lista (remover) nessa seção.

Baixar exemplos didáticos (ZIP)

Como carregar a DLL

Use o instalador. A paleta abre no load; TFAI reabre se fechar.

Ferramentas do Plugin

A paleta TF AI (abas Ferramentas, Alertas e Resultados) já abre com a abertura de um projeto; digite TFAI para reabrir. A aba Resultados espelha a saída do console (útil no CAD, onde o prompt mostra ~3 linhas). Não há subopções na linha de comando: escolha a ação pelos botões da paleta ou execute os comandos diretos no CAD:

• STAMP — preenche carimbo/titleblock com diálogo interativo e pré-preenchimento
• ARTICULATE — numera folhas/layouts em sequência de articulação
• CADINVENTORY — exporta inventário MCPSB (ANA) de redes de saneamento em CSV
• PROJECTMGR — pesquisa e gestão de arquivos de projetos DWG/DXF no computador
• DIGITIZE — calibração de 2 pontos (escala/rotação) e criação de layers de digitalização
• TRACIMAGE — linhas sobre mapa/imagem via IA (vias, redes de água e esgoto, urbanização)
• SMARTINSERT — catálogo inteligente e atalhos de ferramentas Smart Tools / Express Tools
• WATCH — liga/desliga o copiloto contínuo em tempo real (alterna ON/OFF)
• SCAN — varredura manual das regras de qualidade (MEP, estrutural, ANA)
• CHECKLIST — QA de entrega com score % (CHK_*)
• DIFF — diff visual vs baseline (+N / −M / ~K)
• BASELINE — grava baseline do desenho
• ALERTS — abre a aba de alertas
• RESULTS — abre a aba de resultados (log do plugin)
• ASK — pergunta em texto livre à IA com RAG de NBR
• DRAW — gera comandos CAD nativos
• LISP — gera e carrega LISP
• CLEAR — limpa histórico do LISP
• TEST — testa conexão com a IA
• LOGIN — vincula conta e licença
• SETTOKEN / SETENDPOINT / SETMODEL — configuração avançada de IA

1. LOGIN

Salva token da conta do site (exige licença ativa). Se o endpoint estiver vazio, grava 0 (proxy do plugin). Caso contrário, mantém o SETENDPOINT já configurado (menu 0–8).

2. WATCH

Na paleta, o botão WATCH alterna o copiloto contínuo (ON ↔ OFF) e mostra o status no console. Com ON, após comandos de edição (exceto zoom/pan/salvar etc.) o plugin faz scan com debounce de ~1,5 s e atualiza a aba Alertas.

3. SCAN

Varredura manual imediata das regras de qualidade no model space (gerais + pacotes MEP/estrutural/ANA). A primeira SCAN da sessão grava baseline se ainda não houver. Alertas elegíveis podem oferecer Aplicar correção.

4. CHECKLIST

QA de entrega com score % e alertas CHK_* (tag CHECKLIST). Verifica unidades, layers obrigatórias de carimbo (incluindo COPASA FRLEGEN*/FRFORM*),XREFs, Defpoints e viewports. Resumo na aba Alertas.

5. DIFF

Compara com a baseline, destaca +/~ no desenho, lista removidos e mostra +N / −M / ~K. Chips Added / Removed / Changed na aba Alertas.

6. BASELINE

Grava o snapshot atual como baseline (substitui a anterior). Pode pedir uma nota opcional exibida no status do DIFF.

7. STAMP

Preenchimento e formatação automática de carimbo/titleblock. Busca o bloco de carimbo no Model Space e em todos os Paper Spaces, pré-carrega os atributos existentes e apresenta diálogo para edição rápida de Projeto, Escala, Revisão, Folha, Responsável e Cliente.

8. ARTICULATE

Numeração automática de folhas/layouts em sequência de articulação (ex.: EST-01, HID-002). Suporta ordenação por abas (TabOrder),geográfica (esquerda→direita, cima→baixo) ou alfabética. Atualiza o atributo NR_FOLHA de cada prancha e permite inserir tabela de articulação no Model Space.

9. CADINVENTORY

Exporta o inventário físico patrimonial de saneamento conforme as normas da ANA (MCPSB). Lê as tubulações nas layers mapeadas, extrai DN e material, calcula comprimentos em metros (INSUNITS),adiciona coordenadas georreferenciadas (SIRGAS2000) e gera planilha CSV formatada, abrindo o arquivo no Explorer.

10. PROJECTMGR

Gerenciador e buscador inteligente de arquivos DWG/DXF locais. Varrer pastas configuradas, extrai clientes e disciplinas das pastas e nomes de arquivos, mantendo um catálogo rápido em cache. Permite pesquisar por palavras-chave e abrir desenhos diretamente pelo CAD.

11. DIGITIZE

Assistente para vetorização de mapas e rascunhos escaneados. Permite calibração geométrica de 2 pontos (calcula escala real, ângulo de rotação e translação) e criação com 1 clique de 8 layers padronizadas de digitalização com cores ACI normatizadas.

12. TRACIMAGE

Vetorização assistida por IA sobre imagens (captura de mapa, ortofoto, planta escaneada ou raster IMAGE já inserido no desenho). O comando pede a origem da imagem (arquivo ou seleção raster),os cantos no desenho (para alinhar coordenadas) e um pedido em linguagem natural.

Exemplos de pedido:

• traçar as redes de água visíveis na imagem, incluindo adutoras, principais e ramais
• traçar as redes de esgoto visíveis na imagem, incluindo coletores, principais e ramais
• traçar os elementos lineares de urbanização visíveis na imagem, incluindo vias, quadras e limites de lotes

A IA devolve eixos como polylines na layer DIGIT_VIAS_EIXO. Requer LOGIN, licença ativa e SETENDPOINT 0 (proxy do plugin). Limite: 4 MB por imagem.

13. SMARTINSERT

Painel de produtividade com as ferramentas mais usadas do CAD e Express Tools (BURST, NCOPY, BCOUNT, EXTRIM, FLATTEN, OVERKILL, TXT2MTXT, TCOUNT, LAYDEL, LAYMRG) com registro de frequência e execução automática.

14. ALERTS

Abre a aba Alertas (filtros por severidade, DIFF e tags MEP / ESTRUTURAL / ANA / CHECKLIST). Correções sugeridas com botão dedicado.

15. PALETA / aba Alertas

Clique num alerta para destacar (exceto DIFF_REMOVED). Botões Scan, Checklist, Diff e Limpar HL.

16. SETTOKEN

Opcional: chave própria de provedor de IA (Gemini, OpenAI, etc.). Com licença, LOGIN e SETENDPOINT 0, o proxy do plugin cobre TEST / ASK sem token próprio. Com o proxy 0 ativo, SETTOKEN fica indisponível (use um endpoint 1–8 para chave própria).

17. SETENDPOINT

Menu 0–8: 0 = proxy do plugin (após LOGIN com licença ativa); 1–8 = Azure, GitHub, Gemini, OpenAI, DeepSeek, Anthropic, Ollama, Custom.

18. SETMODEL

Nome do modelo de IA. Com o proxy 0 ativo, também fica indisponível (o modelo do proxy é o do plugin).

19. TEST

Testa a conexão com a IA e imprime a resposta no console.

20. ASK

Perguntas em texto livre à IA. Na paleta, use a aba Assistente (ou o botão ASK) — chat com histórico, chips “Executed …” e tabelas. No console CAD, ASK pede a pergunta num prompt.

O plugin envia um resumo do ambiente (documento, INSUNITS, layers, extents, cores top, seleção) e a IA pode pedir ferramentas locais. Na aba Assistente vazia aparecem dicas clicáveis (ex.: cores, layers, seleção). Use Histórico para rever perguntas da sessão e + / Limpar para nova conversa (o histórico ASK é independente do LISP; ao reabrir a paleta o chat é restaurado da memória do plugin). Quando houver versão nova no site, a paleta mostra um aviso de atualização com link para o instalador (pode dispensar até a próxima versão).

• AggregateObjects (groupBy: color / layer / type / block / linetype)
• SelectByProperty / SelectByColor
• DescribeSelection — propriedades da seleção atual
• ListLayers / AggregateColors

Exemplos: quais cores?; agregue por layer; selecione objetos amarelos; o que está selecionado?.

21. DRAW

Gera sequência de comandos CAD nativos (ex.: RECTANG / coordenadas) e tenta executá-la na linha de comando. Serve para geometria (quadrado, círculo, planta esquemática),não para prompts de imagem/render (“estilo técnico limpo”, “renderização vetorial”). O plugin inclui o resumo do desenho ativo (unidades, layers, extents) para a IA respeitar o ambiente.

Exemplos que funcionam: quadrado 10x10 em 0,0; planta 12000×8000 mm com sala, cozinha e 2 quartos. Se faltar medida numa planta, a IA assume valores tipicos em mm e desenha paredes com RECTANG/PLINE.

22. LISP

Botão LISP na paleta: gera LISP, salva em AI_Generated.lsp e tenta carregar no CAD (também copia o (load ...)). Após o load, digite o comando c:NOME (ex.: MEDCOMP). Use CLEAR se o histórico misturar respostas ruins.

Como o DRAW, não gera imagem/render. Pedidos de planta baixa viram um (defun c:…) que desenha com (command "_.RECTANG" …) / PLINE (respeita INSUNITS do desenho quando disponível). Utilitários (medir, selecionar) usam entsel. O plugin envia o resumo do ambiente CAD junto com o pedido.

23. CLEAR

Limpa o histórico de conversa do ASK e do LISP.