MHS 常见问题（FAQ）
概念问题可结合 7 天 MHS 课纲 每日主题理解；动手问题请用设备模拟器验证。
基础概念
MHS 是什么？
Model Hardware Standard（模型硬件标准） 是面向 Physical AI 的协议层，用 read（状态向量）和 write（物理操作+验证）两个原语统一 Agent 与硬件的交互。它补足 MCP 在物理世界的开环盲区。
MHS 与 MCP 是什么关系？
互补分层。MCP 连接数字工具（文件、数据库、API）；MHS 连接物理设备（激光器、离心机、机器人）。MHS Driver 可暴露为 MCP Server，Agent 仍用 tool 调用，底层执行 MHS 闭环。
为什么只有两个原语 read/write？
极简性降低 Driver 与 Agent 门槛。复杂性下沉到 Device Description（能力与安全）和 Driver（协议翻译），而非增加 RPC 表面。
什么是状态向量？
结构化物理量集合，每通道含 value、unit、confidence、timestamp 等。是物理世界的 ground truth，替代「OK」文本。
什么是 Device Description？
机器可读 YAML/JSON，声明设备能力、量程、互锁与安全边界。Agent 动态 discover，无需硬编码型号。
与 ROS / OPC-UA / SCADA 对比
MHS 会取代 ROS 吗？
不会。ROS 2 擅长机器人实时控制与生态；MHS 擅长跨领域 Agent 语义与闭环编排。常见模式：关节控制走 ROS，实验编排走 MHS，经桥接 Driver 连接。
MHS 与 OPC-UA 重复吗？
不重复。OPC-UA 是工业通信与信息模型；MHS 是 Agent 层的 read/write 语义、verify 策略与 audit。可 stack：Driver 内 OPC-UA，对外 MHS。
已有 SCADA 还需要 MHS 吗？
SCADA 偏监控与人工操作；MHS 偏 Agent 自主闭环。可共存：SCADA 只读 MHS 状态，write 经 MHS 编排器。
MHS 是 PyVISA 的替代品吗？
PyVISA 是仪器控制库；MHS 是更高层标准。PyVISA 常作为 MHS Driver 的实现细节。
安全与闭环
安全边界谁强制执行？
Driver 必须校验；编排器可追加策略；硬件固件最后防线。写在 prompt 里的规则不算数。
硬边界和软边界区别？
硬边界：绝对拒绝。软边界：警告或需人工 waiver。示例：激光 5.0 W hard，4.5 W soft 建议。
什么是互锁？
多参数联合条件。例：power_w > 0 要求 cooling_lpm ≥ 2。违反则 reject write。
闭环一定比开环慢吗？
单步略慢（多 read），但整体 wall-clock 可能更短——Janelia 11h→23min 因消除 blind sleep 与早期故障检测。
何时可以跳过 verify？
仅当 Description 允许、后果可逆、且无安全 implication。样品安全场景禁止跳过。
开发与集成
如何开始写 Driver？
见 开发指南：实现 read/write/get_description，从 modbus-tk 或 PyVISA 最小示例起步。
没有硬件怎么测？
Gazebo、设备模拟器（子站 LAB.01）、PyVISA-sim、Modbus simulator。
MCP tool 如何映射 MHS？
tool 参数 → write；x-mhs.verify → read 验收；resource 暴露 state JSON。见 快速开始。
多 Agent 同时控制一台设备？
Driver 层 write 串行化 + lease 机制；read 可并发。
慢操作（30s 移动）如何处理？
状态向量提供 progress 或 phase；编排器 poll read，非 blind sleep。
实测案例
QuEra 99.3% 成功率的要点？
闭环小步修正激光参数，替代人工微调；hard limit 保护 样品。
CMU 8 小时完成数周实验？
自动编排 + 6 类故障拦截；减少人工值守与重复 setup。
Genentech 气泡问题说明什么？
LLM 物理推理有限；需 Driver 提供 sample_quality 等符号通道，不能仅靠文本日志。
生产与合规
MHS 规范开源了吗？
当前研究预览；完整开源路线见 Day 7。学习以概念与模式为主。
审计日志要什么字段？
who/when/what/before/after/verify/action；越界尝试单独记录。
如何满足 GMP/FDA 意图？
append-only audit、权限分离、HITL 签核、Description 变更受控。具体法规咨询 QA。
零信任如何落地？
设备证书、指令签名、网络隔离、最小权限 device 列表。
故障排查
read 返回 confidence 很低？
传感器噪声、校准过期、通信误码。检查 calibration_date、重试 read、必要时 maintenance。
write 被拒 SafetyViolation？
检查 hard_limits 与 cmd 值；查 audit 明细；不要绕过 Driver。
verify 一直失败？
容差过严、设备动力学慢、传感器 bias。增加 settling wait 或修正 算法；检查 tolerance 配置。
Modbus 超时？
网络、unit id、寄存器地址、防火墙。Driver 应 exponential backoff 并限次重试。
Agent 暂停一整夜？
过度谨慎阈值。调整 confidence 与 HITL 策略，见 最佳实践 渐进式自治。
MCP 显示 OK 但物理未变？
说明走了开环路径。检查 Bridge 是否启用 x-mhs verify。
学习路径
七天怎么安排？
需要什么背景？
MCP/API 基础、Python、基本物理量概念。机器人/实验室经验加分。
推荐先读哪篇文档？
intro → getting-started → from-zero-to-one。
前沿与展望
数字孪生与 MHS？
状态向量同步孪生；离线优化经 audit 的 write 回写。
群体机器人？
多台设备通过 MHS 组成协作网络；统一 discover 与编排。
Dynamic MHS？
设备能力随磨损/漂移更新 Description；自适应 calibration metadata。
仍未解决？
协议细节
状态向量可以嵌套吗？
推荐扁平通道命名（stage_x_mm），避免深层 JSON。复杂结构用多通道或引用 frame_id。
write 可以批量吗？
概念上可 write_many 原子组，但物理设备常需逐步 verify。多设备并行 write 需注意资源互锁。
Description 用 JSON 还是 YAML？
二者皆可；YAML 人类编辑友好，JSON Schema 校验常用。团队统一即可。
27 种协议列表在哪？
规范研究预览中将完整列出；常见见 intro 与 github-projects 表。
组织与流程
谁维护 Description？
设备 owner + 安全 reviewer；Agent 团队只读 consume。
能否动态改 hard limit？
需 maintenance mode + 双人授权 + audit；禁止 Agent 自行 relax hard limit。
如何做版本回滚？
Driver+Description 版本 pin；回滚后 re-read 全设备 state 再恢复编排。
与其他 AI 框架
LangChain Tool 与 MHS？
Tool 内调 MCP/MHS Bridge，不要在 tool 内直接 Modbus。
AutoGPT 类 agent 适用吗？
适用但风险高；必须 L0/L1 起步，Physical AI 不适合完全自主黑盒。
模拟与测试
故障注入有哪些？
通信超时、噪声、漂移、互锁失败、慢执行、partial state。
如何 benchmark 闭环？
指标：steps/hour、verify 次数/步、reject 率、human 次数、任务成功率。
商业与许可
研究预览谁可申请？
先进制造与研究机构；见 Anthropic 官方发布说明。
商业产品可以用 MHS 吗？
关注规范许可证发布；当前以研究预览条款为准。
术语扩展
| 术语 | 说明 |
|---|---|
| Physical AI | 物理世界感知决策执行 |
| NSP | Next State Prediction，相对 NLP 的 NTP |
| HIL | Hardware-in-the-Loop |
| WoT | Web of Things |
| LIMS | 实验室信息管理系统 |
排错命令速查
mhs describe DEVICE # 能力与安全
mhs read DEVICE -v # 详细 confidence/ts
mhs audit --tail 50 # 最近审计
mhs health # gateway 与 Driver 状态
仍无法解决
- 收集 audit + state snapshot
- 子站 Community 发帖
- 检查 Description 与固件版本 pin
- 对照 best-practices 检查表
更多 FAQ：协议与数据
read 和 poll 有什么区别？
read 是语义原语；poll 是 Driver 实现策略（定时读硬件）。Agent 只 call read。
StateVector 能否包含图像？
可以 frame_ref 或 image_uri 通道，大对象走 blob 存储，向量只含 metadata 与 checksum。相机 Driver read 返回 last_frame_id 而非嵌入像素。
write 参数可以一次写多个通道吗？
可以，但 verify 需对每个声明了 verify 的通道 read 验收。互锁评估基于 write 后预期状态。
Description 谁签名？
建议 maintainer GPG 签 Description；gateway 加载时验签，防篡改 hard_limit。
更多 FAQ：组织与角色
实验员、IT、Agent 团队如何分工？
- 实验员：SOP、soft limit、HITL 决策
- IT：网络、gateway、证书
- Agent 团队：编排、MCP 集成
- 设备 owner：Description + Driver
能否外包 Driver 开发？
可以，但 SAR 与 Description 审批必须在组织内部。外包交付物：源码、测试、映射文档、SBOM。
更多 FAQ：与 MCP 共存
同一 Agent 既调 filesystem 又调激光？
可以。MCP Server 多个：filesystem + mhs-bridge。Agent 规划时区分数字步骤与物理步骤。
resource 与 state vector 关系？
MCP resource 是 state vector 的 JSON 投影，可订阅变更。tool 写后 Bridge 更新 resource。
更多 FAQ：故障场景
设备断电重启后编排怎么办？
重新 discover → read 全状态 → 与 checkpoint 比较 → 决定 resume 或 abort。checkpoint 存 last verified state。
两个 Agent 争用 lease 失败？
后申请者排队或 fail fast；audit 记录 lease holder。人工可 force release（需授权）。
校准过期能否自动 write？
禁止提高风险的操作；允许 read_only 或 maintenance 模式下降额 write。
更多 FAQ：合规
21 CFR Part 11 电子签名？
HITL approve 步骤需电子签名与 reason code；与 audit 关联 user_id。
数据驻留？
状态与 audit 存储地域按机构政策；云 Agent 需注意跨境。
排错决策树
常见误解辨析
误解 1：SCADA 点位即 MCP tool
正解：SCADA 点位缺乏 tolerance 与 audit，应经 MHS Driver 暴露 read/write。
误解 2：confidence 只是装饰
正解：低 confidence 必 须触发降级或 HITL，尤其 irreversible 操作前。
误解 3：ROS 完全替代 MHS
正解：ROS 管机器人实时控制；MHS 管跨设备 Agent 语义与闭环验证。
误解 4：Description 可省略
正解：无 Description 则 Agent 无法 discover 能力与边界，等于盲写硬件。
误解 5：verify 拖慢实验
正解：Janelia 案例证明闭环消除 blind sleep，总时间反而缩短。
误解 6：prompt 足够保安全
正解：hard_limit 必须在 Driver 强制执行，LLM 会 hallucinate 合规。
误解 7：模拟器通过即可上线
正解：HIL 后半段必须真机；sim confidence=1.0 掩盖噪声与漂移。
误解 8：MHS 只管实验室
正解：MHS 面向一切 Physical AI：制造、量子、生物、机器人编排。
误解 9：write 越多越快
正解：无 verify 的 write 堆叠导致故障雪崩，CMU 案例强调拦截。
误解 10：OPC-UA 与 MHS 二选一
正解：可 stack：OPC-UA 通信，MHS Agent 语义。
误解 11：audit 可事后补
正解：物理 audit 必须同步 append-only，否则合规无效。
误解 12：多 Agent 无需 lease
正解：写设备必须串行化或租约，否则竞态损坏样品。
误解 13：LLM 能替代 Driver
正解：LLM 不能发 Modbus 帧；Driver 是必要翻译与安全层。
误解 14：开源 Driver 无需 SAR
正解：社区 Driver 上线前仍须本地 SAR 与互锁测试。
误解 15：MCP OK 等于物理 OK
正解：这是 Physical AI 第一误区；必须 read 状态向量。
场景化 FAQ：实验室
显微镜 Z 轴漂移怎么办？
read focus_score 或 z_position_um；若 verify 失败，policy retry 调焦有限次数；仍失败 skip tile 并标记 QA（Janelia 策略）。
离心机不平衡检测到怎么办？
立即 safe_state（减速停）；audit 记录 imbalance_g；人工检查样品对称性后再 reset。
质谱仪 long write 如何编排？
Description 声明 estimated_duration_s；read 返回 phase: pumping|ready；编排器显示 progress 而非 blind wait。
场景化 FAQ：制造
CNC 与 MHS 关系？
CNC 程序执行可走专用 Driver；MHS 编排高层步骤（装夹→加工→质检 read）。μs 级插补不在 MHS 层。
EtherCAT 实时轴能否 Agent 直控？
不建议。Agent 发 MHS 目标位姿；RT gateway 执行轨迹并 read 验证到位。
场景化 FAQ：量子/光学
QuEra 锁频失败怎么 debug？
查 audit 中每次 write 步长与 error_hz 曲线；是否触 hard limit；confidence 是否下降；通信 timeout 比例。
多激光器 sync？
wait_all on phase_locked=true；Description 声明 master/slave 角色。
场景化 FAQ：开发与测试
pytest 如何 mock MHS？
注入 FakeDriver 返回 programmable StateVector；测试 orchestrator accept 逻辑无需硬件。
如何 regression 互锁？
参数化测试：生成互锁布尔组合，仅 legal 组合 expect write success。
场景化 FAQ：MCP 集成
Cursor/Claude Desktop 多 MCP Server？
filesystem + mhs-bridge 同时启用；Agent 规划时物理步骤调用 mhs-bridge tools。
resource 更新频率？
每次 verified write 后 push；高频 read 可 throttle 500ms 避免 flooding context。
版本与兼容 FAQ
固件升级后 Driver 失效？
Description firmware range 不匹配 → initialize 失败；需 Driver 更新或 downgrade 固件。
规范研究预览 API 会变吗？
四支柱稳定；HTTP/CLI 细节可能变。逻辑层依赖 read/write 语义，不依赖 URL 路径。
术语速查扩展
| EN | CN | 备注 |
|---|---|---|
| Setpoint | 设定值 | write 目标 |
| Ground truth | 真值 | read 状态向量 |
| Wafer | 晶圆 | 制造场景 |
| Tile | 视场块 | 成像编排 |
| DBC | CAN 数据库 | CAN Driver |
快速索引：问题 → 文档
| 问题 | 阅读 |
|---|---|
| 什么是 MHS | intro |
| 第一次 read/write | getting-started |
| 写 Driver | development |
| 选开源库 | github-projects |
| 安全与 audit | best-practices |
| 7 天怎么学 | from-zero-to-one |
联系与社区
- 子站 Community：Driver 诊所、编排复盘
- 子站 Resources：规范、协议、案例、书籍
- 本站 MCP 文档：数字层前置知识
若问题涉及未开源 API 细节，请以 MHS 研究预览官方发布为准；本文档基于公开课纲与协议概念整理。
反馈
FAQ 未能覆盖的场景，欢迎在子站 Community 提问并附上 mhs audit --tail 与 Device Description 版本号，便于社区复现与补充本条文档。
也欢迎对照 best-practices 检查表自检：多数「Agent 行为异常」根因是 verify 关闭、confidence 未用或互锁未进 Description。先 read，再问为什么。入门请从 getting-started 的闭环检查清单开始。祝学习顺利。