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. Retornaresolved,ambiguous,unresolvedoufailed; nunca escolhe um entre vários candidatos por ordem de travessia.facts orient: seis candidatos de câmera e umrecommended_viewopcional baseado na heurística da face com maior bbox, voltada para fora da montagem. Uma recomendação sempre temsemantic_status=assumed.facts renderem STEP: uma ocorrência ativaoccurrence:N, umaViewSpecificationexplícita, um novo SVG e um novo manifesto.view.jsonirmã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 seuoccurrence_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;
nearprecisa 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 mapeamentomade_byde 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_counteVIEW_EDGES_NOT_DISCRETIZEDdivulgam 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.