CommunityImagemgithub.com

cad-view

Resolve ocorrências de montagens STEP e exporta vistas SVG ortográficas isoladas do alvo com manifestos de proveniência. Use para pedidos como "exportar a vista frontal desta porta", "renderizar apenas esta ocorrência" ou "criar uma ilustração vetorial para um documento". Suporta seletores espaciais e uma heurística explicitamente assumida de frontal; preserva a câmera versus suposições semânticas de frontal e nunca infere dimensões a partir de pixels. Renderização PNG, fotorrealista, interpretação VLM e reconhecimento de frontal declarado/funcional não são implementados.

O que é cad-view?

O skill `cad-view` é uma ferramenta para extrair vistas técnicas isoladas de arquivos STEP (modelos CAD 3D) como ilustrações vetoriais SVG de alta qualidade. Ele resolve ocorrências específicas em montagens, permitindo que você exporte a vista de uma única peça (como uma porta) em vez da montagem inteira. A renderização é offline e determinística, usando o algoritmo OCCT Hidden-Line Removal (HLR) — não depende de LLMs, VLMs ou serviços externos. O skill é composto por três comandos principais no CLI `facts`: `resolve` para encontrar e desambiguar ocorrências, `orient` para recomendar uma vista frontal baseada em heurísticas de bounding box, e `render` para gerar o SVG e um manifesto `.view.json` detalhado. Ele suporta presets de câmera (frente, trás, etc.), vetores explícitos de normal e direita, e metadados semânticos para distinguir entre seleção do usuário (`user_selected`) e suposição do agente (`assumed`). O skill é transparente sobre suas limitações: não extrai declarações de frontal do arquivo fonte, não substitui evidências dimensionais exatas, e não deve ser usado com seletores de faces/arestas ou para inferir dimensões a partir de pixels.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/EthanLoveQueen/cad-to-facts/tree/HEAD/skills/cad-view

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Vistas de ocorrências STEP e ilustrações técnicas

Este skill aciona o mesmo CLI local facts que o cad-to-facts. Ele cria vistas de linhas ocultas OCCT somente leitura de uma ocorrência STEP explicitamente selecionada. O artefato fonte nunca é modificado. A renderização é offline e determinística; não chama um LLM/VLM nem envia o modelo/imagem.

Escopo implementado

  • facts resolve: correspondência exata de nome de ocorrência/definição, substring/alias, caminho, definição, tipo raiz/montagem, estado e restrições espaciais de world-bbox. Retorna resolved, ambiguous, unresolved ou failed; nunca escolhe um entre vários candidatos por ordem de travessia.
  • facts orient: seis candidatos de câmera e um recommended_view opcional baseado na heurística da face com maior bbox, voltada para fora da montagem. Uma recomendação sempre tem semantic_status=assumed.
  • facts render em STEP: uma ocorrência ativa occurrence:N, uma ViewSpecification explícita, um novo SVG e um novo manifesto .view.json irmão.
  • Presets de câmera de eixos globais e vetores explícitos de normal/direita, saída com/sem linhas ocultas, contagem de pontos SVG limitada, hashes de artefato/snapshot/saída com vinculação exata ao alvo, e semânticas de vista opcionais selecionadas pelo usuário ou assumidas.

Renderização PNG, vistas seccionadas/explodidas/sombreadas, saída fotorrealista, anotação de dimensões, reconhecimento de frontal declarado no fonte ou funcional e inferência visual não são implementados. SVG é um WorkProduct de revisão/documentação, não uma prova de equivalência visual ou geométrica e não um FactSet.

Configuração

Use o CLI facts instalado do repositório, ou uv run --project /caminho/para/cad-to-facts facts .... O ambiente de referência é Python 3.13 com as dependências OCCT travadas. Nenhum ODA, text-to-cad, Blender ou serviço de rede é usado para renderização STEP SVG.

Resolver antes de renderizar

Escreva um JSON TargetSelector como:

{"name_contains": "PORTA", "is_assembly": false}

Então execute:

facts resolve assembly.step --selector door-selector.json

Leia resolution.status, resolution.complete, resolution.discovery, candidatos e diagnósticos. name e name_contains inspecionam tanto nomes de ocorrência quanto nomes de definição de peça porque alguns arquivos STEP declaram apenas nomes de PRODUTO. name_path e path do candidato são diferentes: o primeiro é para exibição, enquanto o último une IDs de ocorrência com escopo de snapshot e é a forma exata de seletor de caminho.

  • resolved: exatamente um candidato descoberto; use seu occurrence_id.
  • ambiguous: inspecione os caminhos, nomes e bounding boxes posicionadas dos candidatos, adicione restrições ou peça ao usuário para escolher. Nunca selecione silenciosamente o primeiro.
  • unresolved: nenhum candidato correspondente foi descoberto. Isso não é prova de ausência de engenharia.
  • failed: o snapshot não pôde ser lido; não renderize a partir dele.

complete significa descoberta completa de ocorrências mais uma bounding box posicionada mensurável para cada candidato retornado. Não significa validação completa de forma, sem diagnósticos, resolução bem-sucedida ou exclusividade global. Um resultado ambíguo ou não resolvido pode estar completo quando a descoberta está completa. Com descoberta parcial ou desconhecida, exclusividade é apenas descoberta e complete=false.

