┌─────────────┐
│     MCU     │
└──────┬──────┘
       │ 串口 (COM9, 115200, 8N1)
       ▼
┌─────────────────────────────────────────┐
│              SerialHub                  │
│                                         │
│  ┌─────────────┐    ┌───────────────┐  │
│  │  串口管理器  │    │  数据桥接     │  │
│  │   Serial    │◄──►│  (事件总线)    │  │
│  │   Manager   │    │  DataBridge   │  │
│  └─────────────┘    └───────┬───────┘  │
│                             │          │
│              ┌──────────────┼────────┐ │
│              ▼              ▼        ▼ │
│       ┌───────────┐  ┌──────────┐ ... │
│       │   Web     │  │   MCP    │     │
│       │  终端     │  │  服务    │     │
│       │ (端口5000)│  │ (HTTP)   │     │
│       └───────────┘  └──────────┘     │
└─────────────────────────────────────────┘
       │                    │
       ▼                    ▼
┌─────────────┐     ┌─────────────┐
│   浏览器     │     │  AI 工具     │
│ (人工操作)   │     │ (OpenCode,  │
│             │     │  iFlow CLI) │
└─────────────┘     └─────────────┘

go build -o bin/serialhub.exe ./cmd/serialhub

serialhub                                    # 默认配置启动
serialhub -p COM8                            # 指定串口
serialhub -p COM8 -b 9600 --parity even      # 完整串口参数
serialhub -m 8080                            # 使用 8080 端口
serialhub --host 0.0.0.0                     # 监听所有网络接口（联邦模式 Windows 主侧需要）
serialhub --stdio                            # stdio 模式（MCP 客户端本地拉起）
serialhub -c config.toml                     # 使用配置文件
serialhub -D                                 # 调试模式

serialhub -p COM9 --host 0.0.0.0 -D

{
  "mcp": {
    "serialhub": {
      "type": "remote",
      "url": "http://localhost:5000/mcp",
      "enabled": true
    }
  }
}

# 健康检查
curl http://localhost:5000/health

# 列出可用串口
curl -X POST http://localhost:5000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"serial_list"},"id":1}'

# 连接串口
curl -X POST http://localhost:5000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"serial_connect","arguments":{"port":"COM9"}},"id":2}'

# 发送命令（自动追加换行符）
curl -X POST http://localhost:5000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"serial_write","arguments":{"data":"help"}},"id":3}'

# 读取串口返回数据（阻塞等待，timeout=0 表示无限等待）
curl -X POST http://localhost:5000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"serial_read","arguments":{"timeout":5000}},"id":4}'

serial_list → 识别目标串口 → serial_connect → serial_write 发送命令 → serial_read 读取响应

// 步骤 1: 查找可用串口
serial_list()
// 返回: { ports: [{ path: "COM6", vendorId: "0D28", productId: "0202" }, ...] }

// 步骤 2: 根据硬件 ID 识别目标设备，连接
serial_connect({ port: "COM6", baudRate: 115200 })
// 返回: { success: true, port: "COM6", baudRate: 115200 }

// 发送命令（自动追加换行符）
serial_write({ data: "version" })
// 返回: { success: true, bytesWritten: 8 }

// 读取响应（等待 2 秒）
serial_read({ timeout: 2000 })
// 返回: { data: "MCU v1.2.3\nBuild: 2024-01-15\n", timedOut: false, bytes: 28 }

// timeout=0 表示无限等待，直到有数据到达
serial_write({ data: "flash_verify" })  // 耗时操作
serial_read({ timeout: 0 })  // 等待直到设备返回结果

serial_disconnect()  // 断开当前连接
serial_list()        // 重新查找串口
serial_connect({ port: "COM7" })  // 连接新设备

serial_status()
// 已连接: { connected: true, port: "COM6", baudRate: 115200 }
// 未连接: { connected: false }

# 日志目录，为空则保存到可执行文件目录下的 logs/
# logDir = "D:/Logs"

[serial]
port = ""           # 串口号，为空时不自动连接
baudRate = 115200
dataBits = 8
parity = "none"     # none / even / odd
stopBits = 1

[mcp]
httpPort = 5000

# 开发运行
go run ./cmd/serialhub

# 构建
go build -o bin/serialhub.exe ./cmd/serialhub

# 测试
go test ./...

# 静态分析
go vet ./...

# 整理依赖
go mod tidy