docs: daily engineering digest for 2026-07-24

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

@@ -0,0 +1,33 @@
+# LiveKit Agents 工程日报
+
+**Date range covered:** 2026-07-23 00:00 UTC → 2026-07-24 00:00 UTC
+
+**仓库：** [livekit/agents](https://github.com/livekit/agents)（upstream/main）
+
+---
+
+## 关键变更
+
+- **SLNG 插件 2.0 大重写（破坏性变更）** — [#6442](https://github.com/livekit/agents/pull/6442) 将 `livekit-plugins-slng` 全面迁移至 Unmute Bridge v2 协议（+2415/−1101 行，涉及 `stt.py`、`tts.py`、`gateway_adapter.py`）。移除 1.x 的 `model_endpoint` 参数，STT/TTS 需显式传入 `model=` 或 `connections=[...]` 故障转移链；新增 `attach_to_session()` 加速 utterance 结束、`provider_api_key` BYOK、`world_part_override` 地理路由。PR 标注为 **2.0.0 breaking release**。影响：所有 SLNG 集成需按 README「Migrating from 1.x」迁移。
+
+- **Realtime 模型支持自适应打断（barge-in）** — [#6488](https://github.com/livekit/agents/pull/6488) 在禁用服务端 turn detection 的 OpenAI 兼容 realtime 模型上，启用客户端自适应打断：用户说「嗯嗯」等 backchannel 时不再误触发回复，通过 `OverlappingSpeechEvent.agent_ended` 区分 agent 结束与用户结束，并在确认 backchannel 后调用 `clear_audio()` 清空缓冲。新增 `tests/test_realtime_adaptive_interruption.py`（+260 行）。影响：无 STT 的纯 realtime 路径打断行为变更；若需更细粒度控制可叠加 STT。
+
+- **Inference 网关新增 AvatarSession** — [#6492](https://github.com/livekit/agents/pull/6492) 新增 `inference.AvatarSession`，通过 gateway `POST /v1/avatar/sessions` 以单一 `LIVEKIT_API_KEY` 完成 avatar 会话 provisioning（+1277 行，含 `tests/test_inference_avatar.py` +648 行）。影响：无需 BYOK provider key 即可使用 LemonSlice 等 avatar；BYOK 插件路径不受影响。
+
+- **Agent handoff 死锁修复** — [#6500](https://github.com/livekit/agents/pull/6500) 修复 `session.update_agent()` 在新 agent 的 `on_enter` 等待长生命周期 `AgentTask` 时导致 `session.run()` 永久阻塞的循环等待。改为 `wait_on_enter=False` 并通过 `run_state._watch_handle()` 追踪 `on_enter` 输出。新增 `tests/test_update_agent_long_on_enter.py`（+148 行）。影响：多 agent 切换 + function tool 场景不再死锁。
+
+- **Krisp 电话模式 + 内部 SDK 升级** — [#6510](https://github.com/livekit/agents/pull/6510) 新增 `viva_filter.py` 支持 voice isolation telephony mode；`livekit-plugins-krisp-internal` 从 `>=0.1.0` 锁定至 `==0.2.0`（`uv.lock` 同步更新，wheel 体积约 +5MB）。影响：电话场景降噪能力增强；Krisp 用户需验证 0.2.0 SDK 兼容性。
+
+- **Fish Audio TTS 扩展** — [#6520](https://github.com/livekit/agents/pull/6520) 在 FishAudio 插件新增 `normalize_loudness` 及生成调参选项（+219 行测试）；[#6529](https://github.com/livekit/agents/pull/6529) 在 `inference/tts.py` 网关路径注册 Fish Audio 模型（+50 行）。影响：Fish Audio 用户可获得更一致的响度与可调生成参数。
+
+- **本地 VAD 支持专用 executor** — [#6498](https://github.com/livekit/agents/pull/6498) 允许本地 VAD 推理使用独立 executor，避免阻塞主事件循环（`inference/vad.py` +19/−5 行，测试 +28 行）。影响：高并发场景下 VAD 延迟与主循环隔离。
+
+---
+
+## Watchlist
+
+1. **SLNG 2.0 破坏性迁移窗口** — [#6442](https://github.com/livekit/agents/pull/6442) 移除全部 1.x API（`model_endpoint` 直接 `ValueError`），且 PR 注明 out-of-tree 测试未随 PR 合入。生产 SLNG 用户需在发布 2.0.0 前完成迁移并自行验证 failover / finalize 行为。
+
+2. **Realtime 打断语义变更需回归** — [#6488](https://github.com/livekit/agents/pull/6488) 对无 STT 的 realtime 路径采用 all-or-nothing 丢弃策略（与 STT 时间窗口裁剪不同）；慢速 backchannel 判定在 agent 已停止说话后会 fallback 为 commit 而非丢弃。建议在纯 realtime agent 上回归打断灵敏度与误拒场景。
+
+3. **Fork 持续落后 upstream 307 commits** — 本仓库 `main` HEAD 仍为 `f9b68de7`（2026-05-27，[#5857](https://github.com/livekit/agents/pull/5857)）；昨日 watchlist 中的 [#6488](https://github.com/livekit/agents/pull/6488) 已合入，但 SLNG 2.0、AvatarSession、Krisp 0.2.0 等变更均未同步至 fork，需计划 bulk sync。