docs: daily engineering digest for 2026-07-12

automations/livekit-agent/2026-07-12.markdown

@@ -0,0 +1,37 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间范围
+
+**2026-07-11 00:00 UTC → 2026-07-12 00:00 UTC**（与 cron 触发 `2026-07-12T00:00:36Z` 对齐）
+
+数据来源：`git log upstream/main`（[livekit/agents](https://github.com/livekit/agents)）提交历史与 GitHub PR 元数据。
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`HEAD` 仍为 `f9b68de7`（2026-05-27，[#5857](https://github.com/livekit/agents/pull/5857)）。相对上游 **落后 244 个提交**（`git rev-list --count origin/main..upstream/main`，较昨日 +2）。
+
+**上游追踪（livekit/agents `main`）**：同期 **2 个 PR 合入**，均为插件层修复/扩展；**无新版本发布或依赖安全更新**。
+
+---
+
+## 要点摘要
+
+- **OpenAI Responses WebSocket 序列化修复** ([#6385](https://github.com/livekit/agents/pull/6385)，2026-07-11 16:10 UTC)：`responses/llm.py` 中 `_ResponsesWebsocket.generate_response._default` 改为 `model_dump(mode="json", exclude_none=True)`，与 openai SDK 行为对齐。根因：`openai-python` **2.45.0** 新增 `Reasoning.mode` 可选字段后，WS 路径将未设置字段序列化为 `null`，导致 gpt-5.x 请求被 API 以 **HTTP 400**（`reasoning.mode` 不接受 null）拒绝；同时修复 `_parse_ws_event` 对缺少 `sequence_number` 的 error frame 解析崩溃，使真实 API 错误不再被 pydantic `ValidationError` 掩盖。**影响**：使用 Responses API + WebSocket（默认）且 openai ≥ 2.45.0 的 gpt-5.x agent 此前每轮可能失败；HTTP 传输（`use_websocket=False`）不受影响。新增 hermetic 回归测试 `tests/test_plugin_openai_responses.py`（2 cases）。
+
+- **Phonic Realtime 支持 additional_params** ([#6384](https://github.com/livekit/agents/pull/6384)，2026-07-11 04:00 UTC)：`livekit-plugins-phonic` 的 `realtime_model.py` 在 config 消息中透传 `additional_params`，插件版本 bump（`pyproject.toml`）。**影响**：Phonic 用户可将 vendor 特定参数注入 config，无需 fork 插件；变更面小（+5 行），需确认 Phonic API 对未知 key 的容错。
+
+- **上游活动节奏放缓**：相较昨日 4 个 PR（Fishaudio 爆音、CLI 重命名、drive-thru 测试、ElevenLabs deprec），今日仅 2 个合入，均为 targeted 插件修复；核心 voice/worker/inference 路径无变更。
+
+- **多项高优先级 PR 仍待合入**（窗口外但持续活跃）：[#6386](https://github.com/livekit/agents/pull/6386)（AMD 在 SIP 接听后才开始检测，与昨日 digest watchlist 呼应）、[#6387](https://github.com/livekit/agents/pull/6387)（tool call 开始时 flush TTS preamble）、[#6389](https://github.com/livekit/agents/pull/6389)（worker full-capacity Prometheus counter）。这些 PR 更新于 7/11 下午，预计下一 digest 周期合入。
+
+---
+
+## Watchlist
+
+1. **OpenAI Responses WS + openai ≥ 2.45.0 升级路径** ([#6385](https://github.com/livekit/agents/pull/6385))：修复已合入但 fork 仍缺；若生产使用 gpt-5.x + Responses API 默认 WS，升级 openai SDK 前必须先 cherry-pick/merge 此修复，否则每轮 400。建议 pin `openai` 版本或显式设 `use_websocket=False` 作为临时缓解。
+
+2. **AMD SIP 检测时机** ([#6386](https://github.com/livekit/agents/pull/6386)，仍 open）：与 7/10 已合入的 no-speech 计时器修复（[#5848](https://github.com/livekit/agents/pull/5848)）互补——将 detection 推迟到 answer 后，避免振铃阶段误触发。电话机器人场景应关注合入后端到端 AMD 分类准确率。
+
+3. **Fork 漂移 244 commits**：本 fork 仍停留在 5 月快照，缺失 1.6.5 发布、Fishaudio 预缓冲、ElevenLabs deprec 及今日 OpenAI/Phonic 修复。上游开放 issue [#6388](https://github.com/livekit/agents/issues/6388)（worker full 状态 metrics 盲区）、[#6390](https://github.com/livekit/agents/issues/6390)（xAI TTS WS 2100s 超时 vs ConnectionPool 3600s）提示 observability 与连接池配置仍有待跟进。
+
+---
+
+*生成时间：2026-07-12（自动化 cron）*