docs: daily engineering digest 2026-07-09

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

@@ -0,0 +1,39 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间范围
+
+**2026-07-08 00:02 UTC → 2026-07-09 00:02 UTC**（与 cron 触发 `2026-07-09T00:02:16Z` 对齐）
+
+数据来源：`git log upstream/main`（[livekit/agents](https://github.com/livekit/agents)）提交历史与 GitHub API 已合并 PR 查询。
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`HEAD` 仍为 `f9b68de7`（2026-05-27，[#5857](https://github.com/livekit/agents/pull/5857)）。相对上游 **落后 228 个提交**（`git rev-list --count origin/main..upstream/main`，较昨日 +2）。
+
+**上游追踪（livekit/agents `main`）**：同期 **2 个 PR 合入**（较昨日 10 个显著放缓），集中在 TTS 重试可靠性修复与 CLI 开发体验。
+
+---
+
+## 要点摘要
+
+- **TTS ChunkedStream 重试修复合入** ([#6346](https://github.com/livekit/agents/pull/6346)，2026-07-08 11:05 UTC，u9g)：修复 `test_tts_synthesize[deepgram]` CI 失败根因——连接中断后 `ChunkedStream` 重试时，失败尝试的音频帧仍可能与重试帧交错、且 `request_id` 混杂。变更在重试前 `await output_emitter.aclose()` 结算 emitter，并以新 `request_id` 重启合成；同时仅对 `e.retryable` 错误重试（`tts/tts.py` +111/-19 行，含 `fake_tts.py` 与 `test_tts.py` 回归）。**影响**：Deepgram 等 ChunkedStream TTS 在 transient 网络错误下不再产出混合音频；昨日 Watchlist 中标注的开放项现已关闭。
+
+- **CLI 开发模式 ServerInfo 握手** ([#6260](https://github.com/livekit/agents/pull/6260)，2026-07-08 21:22 UTC，davidzhao)：`cli/watcher.py` 在启动时向 Go CLI host 发送 `ServerInfo`（`agent_name` + `ws_url`），便于 CLI 展示 Cloud console 链接等信息，随后再同步 running jobs。**影响**：`python myagent.py dev` 热重载/watch 流程的用户可见性改善；属开发工具链变更，不影响生产 `start` 路径。
+
+- **依赖：`livekit-protocol` 升至 1.1.18**（随 [#6260](https://github.com/livekit/agents/pull/6260) 合入）：`livekit-agents/pyproject.toml` 下界从 `>=1.1.17` 调整为 `>=1.1.18`，`uv.lock` 同步更新（+122 行 lockfile 变更，含 `lxml` 等传递依赖刷新）。**影响**：需 `uv sync` 或重新 pin 以确保 protobuf wire 定义与 CLI `AgentDevMessage.server_info` 字段一致。
+
+- **合入节奏明显放缓**：昨日同期合入 Expressive Mode 三连修（#6232/#6347/#6350）、结构化输出回滚（#6345）、voice 重试（#6080）等 10 个 PR；今日仅上述 2 项。**影响**：无新 voice/tts 大功能或破坏性 API 变更，升级风险窗口相对平静。
+
+- **多项 voice/telemetry 修复仍在 review**（未合入）：[#6349](https://github.com/livekit/agents/pull/6349)（中断时保留已完成 tool results，fixes [#3702](https://github.com/livekit/agents/issues/3702)）、[#6352](https://github.com/livekit/agents/pull/6352)（realtime `generate_reply` 响应级重试）、[#6353](https://github.com/livekit/agents/pull/6353)（`text` content 字段翻转，AGT-3103）、[#6356](https://github.com/livekit/agents/pull/6356)（trace/log PII 红标 `lk.pii.*`，AGT-3074）均在 7/8 有更新但仍 open。**影响**：使用 tool handoff + 用户打断、OpenAI realtime 或 telemetry 导出的部署，短期内仍需关注上游合入进度。
+
+---
+
+## Watchlist
+
+1. **#6346 生产验证**：修复针对 ChunkedStream 非流式合成路径；使用 Deepgram / 其他 ChunkedStream provider 且启用 TTS 重试的 agent，建议在 staging 模拟 mid-response 断连，确认无音频交错与 `request_id` 污染。
+
+2. **开放 PR 与昨日变更的衔接**：#6349（tool 中断）与 #6352（realtime 重试）分别补足昨日 #6345 结构化输出回滚后仍存在的 voice 韧性缺口；合入前使用 `session.run()` + tool handoff + realtime 的 agent 可能仍遇已知 edge case。
+
+3. **Fork 漂移 228 commits + 无新版本发布**：今日合入的 TTS 修复与 CLI 改进均未伴随 PyPI 发布 PR；本 fork `main` 仍停留 5 月快照。若生产基于本仓库，需计划 rebase/cherry-pick 或显式追踪上游 tag。
+
+---
+
+*生成时间：2026-07-09（自动化 cron）*