RoboParts 机器人零部件兼容性

搜索机器人零部件。可按品类、关键词筛选，返回匹配条目的摘要（id/name/category/manufacturer/关键规格/证据等级）。覆盖执行器、传感器、芯片、通信协议、接口、机器人平台、具身智能模型等 20 个品类。库存实时口径（总数/可选型/已隔离）见 initialize 的 instructions 或 GET /mcp 的 dataset 字段 —— 此处不写死数字，避免文案与真实库存漂移。

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "品类精确筛选，取值必须来自 enum（严格相等，不做别名映射：传 \"actuator\"、\"电机\" 均返回空）。不传则跨全部 20 个品类检索。注意品类与 ID 前缀不是一一对应的，请以本字段为准。",
      "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"
      ]
    },
    "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 收窄。"
    },
    "limit": {
      "type": "number",
      "description": "返回条数上限，默认 10，最大 50（超出按 50 截断）。",
      "default": 10
    },
    "include_market_intelligence": {
      "type": "boolean",
      "description": "默认 false。库内另有 3 条市场情报条目（专利地图/咨询报告/趋势条目），它们不是可采购零件，默认不返回；仅在你确实想查行业研究材料时设为 true。",
      "default": false
    }
  }
}

按 ID 获取单个零部件的完整字段，包含 source_tier（数据来源等级）、confidence（置信度）、data_quality 与 mechanical_interface 等元数据。用于在做出采购/设计决策前核对证据强度。

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

判定两个零部件在 protocol（协议）/ electrical（电气）/ mechanical（机械）/ software（ROS2）四个维度的兼容性，返回逐维结论、总体判定与置信说明。注意：结论基于厂商公开声明字段做规则推断，非实验室实测；厂商未声明的维度记为"无法判定"，既不计入兼容也不计入不兼容。

{
  "type": "object",
  "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 可以属于不同品类（跨品类比对正是本工具的用途）。"
    }
  },
  "required": [
    "component1_id",
    "component2_id"
  ]
}

并排对比 2~6 个零部件的关键参数（torque/speed/voltage/protocol/interface/weight/price），相同值自动标注，替代为同一目的连发多次 get_component_detail。缺失字段以 null 呈现，不代表不支持该特性；跨厂商数值比较请配合 get_parameter_semantics。

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

按应用场景推荐零部件组合，可选预算上限（USD）。返回各品类的候选项及推荐理由。这是基于库内字段的启发式筛选，不构成工程选型意见，最终仍需核对厂商原始数据手册。

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

获取参数口径规范：同一个 torque/speed 字段在不同厂商那里含义可能不同（库内 torque 出现 19 种口径、speed 37 种，甚至混入 Gbps 与 rad/s）。本工具返回物理红线、单位换算、可比性分级与向厂商问询的清单，用于判断两份参数表到底能不能直接比较。

{
  "type": "object",
  "properties": {}
}

对一组零部件（BOM，物料清单）做两两兼容性矩阵。输入已有条目 ID（可含开源贡献层 OSS-xxx），返回每个组合在 protocol/electrical/mechanical/software 四维的判定与理由。判定基于厂商公开声明字段的规则推断而非实测；未声明维度记为无法判定，不会为了填满矩阵而编造结论。返回的 verdict_reason 才是结论依据，overall_compatible=null 表示"证据不足"，不等于不兼容。

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

用自然语言描述需求（如"人形机器人髋部高扭矩电机"）做语义召回，返回最相近的零部件。语义索引由离线哈希 TF-IDF 向量（构建时预计算、零外发、零外部模型）在当前全量实体上生成，是兼容性判定之外的"发现"通道：当你不确定零件的确切型号或参数名时，用它比关键词子串匹配更稳。索引不可用时自动降级为关键词检索，并明确告知。

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

返回标准登记表 ↔ 实体声明 的自动交叉校验结果：哪些机械/总线声明能被已知标准集核实、哪些声明的编码不在已知指定集中（无法核实），以及登记表缺口与行业标准覆盖情况。这是数据质量自检，不是兼容性裁决；其作用是指出"声明了但出处存疑"的条目，供人工补全证据。

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

对两个零部件做「多 Agent 质保复核」：Worker 层执行标准四维兼容性裁决（与 /api/compatibility 同一引擎），Governor 层独立复核结论——按证据强度给出 L0–L3 风险分级、在证据不足 2 条时把"兼容"降级为"需人工确认"、对无法判定项显式列出缺失证据段。返回四维细节 + 证据契约 + governor_review。只读、免鉴权。

{
  "type": "object",
  "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 可以属于不同品类。"
    }
  },
  "required": [
    "component1_id",
    "component2_id"
  ]
}

对 URDF（Unified Robot Description Format）XML 文件做静态兼容性检查。返回结构化 JSON 报告，含 severity（error/warning/info）、issues 数组、summary 与 stats。检查 10 类问题：XML 解析错误、缺失根 link、关节限位缺失、关节类型非法、重复 link 名、运动学树循环、缺少 ROS 工业标准帧（flange/tool0/base）、缺少 origin、缺少 inertial 数据、mesh 路径问题。只读、免鉴权。适用于上传 URDF 到 RoboParts 前做兼容性预检。

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