查找、评估和下载 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 或 .stp 文件的 step.parts 工作后，如果安装了 $cad-viewer 技能，必须始终将明确的文件路径传递给 $cad-viewer。$cad-viewer 必须启动 CAD 查看器（如果尚未运行）并返回相关创建或更新文件的链接；如果 $cad-viewer 不可用或启动失败，报告该情况，而不是静默省略交接。
捆绑下载器
使用 scripts/download_step_part.py 进行确定性搜索、下载和校验和验证：
python scripts/download_step_part.py "M3 socket head 12" --download
python scripts/download_step_part.py --id iso4762_socket_head_cap_screw_m3x12 --download
python scripts/download_step_part.py "bearing 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进行下载。
