find-stl

此工具为专注于实体原型制作与增材制造的 AI 代理提供了一个确定性的工作流。它能自动执行搜索、验证与获取 Printables 上的 3D 模型文件，缩短设计概念与实体产出之间的距离。AI 代理可利用此工具精准定位合适的零件，确保文件类型正确，并自动建立工程项目所需的文件结构。

该技能会为每个下载的模型生成结构化的 manifest.json，详细记录来源网址、作者、授权信息与文件哈希值 (checksums)，这对法规遵循与专业项目管理至关重要。它是工程师、创客与设计师快速获取经验证的 CAD 或网格资产 (STL, 3MF, ZIP) 并直接进行打印或检查的理想工具。

• 整合 Printables GraphQL 接口，有效解析具时效性的下载链接。

• 通过命令行接口进行精确搜索、数量限制与完整模型包下载。

• 自动生成清单文件，记录来源 URL、作者信息、授权 ID 与文件哈希，维持项目文件的完整性。

• 批处理文件组织功能，将资产存放至指定的输出目录，方便后续对接切片软件或进行 CAD 修改。

• 支持多种格式采集，优先处理 STL 与 3MF 等打印专用文件，加速制造准备阶段。

• 请确保已安装 Python 3 以执行 scripts/ 目录下的脚本。

• 请务必检查 manifest.json 中的授权信息，确保符合模型作者的要求。

• 建议将此工具整合至自动化流程中，即 AI 代理先识别零件需求（例如“iPhone 15 Pro 底座”），接着执行下载并通知用户进行打印。

• 请注意 Printables 的下载链接具有时效性，脚本会通过 API 处理链接取得，建议在搜索后尽快下载。

• 常见输入为具体的搜索关键词，输出则为包含原始模型文件与必要清单信息的本地化文件夹。