STEPオカレンスビューとテクニカルイラスト
このスキルは、cad-to-factsと同じローカルのfactsCLIを駆動します。明示的に選択された1つのSTEPオカレンスの読み取り専用OCCT隠線除去ビューを作成します。ソースアーティファクトは決して変更されません。レンダリングはオフラインで決定論的です。LLM/VLMを呼び出したり、モデル/画像をアップロードしたりしません。
実装範囲
facts resolve: 正確なオカレンス名/定義名、部分文字列/エイリアス、パス、定義、ルート/アセンブリ種別、状態、有界ワールドバウンディングボックスの空間制約。resolved、ambiguous、unresolved、failedのいずれかを返します。トラバーサル順序で複数の候補から1つを選択することはありません。facts orient: 6つのカメラ候補と、最大バウンディングボックス面からの外向きアセンブリヒューリスティックによるオプションのrecommended_view。推奨は常にsemantic_status=assumedです。- STEPに対する
facts render: 1つのアクティブなoccurrence:N、1つの明示的なViewSpecification、1つの新しいSVG、1つの新しい兄弟.view.jsonマニフェスト。 - グローバル軸カメラプリセットと明示的な法線/右ベクトル、可視/隠線出力、有界SVGポイント数、アーティファクト/スナップショット/出力のハッシュと正確なターゲットバインディング、オプションのユーザー選択または想定ビューセマンティクス。
PNG、断面/爆発/シェーディングビュー、フォトリアリスティック出力、寸法注釈、ソース宣言または機能的な正面認識、視覚的推論は実装されていません。SVGはレビュー/ドキュメンテーションのWorkProductであり、視覚的または幾何学的等価性の証明ではなく、FactSetでもありません。
セットアップ
リポジトリにインストールされたfactsCLI、または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: 正確に1つの発見された候補。そのoccurrence_idを使用します。ambiguous: 候補のパス、名前、配置バウンディングボックスを検査し、制約を追加するか、ユーザーに選択を依頼します。決して最初のものを自動選択しないでください。unresolved: 一致する候補が見つかりませんでした。これは工学的な欠如の証明ではありません。failed: スナップショットを読み取れませんでした。これからレンダリングしないでください。
completeは、完全なオカレンス発見と、返されたすべての候補に対する測定可能な配置バウンディングボックスを意味します。完全な形状検証、診断なし、成功した解決、またはグローバルな一意性を意味するわけではありません。曖昧または未解決の結果でも、発見が完全であればcompleteになることがあります。発見が部分的または不明な場合、一意性は発見されたもののみであり、complete=falseとなります。
オプションの想定正面選択
一意に解決されたターゲットに対して、facts orient assembly.step --selector selector.jsonは6つのワールドバウンディングボックス投影候補を返します。アセンブリ中心からの外向き符号が明確な一意の最大面積軸のみを選択します。それ以外の場合は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": "front",
"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が作成されます。両方のパスは新しいものでなければならず、どちらも上書きされません。どちらかが既に存在する場合、新しいペアは書き込まれません。マニフェストは、アーティファクト/スナップショットのアイデンティティ、正確なターゲット、完全なビュー仕様、レンダラー/バージョン、投影範囲、エッジ/ポイント数、画像SHA-256/サイズ、診断をバインドします。ダウンストリームで使用する前にこれらのバイトを確認してください。
解決とレンダリングは独立してSTEPファイルを再読み取りします。レンダリングは事前の解決IDを強制しません。選択に依存する前に、解決のartifact.sha256とsnapshot.snapshot_idをレンダリングのartifact.sha256とsnapshot_idと比較してください。いずれかが異なる場合は、事前の選択を破棄して再解決してください。マニフェストは実際にレンダリングされたスナップショットとターゲットを記録します。
カメラセマンティクスは設計セマンティクスではありません
frontプリセットが意味するのは、ビューアがグローバル**-Yにいて、+Yを見ており、画面右が+X**、画面上が**+Z**であることだけです。パーツの機能的な正面を証明するものではありません。他のプリセットはView契約に文書化されています。
ユーザー定義の方向には、明示的なnormalとrightベクトルを使用します。normalはモデルからビューアへ向かう方向を示し、normal × rightが画面上方向を決定します。semantic_intent.basisは次のみです:
user_selected: ユーザーがこの意味を提供/確認しました。assumed: 開示しなければならない明示的なエージェントの仮定。
現在の契約ではdeclaredベースは受け入れられません。ソースファイルの正面側宣言は抽出されません。純粋に幾何学的なカメラの場合はsemantic_intentを省略してください。プリセットまたは想定された正面を、ソース設計がその側を宣言しているという主張に決して変えないでください。
正直な制限
- エンティティ/オカレンスIDとパスはスナップショットスコープであり、永続的なリビジョン間の同一性ではありません。
- ターゲット解決は、宣言されたID、パス、名前/エイリアス、定義、ルート/アセンブリ種別、状態、有界ワールドバウンディングボックスの空間関係をフィルタリングします。配置バウンディングボックスと空間的証拠が返されます。方向関係は明示的なカメラで中心を比較します。
nearは明示的なバウンディングボックスギャップ制限を必要とします。これらは接触、包含、正確な距離、または機能的な特徴の証明ではありません。面/エッジセレクターとソースコードのmade_byマッピングは実装されていません。 - ジオメトリを解決しても、編集可能なソースパラメータは特定されません。既存の変更コマンドは、独自の明示的なChangePreparationSpecとSourceManifestの証拠を引き続き必要とします。
- OCCT HLRは投影エッジを提供します。曲線はSVGポリラインに離散化されます。
skipped_edge_countとVIEW_EDGES_NOT_DISCRETIZEDは省略されたパスを開示します。ポイント数は制限されていますが、HLR実行時間は一般的な大規模アセンブリの保証ではありません。投影範囲は、出力された離散化ポイントセットを記述し、正確なソース寸法ではありません。 - 部分的な発見またはパーサー診断でレンダリングが成功する可能性があります。これらはマニフェストに残り、モデル全体の完全性の主張を防ぎます。
- ピクセルから寸法を読み取らないでください。実装された測定にはFactsを、宣言された注釈値には意味的PMIを使用してください。
- フォーカステストでは、分析OCCT生成STEPフィクスチャを使用します。これらのテストと分離された実ファイルの観察は、エクスポーターの相互運用性や一般的な大規模アセンブリレンダリングを確立するものではありません。
- ソースまたは派生SVGを、個別の承認なしに外部の視覚モデルに送信しないでください。
すべてのセレクター、カメラ、マニフェストフィールドについては、View契約を参照してください。