数字主线连接器
数字主线通过连接器接入 MES · ERP · PLM 等客户系统，把「什么时候发生了什么、又与什么相关联」串起来。 本页按家族梳理连接器 —— 每个家族必须提供哪些工具、数字主线把它们用在哪里、需要注意什么。 在界面上进行注册 · 符合性 · 启用的方法见 数字主线。
本页以 2026.10 再发布（2026-10-20） 为准
自再发布（2026-10-20） 起，数字主线不再使用低于下列最低版本的连接器。使用更早版本接入的连接器必须升级 → 升级版本
一览 —— 十一个家族
| 家族 | 界面名称 | 规范 · 最低版本 | 必备工具 | 动作工具(🔒) | 新鲜度上限 · 同步 | 主要用途 |
|---|---|---|---|---|---|---|
mes | MES | mes-mcp/0.7 | 7 | 三个 | 2小时 · 1小时 | 作业就绪度 · 今日作业 · 恢复方案 · 时间线 —— 基础底座 |
scm | SCM | mes-mcp/0.7 | 5 | 两个 | 24小时 · 12小时 | 物料就绪度 · PO 主线 · 供应恢复 |
sched | 排产计划(APS) | mes-mcp/0.7 | 2 | 一个 | 2小时 · 1小时 | 恢复方案的基准计划 |
erp | ERP | erp-mcp/0.4 | 2 | 无 | 24小时 · 12小时 | 人员 · 资质，PO · 收货，客户订单，制造 BOM |
plm | PLM | plm-mcp/0.2 | 3 | 无 | 24小时 · 12小时 | 设计变更 · 版本确认 · BOM 比对 |
qm | 质量 | qm-mcp/0.2 | 3 | 无 | 24小时 · 12小时 | 质量就绪度 · 不合格延误 |
cmms | 维护(CMMS) | cmms-mcp/0.2 | 2 | 无 | 4小时 · 2小时 | 设备就绪度 · 维护窗口恢复 |
tool | 工具管理 | tool-mcp/0.2 | 2 + 功能 | 无 | 24小时 · 12小时 | 工具巡检 · 工具就绪度 |
wms | 仓库(WMS) | wms-mcp/0.2 | 3 | 无 | 2小时 · 1小时 | 延迟零件的库存 |
lims | 实验室(LIMS) | lims-mcp/0.2 | 2 | 无 | 12小时 · 6小时 | 批次试验报告 · 不合格事件 |
ehs | 安全(EHS) | ehs-mcp/0.3 | 2 + 功能 | 无 | 1小时 · 30分钟 | 作业许可就绪度 · 隔离窗口 |
scm·sched与 MES 属于同一规范主干(mes-mcp)下的不同家族。其余家族各有独立规范。- MES 是基础。没有 MES，整个作业就绪度判定就是「未接入」，仅靠其他家族得不出结论。
- 动作工具只存在于
mes-mcp主干(MES · SCM · 排产计划)。其余八个家族均为只读。
所有连接器通用的规则
镜像中只装载「键」
数字主线把从连接器读到的内容，只以键和连接的形式装入工厂图谱镜像 ——「工单 WO-1 在设备 M-3 上运行」。 名称 · 数量 · 日期 · 状态等值不做存储，在收到提问时再通过连接器的读取工具重新读取。因此连接器关闭时答案中的值为空，而原始系统中的值一旦变更，下一次提问就会立即反映新值。
工具响应规则(规格 0.2)
| 规则 | 值 |
|---|---|
| 单次响应大小 | 16,000 字符以内 |
| 页大小 | limit 1 ~ 200(默认 50)，下一页用 cursor |
| 时间窗 | 最长 31 天。例外 —— 供应商交期实绩 · 设备维护履历 · 校准记录为 366 天 |
| 错误码 | invalid_argument · not_found · unauthorized · rate_limited · unavailable · conflict |
| 「未知」表示 | 行的 unknown_fields，响应的 partial(仅部分读取) · unreadable(未能读取的行)。未知值不得臆测，须以 null 输出 |
| 时刻 | 带时区偏移的 ISO 8601。无偏移的时刻按「未知」处理 |
- 无条件的「全部给我」调用必须以
invalid_argument拒绝 —— 符合性测试会检查这一点。 - 用未知设备 ID 查询时必须返回
not_found，而不是空列表。
同步与新鲜度
- 数字主线按家族新鲜度上限的一半间隔对每个连接器同步(最小 5 分钟，见上表)。给定
DT_CONNECTOR_SYNC_INTERVAL_S则所有连接器都按该间隔。启动 2 分钟后执行首次同步。 - 单次读取当前 ±15 天的窗口。本次窗口中未出现的连接不会删除，而是关闭(保留在连接履历中，默认 180 天)。实绩 · 谱系 · 检验等记录型连接不会被关闭。
- 若响应被截断(
truncated)或仅部分读取(partial)，该轮次不关闭任何连接。 - 若最后一次同步早于新鲜度上限，恢复方案不会基于该数据给出数字，而是标注为「陈旧输入」。上限可通过
DT_CONNECTOR_MAX_AGE按家族调整。 - 具备事件工具的家族，在同步后会把事件以时间线引用方式装载(不含正文)。同一事件重复读取不会产生重复项，每轮次上限 5,000 条。
调用限额
连接器若声明 capabilities.limits.rate_limit_per_min，数字主线只在该限额之内调用。
同步 · 符合性等无人值守调用最多使用限额的 80%(最长等待 10 分钟)，聊天等交互式调用最多等待 20 秒。
连接器返回 Retry-After 时，最长遵守一小时。未声明则不排队。
现场(站点)须与 MES 一致
连接器注册到某一个现场。现场与该工厂 MES 不一致的家族会被排除在判定之外，答案中留下 site_mismatch:<系列>(仅 PLM 例外 —— 设计资料不区分工厂)。
🔴 若把全公司 ERP 注册到总部现场，该工厂的判定中 ERP 将被排除。请按工厂注册到与该工厂 MES 相同的现场。
直达原始界面(深度链接)
为每个连接器配置链接模板（links —— base_url · label · allow_http · templates）后，连接 · 时间线 · 影响范围 · 节点详情答案中的对象会附带
open_url · open_label，副驾驶依据面板中会出现「在 SAP 中打开」这样的按钮。按钮文字为 label（留空则为连接器名称）。
模板的占位符仅 {base} · {key} · {key.1} ~ {key.9} 三类，默认只允许 https（allow_http: true 时也允许 http），且结果主机须与 base_url 的主机一致。修改链接模板不影响符合性 · 启用状态。没有模板则不显示链接列。
在控制台中填写的方法（集成地图 › 连接器侧边窗口 › 外部链接）见数字主线 — 外部链接。
节点详情 —— 每次点击时调用的读取工具
在副驾驶依据面板中点击节点时（原系统的当前值），数字主线会在该类型权威家族的连接器上调用下列工具一次。 值既不保存在镜像中，也不保存在服务中，只传递各类型预先规定的字段（不传递人名 · 工号 · 联系方式）。单次超过 15 秒即为«原系统无响应»。
| 类型 | 家族 | 调用的工具 |
|---|---|---|
| PO 行 | ERP | erp_list_purchase_orders |
| 客户订单行 | ERP | erp_list_sales_orders |
| 工单 · 工序 | MES | mes_get_work_order（工序按父工单读取） |
| 料号 | PLM | plm_get_bom |
| 供应商 | SCM | scm_get_supplier_delivery_performance（最近 90 天） |
- 检验 · 不合格（QM）和维护工单（CMMS）在规范中没有单条读取，因此为«未知» —— 因为列表工具只接受时间窗口，无法按编号筛选。
- 选择连接器的顺序与链接相同 —— 已启用且版本匹配的权威家族连接器中与节点同一现场者（PLM 免于现场比对）→ 代表 → 最先注册者。
升级版本 —— 低于最低版本将不被使用
- 声明版本低于上表最低版本的连接器会被拒绝同步(409
connector_outdated)，在判定 · 恢复方案中视为「未接入」。答案的「缺失项」中会出现connector_outdated:<系列>，注册表中可见spec_status: outdated和应升级到的版本(upgrade_to)。 - 把连接器升级到新版本后，需重新走工具发现 → 符合性测试 → 启用 → 同步。因为版本变更会在工具发现阶段关闭连接器并清除符合性结果。
- 连接器较多时，
bin/reregister-connectors.sh会代为对每个连接器执行这些步骤(先 MES，然后 SCM · 排产计划 · ERP)。可先用--dry-run预览。
在外部运行符合性测试
连接器开发方无需数字主线也可运行同样的测试。
python -m app.connectors.conformance_cli <连接器 MCP 地址> --family <系列>
单次测试须在 15 分钟内完成(因调用限额而等待的时间不计入)。临时性中断不会改写记录，只有确定的失败才会被记录并关闭连接器。
MES —— 工单 · 工序 · 实绩
规范 mes-mcp 0.7 · 家族 mes · 新鲜度上限 2小时(每 1 小时同步) · 数字主线的底座
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
mes_capabilities | ✅ | 声明版本 · 站点 · 限额 | — |
mes_list_equipment | ✅ | MES 设备 ↔ 平台资产(asset_id)对照表、设备层级 | asset_id · equipment_id |
mes_list_work_orders | ✅ | 按设备 · 按期间的工单 —— 状态 · 物料 · 数量 · 计划/实际时刻 · 交期 · 里程碑 · 订单项目(0.4) · 客户订单行(0.7) | asset_id 或 from · to、status、due_before |
mes_get_work_order | ✅ | 单个工单的工序与 BOM 行 | work_order_id |
mes_list_production_results | ✅ | 生产实绩 —— 良品 · 不良 · 报废，批次 · 序列号 | from · to |
mes_list_downtime_events | ✅ | 停机及其原因 | from · to |
mes_events | ✅ | 事件信封 —— 装载到时间线 | from · to、types |
mes_get_genealogy | 可选 | 批次 · 序列号的谱系(前后各 3 层) | direction |
mes_get_precedence | 可选 | 工序前后序图与余量 | direction、depth 1~5 |
mes_list_maintenance_history · mes_list_nonconformances · mes_list_personnel | 可选 | 维护履历 · 不合格 · 人员与资质 —— 没有 CMMS · QM · ERP 时的替代来源 | 期间 |
mes_get_operation_requirements | 可选 | 每道工序可用的设备 · 所需资质 · 换型组 | work_order_id |
mes_list_calendars · mes_list_maintenance_windows · mes_get_power_limit | 可选 | 设备 · 人员日历(含换型切换)、计划维护窗口、现场同时用电上限 —— 恢复方案的资源约束 | 期间 |
mes_get_mbom | 可选 | 制造 BOM —— MES/MPM 为正本时(0.6) | material_id |
🔒 动作工具 —— 只有在人工于副驾驶建议卡片上批准后才会被调用。它只在原始系统中创建「草稿 · 申请」，最终确认由人在该系统内完成。
| 工具 | 创建内容 |
|---|---|
mes_create_work_order_draft | 工单草稿(物料 · 数量 · 设备 · 开始 · 交期) |
mes_create_hold_request | 工单 · 批次 · 序列号的冻结 / 解除申请 |
mes_create_maintenance_request | 维护申请(设备 · 优先级 · 故障代码 · 依据链接) |
- 装入镜像的内容 —— 设备 → 平台设备 · 上级设备，工单 → 设备 · 里程碑 · 项目 · 客户订单行，工序 → 工单 · 设备 · 所需资质，BOM 行 → 物料号，前后序，实绩批次 → 设备 · 工单，谱系，制造 BOM。 数量 · 时刻 · 日历 · 维护窗口 · 用电 · 停机原因在提问时读取。
用在哪里
| 功能 | 使用方式 |
|---|---|
| 作业就绪度 | 工单 · 工序是判定的骨架。缺失则整个判定为「未接入」。无工序要求时人员项为「未知」 |
今日作业(thread_today_work) | 今日计划的工序与设备状态 |
恢复方案(thread_explain_recovery) | 工单 · 前后序 · 资源(日历 · 维护窗口 · 用电) · 制造 BOM |
| 时间线 · 影响范围 | mes_events 与谱系 |
符合性测试中常见的失败点
设备父级链中存在环路会判定失败。工单中若输出 wbs_parent_id，也必须输出 project。必备读取工具须满足 p95 低于 2 秒。
SCM —— 采购 · 收货 · 供应商
规范 mes-mcp 0.7 · 家族 scm · 新鲜度上限 24小时(每 12 小时同步)
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
scm_capabilities | ✅ | 声明版本 · 站点 · 限额 | — |
scm_list_supply_lines | ✅ | 未结采购 · 供应行 —— 订单 · 收货 · 未结数量，请求 · 承诺 · 确定日期，关联工单 · 客户订单 | 物料号 · 工单 · 供应商之一 |
scm_list_inbound_shipments | ✅ | 发货通知(ASN) —— 预计到达 · 运输状态 | from · to |
scm_list_goods_receipts | ✅ | 收货与检验状态 | from · to |
scm_get_work_order_shortage | ✅ | 单个工单的缺件 —— 每个物料号的需求 · 可用 · 在途 · 缺口，下次到货日 | work_order_id |
scm_events | 可选 | 事件信封 | from · to |
scm_get_supplier_delivery_performance | 可选 | 供应商交期达成率 · 平均 / p90 延误(最长 366 天) | supplier_id |
scm_list_alternates | 可选 | 替代零件 · 替代供应商 | material_id |
scm_list_incoming_inspections · scm_list_supplier_nonconformances | 可选 | 来料检验结果 · 供应商零件不合格 | 期间 |
scm_list_supplier_capacity | 可选 | 供应商供应能力(运输天数 · 分期间能力) | 供应商或物料号 |
🔒 动作工具
| 工具 | 创建内容 |
|---|---|
scm_create_expedite_request_draft | 交期提前申请草稿(PO 行 · 需求日) —— 由采购人员在原始系统中发出 |
scm_create_supplier_inquiry_draft | 供应商问询草稿(交期 · 质量，最多 1,000 字符) |
- 装入镜像的内容 —— PO 行 → 供应商 · 物料号 · 关联工单 · 客户订单行，收货批次 → 供应商。供应行按发货 · 收货中出现的供应商缩小范围读取(因为 SCM 规范禁止大批量查询)。
用在哪里 —— 物料就绪度(缺件)、PO 主线、恢复方案(缺件 · 发货 · 供应能力 —— 没有供应能力时供应侧只回答「影响」)、今日作业的 PO 列。
排产计划(APS) —— 已发布的计划
规范 mes-mcp 0.7 · 家族 sched · 新鲜度上限 2小时(每 1 小时同步)
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
sched_capabilities | ✅ | 声明版本 · 站点 | — |
sched_events | ✅ | 里程碑 · 计划日期变更事件 | from · to |
sched_list_planned_operations | 可选 | 已发布计划的工序排程 —— 计划版本 · 设备 · 计划时刻 · 换型 · 冻结 · 顺序 | from · to |
sched_get_resource_calendars | 可选 | 按设备的班次与计划停机 | from · to |
sched_list_scenarios | 可选 | 情景(what-if 计划)列表与 KPI | status |
🔒 动作工具 —— sched_create_scenario_draft：把恢复方案中的工序移动(最多 200 个)在 APS 中创建为情景草稿。不发布计划 —— 评估 · 发布由人在 APS 内完成。
用作恢复方案的基准计划。 读取从昨天起未来 15 天的发布计划，用 APS 的计划时刻覆盖前后序的计划时刻。 已完成或进行中的工序不覆盖(实绩优先于计划)。冻结工序固定在该时刻，但若前序延误导致无法在该时刻开始，则不固定，并记入「假设」。 没有 APS 时，基准为 MES 的作业分配，答案的「未考虑项」中会出现「APS 计划未知」。
ERP —— 人员 · 采购 · 客户订单 · 制造 BOM
规范 erp-mcp 0.4 · 家族 erp · 新鲜度上限 24小时(每 12 小时同步) · 只读
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
erp_capabilities | ✅ | 声明版本 · 站点 | — |
erp_list_personnel | ✅ | 人员(假名 ID) · 资质 · 分配 | on_date、qualification_code |
erp_list_availability | 可选 | 人员的可用窗口 —— 出勤 · 休假 · 加班 | from · to |
erp_get_mbom | 可选 | 制造 BOM —— ERP 为正本时 | material_id |
erp_list_purchase_orders | 可选 | 物料采购订单行(默认未结) —— 关联工序 · 客户订单行 | 留空则返回全部未结行 |
erp_list_goods_receipts | 可选 | 收货 | from · to |
erp_list_sales_orders | 可选 | 客户订单行 —— 客户 · 客户 PO · 合同交期 · 确定日 · 违约金 · 关联项目 · 里程碑 · 工单 | 留空则返回全部未结行 |
- 人员仅以假名 ID 进入镜像。姓名 · 资质有效期在提问时读取。
- 装入镜像的内容 —— 人员 → 资质 · 已分配工单 · 工序，PO 行 → 供应商 · 物料号 · 工单 · 客户订单行，客户订单行 → 客户，项目 · 里程碑 · 工单 → 客户订单行，制造 BOM。 若 ERP 与 SCM 给出相同的 PO 行号，在镜像中视为同一行。
ERP 与 SCM 同时存在时 —— 交期以 SCM 的供应商确定日为准，没有则用 ERP 的。状态 · 未结数量以 ERP 为正本，关联工单则合并两侧。值不一致时，答案的「不一致」中会同时列出两者。
用在哪里
| 功能 | 使用方式 |
|---|---|
| 作业就绪度 —— 人员 · 物料 | 人员优先取 ERP(没有则取 MES)。没有 SCM 的客户也可用 ERP 采购订单的未结 · 关联行判定物料 |
| 订单上下文 | 每道工序所履行的客户订单与余量天数 |
| 恢复方案 | 人员资源 · PO · 客户订单余量天数 |
| BOM 比对 | 优先查看 ERP 制造 BOM(没有则 MES) |
符合性测试中常见的失败点
客户订单行不输出任何项目 · 里程碑 · 工单键不算失败，只是信息(只是未与工厂作业关联)。订单行号重复则为失败。
PLM —— 设计变更与 BOM
规范 plm-mcp 0.2 · 家族 plm · 新鲜度上限 24小时(每 12 小时同步) · 全部只读
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
plm_capabilities | ✅ | 声明版本 · 站点 · 功能 | — |
plm_list_change_orders | ✅ | 设计变更指令(ECO · ECN) —— 状态 · 变更的物料号与版本 · 库存处置 · 生效 · 可使用新版本的时刻 | from · to(以变更时刻为准，必填)、material_id、status[] |
plm_get_bom | ✅ | 物料号某一版本的设计 BOM —— 子物料号(lines)与该物料号的被用处(where_used) | material_id(必填)、revision(留空则取当前 released 版本)。自 0.2 起支持分页(limit 最大 200) |
plm_list_documents | 可选 | 关联到物料号的文档 · 图纸元数据(名称 · 类型 · 版本 · 状态 · 打开链接)。不输出文件内容 | material_id(必填)、revision |
- 变更指令状态为
draft·in_review·approved·released·design_released(0.2) ·implemented·cancelled， 库存处置为pending·use_as_is·rework·scrap·none，生效为immediate·date·unit·serial。 - 装入镜像的内容 —— 仅变更指令 · 物料号 · 文档的键与连接(指令 → 物料号，子物料号 → 母物料号，文档 → 物料号)。BOM 从变更物料号向上追溯至 4 层。 状态 · 日期 · 文档名称 · 链接不装载，提问时读取。
- 时间线事件 —— 变更指令被修改 · 已发布 · 状态变更(0.2)。附着在受影响的物料号上。
用在哪里
| 功能 | 使用方式 |
|---|---|
恢复方案(thread_explain_recovery) | 过去 30 天 ~ 明天的变更指令中，只有已批准 · 已发布的才构成约束。库存处置为 use_as_is 时不阻断；为 rework · scrap · none 时，在「可使用新版本的时刻」之前阻断该零件。design_released 仅显示，不阻断 |
| 作业就绪度 —— 图纸项 | 读不到变更指令时该项为「未知」，没有 BOM 时判定范围会收窄 |
版本确认(thread_part_revision_status) | 查看当前 released 版本和未结变更(93 天)，以 current · outdated · change_open · unknown 作答 |
| BOM 比对 · 影响范围 | 将设计 BOM 与制造 BOM · 实绩对照 → 见上文 制造 BOM |
符合性测试中常见的失败点
在 truncated: true 的 BOM 响应中同时输出 next_cursor 会判定失败。文档的 open_url 必须是 http(s) 链接(禁止 data:)。
QM —— 检验与不合格
规范 qm-mcp 0.2 · 家族 qm · 新鲜度上限 24小时(每 12 小时同步) · 全部只读
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
qm_capabilities | ✅ | 声明版本 · 站点 | — |
qm_list_inspections | ✅ | 检验批 —— 来料 · 过程 · 最终检验，结果(passed · failed · conditional · pending)，关联不合格单号 | from · to(必填)、material_id · lot_id · work_order_id |
qm_list_nonconformances | ✅ | 不合格(NCR) —— 缺陷 · 数量 · 处置(返工 · 报废 · 退货 …) · 返工计划 · 替代品预计时刻 | from · to(发现时刻，必填)、物料号 · 批次 · 工单 · 供应商 · status[] |
- 装入镜像的内容 —— NCR · 检验的键与连接：NCR → 物料号 · 批次 · 序列号，NCR → 阻断的工单 · 工序，批次 → 检验，批次 → 供应商。
- 时间线事件 —— 不合格发生 · 返工完成，检验合格 · 不合格 · 有条件(
pending不作为事件)。
用在哪里
| 功能 | 使用方式 |
|---|---|
| 恢复方案 | 处置为返工 · 修理时阻断至返工计划结束；为报废 · 退货时阻断至替代品预计时刻。没有时刻则不给出数字，保留为「未知」 |
| 作业就绪度 —— 质量项 | 优先查看 QM，没有则查看 MES 的不合格(mes_list_nonconformances) |
工具巡检(thread_check_tooling) | 查找不合格的原因候选时一并读取 |
CMMS —— 维护
规范 cmms-mcp 0.2 · 家族 cmms · 新鲜度上限 4小时(每 2 小时同步) · 全部只读
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
cmms_capabilities | ✅ | 声明版本 · 站点 | — |
cmms_list_work_orders | ✅ | 维护工单 —— 类型(预防 · 故障修理 · 预测 · 巡检 · 校准) · 7 级状态 · 计划/实际时刻 · 是否停机 · 所用备件 · 等待的生产工单 | from · to(必填)、equipment_id · asset_id · type[] · status[] · open_only |
cmms_list_pm_schedules | 可选 | 预防性维护停机窗口 —— 时长 · 最早开始 · 最晚结束 · 是否可移动(movable) | from · to(必填)、设备 |
cmms_get_asset_history | 可选 | 单台设备的维护履历摘要(件数 · 故障数 · MTBF · MTTR · 停机时间) | from · to(最长 366 天)、设备 |
- 装入镜像的内容 —— 维护工单号与连接：维护 → 设备(若有平台资产 ID 则直接挂到平台设备)，维护 → 备件，维护 → 等待的生产工单。 除窗口内的工单外，还读取在窗口之前开始且仍未关闭的工单。
- 时间线事件 —— 维护申请 · 开始 · 结束，预防性维护计划。完全没有时刻的工单不产生事件，保留为「无时刻」。
用在哪里
| 功能 | 使用方式 |
|---|---|
| 恢复方案 | 读取从昨天起未来 15 天的预防性维护窗口与未结工单。未完成的故障修理阻断设备至预计结束，不可移动的预防性维护同样阻断。可移动的预防性维护由优化在排程内移动。没有 CMMS 时，答案的「未考虑项」中会出现维护计划 |
| 作业就绪度 —— 设备项 | 预防性维护窗口与工单两者都没有时为「未知」 |
| 安全(EHS)对照 | 将维护工单与作业许可 · 隔离对照 |
| 异常案例标签 | 用已完成的故障修理工单给异常案例打标签(DT_WO_LABELS_ENABLED) |
- 若同一维护窗口在 MES 中也存在，以 CMMS 侧为准。
TOOL —— 工具 · 夹具 · 量具
规范 tool-mcp 0.2 · 家族 tool · 新鲜度上限 24小时(每 12 小时同步) · 全部只读
工具管理系统职能各不相同，因此由连接器声明功能，并只提供该功能对应的工具。只做校准的系统可以只声明一个 calibration。
| 功能 | 提供的工具 | 在台账中填充的列 |
|---|---|---|
inventory | (仅台账) | 数量 |
issue_return | tool_list_issues —— 领用 · 归还(由谁 · 用于哪个工单 · 工序 · 检验 · 批次) | — |
calibration | tool_list_calibrations —— 校准记录(校准前 · 后判定，最大误差，下次期限)。最长 366 天 | 校准 |
tool_life | tool_list_life_events —— 重磨 · 更换 · 寿命终止 · 寿命预警 | 寿命 |
presetting | tool_list_requirements —— 工单 · 工序所需的工具清单 | 预设 |
- 始终提供的工具是
tool_capabilities和tool_list_tools(工具 · 夹具 · 量具台账 —— 状态available·issued·in_calibration·out_of_tolerance·quarantined·worn_out·retired)。 事件工具tool_events为与功能无关的可选项。 - 🔴 已声明功能的工具必须全部提供，未声明功能的工具不得提供，且对应台账列须留空 —— 符合性测试会检查这一点。
- 装入镜像的内容 —— 工具键与连接：工具 → 所在设备，工单 · 工序 · 检验 · 批次 · 序列号 → 实际使用的工具。寿命 · 校准 · 数量等值不装载。
- 时间线事件 —— 领用 · 归还 · 校准合格/不合格 · 寿命终止 · 更换。没有
tool_events时，仅从校准记录生成校准事件。
用在哪里
| 功能 | 使用方式 |
|---|---|
工具巡检(thread_check_tooling) | 回答三件事 —— 可疑测量(用超过校准期限的量具测量，或使用后校准不合格)、实际使用的工具、不合格的原因候选(寿命 · 领用 · QM 不合格)。查询期间 1~31 天(默认 30 天)，校准记录可回溯 1 年 |
| 作业就绪度 —— 工具项 | 所需工具清单与台账任一缺失即为「未知」 |
WMS —— 仓库库存与移动
规范 wms-mcp 0.2 · 家族 wms · 新鲜度上限 2小时(每 1 小时同步) · 只读
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
wms_capabilities | ✅ | 声明版本 · 站点 | — |
wms_list_stock | ✅ | 库存 —— 按物料号 · 库位 · 批次的持有 · 预留 · 可用，库存状态(以 as_of 时点为准) | material_id · location_id(无条件的全量查询将被拒绝) |
wms_list_movements | ✅ | 库存移动 —— 入库 · 出库 · 转移 · 调整 · 退货 | from · to(必填)、物料号 · 工单 |
- 不装入镜像。 库存是逐小时变化的值，因此在提问时读取。
- 时间线事件 —— 每次移动产生入库 · 出库 · 转移 · 调整 · 退货事件。
- 用在哪里 —— 恢复方案会为每个延迟零件一并显示仓库库存(可用 · 持有 · 预留 · 冻结 · 检验中)。若仅部分读取，没有对应行的物料号不是 0 而是「未知」。 没有 WMS 时，答案的「未考虑项」中会出现库存。
LIMS —— 样品与试验结果
规范 lims-mcp 0.2 · 家族 lims · 新鲜度上限 12小时(每 6 小时同步) · 只读
| 工具 | 必备 | 作用 | 主要输入 |
|---|---|---|---|
lims_capabilities | ✅ | 声明版本 · 站点 | — |
lims_list_samples | ✅ | 样品与试验结果 —— 物料号 · 批次 · 序列号 · 供应商 · 工单 · 检验，状态(registered · in_testing · completed · cancelled)，综合判定 | from · to(取样时刻，必填)、物料号 · 批次 · 状态 |
- 装入镜像的内容 —— 样品 → 批次 · 序列号(没有则物料号) · 工单 · 检验，批次 → 供应商。试验值 · 规格 · 判定不装载。
- 时间线事件 —— 每个已判定样品的合格 · 不合格。未判定的样品不作为事件。
- 用在哪里 —— 为批次附上试验报告，并从样品开始追踪影响范围。不会把 LIMS 不合格上报为 QM 不合格 —— 不合格以 QM 为正本。
EHS —— 作业许可 · 隔离 · 安全
规范 ehs-mcp 0.3 · 家族 ehs · 新鲜度上限 1小时(每 30 分钟同步 —— 各家族中最短) · 只读
始终提供的工具是 ehs_capabilities 和 ehs_events(许可批准 · 开始 · 中止 · 结束，隔离装设 · 解除，事故报告，巡检完成，风险评估到期)两个，
其余与工具管理一样，由连接器声明功能并提供对应工具。
| 功能 | 工具 | 作用 |
|---|---|---|
permits | ehs_list_permits | 作业许可 —— 类型 · 状态 · 设备 · 区域 · 工单 · 维护工单 · 工序，有效期间，是否需要隔离 |
isolations | ehs_list_isolations | 隔离(LOTO) —— 隔离点 · 许可 · 计划/装设/确认/解除时刻 |
incidents | ehs_list_incidents | 事故引用 —— 事故 · 未遂 · 不安全状态 · 环境泄漏，严重度等级 |
inspections | ehs_list_inspections | 安全巡检 —— 发现项数 · 未结措施 |
risk_assessments | ehs_list_risk_assessments | 风险评估 —— 批准日 · 复评期限 |
training | ehs_list_training | 岗位资质(培训) —— 假名 ID · 有效期间 |
- 🔴 0.3 为最低版本的原因 —— 自 0.3 起单独接收维护工单(
maintenance_order_ids)。work_order_*仅表示 MES 工单。 0.2 连接器若把维护单号填入工单列，会产生镜像中不存在的工单，因此低于 0.3 的版本不予同步。 - 🔴 不接收个人信息。 事故的描述 · 受伤 · 人员信息列不存在，额外输出这些列会在符合性测试中失败。人员只用假名 ID。
- 装入镜像的内容 —— 许可 → 设备 · 区域 · 工单 · 维护工单 · 工序，隔离 → 设备 · 许可，事故 → 设备 · 区域 · 工单 · 维护。巡检 · 风险评估 · 资质在提问时读取。
用在哪里
| 功能 | 使用方式 |
|---|---|
| 作业就绪度 —— 许可项 | 以无许可 · 无覆盖该工序的许可 · 缺少所需隔离作为理由输出 |
| 许可覆盖巡检 | 检查指定期间(默认 7 天，最长 31 天)的作业 · 维护中许可 · 隔离是否存在空档，以及风险评估复评是否逾期 |
| 恢复方案 | 把隔离期间作为该设备不可用窗口纳入。未批准 · 已中止的许可只作为「参考」标注 |
- 岗位资质(
training)会读取，但尚未用于判定。没有聊天工具。
商用产品适配器 —— 预验证阶段
我们准备了针对常用商用产品的四个适配器。四者均处于已通过针对模拟服务器的符合性测试的阶段， 尚未接入实际产品进行验证 —— 导入时将在客户环境中一同验证。全部为只读。
| 产品 | 家族 · 版本 | 提供的工具 | 产品侧接口 | 认证 |
|---|---|---|---|---|
| SAP S/4HANA | ERP erp-mcp/0.4 · 维护 cmms-mcp/0.2(按家族分别注册) | ERP：人员 · 采购订单 · 收货 · 客户订单(可用窗口 · 制造 BOM 尚未提供)。维护：四项齐全 | OData V2 标准 API(采购订单 · 物料凭证 · 销售订单 · 维护订单 · 维护计划 · 设备等) | OAuth2 client credentials 或 basic |
| IBM Maximo(Manage · 7.6) | 维护 cmms-mcp/0.2 | 四项齐全 | REST(OSLC JSON) —— 工单 · 预防性维护 · 资产 | API 密钥(MAS) · maxauth(7.6) · basic |
| Siemens Teamcenter | PLM plm-mcp/0.2 | 四项齐全(含文档) | SOA JSON —— 已保存查询 · BOM 窗口 · where-used | 会话登录(用户 · 密码) |
| Dassault 3DEXPERIENCE | PLM plm-mcp/0.2 | 四项齐全(含文档) | 3DPassport 登录 → 3DSpace 变更 · 工程 · 文档 API | 用户 · 密码 + 安全上下文 |
- 适配器作为与数字主线相互独立的容器部署在客户侧，并像普通连接器一样以端点 · 令牌注册到数字主线。令牌为空时适配器拒绝启动。
- 原始系统地址只接受 https。密钥可用文件(
…_FILE)代替明文值提供。 - 每个适配器都声明每分钟调用限额(例如 Teamcenter 每分钟 40，3DEXPERIENCE 每分钟 25)。原始系统拒绝凭证时，会休眠 5 至 60 分钟后重试。
- MES · 质量 · 工具 · 仓库 · 实验室 · 安全家族尚无商用适配器。这些家族需自建遵循上述规范的连接器接入。
致连接器开发方
- 规范原文位于数字主线源码的
app/connectors/spec/<规格>-<版本>/，每个工具一份 JSON。新版本只包含在上一版本之上新增的内容。 - 不提供的功能对应的工具请从列表中移除。返回空响应的工具会被解读为「功能存在，但无数据」。
- 未知值请用
null和unknown_fields明确标注。若用 0 或空字符串填充，会被解读为「实测的 0」，导致判定出错。 - 读取工具请提供
readOnlyHint: true，带时间窗的工具请遵守 31 天上限。 - 事件 ID 重复读取时必须保持一致 —— 时间线据此去重。
相关文档
- 数字主线 —— 注册界面 · 绑定 · 同步 · 图谱镜像 · 聊天工具
- MCP 工具地图 —— 聊天调用的
thread_工具 - 密码 · API 密钥变更 —— 加密连接器凭证的
PI_DT_SECRET_KEY