docs: daily engineering digest 2026-08-04

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

@@ -0,0 +1,41 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间
+
+**2026-08-03 00:00 UTC — 2026-08-04 00:02 UTC**（与 cron 触发 `2026-08-04T00:02:47Z` 对齐）
+
+数据来源：`git log upstream/main`、`gh` API 查询 [livekit/agents](https://github.com/livekit/agents) `main` 合并 PR。
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**。相对上游 **落后 375 个提交**（`git rev-list --count origin/main..upstream/main`）。
+
+**上游追踪（livekit/agents `main`）**：同期 **6 个已合并 PR**；以下要点均来自上游提交/PR 证据。
+
+---
+
+## 要点变更
+
+- **livekit-agents@1.6.8 发布**（[#6659](https://github.com/livekit/agents/pull/6659)，2026-08-03 17:10 UTC）：全量包版本升至 **1.6.8** 并发布至 PyPI。自 1.6.7 以来约 **54 个提交**合入，涵盖 voice 中断/暂停修复（[#6662](https://github.com/livekit/agents/pull/6662)、[#6642](https://github.com/livekit/agents/pull/6642)）、用户转录超时（[#6182](https://github.com/livekit/agents/pull/6182)）、Google genai 客户端泄漏修复（[#6643](https://github.com/livekit/agents/pull/6643)）、AWS STT/Bedrock 指标修正（[#6653](https://github.com/livekit/agents/pull/6653)、[#6663](https://github.com/livekit/agents/pull/6663)）、CLI `console`/`dev` 弃用提示（[#6656](https://github.com/livekit/agents/pull/6656)）等。影响：生产环境升级需关注 voice 会话行为与 telemetry 指标变化。
+
+- **Deepgram Flux TTS 集成**（[#6511](https://github.com/livekit/agents/pull/6511)，2026-08-03 19:09 UTC）：新增 `deepgram.TTSv2` 类，对接 `/v2/speak` 端点（Flux TTS），与现有 Aura TTS（`/v1/speak`）并行存在，**纯增量、无破坏性变更**。实现模式与 `STTv2` 一致，复用 `ConnectionPool` 与 `AudioEmitter`，流式路径以 `SpeechMetadata` 作为回合结束标记。影响：使用 Deepgram 的 agent 可选用新一代 Flux 语音合成。
+
+- **Examples 纳入 uv workspace**（[#6649](https://github.com/livekit/agents/pull/6649)，2026-08-03 20:44 UTC）：将所有 `examples/` 目录声明为 `[tool.uv.workspace].members`，修复 `uv sync` 不安装 example 依赖导致 `ModuleNotFoundError`（如 `hotel_receptionist` 缺少 `apsw`）的问题。影响：本地开发与 CI 中运行 example 的依赖一致性改善，35 个文件变更。
+
+- **Sarvam saaras:v3 热词偏置静默失效修复**（[#6617](https://github.com/livekit/agents/pull/6617)，2026-08-03 17:04 UTC，closes [#6606](https://github.com/livekit/agents/issues/6606)）：`MODEL_CONFIGS["saaras:v3"]` 错误声明 `supports_prompt=True`，导致 config/prompt 消息被发送但连接端忽略，用户设置 `prompt` 做热词偏置时实际无效。已将标志改为 `False`。影响：使用 Sarvam saaras:v3 的 STT 集成需确认不再依赖 prompt 参数。
+
+- **Cerebras 暴露 `max_completion_tokens`**（[#6685](https://github.com/livekit/agents/pull/6685)，2026-08-03 19:38 UTC）：Cerebras LLM 子类此前未在构造函数中暴露该参数，用户只能退回到通用 OpenAI 兼容插件，丢失 gzip/msgpack 优化。现已补齐并转发至父类。影响：Cerebras 用户可直接限制输出 token 数。
+
+- **跨平台 type-check 对齐 CI**（[#6623](https://github.com/livekit/agents/pull/6623)，2026-08-03 01:06 UTC，closes [#6622](https://github.com/livekit/agents/issues/6622)）：`make type-check` 在所有宿主 OS 上均以 Linux 为目标平台运行 mypy，修复 Windows 贡献者遇到的 20+ `attr-defined` 误报。影响：仅开发体验，无运行时行为变更。
+
+---
+
+## Watchlist
+
+1. **Voice 中断栈仍有未合并 PR**：[#6600](https://github.com/livekit/agents/pull/6600)（realtime 中断时 tool result 投递，自 7 月 29 日起开放）、[#6644](https://github.com/livekit/agents/pull/6644)（中断遍历在 `disallow_interruptions` 处停止）、[#6660](https://github.com/livekit/agents/pull/6660)（非阻塞 tool 触发的会话工作不被丢弃）。1.6.8 已合入 [#6662](https://github.com/livekit/agents/pull/6662)/[#6642](https://github.com/livekit/agents/pull/6642)，但上述 PR 仍开放，升级后需关注 Gemini realtime 与复杂 tool 场景的回归。
+
+2. **TTS fallback 恢复路径集中活跃**：过去 24 小时内 [#6680](https://github.com/livekit/agents/pull/6680)–[#6684](https://github.com/livekit/agents/pull/6684) 等多个 PR 针对 fallback adapter 的 skipped provider 探测与 task slot 隔离提交修复，表明流式 TTS 故障恢复路径存在已知缺陷，合入前建议关注多 provider fallback 场景的 e2e 验证。
+
+3. **CLI 破坏性移除待合入 + Fork 漂移**：[#6657](https://github.com/livekit/agents/pull/6657)（移除 `console`/`dev` 实现，保留迁移提示）在 1.6.8 弃用公告（[#6656](https://github.com/livekit/agents/pull/6656)）之后仍未合并；本 fork 已 **落后上游 375 提交**，若生产基于 fork 部署，需规划同步策略。
+
+---
+
+*生成时间：2026-08-04（自动化 cron）*