docs: daily engineering digest for 2026-06-18

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

@@ -0,0 +1,33 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间
+
+**2026-06-17 00:01 UTC — 2026-06-18 00:01 UTC**（与每日 cron 触发对齐）
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`main` 仍停留在 2026-05-27（[#5857](https://github.com/livekit/agents/pull/5857) 等），相对上游 [livekit/agents](https://github.com/livekit/agents) **落后约 130 个提交**。
+
+**上游追踪（livekit/agents `main`）**：同期 **6 个已合并 PR**，含 **1.6.1 版本发布**、2 项插件能力扩展、1 项同日合并又回滚的核心变更。以下要点均来自上游提交/PR 证据。
+
+---
+
+## 要点变更
+
+- **livekit-agents@1.6.1 发布**（[#6140](https://github.com/livekit/agents/pull/6140)，2026-06-17 16:26 UTC）：相对 1.6.0 合入 **25 个提交**，涵盖 voice/session 多项修复（如 [#6071](https://github.com/livekit/agents/pull/6071) AgentTask 等待时 session 关闭死锁、[#6084](https://github.com/livekit/agents/pull/6084) 工具执行期间对话项纳入回复上下文）、IPC/worker 修复，以及依赖更新（`livekit` → v1.1.9 [#6102](https://github.com/livekit/agents/pull/6102)、`av` → 17.1.0 [#6091](https://github.com/livekit/agents/pull/6091)）。影响：生产环境若跟进 PyPI 版本，需关注 voice 会话生命周期与 worker 超时相关行为变化。
+
+- **AssemblyAI STT 默认模型切换**（[#6119](https://github.com/livekit/agents/pull/6119)）：新增 `universal-3-5-pro` 并设为 **插件默认**（原为 `universal-streaming-english`）；同时新增 `voice_focus` / `voice_focus_threshold` 连接参数，归入 u3-rt-pro 参数族。影响：未显式指定 `model` 的现有 agent 将自动切换到新模型及其默认行为（如 `continuous_partials=True`）；电话/远场场景需验证 Voice Focus 配置。
+
+- **Google Gemini TTS 升级至 3.1 + 流式响应**（[#6134](https://github.com/livekit/agents/pull/6134)）：新增 `gemini-3.1-flash-tts-preview` 模型并设为 **默认**；`generate_content` 改为 `generate_content_stream` 逐 chunk 推送音频；附带示例 `google_gemini_tts.py` 与单元测试。影响：使用 `GeminiTTS` 的 agent 默认模型与合成路径均变更，需确认 Google API 对 preview 模型的配额与延迟表现。
+
+- **非主 session 支持同日合并又回滚**（[#6137](https://github.com/livekit/agents/pull/6137) → [#6139](https://github.com/livekit/agents/pull/6139)）：`AgentSession.start()` 新增私有参数 `_register_as_room_host`，意图让非 primary session 可在无 `job_ctx` 场景运行（simulation 需求）；约 **36 分钟后被 revert**，1.6.1 最终 **不包含** 此变更。影响：依赖多 session / simulation 的集成方仍需等待后续方案；1.6.1 中该能力不可用。
+
+- **Google 插件格式化修正**（[#6142](https://github.com/livekit/agents/pull/6142)）：对 [#6134](https://github.com/livekit/agents/pull/6134) 引入的示例与测试做 ruff 格式化（逗号、空行、import 排序），无功能变更。
+
+---
+
+## Watchlist
+
+1. **Fork 与上游持续漂移**：本仓库 `main` 已连续 **22 日无合并**，上游 6/17 发布 1.6.1 并切换 AssemblyAI/Gemini TTS 默认模型；若生产基于本 fork，需计划 rebase/merge 或至少 cherry-pick 关键 voice 修复与插件默认变更。
+
+2. **插件默认模型 breaking change**：[#6119](https://github.com/livekit/agents/pull/6119) 与 [#6134](https://github.com/livekit/agents/pull/6134) 均静默更改默认模型；未 pin `model` 参数的 agent 升级后可能出现识别/合成质量或延迟差异，建议在预发对比 `universal-streaming-english` vs `universal-3-5-pro` 及 Gemini 2.5 vs 3.1 TTS。
+
+3. **1.6.1 发布面较广、同日 revert 信号**：25 个提交打包发布且含 voice 死锁/IPC 修复，但 [#6137](https://github.com/livekit/agents/pull/6137) 快速回滚表明核心 session 注册逻辑仍有争议；升级 1.6.1 后应重点回归多 agent handoff、session 关闭、AssemblyAI/Gemini TTS 路径。