# 更新日志

本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 风格，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [0.1.1] - 2026-11-21

### 修复

- **协议对齐真实 iperf3**：流 id 序列复刻 `iperf_add_stream` 的 1,3,4,5… 规则
  （`-P > 1` 时普通 1..N 编号会被真实对端以 `stream has an invalid id` 拒绝）；
  参数 JSON 遵循 iperf3 的"键存在即激活"语义（发送 `"udp": false` 会把测试
  切成 UDP）；服务器结果回显客户端声明的流 id，对 id 规则变化保持鲁棒。
- 数据连接 cookie 逐字节比对（`strcmp` 语义），不匹配回 `ACCESS_DENIED`。

### 新增

- 与真实 iperf3（3.1.3）的双向互操作矩阵：TCP `-P 1/2/3`、UDP、`-J`、`-O`、
  `-n` 共 13 例全部通过（`docs/protocol.md`）。
- 边界测试：限速解析、流 id 序列、Int64 溢出防护、封帧长度上限、
  `SERVER_ERROR` 越界读取等（单元测试 22 → 33）。
- CI 扩展到 Linux / Windows / macOS 三平台，并在干净 runner 上做回环冒烟测试。

### 已知限制（v0.1.1 仍存在）

- `-R` 反向模式在 CLI 层禁用（Windows 事件循环边界问题，见
  [docs/roadmap.md](docs/roadmap.md)）；UDP `-u` 暂为单流。

## [0.1.0] - 2026-11-20

### 新增

- iperf3 线上协议实现：控制连接（37 字节 cookie、状态字节、长度前缀 JSON）、
  TCP 数据连接、UDP 报文头与握手、RFC 1889 抖动估计、丢包/乱序统计。
- 客户端/服务器完整测试流：参数交换、多流（`-P`）、预热（`-O`）、字节/块数
  限制（`-n`/`-k`）、时间驱动 UDP 步进限速（1 Mbit/s 到数百 Mbit/s 精确）。
- iperf3 风格的人类可读输出与 `-J` JSON 报告。
- mooncakes.io 首发 `yiii0012/mooniperf@0.1.0`。

[0.1.1]: https://github.com/yiii0012/mooniperf/compare/0.1.0...0.1.1
[0.1.0]: https://github.com/yiii0012/mooniperf/releases/tag/0.1.0
