docs: daily engineering digest 2026-06-20

automations/livekit-agent/2026-06-20.markdown

@@ -0,0 +1,37 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间
+
+**2026-06-19 00:00 UTC — 2026-06-20 00:00 UTC**（与每日 cron 触发对齐）
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`main` 仍停留在 2026-05-27 的合并（[#5857](https://github.com/livekit/agents/pull/5857)–[#5859](https://github.com/livekit/agents/pull/5859) 等），相对上游 [livekit/agents](https://github.com/livekit/agents) **落后 146 个提交**。
+
+**上游追踪（livekit/agents `main`）**：同期 **10 个已合并 PR**，并于 2026-06-19 22:58 UTC 发布 **livekit-agents@1.6.2** 至 PyPI（[#6170](https://github.com/livekit/agents/pull/6170)）。以下要点均来自上游提交/PR 证据。
+
+---
+
+## 要点变更
+
+- **1.6.2 版本发布**（[#6170](https://github.com/livekit/agents/pull/6170)）：全量包发布至 PyPI。当日合入的 Phonic 修复、Google context 耗尽处理、AssemblyAI 新模型、工作流 DOB 修复等均包含在此版本；升级路径为 `pip install -U livekit-agents`。
+
+- **Phonic Realtime 插件集中改进**（[#6143](https://github.com/livekit/agents/pull/6143)、[#6163](https://github.com/livekit/agents/pull/6163)、[#6169](https://github.com/livekit/agents/pull/6169)、[#6168](https://github.com/livekit/agents/pull/6168)）：新增 `forbid_speech_after_tool_call` 配置，防止 handoff 工具调用后 outgoing agent 抢话；handoff 间复用 WebSocket 连接；修复 `update_chat_ctx` 忽略用户文本输入导致聊天消息被静默丢弃的问题。影响：使用 Phonic + 多 agent handoff 或文本输入的生产部署应优先升级。
+
+- **Google Gemini Realtime context 耗尽处理**（[#6144](https://github.com/livekit/agents/pull/6144)）：当 Gemini Live 以 WebSocket 1007（context exhausted）关闭会话时，不再无限重连（重连会回放相同超大 context 并再次失败），改为通过 `error` 事件以 `recoverable=False` 终止会话并抛出 `APIConnectionError`。影响：长对话场景下 agent 会明确失败而非陷入 tight retry loop；需在上层实现 context 裁剪或会话重启策略。
+
+- **工作流 GetDOBTask 静默数据损坏修复**（[#6124](https://github.com/livekit/agents/pull/6124)）：对两位年份（如 "90"）按当前年份 pivot 归一化（90→1990、27→1927），避免 `date(90, 5, 15)` 被当作公元 90 年通过校验。新增 `tests/test_dob.py` 覆盖。影响：身份/医疗/金融 intake 工作流中出生日期采集的准确性；小模型更易触发此 bug。
+
+- **Azure STT 用量指标修正**（[#6161](https://github.com/livekit/agents/pull/6161)）：改为追踪已处理音频时长并周期性/flush 时发出 recognition usage metrics，包含静音时段（此前仅计已识别语音段）。含 `tests/test_plugin_azure_stt.py`。影响：基于 Azure STT 用量的计费/监控报表数值将更准确，可能与历史数据有偏差。
+
+- **Inference 新增 AssemblyAI 模型**（[#6162](https://github.com/livekit/agents/pull/6162)）：`inference/stt.py` 增加 `assemblyai/universal-3-5-pro` 模型字符串。影响：使用 LiveKit Inference STT 的 agent 可直接选用新模型。
+
+- **xAI TTS WebSocket 选项暴露**（[#6095](https://github.com/livekit/agents/pull/6095)）：支持 `optimize_streaming_latency`、`speed`、`text_normalization` 参数及 `update_options` 动态更新。影响：xAI TTS 用户可精细调优延迟与语速，无 breaking change。
+
+---
+
+## Watchlist
+
+1. **Fork 与上游持续漂移**：本仓库 `main` 已连续 **24 日无合并**，上游单日合入 10 个 PR 并发布 1.6.2；若生产基于本 fork，需计划 rebase/merge 或至少 cherry-pick Phonic handoff 修复（[#6143](https://github.com/livekit/agents/pull/6143)–[#6169](https://github.com/livekit/agents/pull/6169)）与 DOB 工作流修复（[#6124](https://github.com/livekit/agents/pull/6124)）。
+
+2. **Phonic `forbid_speech_after_tool_call` 配置误用风险**：仅应列出 **必定触发 handoff** 的工具名；若列出非 handoff 工具，agent 将在工具调用后保持沉默（[#6143](https://github.com/livekit/agents/pull/6143) PR 描述已明确警告）。部署时应逐工具审计配置。
+
+3. **Google Realtime 长会话 context 管理**：[#6144](https://github.com/livekit/agents/pull/6144) 将 context 耗尽从隐式重试循环变为显式 fatal error；长对话 agent 需验证上层是否正确处理 `APIConnectionError` 并实施 context 裁剪，否则用户体验从「卡顿重试」变为「会话终止」。