feat: 测试交付 Q1 混沌压测骨架与 Q4 镜像骨架

test/chaos/README.md

@@ -0,0 +1,61 @@
+# 混沌 / 弱网测试辅助（Q 线）
+
+用 toxiproxy 官方镜像做延迟和断开；Linux 丢包用容器内 netem。所有 Docker 资源名带 `q` 前缀，用完删除。
+
+## 启动 toxiproxy
+
+在仓库根目录（或本目录）执行：
+
+```powershell
+docker compose -p q-chaos -f test/chaos/compose.yml up -d
+```
+
+API 默认映射到本机随机/固定端口见 compose 注释。查看实际端口：
+
+```powershell
+docker compose -p q-chaos -f test/chaos/compose.yml port toxiproxy 8474
+```
+
+清理：
+
+```powershell
+docker compose -p q-chaos -f test/chaos/compose.yml down -v
+```
+
+## 对运行中的服务注入故障
+
+不要写死 `7443`。上游地址取自当前实例的实际监听端口（例如测试 harness 写入的 `listen.addr`，或你启动时打印的地址）。
+
+1. 本机起好 NixMsg（或任意 TCP 服务），记下 `HOST:PORT`。
+2. 在 Windows 上，容器访问本机服务用 `host.docker.internal:PORT`。
+3. 用本包客户端或 curl 建代理（listen 用 `0.0.0.0:0` 让 toxiproxy 分配端口）：
+
+```go
+c := chaos.NewClient("http://127.0.0.1:<api端口>")
+p, err := c.CreateProxy("q-nixmsg", "0.0.0.0:0", "host.docker.internal:"+strconv.Itoa(port))
+// 客户端改连 p.Listen（把 0.0.0.0 换成 127.0.0.1）
+_, _ = c.AddLatency("q-nixmsg", "lag", 200, 50, "")
+_, _ = c.AddResetPeer("q-nixmsg", "rst", 0, "")
+```
+
+等价 curl：
+
+```bash
+curl -s -X POST http://127.0.0.1:<api>/proxies \
+  -H 'Content-Type: application/json' \
+  -d '{"name":"q-nixmsg","listen":"0.0.0.0:0","upstream":"host.docker.internal:<PORT>","enabled":true}'
+```
+
+延迟：`POST .../proxies/q-nixmsg/toxics`，`type=latency`，`attributes.latency` / `jitter`（毫秒）。
+
+断开：`type=reset_peer`，`attributes.timeout`（毫秒，0 表示尽快 RST）。
+
+## 单元测试
+
+```powershell
+go test ./test/chaos/ -count=1
+```
+
+## netem 丢包
+
+见 [netem/README.md](./netem/README.md)。脚本必须在 Linux 容器内执行（本机是 Windows）。