Community影像github.com

cad-view

解析 STEP 組合件出現次,並匯出目標隔離的正交 SVG 視圖,附帶來源清單。用於如「匯出這扇門的前視圖」、「僅渲染此出現次」或「為文件建立向量插圖」等請求。支援空間選擇器和明確假設的前方啟發法;保留相機與語意前方的假設,且絕不從像素推斷尺寸。

cad-view 是什麼?

此技能驅動與 `cad-to-facts` 相同的本地 `facts` CLI,專注於從 STEP 檔案建立唯讀的 OCCT 隱藏線視圖。它僅針對一個明確選取的 STEP 出現次進行渲染,且絕不修改原始工件。處理流程完全離線且確定性,不呼叫任何 LLM/VLM 或上傳模型/影像。此技能的核心功能包括透過 `facts resolve` 解析出現次(支援精確名稱、子字串、路徑、定義等條件),透過 `facts orient` 推斷建議的前方視圖(基於最大包圍盒面的啟發法),以及透過 `facts render` 匯出 SVG 向量圖並附帶 `.view.json` 清單。清單會記錄工件雜湊、精確目標、相機規格、渲染器版本及診斷資訊,確保存取的可追溯性。此技能特別適用於需要將 CAD 組合件中的特定零件獨立輸出為乾淨、無陰影的技術插圖,以供文件或審查使用,且不支援 PNG、照片級渲染或 VLM 解釋。它支援空間選擇器(如名稱包含、路徑、定義類型)和明確的使用者定義相機方向,但無法識別來源檔案中宣告的前方。因此,任何假設的前方都必須明確揭露其語意基礎為「assumed」。

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

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

STEP 出現次檢視與技術插圖

此技能驅動與 cad-to-facts 相同的本地 facts CLI。它為一個明確選取的 STEP 出現次建立唯讀的 OCCT 隱藏線視圖。來源工件絕不會被修改。渲染是離線且確定性的;它不會呼叫 LLM/VLM 或上傳模型/影像。

已實作範圍

  • facts resolve:精確的出現次/定義名稱、子字串/別名、路徑、定義、根/組合件類型、狀態和有界世界包圍盒空間約束。傳回 resolved、ambiguous、unresolved 或 failed;絕不會透過遍歷順序從多個候選項中選取一個。
  • facts orient:六個相機候選項和一個可選的 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、文字轉 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 會傳回六個世界包圍盒投影候選項。它僅選取一個唯一的最大面積軸,其從組合件中心向外的符號是明確的。否則傳回 ambiguous 且無視圖。將成功的 recommended_view 逐字複製到一個 JSON 檔案中以供渲染;它已經有 semantic_intent.basis=assumed。除非使用者實際選擇它,否則不要將其重新標記為 user_selected,且永遠不要稱其為來源宣告的前方。包圍盒啟發法可能選錯文件面,因此請揭露這個假設。

匯出視圖

撰寫一個 ViewSpecification,例如 door-front-view.json:

{
  "title": "Door front",
  "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。這並不證明零件的功能前方。其他預設記錄在視圖合約中。

對於使用者定義的方向,請使用明確的 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 傳送給外部視覺模型。

請參閱視圖合約以了解所有選擇器、相機和清單欄位。

相關技能