用途:把 OpenAPI 3.x 或 Swagger 2.0 规范(YAML/JSON)转换为完整、可导入的 Postman Collection v2.1 JSON,适用于用户提供或引用 openapi.yaml、swagger.json 等规范文件时。
主要能力:先检测并校验规范版本(openapi: 3.x.x 为 OpenAPI 3,swagger: "2.0" 为 Swagger 2),再按映射规则提取字段——info.title 作为集合名、info.description 作为集合描述、servers[0].url 作为 {{base_url}} 变量、每个 path/method 生成一个请求项,operationId 或 summary 作为请求名,parameters 转为 URL 路径变量、查询参数与请求头,requestBody 或 body 参数生成原始 JSON 请求体示例,responses 保存为示例响应。按 tags 分组为文件夹。根据 schema 生成示例请求体,$ref 内联解析;安全方案映射为 Postman 认证(bearer 用 {{token}},basic 用 {{username}}/{{password}},apiKey 用 {{api_key}},oauth2 需手动配置令牌),共享认证置于集合级,例外在请求级覆盖。
输出:collection.json 与 environment.json,以及转换摘要(端点数、文件夹数、认证类型、跳过或近似的字段),并附导入说明。
限制:截断或部分规范仅转换已有部分并标注缺失;allOf/oneOf/anyOf 取首个主要 schema 并在描述中说明;多内容类型优先 application/json;无 operationId 时按 METHOD /path 命名;路径参数转为 :param 并加入 url 变量数组;所有 $ref 须内联解析,输出中不得残留原始 $ref;令牌须为 {{变量}} 而非硬编码。需在应用前验证命令、生成代码、依赖、凭据与外部服务行为,示例不能替代环境专属测试、安全审查或用户审批。完成后可询问是否生成 API 文档;若用户同意且已安装 API Documentation 技能,则以其为输入执行,否则提示未安装。官方介绍中未提供安装命令等更多信息。