STEP 발생 뷰 및 기술 일러스트레이션
이 스킬은 cad-to-facts와 동일한 로컬 facts CLI를 구동합니다. 명시적으로 선택된 하나의 STEP 발생 항목에 대해 읽기 전용 OCCT 숨은 선 제거(HLR) 뷰를 생성합니다. 원본 아티팩트는 수정되지 않습니다. 렌더링은 오프라인에서 결정론적으로 수행되며, LLM/VLM을 호출하거나 모델/이미지를 업로드하지 않습니다.
구현된 범위
facts resolve: 정확한 발생/정의 이름, 부분 문자열/별칭, 경로, 정의, 루트/어셈블리 종류, 상태 및 경계 워드 bbox 공간 제약 조건을 처리합니다.resolved,ambiguous,unresolved또는failed를 반환하며, 순회 순서로 여러 후보 중 하나를 선택하지 않습니다.facts orient: 가장 큰 bbox 면에서 바깥 방향(어셈블리 중심 기준) 휴리스틱을 기반으로 6개의 카메라 후보와 선택적recommended_view를 반환합니다. 권장 뷰는 항상semantic_status=assumed입니다.facts render(STEP): 하나의 활성occurrence:N, 하나의 명시적ViewSpecification, 하나의 새 SVG, 하나의 새 형제.view.json매니페스트를 생성합니다.- 전역 축 카메라 프리셋과 명시적 법선/오른쪽 벡터, 가시선/숨은 선 출력, 제한된 SVG 점 개수, 정확한 대상 바인딩이 있는 아티팩트/스냅샷/출력 해시, 그리고 선택적 사용자 선택 또는 가정된 뷰 의미 체계를 지원합니다.
PNG, 단면/분해/음영 뷰, 사실적 출력, 치수 주석, 소스 선언 또는 기능적 정면 인식 및 시각적 추론은 구현되지 않았습니다. SVG는 검토/문서화 작업 산물(WorkProduct)이며, 시각적 또는 기하학적 동등성 증명이나 FactSet이 아닙니다.
설정
저장소에 설치된 facts CLI를 사용하거나 uv run --project /path/to/cad-to-facts facts ... 명령을 사용하세요. 참조 환경은 Python 3.13이며 고정된 OCCT 종속성을 사용합니다. STEP SVG 렌더링에 ODA, text-to-cad, Blender 또는 네트워크 서비스를 사용하지 않습니다.
렌더링 전 해결
다음과 같은 TargetSelector JSON을 작성하세요:
{"name_contains": "DOOR", "is_assembly": false}
그런 다음 실행하세요:
facts resolve assembly.step --selector door-selector.json
resolution.status, resolution.complete, resolution.discovery, 후보 및 진단 정보를 확인하세요. name과 name_contains는 발생 이름과 부품 정의 이름을 모두 검사합니다. 일부 STEP 파일은 PRODUCT 이름만 선언하기 때문입니다. 후보 name_path와 path는 다릅니다. 전자는 표시용이고, 후자는 스냅샷 범위의 발생 ID를 결합하며 정확한 경로 선택자 형태입니다.
resolved: 정확히 하나의 발견된 후보입니다. 해당occurrence_id를 사용하세요.ambiguous: 후보의 경로, 이름 및 배치된 경계 상자를 검사하고, 제약 조건을 추가하거나 사용자에게 선택을 요청하세요. 절대 첫 번째를 자동으로 선택하지 마십시오.unresolved: 일치하는 후보가 발견되지 않았습니다. 이것이 엔지니어링 부재의 증거는 아닙니다.failed: 스냅샷을 읽을 수 없습니다. 이 스냅샷으로 렌더링하지 마십시오.
complete는 완전한 발생 발견과 반환된 모든 후보에 대한 측정 가능한 배치된 경계 상자를 의미합니다. 전체 형상 검증, 진단 없음, 성공적인 해결 또는 전역 고유성을 의미하지 않습니다. 모호하거나 해결되지 않은 결과도 발견이 완료되면 complete일 수 있습니다. 부분적이거나 알 수 없는 발견의 경우 고유성은 발견된 것에 한정되며 complete=false입니다.
선택적 가정된 정면 선택
고유하게 해결된 대상에 대해 facts orient assembly.step --selector selector.json은 6개의 워드 bbox 투영 후보를 반환합니다. 어셈블리 중심에서 바깥 방향 부호가 명확한 고유한 최대 면적 축만 선택합니다. 그렇지 않으면 ambiguous를 반환하고 뷰가 없습니다. 성공적인 recommended_view를 그대로 렌더링용 JSON 파일에 복사하세요. 이미 semantic_intent.basis=assumed가 설정되어 있습니다. 사용자가 실제로 선택하지 않는 한 user_selected로 레이블을 변경하지 말고, 소스 선언 정면이라고 부르지 마십시오. 경계 상자 휴리스틱은 잘못된 문서화 측면을 선택할 수 있으므로 가정을 공개하십시오.
뷰 내보내기
ViewSpecification을 작성하세요 (예: door-front-view.json):
{
"title": "문 정면",
"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": "정면",
"basis": "user_selected",
"note": "사용자가 외부 측면을 정면으로 선택했습니다"
}
}
해결된 대상을 렌더링하세요:
facts render assembly.step \
--target occurrence:12 \
--view-spec door-front-view.json \
--output door-front.svg
이 명령은 door-front.svg와 door-front.view.json을 생성합니다. 두 경로 모두 새로워야 하며 덮어쓰지 않습니다. 둘 중 하나라도 이미 존재하면 새 쌍이 작성되지 않습니다. 매니페스트는 아티팩트/스냅샷 ID, 정확한 대상, 전체 뷰 사양, 렌더러/버전, 투영된 범위, 에지/포인트 개수, 이미지 SHA-256/크기 및 진단 정보를 바인딩합니다. 다운스트림에서 사용하기 전에 해당 바이트를 확인하세요.
resolve와 render는 각각 독립적으로 STEP 파일을 다시 읽습니다. render는 이전 해결 ID를 강제하지 않습니다. 선택에 의존하기 전에 resolve의 artifact.sha256 및 snapshot.snapshot_id를 render의 artifact.sha256 및 snapshot_id와 비교하세요. 둘 중 하나라도 다르면 이전 선택을 폐기하고 다시 해결하세요. 매니페스트는 실제로 렌더링된 스냅샷과 대상을 기록합니다.
카메라 의미 체계는 설계 의미 체계가 아닙니다
front 프리셋은 다음을 의미할 뿐입니다: 뷰어가 전역 -Y에 위치하여 +Y 방향을 바라보고, 화면 오른쪽은 +X, 화면 위쪽은 +Z입니다. 이것이 부품의 기능적 정면을 증명하지는 않습니다. 다른 프리셋은 View contract에 문서화되어 있습니다.
사용자 정의 방향의 경우 명시적 normal 및 right 벡터를 사용하세요. normal은 모델에서 뷰어 방향을 가리키고, normal × right는 화면 위쪽을 결정합니다. semantic_intent.basis는 다음만 가능합니다:
user_selected: 사용자가 이 의미를 제공/확인했습니다.assumed: 공개되어야 하는 명시적 에이전트 가정입니다.
현재 계약은 declared 기준을 허용하지 않습니다. 소스 파일의 정면 선언은 추출되지 않습니다. 순수 기하학적 카메라의 경우 semantic_intent를 생략하세요. 프리셋이나 가정된 정면을 소스 설계가 해당 측면을 선언한다는 주장으로 전환하지 마십시오.
정직한 한계
- 엔티티/발생 ID 및 경로는 스냅샷 범위로 지정되며, 교차 개정 ID가 아닙니다.
- 대상 해결은 선언된 ID, 경로, 이름/별칭, 정의, 루트/어셈블리 종류, 상태 및 경계 워드 bbox 공간 관계를 필터링합니다. 배치된 경계 상자와 공간 증거가 반환됩니다. 방향 관계는 명시적 카메라의 중심을 비교하며,
near에는 명시적 bbox 간격 제한이 필요합니다. 이는 접촉, 포함, 정확한 거리 또는 기능적 특징 증명이 아닙니다. 면/에지 선택자 및 소스 코드made_by매핑은 구현되지 않았습니다. - 기하학 해결은 편집 가능한 소스 매개변수를 찾지 않습니다. 기존 변경 명령에는 여전히 명시적 ChangePreparationSpec 및 SourceManifest 증거가 필요합니다.
- OCCT HLR은 투영된 에지를 제공합니다. 곡선은 SVG 폴리라인으로 이산화됩니다.
skipped_edge_count및VIEW_EDGES_NOT_DISCRETIZED는 생략된 경로를 공개합니다. 포인트 개수는 제한되지만, HLR 런타임은 일반적인 대형 어셈블리에 대한 보장이 아닙니다. 투영된 범위는 방출된 이산화된 포인트 집합을 설명하며, 정확한 소스 치수가 아닙니다. - 부분적인 발견 또는 파서 진단과 함께 렌더링이 성공할 수 있습니다. 이는 매니페스트에 남아 있으며 전체 모델 완전성 주장을 방지합니다.
- 픽셀에서 치수를 절대 읽지 마십시오. 구현된 측정에는 Facts를, 선언된 주석 값에는 의미론적 PMI를 사용하세요.
- 집중 테스트는 분석적 OCCT 생성 STEP 픽스처를 사용합니다. 이러한 테스트와 격리된 실제 파일 관찰은 내보내기 상호 운용성 또는 일반적인 대형 어셈블리 렌더링을 입증하지 않습니다.
- 별도 권한 없이 소스 또는 파생 SVG를 외부 시각 모델에 보내지 마십시오.
모든 선택자, 카메라 및 매니페스트 필드는 View contract를 참조하세요.