{
  "schema_version": "1.1",
  "generated_by": "scripts/gen_skills_manifest.mjs（从 functions/mcp.js 的 TOOLS 生成，勿手改）",
  "provider": "RoboParts",
  "summary": "把 RoboParts 具身系统组合校验能力封装为可被其他 Agent 框架（WorkBuddy / Dify / Coze / Cursor / Claude）一键接入的 Skills。判定零件能否装配/共装/互换，输出可核验的三态结论。国际标准锚点：ISO 9409-1（法兰几何）+ ISO 22166-1（模块化框架，德国主导，ISO/AWI 22166-1 FDIS 2026-04-05）+ GB/T 20255807-T-604（国内模块化信息模型，审查中）。底层统一走免鉴权只读 MCP 端点，零安装、零 API Key。本清单由 MCP 工具定义自动生成，参数与线上端点逐字一致。",
  "mcp_server": "https://roboparts.cc/mcp",
  "mcp_registry_name": "cc.roboparts/roboparts",
  "skills": [
    {
      "name": "roboparts-search",
      "title": "搜索机器人零部件",
      "type": "mcp_tool",
      "tool": "search_components",
      "description": "搜索机器人零部件。可按品类、关键词筛选，返回匹配条目的摘要（id/name/category/manufacturer/关键规格/证据等级）。覆盖执行器、传感器、芯片、通信协议、接口、机器人平台、具身智能模型等 20 个品类。库存实时口径（总数/可选型/已隔离）见 initialize 的 instructions 或 GET /mcp 的 dataset 字段 —— 此处不写死数字，避免文案与真实库存漂移。",
      "when_to_use": "用户想找某类机器人零件（执行器/传感器/芯片/协议/平台），或给出型号片段需要补全信息时。",
      "guardrails": "只读检索，不写库；中英文命中集合可能不重叠，须两种语言都试；未声明字段不得臆测为「无此物」。",
      "params": [
        {
          "name": "category",
          "type": "string",
          "required": false,
          "desc": "品类精确筛选，取值必须来自 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"
          ]
        },
        {
          "name": "keyword",
          "type": "string",
          "required": false,
          "desc": "关键词，对 name / name_en / manufacturer / type / protocol / interface / description 七个字段做大小写不敏感的**子串**匹配（非分词、非模糊、不纠错）。**中英文命中集合可能完全不重叠**，务必两种都试：实测 \"六维力\" 命中 16 条、\"force torque\" 命中 2 条、交集为 0（部分国产条目尚无英文名）。多个词不做 AND 拆分，\"harmonic drive 20Nm\" 会被当作一整个串匹配，实测返回 0 条；请只给一个词（如 \"harmonic\" 命中 9 条），再用 category 收窄。"
        },
        {
          "name": "limit",
          "type": "number",
          "required": false,
          "desc": "返回条数上限，默认 10，最大 50（超出按 50 截断）。"
        },
        {
          "name": "include_market_intelligence",
          "type": "boolean",
          "required": false,
          "desc": "默认 false。库内另有 3 条市场情报条目（专利地图/咨询报告/趋势条目），它们不是可采购零件，默认不返回；仅在你确实想查行业研究材料时设为 true。"
        }
      ]
    },
    {
      "name": "roboparts-component-detail",
      "title": "查询单个零部件详情",
      "type": "mcp_tool",
      "tool": "get_component_detail",
      "description": "按 ID 获取单个零部件的完整字段，包含 source_tier（数据来源等级）、confidence（置信度）、data_quality 与 mechanical_interface 等元数据。用于在做出采购/设计决策前核对证据强度。",
      "when_to_use": "已经拿到零部件 ID（如 ACT-001），需要完整规格、厂商、证据等级与数据缺口时。",
      "guardrails": "只读；source_tier/confidence 仅表示证据强度，非厂商背书；quarantine=true 的条目须明示「不应直接用于决策」。",
      "params": [
        {
          "name": "id",
          "type": "string",
          "required": true,
          "desc": "零部件 ID，如 ACT-001 / CHIP-001 / SENS-001。大小写与连字符需完全匹配，不做模糊查找；建议先由 search_components 返回值取得。注意 ID 前缀不能反推 category（库内存在前缀与品类不一致的条目，实时条数见 GET /mcp 的 dataset.id_category_mismatch）。"
        }
      ]
    },
    {
      "name": "roboparts-compat-check",
      "title": "四维兼容性判定",
      "type": "mcp_tool",
      "tool": "check_compatibility",
      "description": "判定两个零部件在 protocol（协议）/ electrical（电气）/ mechanical（机械）/ software（ROS2）四个维度的兼容性，返回逐维结论、总体判定与置信说明。注意：结论基于厂商公开声明字段做规则推断，非实验室实测；厂商未声明的维度记为\"无法判定\"，既不计入兼容也不计入不兼容。",
      "when_to_use": "用户问「A 和 B 能不能装一起」「这两个零件兼容吗」「选型有没有冲突」时。",
      "guardrails": "只读裁决；overall=null 一律不得表述为「不兼容」；判 true 至少需一项硬约束（协议/电气/机械）有双方声明，不得凭单维证据盖章。",
      "params": [
        {
          "name": "component1_id",
          "type": "string",
          "required": true,
          "desc": "零件 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），按品类猜前缀会取到错误条目或直接查无此项。"
        },
        {
          "name": "component2_id",
          "type": "string",
          "required": true,
          "desc": "零件 2 的 ID，取值方式同 component1_id。两个 ID 可以属于不同品类（跨品类比对正是本工具的用途）。"
        }
      ]
    },
    {
      "name": "roboparts-recommend",
      "title": "按应用场景推荐组合",
      "type": "mcp_tool",
      "tool": "recommend_for_application",
      "description": "按应用场景推荐零部件组合，可选预算上限（USD）。返回各品类的候选项及推荐理由。这是基于库内字段的启发式筛选，不构成工程选型意见，最终仍需核对厂商原始数据手册。",
      "when_to_use": "用户要「给某类机器人配一套零件」「预算 X 元怎么选」时。",
      "guardrails": "只读启发式筛选，不构成工程选型意见；price_fit=unknown 不得表述为「符合预算」；预算仅剔除确定超支项。",
      "params": [
        {
          "name": "application",
          "type": "string",
          "required": true,
          "desc": "应用场景，必填，取值限 enum。判定方式是拿一组固定场景词去匹配条目的 applications/name/type/description 字段，而非人工标注的场景分类：humanoid=人形/双足，quadruped=四足，robot_arm=机械臂/协作臂，amr=移动机器人/AGV，industrial=工业产线。若某品类下无任何条目命中该场景，该品类会退化为品类罗列并在 scene_matched=false 中标明，此时结果不代表适配该场景，应改用 search_components 按具体参数筛选。",
          "enum": [
            "humanoid",
            "quadruped",
            "robot_arm",
            "amr",
            "industrial"
          ]
        },
        {
          "name": "budget",
          "type": "number",
          "required": false,
          "desc": "单件预算上限（USD，正数），可选。**价格字段覆盖率有限**（实时覆盖数见 GET /mcp 的 dataset.priced），因此本参数只能剔除「确定超预算」的条目，不能保证结果全部在预算内。每条结果会附 price_fit：within（确定在预算内）/ partial（区间跨越预算）/ unknown（库内无价格，未经校验）。不传则不做任何价格筛选，也不返回 price_fit。"
        },
        {
          "name": "count",
          "type": "number",
          "required": false,
          "desc": "每品类返回条数，默认 3，上限 10（超出按 10 截断）。四个品类各自独立计数。"
        }
      ]
    },
    {
      "name": "roboparts-compare",
      "title": "多零部件参数并排对比",
      "type": "mcp_tool",
      "tool": "compare_components",
      "description": "并排对比 2~6 个零部件的关键参数（torque/speed/voltage/protocol/interface/weight/price），相同值自动标注，替代为同一目的连发多次 get_component_detail。缺失字段以 null 呈现，不代表不支持该特性；跨厂商数值比较请配合 get_parameter_semantics。",
      "when_to_use": "用户要在 2~6 个零部件之间横向比较参数（扭矩/电压/协议/价格等），或说「帮我对比这几个型号」时，一次调用替代连发多次 get_component_detail。",
      "guardrails": "只读；缺失字段以 null 呈现，不得表述为「不支持该特性」；跨厂商数值比较须配合 get_parameter_semantics 与厂商规格书核对，不得直接断言优劣。",
      "params": [
        {
          "name": "ids",
          "type": "array",
          "required": true,
          "desc": "待对比零部件 ID 数组（2~6 个），形如 [\"ACT-001\", \"ACT-002\"]。请先用 search_components 确认 ID。"
        }
      ]
    },
    {
      "name": "roboparts-parameter-semantics",
      "title": "参数口径语义查询",
      "type": "mcp_tool",
      "tool": "get_parameter_semantics",
      "description": "获取参数口径规范：同一个 torque/speed 字段在不同厂商那里含义可能不同（库内 torque 出现 19 种口径、speed 37 种，甚至混入 Gbps 与 rad/s）。本工具返回物理红线、单位换算、可比性分级与向厂商问询的清单，用于判断两份参数表到底能不能直接比较。",
      "when_to_use": "用户问「这个扭矩参数靠谱吗」「不同厂商参数怎么比」「单位怎么换算」时。",
      "guardrails": "只读；返回物理红线与单位换算，不直接断言跨厂商参数可比，须提示向厂商核对原始手册。",
      "params": []
    },
    {
      "name": "roboparts-bom-compat",
      "title": "BOM 两两兼容性矩阵",
      "type": "mcp_tool",
      "tool": "bom_compatibility_check",
      "description": "对一组零部件（BOM，物料清单）做两两兼容性矩阵。输入已有条目 ID（可含开源贡献层 OSS-xxx），返回每个组合在 protocol/electrical/mechanical/software 四维的判定与理由。判定基于厂商公开声明字段的规则推断而非实测；未声明维度记为无法判定，不会为了填满矩阵而编造结论。返回的 verdict_reason 才是结论依据，overall_compatible=null 表示\"证据不足\"，不等于不兼容。",
      "when_to_use": "用户给了一整张零件清单 / BOM（如 [\"ACT-001\",\"SENS-001\"]），问这些零件彼此之间在电气 / 机械 / 协议 / 软件四维是否兼容、冲突在哪时。",
      "guardrails": "只读；overall_compatible=null 表示证据不足，不等于不兼容；semantic_hint 仅作人工核查线索，非兼容性结论。",
      "params": [
        {
          "name": "component_ids",
          "type": "array",
          "required": true,
          "desc": "待校验的零件 ID 列表，如 [\"ACT-001\",\"SENS-001\",\"PROTO-012\"]。ID 必须真实存在：先用 search_components 取得，不要自行拼造（ID 前缀与 category 非一一对应）。支持主库零件与开源贡献层 OSS-xxx 混合。至少传 2 个才有意义。"
        }
      ]
    },
    {
      "name": "roboparts-semantic-search",
      "title": "自然语言语义召回零部件",
      "type": "mcp_tool",
      "tool": "semantic_search",
      "description": "用自然语言描述需求（如\"人形机器人髋部高扭矩电机\"）做语义召回，返回最相近的零部件。语义索引由离线哈希 TF-IDF 向量（构建时预计算、零外发、零外部模型）在当前全量实体上生成，是兼容性判定之外的\"发现\"通道：当你不确定零件的确切型号或参数名时，用它比关键词子串匹配更稳。索引不可用时自动降级为关键词检索，并明确告知。",
      "when_to_use": "用户用自然语言描述需求（如「人形机器人髋部高扭矩电机」「六维力传感器 防水」），不确定确切型号或参数名，需要发现式检索而非精确筛选时。",
      "guardrails": "只读；语义索引为离线 TF-IDF 哈希，索引不可用时须明确降级为关键词检索，不得假装语义检索成功。",
      "params": [
        {
          "name": "query",
          "type": "string",
          "required": true,
          "desc": "自然语言查询，如\"六维力传感器 防水\"或\"ROS2 通信模组\"。中英文均可，建议具体。"
        },
        {
          "name": "k",
          "type": "number",
          "required": false,
          "desc": "语义召回返回的候选零部件条数（top-k），默认 5，取值 1–30；数值越大召回越广但越可能偏离查询意图。"
        }
      ]
    },
    {
      "name": "roboparts-standard-audit",
      "title": "标准符合性自校验",
      "type": "mcp_tool",
      "tool": "get_standard_audit",
      "description": "返回标准登记表 ↔ 实体声明 的自动交叉校验结果：哪些机械/总线声明能被已知标准集核实、哪些声明的编码不在已知指定集中（无法核实），以及登记表缺口与行业标准覆盖情况。这是数据质量自检，不是兼容性裁决；其作用是指出\"声明了但出处存疑\"的条目，供人工补全证据。",
      "when_to_use": "用户想核对某零件 / 厂商声明的标准符合性，或想知道哪些声明能被已知标准集核实、哪些是出处存疑的条目时。",
      "guardrails": "只读自检，不裁决；作用是指出「声明了但出处存疑」的条目供人工补全证据，不得据此断言某标准符合/不符合。",
      "params": [
        {
          "name": "scope",
          "type": "string",
          "required": false,
          "desc": "返回范围：all=完整审计报告（默认）；conflicts=仅数据质量冲突条目。",
          "enum": [
            "all",
            "conflicts"
          ]
        }
      ]
    },
    {
      "name": "roboparts-compat-review",
      "title": "多Agent质保复核兼容性",
      "type": "mcp_tool",
      "tool": "review_compatibility",
      "description": "对两个零部件做「多 Agent 质保复核」：Worker 层执行标准四维兼容性裁决（与 /api/compatibility 同一引擎），Governor 层独立复核结论——按证据强度给出 L0–L3 风险分级、在证据不足 2 条时把\"兼容\"降级为\"需人工确认\"、对无法判定项显式列出缺失证据段。返回四维细节 + 证据契约 + governor_review。只读、免鉴权。",
      "when_to_use": "对外发布 / 采购决策前要对兼容性结论做第二双眼睛复核时：给出 L0–L3 风险分级、证据不足时降级、缺失证据显式列出。",
      "guardrails": "只读裁决，不写库、不生成文件；证据不足 2 条时不得向用户输出『确认兼容』，必须附 governor_review.risk_level 与 recommended_next_step。",
      "params": [
        {
          "name": "component1_id",
          "type": "string",
          "required": true,
          "desc": "零件 1 的 ID，形如 ACT-001 / CHIP-001 / PROTO-012。请先用 search_components 取得，不要自行拼造。"
        },
        {
          "name": "component2_id",
          "type": "string",
          "required": true,
          "desc": "零件 2 的 ID，取值方式同 component1_id。两个 ID 可以属于不同品类。"
        }
      ]
    },
    {
      "name": "roboparts-urdf-lint",
      "title": "URDF 兼容性检查",
      "type": "mcp_tool",
      "tool": "lint_urdf",
      "description": "对 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 前做兼容性预检。",
      "when_to_use": "用户上传或引用 URDF XML 文件，想做兼容性预检、检查运动学树完整性、或验证是否符合 ROS 工业标准帧规范时。",
      "guardrails": "只读静态分析，不修改 URDF 文件、不生成新文件；severity=error 时不得视为通过，必须向用户列出全部 error 级 issue 并建议修复后再提交。",
      "params": [
        {
          "name": "urdf_xml",
          "type": "string",
          "required": true,
          "desc": "URDF XML 文件内容（完整 XML 字符串，含 <?xml ... ?> 声明）。支持 DOMParser 与正则 fallback 双解析路径。最大 512KB，超出截断并返回 parse_error。"
        },
        {
          "name": "check_level",
          "type": "string",
          "required": false,
          "desc": "检查严格度：all=全部检查（默认），errors_only=仅返回 error 级别，warnings_and_errors=warning+error。",
          "enum": [
            "all",
            "errors_only",
            "warnings_and_errors"
          ]
        }
      ]
    },
    {
      "name": "roboparts-compose-frontier",
      "title": "三轴组合裁决与 composed=0 归因",
      "type": "mcp_tool",
      "tool": "explain_compose_frontier",
      "description": "【研究层口径 · 与 check_compatibility 的四维不同】查询 RoboParts 三轴组合判定（mechanical 机械 / electrical 电气 / signal 信号角色）的现算结论：整体 composed/type_error/unknown、逐轴裁决与理由，以及「为什么 composed 通常为 0」的归因（L1 跨角色 → L2 机械可判定 → L3 全轴可判定的三层分解）。适合回答「这两个零件为什么判为 type_error」「哪些配对能真的装起来」「composed=0 是数据缺口还是关系类型问题」。只读、免鉴权。**注意口径差异**：本工具用 signal 角色互补（执行器↔传感器），check_compatibility 用 protocol 总线 + ROS2 支持，两者维度不同不可混用。",
      "when_to_use": "用户问「这两个零件为什么判为 type_error」「哪些配对能真的装起来」「composed 是不是 0」「为什么机械能拧上但组合判不出来」，或需要研究层口径（三轴 mechanical/electrical/signal）结论时。",
      "guardrails": "★ 口径隔离：本报表用 signal 角色互补（执行器↔传感器），check_compatibility 用 protocol 总线 + ROS2 支持——**两者维度不同，结论不可混用或直接比较**。本工具只透传研究层现算结论，不重新裁决。库级模式下 composed=0 是关系类型错配（cobot EOAT 各占机器人侧一个接口，真实关系是共装而非直连），**不得**把它当成数据缺口或未完成。",
      "params": [
        {
          "name": "component1_id",
          "type": "string",
          "required": false,
          "desc": "零件 1 的 ID，形如 ACT-001 / GRIP-002 / SENS-852。请先用 search_components 取得。"
        },
        {
          "name": "component2_id",
          "type": "string",
          "required": false,
          "desc": "零件 2 的 ID。若省略，则只返回库级聚合结论（frontier 概览 + composed 归因）。"
        }
      ]
    },
    {
      "name": "roboparts-evidence-cohort",
      "title": "最小可行同质集取证判据",
      "type": "mcp_tool",
      "tool": "explain_evidence_cohort",
      "description": "【研究层口径】查询「最小可行同质集」取证判据：补哪一条数据最值、为什么单条声明的边际收益为 0、以及应按缺口画像批量取证的顺序。适合回答「取证该从哪开始」「补机械声明率有没有用」「K=2 是什么意思」。只读、免鉴权。",
      "when_to_use": "用户问「取证该从哪开始」「补哪条数据最值」「补机械声明率有没有用」「K=2 是什么意思」时。",
      "guardrails": "只读透传研究层现算结论，不重新裁决。口径与 check_compatibility 的四维不同，不可混用。",
      "params": []
    },
    {
      "name": "roboparts-evidence-mdv",
      "title": "边际声明价值与零贡献轴",
      "type": "mcp_tool",
      "tool": "explain_evidence_mdv",
      "description": "【研究层口径】查询边际声明价值（MDV）：各轴未声明节点的零贡献率、哪些取证方向边际收益恒为 0、以及瓶颈轴是哪个。适合回答「补哪个轴最划算」「某个轴还有取证价值吗」。只读、免鉴权。口径与 check_compatibility 不同，不可混用。",
      "when_to_use": "用户问「补哪个轴最划算」「某轴还有取证价值吗」「机械声明率低是不是真问题」时。",
      "guardrails": "只读透传研究层现算结论。zero_mdv_nodes=100% 的轴不得再建议取证——那是可证明的无效投入。",
      "params": []
    },
    {
      "name": "roboparts-connector-types",
      "title": "连接器类型判据（三元组）",
      "type": "mcp_tool",
      "tool": "explain_connector_types",
      "description": "【研究层口径】查询连接器取证与类型判据：已核实的连接器（针数/针序/供电）、「同族不同变体」的不可互插案例，以及 (family, pins, pinout) 三元组判据。适合回答「这两个连接器能不能互插」「同为 M8 为什么判不兼容」「pinout 为 null 是什么意思」。只读、免鉴权。",
      "when_to_use": "用户问「这两个连接器能不能互插」「同为 M8 为什么判不兼容」「pinout 为 null 是什么意思」时。",
      "guardrails": "只读透传。pinout=null 表示「厂商未公开」，**不得**按同类推断针序；family 相同不等于可互插。",
      "params": []
    },
    {
      "name": "roboparts-research-progress",
      "title": "核心目标完成度",
      "type": "mcp_tool",
      "tool": "get_research_progress",
      "description": "查询「核心目标完成度」的可复现判据：把核心目标（脑×体×智做成机器可校验的组合 + 全链路可溯源）拆成四个维度的分项，每项给出分子/分母/口径/剩余缺口，并报出门控与朴素两个口径的加权完成度。适合回答「这个项目做到什么程度了」「核心目标完成了几成」「composed 为什么是 0」。只读、免鉴权。★ 口径警告：这是**一个口径**下的数字，不是客观测量；权重可争议；且采用**门控口径**——核心判据（composed）为 0 时 body 维记 0，因为「判定基础设施建成」不等于「组合成立」。",
      "when_to_use": "用户问「这个项目做到什么程度了」「核心目标完成了几成」「composed 为什么是 0」时。",
      "guardrails": "★ 这是**一个口径**下的数字，不是客观测量。权重可争议。采用门控口径：核心判据 composed=0 时 body 维记 0——**判定基础设施建成不等于组合成立**，不得把基础设施得分当作核心目标已达成。",
      "params": []
    },
    {
      "name": "roboparts-co-mount",
      "title": "共装裁决（三段 A↔宿主↔B）",
      "type": "mcp_tool",
      "tool": "check_co_mount",
      "description": "查询**共装**关系（第三种关系类型，三段 A↔宿主↔B）：某个机器人本体能否同时装下两个器件（典型问题：「这台 UR5e 能同时装夹爪和六轴力传感器吗」）。与 check_compatibility 的区别：后者判「A 能不能插进 B」（二段互插），本工具判「A 和 B 能不能同时挂在同一台机器人的工具侧」。★ 三段判据：机械同型 + 宿主工具侧位数预算 + 信号角色互补。port_exhausted 表示「**装不下**（工程约束，如需转接/换本体）」，与 unknown（「数据不足，不知道」）严格区分。★ 参数：传 host+a+b 得单对裁决（附证据链）；只传 host 得该宿主的单件可装性 + 工具侧取证；不传参得全层摘要（含关系语义与示例）。只读、免鉴权。返回含 caliber 字段，口径与 check_compatibility 不同、不可混用。",
      "when_to_use": "用户问「这台机器人能不能同时装夹爪 A 和传感器 B」「两个夹爪能一起装吗」「为什么判 port_exhausted」时。",
      "guardrails": "只读透传研究层现算结论。**口径与 check_compatibility 不同、不可混用**：后者判二段互插，本工具判三段共装。port_exhausted = 装不下（工程约束，需转接/换本体），unknown = 数据不足（不知道）——**两者不可混为一谈**。",
      "params": [
        {
          "name": "host",
          "type": "string",
          "required": false,
          "desc": "宿主机器人 id，如 HUB-030（UR3e）、HUB-031（UR5e）、SUPERDEX-fr3。"
        },
        {
          "name": "a",
          "type": "string",
          "required": false,
          "desc": "器件 A 的实体 id，如 ACT-028。需与 b 同时给。"
        },
        {
          "name": "b",
          "type": "string",
          "required": false,
          "desc": "器件 B 的实体 id，如 SENS-047。需与 a 同时给。"
        }
      ]
    },
    {
      "name": "roboparts-tool-side",
      "title": "宿主工具侧接口取证",
      "type": "mcp_tool",
      "tool": "get_robot_tool_side",
      "description": "查询机器人本体的**工具侧接口取证**：工具法兰（ISO 9409-1 标号）、工具 I/O 位数、连接器型号与承载信号。适合回答「这台机器人工具侧有几个电气接口」「tool_io_ports 为什么是 null」「UR 的工具侧能挂几个传感器」。★ tool_io_ports 是**一手取证的整数位计数**（不是针数）；未取证者留 null，判据据此走 unknown，**不按型号名推断**。只读、免鉴权。",
      "when_to_use": "用户问「这台机器人工具侧有几个电气接口」「tool_io_ports 是多少」「为什么 FR3 判 unknown」时。",
      "guardrails": "只读透传。tool_io_ports 是**位计数（连接器数）不是针数**——UR 工具侧是单个 8-pin 连接器，位=1 针=8。未取证者留 null 并判 unknown，**不得按型号名推断**。",
      "params": []
    },
    {
      "name": "roboparts-behavior-evidence",
      "title": "行为证据（真机 benchmark）",
      "type": "mcp_tool",
      "tool": "get_behavior_evidence",
      "description": "查询**行为证据**：开源 VLA 在真机上的 benchmark 成功率（引用论文/官方报告，**非本仓自造日志**——本项目按锚点禁止造仿真器/训练栈）。适合回答「GR00T 真机成功率多少」「SmolVLA 有实测数据吗」「仿真成绩能不能当真机用」。★ 三条纪律：① 仿真（sim）与真机（real）**严格分列**，不可合并统计；② 只收录**有对照组**的数字（孤证可能是 cherry-pick）；③ 官方未报告的指标 value=null，不折算。样本量官方均未报告 ⇒ 不可用于统计比较。只读、免鉴权。",
      "when_to_use": "用户问「这个模型真机表现如何」「有没有实测成功率」「仿真成绩能当真机用吗」时。",
      "guardrails": "仿真(sim)与真机(real)**严格分列，不可合并统计**。只收录有对照组的数字（孤证可能是 cherry-pick）。官方未报告的指标 value=null，**不折算**。样本量官方均未报告 ⇒ 不可用于统计比较，只可作定性参照。本项目**不自造日志**（锚点禁止造仿真器/训练栈），引用官方公开数字。",
      "params": []
    },
    {
      "name": "roboparts-body-binding",
      "title": "开源VLA→本体绑定（强度分档）",
      "type": "mcp_tool",
      "tool": "get_body_binding",
      "description": "查询**开源 VLA → 机器人本体**的绑定及其强度分档。强度四档：validated（论文明写真机评测跑在该本体）/ family（论文列该族）/ adaptable（官方称可微调，非特定硬件验证）/ category_only（只登记类别）。另有两个**非绑定态**：blocked_missing_body（依据充分但本体不在库内）与 category_only。适合回答「OpenVLA 能装在哪台机器人上」「这个绑定可信吗」「为什么 SmolVLA 没有 body_robot」。★ 只绑开源 VLA——闭源模型无公开验证栈，不编造绑定。只读、免鉴权。",
      "when_to_use": "用户问「这个模型跑在什么机器人上」「绑定可信吗」「为什么 SmolVLA 没有 body_robot」时。",
      "guardrails": "强度四档 validated/family/adaptable/category_only + 两种非绑定态。**把 adaptable 当 validated 是过度声称**。只绑开源 VLA——闭源模型无公开验证栈，不编造绑定。blocked_missing_body 表示依据充分但**本体不在库内**，这是诚实阻塞不是缺陷。",
      "params": []
    },
    {
      "name": "roboparts-explain-unknown",
      "title": "为什么判 unknown（字段级证据缺口）",
      "type": "mcp_tool",
      "tool": "explain_unknown",
      "description": "结构化解释「为什么某次判定是 unknown」。三种模式：① component_id + category → 返回该实体的 evidence_gaps / null 字段清单；② verdict_id → 反查当前请求内的判定（hosted 端点无跨请求会话，仅回当前请求）；③ 无参 → 返回全库 unknown 覆盖率摘要。★ 口径纪律：字段级扫描 ≠ 因果归因（后者属 gap_classification 研究层）。只读、免鉴权。",
      "when_to_use": "用户问「为什么这次判定是 unknown」「这个零件缺哪些字段」「全库 unknown 覆盖率多少」时。",
      "guardrails": "★ 口径纪律：字段级扫描 ≠ 因果归因（后者属 gap_classification 研究层）。只读、免鉴权。unknown 表示「不知道」，不得改写为 compatible/incompatible。",
      "params": [
        {
          "name": "component_id",
          "type": "string",
          "required": false,
          "desc": "组件 ID，如 ACT-001、SENS-001"
        },
        {
          "name": "category",
          "type": "string",
          "required": false,
          "desc": "品类：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",
          "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"
          ]
        },
        {
          "name": "verdict_id",
          "type": "string",
          "required": false,
          "desc": "判定 verdict_id（hosted 端点仅当前请求内可查）"
        },
        {
          "name": "max_gaps",
          "type": "number",
          "required": false,
          "desc": "最多返回多少条缺口"
        }
      ]
    },
    {
      "name": "roboparts-start-long-task",
      "title": "启动长任务并返回任务句柄",
      "type": "mcp_tool",
      "tool": "start_long_task",
      "description": "启动长任务并返回任务句柄。★ hosted 端点（Cloudflare Workers）无跨请求内存持久化，任务句柄只在 stdio npm 包 （roboparts-mcp-server）里可用。本端点返回 honest_note 引导到 stdio 模式，不假装能保存跨请求任务。",
      "when_to_use": "用户要批量兼容性检查 / BOM 批量导出 / 深度方言评估，需轮询进度时。",
      "guardrails": "★ stdio npm 包（roboparts-mcp-server）有内存任务句柄；hosted 端点（Cloudflare Workers）无跨请求持久化，返回 honest_note 引导到 stdio，不假装能保存跨请求任务。",
      "params": [
        {
          "name": "task_type",
          "type": "string",
          "required": true,
          "desc": "预定义任务类型",
          "enum": [
            "batch_check_compatibility",
            "bulk_export_bom",
            "deep_dialect_evaluate"
          ]
        },
        {
          "name": "args",
          "type": "object",
          "required": false,
          "desc": "任务参数"
        }
      ]
    },
    {
      "name": "roboparts-get-task-status",
      "title": "查询长任务状态",
      "type": "mcp_tool",
      "tool": "get_task_status",
      "description": "查询长任务状态。★ hosted 端点无跨请求任务句柄，返回 honest_note 引导到 stdio 模式。",
      "when_to_use": "用户拿着 start_long_task 返回的 task_id 查进度/结果时。",
      "guardrails": "★ hosted 端点无跨请求任务句柄，返回 honest_note 引导到 stdio 模式。",
      "params": [
        {
          "name": "task_id",
          "type": "string",
          "required": true,
          "desc": "任务 ID（stdio 模式下 start_long_task 返回）"
        }
      ]
    },
    {
      "name": "roboparts-cancel-task",
      "title": "置任务取消标志位",
      "type": "mcp_tool",
      "tool": "cancel_task",
      "description": "置任务取消标志位。★ stdio 无中断通道，cancel 只置标志位；任务体在下一 checkpoint 才退出。hosted 端点无跨请求任务句柄，返回 honest_note 引导到 stdio。",
      "when_to_use": "用户想取消一个进行中的长任务时。",
      "guardrails": "★ stdio 无中断通道，cancel 只置标志位；任务体在下一 checkpoint 才退出。hosted 端点返回 honest_note 引导到 stdio。",
      "params": [
        {
          "name": "task_id",
          "type": "string",
          "required": true,
          "desc": "任务 ID"
        }
      ]
    },
    {
      "name": "roboparts-trace-export",
      "title": "导出调用轨迹（默认去敏）",
      "type": "mcp_tool",
      "tool": "trace_export",
      "description": "导出调用轨迹（默认去敏）。★ hosted 端点无跨请求内存持久化，trace 环形缓冲只在 stdio npm 包可用。本端点返回 honest_note 引导到 stdio 模式；stdio 支持 ROBOPARTS_TRACE_FILE 环境变量落盘 JSONL 供事后回放。",
      "when_to_use": "用户想审计一次外部 Agent 调用了哪些工具、参数是什么时。",
      "guardrails": "★ hosted 端点无跨请求内存持久化，trace 环形缓冲只在 stdio npm 包可用；stdio 支持 ROBOPARTS_TRACE_FILE 环境变量落盘 JSONL 供事后回放。默认去敏（api_key/token/password/secret 等→<redacted>）。",
      "params": [
        {
          "name": "limit",
          "type": "number",
          "required": false,
          "desc": "最多返回多少条"
        },
        {
          "name": "tool",
          "type": "string",
          "required": false,
          "desc": "按工具名过滤"
        },
        {
          "name": "since",
          "type": "string",
          "required": false,
          "desc": "ISO 8601 时间戳起点"
        },
        {
          "name": "redact",
          "type": "boolean",
          "required": false,
          "desc": "是否去敏（默认 true）"
        }
      ]
    },
    {
      "name": "roboparts-trace-replay",
      "title": "从 JSONL 重放轨迹",
      "type": "mcp_tool",
      "tool": "trace_replay",
      "description": "从 JSONL 文本重放轨迹（结构校验 + 计数）。本端点可处理**当前请求内传入的** json_lines；不做\"重算 verdict\"（语义重放属 P3，需要完整输入重演）。",
      "when_to_use": "用户拿到导出的 trace JSONL 想结构校验/计数时。",
      "guardrails": "★ 本工具可处理当前请求内传入的 json_lines；不做「重算 verdict」（语义重放属 P3，需完整输入重演）。",
      "params": [
        {
          "name": "json_lines",
          "type": "array",
          "required": true,
          "desc": "JSONL 行数组（每行一条 trace JSON）"
        },
        {
          "name": "strict",
          "type": "boolean",
          "required": false,
          "desc": "严格模式：首个 parse 失败即中断"
        }
      ]
    },
    {
      "name": "roboparts-adapter-generate",
      "type": "web_resource",
      "title": "生成法兰转接件",
      "endpoint": "https://roboparts.cc/adapter-generator",
      "description": "当两侧 ISO 9409-1 法兰（PCD/孔数/螺纹）不一致时，生成可 3D 打印的转接板。支持 URL 参数复现：?a=A80&b=A50&t=10&bore=20（a/b 为 A50/A80/A100/A160 或 CUSTOM:pcd:holes:thread:clr:pins:pinD）。",
      "when_to_use": "兼容性判定为不兼容、且根因是机械法兰不匹配时，直接产出解决方案而非只给结论。",
      "guardrails": "仅当兼容判定为机械法兰不匹配时使用；生成的是可 3D 打印的几何建议，承载/材料/公差须由工程师核对，不得直接作为量产件。",
      "params": [
        {
          "name": "a",
          "type": "string",
          "required": false,
          "desc": "侧 A 法兰：预设键 A50/A80/A100/A160 或 CUSTOM:..."
        },
        {
          "name": "b",
          "type": "string",
          "required": false,
          "desc": "侧 B 法兰：同上"
        },
        {
          "name": "t",
          "type": "number",
          "required": false,
          "desc": "转接板厚度 mm，默认 10"
        },
        {
          "name": "bore",
          "type": "number",
          "required": false,
          "desc": "中心通孔直径 mm，默认 20"
        }
      ]
    },
    {
      "name": "roboparts-dataset-discovery",
      "type": "dataset",
      "title": "公开数据集发现",
      "endpoint": "https://roboparts.cc/agent-discovery.json",
      "description": "发现 RoboParts 公开数据集端点并直接下载原始 JSON。注意：这不是一个 MCP 工具（端点未提供 dataset_discovery 工具），而是一组可直接 GET 的静态数据文件。",
      "when_to_use": "用户想下载/引用原始数据、做二次分析、或确认数据来源时。",
      "guardrails": "仅公开数据集的直接 GET 下载；不暴露任何内网/付费数据端点；数据集可能含 quarantine=true 条目，使用者须自行过滤；引用须注明 CC BY 4.0 出处。",
      "datasets": [
        {
          "url": "https://roboparts.cc/api/entities.json",
          "desc": "归一化零部件实体库（含证据等级与数据缺口标注）"
        },
        {
          "url": "https://roboparts.cc/api/oss_components.json",
          "desc": "开源机器人项目零部件摄取库（含溯源分级）"
        },
        {
          "url": "https://roboparts.cc/api/mechanical_interfaces.json",
          "desc": "ISO 9409-1 机械接口注册表"
        },
        {
          "url": "https://roboparts.cc/api/parameter_semantics.json",
          "desc": "参数口径规范与物理红线（CC BY 4.0）"
        }
      ]
    },
    {
      "name": "roboparts-supplier-risk",
      "type": "methodology",
      "title": "供应商异常研判",
      "endpoint": "https://roboparts.cc/docs/supplier-risk.html",
      "description": "基于 source_tier / confidence / quarantine / price_range 对机器人零部件供应商做实时可疑度打分与证据链研判，识别低价可疑、低证据高危、隔离项等风险。对口赛道二「制造供应链异常研判」的方法论页。",
      "when_to_use": "用户问「这家供应商靠谱吗」「这个价格是不是太低了」「哪些零件数据存疑」时，给出可审计的风险结论而非拍脑袋。",
      "guardrails": "所有判定基于库内 source_tier/confidence/quarantine/price_range 字段，不引入外部未验证信号；无 price_range 的条目（约 74%）不判风险，只标『数据缺口』；quarantine=true 强制标 critical，不因价格正常而降级。",
      "params": [
        {
          "name": "tier",
          "type": "string",
          "required": false,
          "desc": "最低证据等级过滤：A(官方发布)>B(厂商实测)>C(社区)>D(二手转述)，低于该等级标红"
        },
        {
          "name": "maxRisk",
          "type": "string",
          "required": false,
          "desc": "风险标签过滤：low/warning/critical"
        }
      ]
    }
  ]
}
