feat: 内置指标 + StxEtx 向量化 + 浸泡套件 + epoch 收口 + demo 场景 5

[CSJ608]

上轮规划的四项 + 小项全部落地。

1. 内置指标（System.Diagnostics.Metrics，零外部依赖）

Meter StreamFrame、单一 endpoint 标签，七台仪器：frames_sent/received、bytes_sent/received、reconnects（计数器）+ session_duration、send_queue_length（直方图）。接线点：worker 整帧写完、解码器切帧、收发字节分片、Retry 发布、会话拆除、每次入队。README 双语新增章节（含最简 MeterListener 订阅示例）。

实现说明：ns2.0 不需要 shim——System.Diagnostics.DiagnosticSource 10.x 的 ns2.0 资产自带完整 Metrics API（初版写了 no-op shim 与真类型冲突后移除），显式 PackageReference 固定依赖。

可观测性测试用 MeterListener 对既有仪器直接 EnableMeasurementEvents（绕开"InstrumentPublished 只对新发布仪器回调"的限制），驱动一次完整连接生命周期断言七台仪器全部有真实记录。

2. StxEtx 向量化

net8+ 用 SearchValues<byte> 跳扫候选字节（不含 STX/ETX 的整段直接跳过）；ns2.0 保留逐字节实现——两套独立完整实现（初版共享循环体的重构有 continue 跳过 i++ 的死循环 bug，拆开杜绝此类错位）。语义逐字节等价，现有 StxEtx/FrameDecoder 测试全绿。

实测（2026-08-28 本机）：≈1.1 µs/帧 → ≈50 ns/帧（约 22 倍），扫描吞吐 ≈1.2 GB/s。README/bench 性能段以本轮数据刷新，端到端数字含指标接入后的真实路径（≈16 万条/秒、RTT ≈51 µs，机器相关、附复现入口）。

3. 浸泡/混沌套件（默认不运行）

STREAMFRAME_SOAK_SECONDS=120 dotnet test --filter FullyQualifiedName~Soak 启用；未设置即跳过，不影响 CI 与提交前验证。两个用例：

• 长流完整性：~200 msg/s 持续发送，终局核对顺序/无丢失/无重复；
• 随机故障混沌：固定种子随机调度（对端 FIN/RST 死亡、半帧注入、绑定/普通发送突发），终局核对：全部发送任务时限内终结、普通消息跨会话续送 FIFO 完整送达、绑定消息零重复投递（错发探测器）。

已通过 20s/60s 双档验证。过程中排掉三个测试自身 bug（重复连接、收尾未释放对端、变量遮蔽导致的静默编译失败），库本体在纯对端死亡混沌下完整性成立；混沌刻意不含用户显式 Reconnect()——它与自动重连并发竞速会触发双 StartAsync 接受循环的存量脆弱点（监听状态机楔死），属"状态过渡原子化"的独立设计任务，建议后续开 issue。

4. epoch 线性化收口（评审附带发现）

会话纪元改为在 Connected 发布点与会话编号同点分配（StartSession 改为接收发布期分配的 id+epoch，病态重入兜底同时刷新两者）："发布后、任务未创建"窗口内的旧纪元幽灵在入口即被丢弃。回归测试在 Connected 发布回调内（最紧时序）反射注入旧纪元幽灵，断言新生会话存活。

5. 小项

• demo 场景 5（会话感知收发全流程，实跑验证）；
• 分支覆盖 79.8% → 81.2%：补 worker 编号校验分支（T3 扩展：新对端驱动排空 + 断言无错发字节）、XML 超限/坏帧、参数守卫；
• CHANGELOG Unreleased 全量记录。

测试

83×3 = 249 全绿（新增 6：指标 1、幽灵回归 1、XML 2、soak 2[env 门控]。soak 在无环境变量时即刻返回）。