从零到一：7 天 MHS 学习路径
七天实战
每日详细课纲、代码对比与实验入口：7 天学会 MHS 协议
说明
本路径与 mhs_frontend 中 days.ts 课纲对齐，侧重学什么、练什么、验什么；不是前端部署教程。
路径总览
| Day | 主题 | 等级 | 核心产出 |
|---|---|---|---|
| 1 | MHS 基础与 Physical AI 范式 | L1 | 理解 MCP vs MHS，完成虚拟激光器闭环 |
| 2 | 协议架构与 read/write 原语 | L2 | 解析 Description，CLI read/write |
| 3 | 设备描述与安全边界 | L3 | 离心机 Description，互锁设计 |
| 4 | Driver 开发与硬件集成 | L4 | Modbus/6 轴臂 Driver，HIL |
| 5 | Agent 编排与闭环控制 | L4 | 样品扫描编排，案例拆解 |
| 6 | 物理推理局限与混合智能 | L5 | HITL 策略，失败归因 |
| 7 | 生产部署与生态展望 | L5 | 大作业：智能实验室平台 |
Day 1：MHS 基础与 Physical AI 范式
主题：从数字 Agent 到物理 Agent 的范式跃迁——状态作为一等公民，操作即协议。
上午：理论
- 数字 Agent 瓶颈：MCP 开环，对物理后果无知
- Physical AI：设备是可观测、可预测、可约束的动力学系统
- 历史脉络：ROS → OPC-UA → MCP → MHS
- 四件套：Driver、Device Description、State Vector、Safety Boundary
下午：理论
- MHS 战略定位：互补 MCP，非替代；通用物理编排者
- 对比：MHS vs ROS / OPC-UA / SCADA
晚间：实战
- 实战：模拟器连接虚拟激光器 → read → write → 验证状态变化
- 可视化：MCP 开环 vs MHS 闭环执行轨迹
- 挑战：设计激光器+位移台+相机场景，划分闭环/开环步骤
当日代码对比
同一任务「激光功率调到 2.5 W」：
# MCP 开环
result = await mcp.call("laser.set_power", {"watts": 2.5})
# OK ≠ 物理达标
# MHS 闭环
await mhs.write("laser", {"power_w": 2.5})
state = await mhs.read("laser")
# 验证 value、confidence、必要时修正
验收标准
- 能口述 MCP 开环与 MHS 闭环差异
- 在模拟器完成一次 power write+verify
- 列出四支柱各自职责
延伸阅读
Day 2：MHS 协议架构与核心原语
主题：三层架构与 read/write；任何可编程硬件都能理解的接口哲学。
上午：理论
- 三层：硬件方言翻译 / 状态语义中枢 / Agent 接口
- read：结构化物理量，非文本对话
- write：经安全边界校验的物理操作
- 状态向量：单位、置信度、时间戳
下午：理论
- 设备发现与自描述
- MCP 协同：Driver 作 MCP Server，tool→write，resource→state
晚间：实战
- 解析虚拟显微镜 Description → 生成 MCP tool schema
- MHS CLI read/write，观察单位与 confidence
- 挑战：最小 Modbus 温控 Driver（read 温度，write 设定）
验收标准
- 画出三层架构图
- 从 YAML 提取 capabilities 与 safety
- CLI 完成 read/write 各一次
延伸阅读
development.md Driver 接口章节
Day 3：设备描述与安全边界工程
主题：物理安全是底线——硬边界、软边界、互锁、审计。
上午：理论
- Description 深度：元数据、能力、物理属性、接口规范
- 硬/软边界、操作模式、互锁
- 机器可读 vs 人类可读文档生成
下午：理论
- 强制执行：Driver / 设备固件 / 审计
- 故障分类与 safe state
晚间：实战
- 编写虚拟离心机 Description（0–15000 RPM，温度，不平衡阈值）
- 安全边界配置器：拖拽 hard/soft，模拟越界拦截
- 挑战：激光仅当快门关且冷却>2L/min 可启动
验收标准
- 完整 centrifuge Description YAML
- 互锁单元测试 8 组合
- 解释 hard vs soft 工程含义
延伸阅读
Day 4：MHS Driver 开发与硬件集成
主题：从厂商 SDK 到 MHS 原语；HIL 与热插拔。
上午：理论
- Driver 规范：initialize/read/write/shutdown/safe_state
- 轮询 vs 事件驱动；状态缓存；并发锁
- Modbus / USB-CDC / CAN-FD / HTTP 映射要点
下午：理论
- HIL 测试矩阵；性能基准
- 热插拔、版本兼容、社区 Driver 生态
晚间：实战
- 虚拟 6 轴臂 Driver：关节角、位姿 read；关节/笛卡尔 write
- 监控面板诊断报文
- 挑战：30s 慢操作的 progress 状态
验收标准
- 最小 Driver 通过 HIL smoke
- write 超 hard limit 被拒绝
- 文档化寄存器/协议映射
延伸阅读
Day 5：Agent 编排与闭环控制
主题：write → read → 验证 → 修正；世界模型与多设备协同。
上午：理论
- 开环 vs 闭环 Agent 架构
- 世界模型 NSP；行动前心理模拟
- 多设备：任务分解、时序、资源竞争
下午：理论（案例）
- QuEra：99.3% 激光锁频，闭环微调
- CMU：8h vs 数周，6 故障拦截
- Janelia：11h→23min，多设备亚微米 sync
- 过度谨慎 vs 效率；置信度阈值；渐进自治
晚间：实战
- 编排「样品扫描」：位移台→相机→激光→循环 verify
- 可视化编排图：红故障绿通过
- 挑战：第 5 步失焦时的 retry/skip/abort 策略
代码对比：编排循环
# 开环：故障雪崩
for step in steps:
send(step.device, step.cmd)
# MHS 闭环
for step in plan:
mhs.write(step.device, step.cmd)
s = mhs.read(step.device)
if not step.accept(s):
action = policy.decide(s)
log.audit(step, s, action)
验收标准
- 4 步以上闭环 plan 运行模拟器
- 口述三个实测案例要点
- 定义一种 fault 的 recovery policy
延伸阅读
development.md 编排章节
Day 6：物理推理局限与混合智能
主题：LLM 非万能；神经符号；传感器融合；HITL；审计。
上午：理论
- LLM 局限：空间推理、物理直觉、故障诊断
- Genentech：气泡需人工引导——物理 vs 软件
- 神经符号：符号规则 + LLM + 世界模型
- 传感器融合与 confidence
下午：理论
- HITL 何时介入；界面设计；人类反馈闭环
- 可解释性；FDA/GMP/ISO 审计意图
晚间：实战
- 分析真实失败案例归因
- 可视化决策链
- 挑战：confidence 低于 θ 且不可逆时才请求人工
验收标准
- 混合架构图（符号/神经/世界模型）
- HITL 触发条件文档 1 页
- 失败案例分类（物理/安全/传感器/软件）
延伸阅读
Day 7：生产部署、生态建设与未来展望
主题：研究预览→生产；拓扑；零信任；大作业。
上午：理论
- MHS 研究预览与开源路线
- LIMS/MES/SCADA 集成
- 大规模拓扑；边缘 vs 云端；零信任
- KPI：利用率、故障率、人工干预率、预测性维护
下午：理论
- 前沿：Dynamic MHS、多模态、群体机器人、数字孪生
- 与 OPC-UA、ROS 2、IEEE 标准融合
晚间：大作业
智能实验室自动化平台：
- ≥3 台虚拟/真实设备的 MHS Driver
- 完整 Description（含安全边界）
- Agent 闭环编排（样品制备→采集）
- HITL 关键决策点
- 审计与监控面板
认证：提交 Driver、Description、安全分析、编排设计 → MHS Physical AI 工程师证书（子站流程）。
验收标准
- 大作业 checklist 全部完成
- audit 日志可导出
- 团队演示 15 分钟：范式+安全+闭环
7 天后能力矩阵
| 能力 | Day 1–2 | Day 3–4 | Day 5–7 |
|---|---|---|---|
| 概念 | MCP/MHS、状态向量 | 安全、Driver | 编排、生产 |
| 动手 | 模拟器闭环 | Description、Driver | 编排、HITL |
| 产出 | 笔记+对比图 | YAML+测试 | 大作业 |
每日时间建议
| 时段 | 时长 | 内容 |
|---|---|---|
| 上午 | 2h | 理论+阅读文档 |
| 下午 | 2h | 理论+案例 |
| 晚间 | 2–3h | 实战+挑战 |
工具与实验室映射
| Day | 子站实验室 |
|---|---|
| 1 | LAB.01 设备模拟器 |
| 2 | LAB.02 描述编辑器、CLI |
| 3 | LAB.03 安全边界配置器 |
| 4 | LAB.05 Driver 工作台 |
| 5 | LAB.04 编排可视化 |
| 1–7 | 状态监控面板 |
与文档站交叉索引
- 概念：intro
- 动手：getting-started
- 深入：development
- 开源：github-projects
- 生产：best-practices
- 答疑：faq
结语
7 天后你应能独立设计安全的 MHS Driver、编写 Device Description、编排多设备闭环流程，并清楚何时需要人机回环。Physical AI 的门槛不在 prompt，而在状态、边界与验证。开始 Day 1：MHS 子站。
第一周每日笔记模板
### Day N 笔记
- 今日最大收获：
- 仍不清楚：
- 实战完成度：
- 明日预习：
常见进度风险
| 风险 | 对策 |
|---|---|
| 跳过 Day 3 安全 | 后面 Driver 返工 |
| 只读理论不练模拟器 | Day 5 编排失败 |
| 过早接真机 | 先在 HIL/sim 通过 |
能力认证 rubric（摘要）
| 项 | 权重 |
|---|---|
| Driver 正确性 | 25% |
| Description 完整性 | 25% |
| 安全分析 | 20% |
| 编排闭环 | 20% |
| 文档与 audit | 10% |
Day 1–7 阅读清单
- intro + getting-started
- development 三层架构 + MCP 映射
- best-practices 安全章节
- development Driver + HIL
- development 编排 + intro 案例表
- best-practices HITL + faq LLM 局限
- best-practices 生产 + github-projects
组队学习建议
- 角色 A：Driver/协议
- 角色 B：Description/安全
- 角色 C：编排/Agent
- 每日 15min sync；共用 audit 日志 review
扩展周（可选 Day 8–14）
- Week 2：接 1 台真机（温控/激光）
- Week 3：LIMS 集成与 audit 导出
- Week 4：生产 hardening 与 SAR 完整版
与子站 progress 同步
子站 useProgress 本地存储 Day 完成度；建议与检查清单同步勾选，避免跳 Day。
里程碑演示脚本（Day 7）
- 5min：MCP vs MHS 对比 demo
- 5min：越界 reject + audit 展示
- 5min：多设备编排 happy path
- 5min：注入故障 + recovery + HITL
引用课纲 tags
Day1: Physical AI, MCP vs MHS, 状态向量, 安全边界
Day2: 三层架构, read/write, 设备发现, MCP 桥接
Day3: Device Description, 硬/软边界, 互锁, 审计
Day4: Driver, Modbus/CAN-FD, HIL, 热插拔
Day5: 闭环, 世界模型, 多设备编排, 置信度
Day6: 神经符号, 传感器融合, 人机回环, 可解释性
Day7: 生产, 零信任, 数字孪生, 群体机器人
最后检查
完成 7 天后再回答：
- 为何 MCP 的 OK 不够？
- hard limit 与 soft limit 各一例？
- write 后为何 read？
- QuEra/CMU/Janelia 各一句启示？
- 何时必须 HITL？
全能答上，即达到 MHS Physical AI 工程师入门线。
Day 1 补充：多设备挑战参考答案框架
激光+位移台+相机场景中，建议闭环：激光 power、位移台到位、相机 capture 成功（read frame_id/focus_score）。开环可仅限：写 ELN 实验日志（MCP 数字工具）。思考题答案应显式列表并理由。
Day 2 补充：Modbus 挑战验收 rubric
| 项 | 通过标准 |
|---|---|
| read | 返回 temperature_c，单位 °C，confidence>0 |
| write | setpoint 写入后 read 验证 |
| 边界 | 超 hard limit 抛 SafetyViolation |
| Description | 含 register_map |
Day 3 补充：互锁真值表
激光启动互锁（快门关 ∧ 冷却≥2L/min）：
| power>0 | shutter | cooling | 允许 |
|---|---|---|---|
| 0 | * | * | yes |
| 1 | closed | ≥2 | yes |
| 1 | open | * | no |
| 1 | closed | 少于 2 | no |
Day 4 补充：6 轴臂 progress 设计
write 笛卡尔移动时，read 返回：
motion_complete: { value: false, ... }
progress_pct: { value: 42, unit: "%", ... }
estimated_remaining_s: { value: 18, unit: s, ... }
编排器 wait until motion_complete or timeout。
Day 5 补充：Janelia 编排伪代码
for tile in grid:
await move_stage(tile.x, tile.y)
await wait_all([laser, stage], ready_for_capture)
await verify_focus()
await capture_cameras([c1,c2,c3])
ready_for_capture 为自定义 predicate，封装在编排库。
Day 6 补充：Genentech 讨论题
「气泡是物理还是软件问题？」——物理：sample_quality= bubble_suspected；软件：last_error= config。Agent 路径：read 两通道 → 若物理则 HITL 换样品；若软件则 retry config write。
Day 7 补充：大作业评分细则
| 模块 | 要点 |
|---|---|
| Driver×3 | 协议不同、均有 HIL smoke |
| Description | 互锁≥1、hard limit 全覆盖 |
| 编排 | ≥5 步闭环、1 故障注入演示 |
| HITL | 1 个 irreversible gate |
| 监控 | audit 查询 + 1 个 KPI 面板 |
7 天后的进阶项目 idea
- 对接真实 Modbus 温控器
- ROS2-MHS 桥接单臂
- LIMS mock API 同步 sample_id
- 数字孪生 MQTT shadow 同步
与子站 CODE_COMPARES 对照
days.ts 中 Day 1/2/5 的 CODE_COMPARES 应在学习时亲手敲一遍：开环 MCP、Description→schema、闭环编排循环。子站 Learn 页按天展示对比卡片。
每日晚间挑战 hint（不剧透答案）
| Day | 挑战 | hint |
|---|---|---|
| 1 | 多设备闭环划分 | 问：哪步失败会损坏样品？ |
| 2 | Modbus 最小 Driver | 从单一 holding register 开始 |
| 3 | 激光互锁 | 画真值表再写 YAML |
| 4 | 慢操作 progress | read 比 sleep 更可靠 |
| 5 | 失焦恢复 | 定义 retry 上限与 skip 成本 |
| 6 | HITL 触发 | irreversible × low confidence |
| 7 | 大作业 | 先 sim 后真机 |
CODE_COMPARES 学习顺序
- Day1 开环 vs 闭环 power 调整
- Day2 Description → MCP schema
- Day5 编排 for 循环对比
在子站 Learn 页按天查看代码卡片，手写运行一遍。
与 mhs_frontend days.ts 字段对照
| days.ts 字段 | 文档位置 |
|---|---|
| theme | 每日「主题」段 |
| tags | 「引用课纲 tags」 |
| sessions.groups | 上午/下午/晚间 bullet |
| CODE_COMPARES | Day1/2/5 代码块 |
学习成果 portfolio 建议
Git repo 结构：
mhs-learning/
descriptions/
drivers/
orchestrations/
sar/
audit-samples/
README.md
Day 7 提交 portfolio 链接申请认证。
导师反馈问题清单
- Description 互锁是否可测试？
- Driver 是否在 verify 失败时 leak 资源？
- 编排 abort 是否调用 safe_state？
- audit 是否含 post_state？
- HITL 是否过频或过少？
结业自测实验（90 分钟）
- 模拟器闭环 power（20 min）
- 编写互锁 YAML（20 min）
- 口述三案例启示（10 min）
- 设计 4 步编排 plan（40 min）
通过即可认为达到 L2 中级入门。