SuperAPI AI 工具集

step-parts

设计与创作

查看项目

更新于 10-15 21:36

技能介绍

用途:该技能用于查找、评估和下载 step.parts 上的低层通用标准 CAD 零件,如螺丝、螺栓、螺母、垫圈、轴承、支撑柱和电子元件等。它通过托管的机器端点访问,而非抓取 HTML 或依赖本地仓库文件。规范 API 源为 https://api.step.parts,站点/静态资源源为 https://www.step.parts;若域名无法解析或 API 不可用,应报告托管服务暂不可达,不要回退到仓库特定假设。

主要能力:将请求解析为搜索词与可选分面,q 用于模糊词、标准、别名、尺寸、来源/产品 URL 及属性名值;category、family、standard、tag 用于精确分面。搜索 /v1/parts 并查看 items、total 和 facets。结果不明确时先展示少量候选的 id、name、standard 和关键属性;明确匹配则返回所选记录详情,除非用户要求下载本地 STEP 文件。下载时获取 stepUrl,并在存在 sha256 时校验文件,返回本地路径、零件 id 及页面/API URL 以便溯源。

使用方式:内置下载脚本 scripts/download_step_part.py 支持确定性搜索、下载与校验,例如:python skills/step-parts/scripts/download_step_part.py "M3 socket head 12" --download --out-dir /tmp/step-parts;也可用 --id iso4762_socket_head_cap_screw_m3x12 指定记录。选项包括 --origin(仅在用户提供其他托管 API 源时覆盖)、--tag/--category/--family/--standard(可重复分面过滤)、--out-dir(默认 /tmp/step-parts)、--all(配合 --download 下载返回页全部结果)、--overwrite。脚本以 JSON 输出到 stdout。

API 参考:需要端点细节、字段含义或查询语义时阅读 references/step-parts-api.md。优先使用 /v1/parts 过滤搜索(含绝对资源 URL)、/v1/parts/{id} 获取单条丰富记录、返回的 stepUrl 下载 STEP、/v1/catalog/parts.index.json 紧凑发现索引、/v1/catalog/schema 字段与族属性含义、/v1/openapi.json 生成客户端或工具。

搜索指引:查询词由 API 做 AND 组合,宜先具体但不过度约束,例如先用 M3 SHCS 12 再加精确 family 和 standard 过滤。同一分面内值做 OR,选定的 tag、category、family、standard 字段之间做 AND。标准可写作 ISO 4762、ISO4762 或精确 standard.designation。attributes 对象含族特定事实,如 thread、lengthMm、bore1Mm、material、profileSeries、slotSizeMm 及毫米尺寸。零件、GLB、PNG 的 URL 模式在 https://www.step.parts 上可预测;STEP URL 与环境相关,生产环境可能解析到 GitHub LFS 媒体,下载应使用 catalog/API 的 stepUrl。

限制:资料未提供收费、价格、平台支持范围或性能数据;实际可用性取决于托管服务是否可达。