┌──────────────────────────────────┐
  人(浏览器)────▶│   serial-hub 守护进程（常驻）       │◀── MCP ──▶ VS Code 的 AI (Cline)
  Web 控制台      │   唯一持有并独占串口的那一个对象      │
                 │   hub: 环形缓冲 + seq + 游标        │◀── MCP ──▶ workbuddy 的 AI
  MobaXterm ────▶│   控制 IPC（本地 TCP，换行 JSON）     │
  (TCP 桥,可选)   └──────────────────────────────────┘
                        ▲
                        └── CLI (serialctl) ── 任何"只能跑 shell"的 AI

cd serial-hub
npm install        # serialport(N-API 预编译) + ws + @xterm/xterm + MCP SDK + zod

# 1) 前台起守护进程（会打印 Web 控制台地址）
node bin/serial-hub.js
#    → 人类 Web 控制台：http://127.0.0.1:48080/serial/
#    → 控制 IPC：127.0.0.1:48555

# 2) 用 CLI 走一遍（虚拟板）
serialctl ports                 # 应看到 VIRTUAL 虚拟演示板
serialctl open VIRTUAL
serialctl wait "U-Boot" --timeout 5000
serialctl read
serialctl close

{
  "mcpServers": {
    "serial-hub": {
      "command": "node",
      "args": ["D:\\AI-agent\\OUTPUT\\serial-hub\\bin\\serial-hub-mcp.js"]
    }
  }
}

{
  "mcpServers": {
    "serial-hub": {
      "command": "node",
      "args": ["D:\\AI-agent\\OUTPUT\\serial-hub\\bin\\serial-hub-mcp.js"]
    }
  }
}

serialctl status                         # 状态 / 输入权 / 缓冲范围
serialctl ports                          # 列串口（含 VIRTUAL）
serialctl open COM6 --baud 115200        # 打开并独占
serialctl send "ls -l"                   # 发送（自动补 \r）
serialctl send --raw "0d"                # 发送十六进制
serialctl keys ctrl-c enter              # 发送按键序列
serialctl read [--since 42] [--max-bytes 65536]   # 读"还没看过的"新输出
serialctl wait "login:" --timeout 10000  # 等输出匹配
serialctl expect-send "login:" "root"    # 命中即发（竞态安全）
serialctl mark "开始烧写"                 # 插标记
serialctl signals --dtr 0 --rts 0        # DTR/RTS（复位板子）
serialctl daemon                         # 前台起守护进程（调试用）

serial-hub/
├─ bin/
│  ├─ serial-hub.js        # 启动守护进程（人类控制台 + IPC + 可选桥）
│  ├─ serial-hub-mcp.js    # MCP Server 入口（给 AI）
│  └─ serialctl.js         # CLI 入口（给能跑 shell 的 AI）
├─ src/
│  ├─ daemon.js            # 守护进程主体：hub + IPC + 控制台 + 桥
│  ├─ client.js            # DaemonClient（换行 JSON over 本地 TCP）
│  ├─ cli.js               # CLI 与 MCP 共用的连接层
│  ├─ cli-main.js          # serialctl 命令实现
│  ├─ mcp-server.js        # 11 个 serial_* MCP 工具（描述即说明书）
│  ├─ serial-api.js        # 高层串口操作（MCP/CLI 共用，对齐 hub 语义）
│  ├─ keys.js              # 按键名 → 字节
│  ├─ config.js            # 端口等配置
│  ├─ console-http.js      # 人类 Web 控制台（原生 http + ws）
│  └─ core/                # 与宿主无关的核心逻辑（从 DSH 插件复用）
│     ├─ hub.js            # SerialHub：单一真源 / 环形缓冲 / 游标 / expectSend
│     ├─ transport.js      # 真实串口 + 虚拟演示串口
│     ├─ console-page.js   # xterm 控制台页面（纯函数）
│     ├─ bridge.js         # TCP/Telnet 桥
│     └─ trust-fence.js    # 信任围栏（防跨站 / DNS-rebinding）
├─ docs/
│  └─ AI-INSTRUCTIONS.md   # ★ 给 AI 的使用手册
├─ test/                   # 冒烟测试（虚拟板跑通整条链路）
└─ package.json

npm test     # 用 VIRTUAL 虚拟板跑通 打开→U-Boot→登录→shell 全链路