Seleção de frontal assumida opcional

Para um alvo exclusivamente resolvido, facts orient assembly.step --selector selector.json retorna seis candidatos de projeção world-bbox. Ele seleciona apenas um único eixo de maior área cujo sinal para fora do centro da montagem é inequívoco. Caso contrário, retorna ambiguous e nenhuma vista. Copie um recommended_view bem-sucedido literalmente para um arquivo JSON para renderização; ele já tem semantic_intent.basis=assumed. Não o rotule como user_selected a menos que o usuário realmente o escolha, e nunca o chame de frontal declarado no fonte. Heurísticas de bounding box podem escolher o lado de documentação errado, portanto, divulgue a suposição.

Exportar uma vista

Escreva uma ViewSpecification, por exemplo door-front-view.json:

{
  "title": "Frente da porta",
  "camera": {"preset": "front"},
  "display": {"show_hidden_lines": false},
  "image": {
    "width": 1200,
    "height": 900,
    "padding": 24,
    "curve_deflection_mm": 0.1,
    "max_points": 200000
  },
  "semantic_intent": {
    "label": "frente",
    "basis": "user_selected",
    "note": "O usuário selecionou o lado exterior como frente"
  }
}

Renderize o alvo resolvido:

facts render assembly.step \
  --target occurrence:12 \
  --view-spec door-front-view.json \
  --output door-front.svg

Isso cria door-front.svg e door-front.view.json. Ambos os caminhos devem ser novos; nenhum é sobrescrito. Se algum já existir, nenhum novo par é escrito. O manifesto vincula a identidade do artefato/snapshot, o alvo exato, a especificação completa da vista, renderizador/versão, extensões projetadas, contagens de arestas/pontos, SHA-256/tamanho da imagem e diagnósticos. Verifique esses bytes antes do uso downstream.

Resolver e renderizar relêem o arquivo STEP de forma independente; renderizar não impõe um ID de resolução anterior. Antes de confiar na seleção, compare o artifact.sha256 e snapshot.snapshot_id da resolução com o artifact.sha256 e snapshot_id da renderização. Se algum diferir, descarte a seleção anterior e resolva novamente. O manifesto registra o snapshot e o alvo realmente renderizados.

Semânticas de câmera não são semânticas de design

O preset front significa apenas: visualizador no eixo global -Y, olhando para +Y, direita da tela +X e para cima na tela +Z. Não prova a frente funcional da peça. Outros presets estão documentados em Contrato de vista.

Para uma direção definida pelo usuário, use vetores explícitos normal e right. normal aponta do modelo para o visualizador; normal × right determina o para cima da tela. semantic_intent.basis é apenas:

  • user_selected: o usuário forneceu/confirmou este significado;
  • assumed: uma suposição explícita do agente que deve ser divulgada.

O contrato atual não aceita uma base declared: declarações de frente do lado do arquivo fonte não são extraídas. Omita semantic_intent para uma câmera puramente geométrica. Nunca transforme um preset ou uma frente assumida em uma afirmação de que o design fonte declara aquele lado.

Limites honestos

  • IDs de entidade/ocorrência e caminhos têm escopo de snapshot, não identidade persistente entre revisões.
  • A resolução de alvo filtra IDs declarados, caminhos, nomes/aliases, definição, tipo raiz/montagem, estado e relações espaciais de world-bbox delimitado. Bounding boxes posicionadas e evidências espaciais são retornadas. Relações direcionais comparam centros em uma câmera explícita; near precisa de um limite explícito de lacuna de bbox. Essas não são provas de contato, contenção, distância exata ou características funcionais. Seletores de faces/arestas e mapeamento made_by de código fonte não são implementados.
  • Resolver geometria não localiza um parâmetro de fonte editável. Comandos de alteração existentes ainda exigem seu ChangePreparationSpec explícito e evidências de SourceManifest.
  • OCCT HLR fornece arestas projetadas; curvas são discretizadas em polilinhas SVG. skipped_edge_count e VIEW_EDGES_NOT_DISCRETIZED divulgam caminhos omitidos. A contagem de pontos é limitada, mas o tempo de execução do HLR não é uma garantia geral para montagens grandes. Extensões projetadas descrevem o conjunto de pontos discretizados emitidos, não as dimensões exatas da fonte.
  • Uma renderização pode ser bem-sucedida com descoberta parcial ou diagnósticos do parser; estes permanecem no manifesto e impedem alegações de completude do modelo inteiro.
  • Nunca leia dimensões a partir de pixels. Use Facts para medições implementadas ou PMI semântico para valores de anotação declarados.
  • Testes focados usam fixtures STEP analíticas geradas por OCCT. Esses testes e observações isoladas de arquivos reais não estabelecem interoperabilidade de exportadores ou renderização geral de montagens grandes.
  • Não envie o SVG fonte ou derivado para um modelo visual externo sem autorização separada.

Consulte Contrato de vista para todos os campos de seletor, câmera e manifesto.

Habilidades Relacionadas