ELAB·FLOW · 给 agent 用的嵌入式开发工具链
把嵌入式开发流程，托管给你的 agent 与 DSH。
体检 → 编译 → 烧录 → 调试校验 → 串口判据，五段合成一条 elab loop。
退出码说话、证据落盘；业务代码留在原地，换芯片只改一行 chip:。
模型能写驱动、能读手册，却卡在最后一步——编译要开 IDE、烧录点鼠标、验证盯串口，它插不进手。
ELAB-Flow 把五段流程托管给 agent：业务代码留在原工程，每一步都有工具调用。
建工程靠 CubeMX 点出来，编译烧录靠 IDE 按钮，工具版本靠 PATH 运气 —— 没有稳定入口，agent 第一步就卡死。
烧完盯着串口日志，「好像跑起来了」就算过；没有判据、没有退出码，agent 判断不了这一步成没成，也进不了 CI。
每个阶段都是一条带退出码、带证据行的命令。agent 一次 tool call 跑完，读同一份事件流再决定下一步 —— 不需要有人守在屏幕前。
elab doctorelab buildelab flashelab debugelab monitorelab loop 顺序跑完五段，任一段失败即停并把证据回传给 agent；面板、CLI、agent 读的是同一份事件流。
从「给目录」到「拿到结论」，每一步都留下可 grep 的证据行；面板、CLI、agent 看到的是同一份事件流。
体检 → 编译 → 烧录 → 调试校验 → 串口闭环。串口判据给出三态结论，能开但没收到约定关键字就报 inconclusive —— 不会把「没验证」冒充成成功。
elab run --steps build，不必每次全量0 ok / 1 failed / 2 inconclusive，CI 直接用
STM32F411CEU6 · 真机
会话式调试器：开始 / 继续 / 暂停 / 单步 / 步入 / 步出 / 复位 / 关闭，十一个页签从调用栈一直看到 RTOS 栈水位。断点与监视持久化到项目文件，带 rev 乐观锁。
#2 0x54535250 非法地址 → heartbeat_pack_buggymonitor reset run，不会把板子留在 halt
HardFault · 实机
每个字节批次都带 seq / dir / t / len / gap，方向过滤、搜索、换表示全在客户端做，切视图不丢游标。四个视图：行 / 字节 / 终端 / 波形。
FireWater · 双通道
给 agent 一段没人告诉过它的抓包，它自己推出帧头、帧长、校验、消息 ID 与字段切分。学习只产草稿、不写文件：证据链与置信度一起返回，人复核后才落盘。
codegen 产出 generated/*.h，-Wall -Werror 干净编译elab_* 混合门面工具，写硬件受 allowAgentWrite 门控
私有协议 · 自学
给一个目录就探测芯片、框架、构建入口与置信度；只读在前，落盘在后，人工接管过的文件绝不覆盖。
点表驱动，31 个点 / 5 组合并成 8 条读；写保护缺 confirm 直接拒，越界被从站异常码 02 挡回。
agent 在跑，你在旁边看：阶梯进度、日志尾、四通道与串口页挤在窄栏里，插件首启自动补齐工具链。
骨架仓零芯片，厂商支持全在数据层；elab pkg index 重生成索引，CI 用 --check 拦漂移。
芯片参数在适配包，主机路径在 elab.host.yaml，命令模板在 provider —— 工程 YAML 只声明「我是谁、怎么接」。下面这份是 elab adapt 真实生成的文件节选。
下面每个数字都来自仓库里的真机记录与基准脚本，跑一次就能复现。
终端分色输出，退出码即结论。适合脚本、CI、无人值守与 agent 直接调用。
./elab loop -p f411 -v
工程轨 / 阶段轨 / 证据轨三列全屏，双击即起，幂等不重复起服务。
cockpit.cmd → 127.0.0.1:8333
窄栏阶梯 + 日志尾 + 串口页；插件首次打开自动下载内核并补齐工具链。
dsh plugin add …#path:/packages/dsh-elab-cockpit
需要 Python ≥ 3.10（无第三方依赖）；上板另需 CMake + Ninja + ARM GCC + OpenOCD。没有探针时 doctor / build / ci 照样能跑。
$ git clone git@github.com:xkk6663/elab-flow.git$ ./elab pkg bootstrap$ ./elab setup && ./elab doctor先不加 --write 看只读报告，确认后再落盘。
$ ./elab adapt ../my-project --write$ ./elab loop -p my-project -v$ python -m cockpit.server$ ./elab setup [elab] 环境自检 · pack st/stm32@0.1.0 · kernel_api >=1 <2 ✓ 芯片包 st/stm32 (stm32f103xb / stm32f411ceux) ✓ 工具链 arm-none-eabi-gcc 13.3.1 · cmake 3.28.1 · ninja 1.11.1 ✓ 调试器 openocd 0.12.0-3 (probe: atlink) ✓ 串口 COM10 @115200 (auto) $ ./elab loop -p stm32f411ceu6 -v [1/5] 体检 ✓ 0.14s 工具链 / 探针 / 串口 [2/5] 编译 ✓ 7.46s RAM 16.29% · FLASH 9.39% · 守卫 untouched [3/5] 烧录 ✓ ** Programming Started ** [4/5] 调试校验 ✓ 6.03s Breakpoint 1 at Core/Src/main.c:84 [5/5] 串口闭环 ✓ 1.68s 命中 regex:^\[(boot|alive)\] within_s=10 结论 ok · 7.46s · exit 0 # 1=failed 2=inconclusive
九篇教程按学习顺序排列，从「换新芯片先过心跳第一关」到 Modbus 主站。全部来自仓库 docs/tutorials，直接在页面里读。
第一次接触：01 → 03 → 06。要接自己的板子：01 → 04。要做厂商适配包：02。串口与协议：07 → 09。
骨架仓本身零芯片。芯片参数、厂商指纹、平台坑位全部来自适配包；包之间互不依赖，索引写 market/index.json。
项目 YAML 不写 provider:（或写 provider: native）时，
体检 / 编译 / 烧录 / 调试校验四步直接走内核代码。工具版本不来自包，
一律以本机 elab.host.yaml 的声明为准 —— 仓库里那套是：
provider: native，或整行省略（默认就是它）elab.host.yaml → toolchains.arm-none-eabi.root / tools.cmake / tools.ninja / tools.openocdELAB_ARM_GCC_ROOT / ELAB_CMAKE / ELAB_NINJA / ELAB_OPENOCD 环境变量覆盖，不改仓库文件
什么时候该换掉它：芯片厂商自带完整 SDK 与构建系统时（ESP32-S31 就是），
项目显式绑 provider: espressif/idf@>=1 <2。绑定后缺哪个步骤就直接报错，
不会静默回退到这条原生链 —— 这是设计决定 D3。
适配包不依赖内核源码，只认 pack.yaml 协议。填一份清单就能生成市场条目，一键提成 Issue —— 审核通过后出现在上面的列表里。