RoboParts 机器人零部件兼容性

{'type': 'object', 'required': ['component_ids'], 'properties': {'component_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': '待校验的零件 ID 列表，如 ["ACT-001","SENS-001","PROTO-012"]。ID 必须真实存在：先用 search_components 取得，不要自行拼造（ID 前缀与 category 非一一对应）。支持主库零件与开源贡献层 OSS-xxx 混合。至少传 2 个才有意义。'}}}

{'type': 'object', 'required': ['component1_id', 'component2_id'], 'properties': {'component1_id': {'type': 'string', 'description': '零件 1 的 ID，形如 ACT-001 / CHIP-001 / PROTO-012。请先用 search_components 取得，不要自行拼造：ID 前缀与 category 并非一一对应（例如 sensors 品类下存在 CHIP-67，platforms 下存在 ACT-patsnap-actuator；实时不一致条数见 GET /mcp 的 dataset.id_category_mismatch），按品类猜前缀会取到错误条目或直接查无此项。'}, 'component2_id': {'type': 'string', 'description': '零件 2 的 ID，取值方式同 component1_id。两个 ID 可以属于不同品类（跨品类比对正是本工具的用途）。'}}}

{'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6, 'minItems': 2, 'description': '待对比零部件 ID 数组（2~6 个），形如 ["ACT-001", "ACT-002"]。请先用 search_components 确认 ID。'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': '零部件 ID，如 ACT-001 / CHIP-001 / SENS-001。大小写与连字符需完全匹配，不做模糊查找；建议先由 search_components 返回值取得。注意 ID 前缀不能反推 category（库内存在前缀与品类不一致的条目，实时条数见 GET /mcp 的 dataset.id_category_mismatch）。'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {'scope': {'enum': ['all', 'conflicts'], 'type': 'string', 'default': 'all', 'description': '返回范围：all=完整审计报告（默认）；conflicts=仅数据质量冲突条目。'}}}

{'type': 'object', 'required': ['urdf_xml'], 'properties': {'urdf_xml': {'type': 'string', 'description': 'URDF XML 文件内容（完整 XML 字符串，含 <?xml ... ?> 声明）。支持 DOMParser 与正则 fallback 双解析路径。最大 512KB，超出截断并返回 parse_error。'}, 'check_level': {'enum': ['all', 'errors_only', 'warnings_and_errors'], 'type': 'string', 'default': 'all', 'description': '检查严格度：all=全部检查（默认），errors_only=仅返回 error 级别，warnings_and_errors=warning+error。'}}}

{'type': 'object', 'required': ['application'], 'properties': {'count': {'type': 'number', 'default': 3, 'description': '每品类返回条数，默认 3，上限 10（超出按 10 截断）。四个品类各自独立计数。'}, 'budget': {'type': 'number', 'description': '单件预算上限（USD，正数），可选。**价格字段覆盖率有限**（实时覆盖数见 GET /mcp 的 dataset.priced），因此本参数只能剔除「确定超预算」的条目，不能保证结果全部在预算内。每条结果会附 price_fit：within（确定在预算内）/ partial（区间跨越预算）/ unknown（库内无价格，未经校验）。不传则不做任何价格筛选，也不返回 price_fit。'}, 'application': {'enum': ['humanoid', 'quadruped', 'robot_arm', 'amr', 'industrial'], 'type': 'string', 'description': '应用场景，必填，取值限 enum。判定方式是拿一组固定场景词去匹配条目的 applications/name/type/description 字段，而非人工标注的场景分类：humanoid=人形/双足，quadruped=四足，robot_arm=机械臂/协作臂，amr=移动机器人/AGV，industrial=工业产线。若某品类下无任何条目命中该场景，该品类会退化为品类罗列并在 scene_matched=false 中标明，此时结果不代表适配该场景，应改用 search_components 按具体参数筛选。'}}}

{'type': 'object', 'required': ['component1_id', 'component2_id'], 'properties': {'component1_id': {'type': 'string', 'description': '零件 1 的 ID，形如 ACT-001 / CHIP-001 / PROTO-012。请先用 search_components 取得，不要自行拼造。'}, 'component2_id': {'type': 'string', 'description': '零件 2 的 ID，取值方式同 component1_id。两个 ID 可以属于不同品类。'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'default': 10, 'description': '返回条数上限，默认 10，最大 50（超出按 50 截断）。'}, 'keyword': {'type': 'string', 'description': '关键词，对 name / name_en / manufacturer / type / protocol / interface / description 七个字段做大小写不敏感的**子串**匹配（非分词、非模糊、不纠错）。**中英文命中集合可能完全不重叠**，务必两种都试：实测 "六维力" 命中 16 条、"force torque" 命中 2 条、交集为 0（部分国产条目尚无英文名）。多个词不做 AND 拆分，"harmonic drive 20Nm" 会被当作一整个串匹配，实测返回 0 条；请只给一个词（如 "harmonic" 命中 9 条），再用 category 收窄。'}, 'category': {'enum': ['actuators', 'sensors', 'chips', 'interfaces', 'protocols', 'llms', 'platforms', 'flexible_actuators', 'robot_ai_models', 'data_acquisition', 'connectors', 'integrated_joints', 'reducers', 'controllers', 'grippers', 'structural', 'cables', 'power', 'pcb', 'bionic_mechanisms'], 'type': 'string', 'description': '品类精确筛选，取值必须来自 enum（严格相等，不做别名映射：传 "actuator"、"电机" 均返回空）。不传则跨全部 20 个品类检索。注意品类与 ID 前缀不是一一对应的，请以本字段为准。'}, 'include_market_intelligence': {'type': 'boolean', 'default': False, 'description': '默认 false。库内另有 3 条市场情报条目（专利地图/咨询报告/趋势条目），它们不是可采购零件，默认不返回；仅在你确实想查行业研究材料时设为 true。'}}}

{'type': 'object', 'required': ['query'], 'properties': {'k': {'type': 'number', 'default': 5, 'description': '语义召回返回的候选零部件条数（top-k），默认 5，取值 1–30；数值越大召回越广但越可能偏离查询意图。'}, 'query': {'type': 'string', 'description': '自然语言查询，如"六维力传感器 防水"或"ROS2 通信模组"。中英文均可，建议具体。'}}}