從 step.parts 尋找、評估並下載常見的可購買 CAD 零件，包括指定的現成致動器、伺服馬達、馬達、電子板、連接器、螺絲、螺栓、螺帽、墊圈、軸承、支柱及其他目錄組件。當 Codex 需要在建立簡化佔位幾何之前搜尋託管的 step.parts 目錄、解析模糊的零件名稱、標準、別名或尺寸、選擇匹配零件、取得標準 .step 檔案、驗證校驗和，或使用 step.parts API/OpenAPI/目錄端點進行標準零件探索時使用。
CAD 零件
來源：維護於 earthtojake/text-to-cad。
使用已安裝的本機技能檔案作為執行階段的真實來源；儲存庫連結僅供來源追溯與版本審查使用。
概述
使用託管的 step.parts 機器端點，而非爬取 HTML 或依賴本機儲存庫檔案。將 https://api.step.parts 視為標準 API 來源，https://www.step.parts 視為網站/靜態資產來源，除非使用者提供不同的託管鏡像。網路/DNS 失敗不具決定性：如果從沙盒無法連線至 api.step.parts，請在回報未找到或使用佔位幾何之前，先以網路權限重試一次。除非 API 可連線且未回傳相關候選項目，否則不要將零件描述為不可取得。
當 CAD 組裝包含指定的現成致動器、伺服馬達、馬達、電子板、連接器或其他可購買組件時，請先搜尋 step.parts，再建立簡化佔位幾何。對於指定的伺服馬達、馬達和致動器，請同時搜尋確切型號字串與常見別名/供應商拼寫，然後再放棄。例如，STS3215 也可能顯示為 ST3215、3215、Waveshare Feetech ST3215，或位於 family=feetech 之下。如果 API 可連線但未找到確切或近似匹配，請記錄搜尋未命中，然後使用已知的外殼或簡化替代品。
快速工作流程
- 將要求的零件解讀為搜尋詞與可選篩選條件：
q用於模糊標記、標準、別名、尺寸、來源/產品 URL 以及屬性名稱/值。- 當使用者提供確切篩選條件時，使用
category、family、standard或tag。
- 搜尋
/v1/parts並檢查items、total和facets。對於致動器型號，請在將空結果視為未命中之前，重試可能的別名、省略字母、供應商名稱及相關 family 篩選條件。 - 如果結果不明確，請在選擇之前呈現最佳選項，包含
id、name、standard及關鍵屬性。如果一個結果明顯匹配，請直接回傳所選記錄的詳細資訊，除非使用者要求下載本機 STEP 檔案。 - 當找到確切或近似匹配的現成致動器型號時，除非有明確的組裝理由需要使用簡化外殼，否則優先下載並使用其 STEP 檔案。明確記錄該選擇。
- 當使用者要求下載或儲存 STEP 檔案時，下載其
stepUrl，然後在記錄包含sha256時驗證檔案。 - 下載時回傳本機路徑，以及所選零件 ID 與頁面/API URL，以便使用者追溯來源。
CAD 檢視器交接
完成 step.parts 工作並建立或更新本機 .step 或 .stp 檔案後，如果該技能已安裝，您必須始終將明確的檔案路徑交給 $cad-viewer。$cad-viewer 必須啟動 CAD 檢視器（如果尚未執行），並回傳相關已建立或更新檔案的路徑；如果 $cad-viewer 不可用或啟動失敗，請回報該情況，而非默默省略交接。
內建下載器
使用 scripts/download_step_part.py 進行確定性搜尋、下載與校驗和驗證：
python scripts/download_step_part.py "M3 內六角 12" --download
python scripts/download_step_part.py --id iso4762_socket_head_cap_screw_m3x12 --download
python scripts/download_step_part.py "軸承 608zz" --limit 5
實用選項：
--origin：僅在使用者提供其他託管 API 來源時覆寫https://api.step.parts。--tag、--category、--family、--standard：可重複的篩選條件。--out-dir：當使用者要求特定目錄時覆寫下載目錄。--all：搭配--download時，下載回傳頁面上的每個結果作為個別 STEP 下載。--overwrite：取代現有輸出檔案。
腳本會將 JSON 輸出至標準輸出。對於搜尋，它會列印匹配的記錄。對於下載，它會列印儲存的檔案路徑、校驗和及來源 URL。
API 參考
當需要端點詳細資訊、欄位意義或查詢語義時，請閱讀 references/step-parts-api.md。優先使用：
/v1/parts進行帶有絕對資產 URL 的篩選搜尋。/v1/parts/{id}取得單一豐富記錄。- 回傳的
stepUrl用於 STEP 下載。 /v1/catalog/parts.index.json取得精簡的探索索引。/v1/catalog/schema取得欄位與 family 屬性的意義。/v1/openapi.json用於產生客戶端或工具。
搜尋指引
- API 會對查詢標記進行 AND 運算，因此從具體但不過度限制開始。例如，在加入確切的 family 與標準篩選條件之前，先使用
M3 SHCS 12。 - 單一篩選條件內的值會進行 OR 運算，而選取的
tag、category、family和standard欄位則會進行 AND 運算。使用確切篩選條件在已知類別內縮小範圍，然後依名稱與屬性手動排序。 - 標準可以查詢為
ISO 4762、ISO4762或確切的standard.designation。 attributes物件包含 family 特定的資訊，例如thread、lengthMm、bore1Mm、material、profileSeries、slotSizeMm以及以毫米為單位的尺寸。- 零件、GLB 和 PNG 的 URL 模式在
https://www.step.parts上是可預測的；STEP URL 會感知環境，並可能在生產環境中解析為 GitHub LFS 媒體。下載時請使用目錄/API 的stepUrl。
