docs: daily engineering digest 2026-08-05

automations/livekit-agent/2026-08-05.markdown

@@ -0,0 +1,41 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间
+
+**2026-08-04 00:00 UTC — 2026-08-05 00:02 UTC**（与 cron 触发 `2026-08-05T00:02:00Z` 对齐）
+
+数据来源：`git log upstream/main`、`gh` API 查询 [livekit/agents](https://github.com/livekit/agents) `main` 合并 PR。
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**。相对上游 **落后 386 个提交**（`git rev-list --count origin/main..upstream/main`）。
+
+**上游追踪（livekit/agents `main`）**：同期 **10 个已合并 PR**；以下要点均来自上游提交/PR 证据。
+
+---
+
+## 要点变更
+
+- **连接失败诊断大幅改善**（[#6696](https://github.com/livekit/agents/pull/6696)，2026-08-04 14:38 UTC）：`APIConnectionError.__str__` 现会遍历 `__cause__` 链并展示根因（如 `RemoteProtocolError`、`ClientConnectorError`），而非一律显示 `Connection error.`。64 处 LLM/TTS/STT 插件的 `raise APIConnectionError() from e` 调用点无需改动即可受益。影响：仿真/远程会话中 `str(e)` 跨进程传递时，网络断连与解析 bug 不再难以区分。
+
+- **Google 插件可靠性与认证补齐**（[#6686](https://github.com/livekit/agents/pull/6686)、[#6618](https://github.com/livekit/agents/pull/6618)）：`google.LLM` 与 `gemini_tts.TTS` 在 `aclose()` 时释放 genai 异步 httpx 客户端（延续 [#6643](https://github.com/livekit/agents/pull/6643) realtime 路径修复）；`google.STT`/`TTS` 新增 `credentials` 参数，支持 Workload Identity Federation 等无法落盘的凭据对象（closes [#6586](https://github.com/livekit/agents/issues/6586)）。影响：长生命周期 agent 的 Google 客户端泄漏风险降低；GCP 联邦认证集成更顺畅。注：同步 `_httpx_client` 仍未释放，与 realtime 行为一致。
+
+- **TTS fallback 恢复路径 task slot 隔离**（[#6683](https://github.com/livekit/agents/pull/6683)，2026-08-04 04:53 UTC，Fixes [#6682](https://github.com/livekit/agents/issues/6682)）：将共享的 `recovering_task` 拆为 `recovering_synthesize_task` / `recovering_stream_task`，与 STT fallback 对齐。修复 chunked 与 streamed 两条恢复路径互相抑制探测、以及 `aclose()` 无法取消被覆盖任务的问题。影响：多 provider TTS fallback 场景下，一侧探测进行中时另一侧不再静默跳过健康 provider 的重试。
+
+- **MultiSpeakerAdapter 静默丢失 STT 上下文**（[#6679](https://github.com/livekit/agents/pull/6679)，2026-08-04 07:00 UTC）：适配器此前宣称 `keyterms`/`chat_context` 能力但未转发 `_update_session_keyterms`、`_push_conversation_item`、`prewarm`、`model`/`provider`、metrics 等七项钩子；Deepgram/AssemblyAI 经 `MultiSpeakerAdapter` 使用时 keyterm 增强与对话上下文 carryover 实际无效，metrics 显示 `unknown/unknown`。现已与 `StreamAdapter` 对齐转发。影响：启用多说话人 diarization 的 STT 集成需重新验证 keyterm 与上下文行为。
+
+- **RemoteSession 事件转发补全**（[#6691](https://github.com/livekit/agents/pull/6691)、[#6693](https://github.com/livekit/agents/pull/6693)）：`agent_false_interruption` 现经 `RemoteSession` 转发至宿主会话；测试从计数 10 个事件改为断言 `FORWARDED_EVENTS` 集合，避免新增转发时测试脆弱且无法检测 `off` 泄漏。影响：分布式/远程 agent 架构中 false interruption 回调行为与本地会话一致。
+
+- **Provider 与模型扩展**：[#6554](https://github.com/livekit/agents/pull/6554) 新增 Bland TTS 插件（`BLAND_API_KEY`，31 项测试）；[#6263](https://github.com/livekit/agents/pull/6263) OpenAI registry 加入 `gpt-5.5` 并支持 `reasoning_effort`；[#6695](https://github.com/livekit/agents/pull/6695) Anam avatar 可选 AI disclosure 水印（EU AI Act Article 50）；[#6687](https://github.com/livekit/agents/pull/6687) Phonic realtime 暴露 VAD、backchannel、redaction 等配置项。均为增量能力，默认行为不变。
+
+---
+
+## Watchlist
+
+1. **TTS fallback 恢复栈仍未完全闭合**：[#6683](https://github.com/livekit/agents/pull/6683) 已合入 task slot 隔离，但 [#6684](https://github.com/livekit/agents/pull/6684)（流式路径对 skipped provider 的恢复探测，Fixes [#6678](https://github.com/livekit/agents/issues/6678)）仍开放。仅使用 `stream()` 的 agent 在 primary TTS 故障后可能永久钉死在 fallback provider 上，合入 [#6684] 前建议做多 provider 流式故障 e2e 验证。
+
+2. **Inference LLM 流式重试语义**：[#6697](https://github.com/livekit/agents/pull/6697)（开放，2026-08-04 更新）指出 gateway 首个无内容 metadata chunk 会使流式响应过早变为不可重试，mid-stream stall 直接失败而非静默恢复。与已合入的 [#6696](https://github.com/livekit/agents/pull/6696) 诊断改进相关，但根因在 `retryable` 清除时机，需关注合入后对 gateway 路径仿真稳定性的影响。
+
+3. **Voice 生命周期与依赖跟进**：[#6694](https://github.com/livekit/agents/pull/6694)（`ctx.foreground()` 内 `update_agent()` 时 run 过早结束，Fixes [#6658](https://github.com/livekit/agents/issues/6658)）仍开放；[#6600](https://github.com/livekit/agents/pull/6600)（realtime 中断时 tool result 投递）自 7 月 29 日起未动；[#6657](https://github.com/livekit/agents/pull/6657) CLI 破坏性移除待合入；[#6692](https://github.com/livekit/agents/pull/6692) aiohttp v3.14.3 安全依赖升级开放。本 fork **落后上游 386 提交**，生产若基于 fork 部署需规划同步。
+
+---
+
+*生成时间：2026-08-05（自动化 cron）*