# 更新日志

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

## [0.1.2] - 2026-11-22

### 新增

- **TCP `-b` 限速**：与 UDP 共用时间驱动块步进调度器（`stats/target_datagrams`），
  对齐 iperf3 的 TCP pacing；实测 `-b 10M` 报告 9.6 Mbit/s（±4%）。
- **UDP `-b 0` 不限速**：遵循 iperf3 语义；未给 `-b` 时 UDP 仍默认 1 Mbit/s。
- **`--get-server-output`**：客户端请求后，服务器把最终摘要以
  `server_output_text` 随结果 JSON 回传（文本模式打印、`-J` 内嵌报告），
  与真实 iperf3（3.1.3）双向验证。
- `-p` 端口范围校验（1–65535），非法参数非零退出码拒绝。

### 测试

- 单元测试 33 → 36（server_output_text 往返、get_server_output 键存在语义、
  限速哨兵值解析）；新增 10 例功能探针全通过；13 例互操作矩阵与 22 例边界
  探针回归无变化。

[0.1.2]: https://github.com/yiii0012/mooniperf/compare/0.1.1...0.1.2

## [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
