docs: daily engineering digest 2026-07-06

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

@@ -0,0 +1,39 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间范围
+
+**2026-07-05 00:01 UTC → 2026-07-06 00:01 UTC**（与 cron 触发 `2026-07-06T00:01:49Z` 对齐）
+
+数据来源：`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)）。相对上游 **落后 207 个提交**（`git rev-list --count origin/main..upstream/main`，较昨日 +1）。
+
+**上游追踪（livekit/agents `main`）**：同期 **仅 1 个 PR 合入**，为 RTC SDK 依赖升级；无功能修复、无 PyPI 版本发布 bot 提交。
+
+---
+
+## 要点摘要
+
+- **livekit Python RTC SDK 升级至 1.1.13** ([#6311](https://github.com/livekit/agents/pull/6311)，2026-07-05 21:32 UTC，David Zhao)：`livekit-agents/pyproject.toml` 将 `livekit` 从 `==1.1.12` 升至 `==1.1.13`；`uv.lock` 同步锁定各平台 wheel（macOS x86_64/arm64、manylinux aarch64/x86_64、win_amd64）。**影响**：所有依赖 `livekit-agents` 的 agent 在 `uv sync` / 重新安装后将自动拉取新版 RTC FFI 绑定；需关注与 LiveKit server 版本的兼容性。
+
+- **livekit-api 最低版本要求上调** ([#6311](https://github.com/livekit/agents/pull/6311))：`pyproject.toml` 中 `livekit-api` 从 `>=1.0.7,<2` 改为 `>=1.1.1,<2`；`uv.lock` 实际解析版本从 `1.1.0` → `1.1.1`。**影响**：使用 room API、token 生成或 SIP 相关调用的 agent 将绑定较新的 API client；若项目单独 pin 了旧版 `livekit-api`，可能触发依赖冲突。
+
+- **合入窗口极为安静**：24 小时内上游仅 1 个 commit（`c82aad2c`），修改 2 个文件（`pyproject.toml` + `uv.lock`），+14/−14 行。对比 7/3–7/4 窗口（4 个 PR：TTFB 修复、OpenAI STT temperature、Responses schema 修复、LiveAvatar 错误透传），本周期无 voice/llm 插件逻辑变更。
+
+- **待合入 PR 在 7/5 仍有活跃更新**（未合并，不计入今日变更）：[#6315](https://github.com/livekit/agents/pull/6315) 修复 `session.run()` 与 `AgentTask` handoff 竞态（closes [#6313](https://github.com/livekit/agents/issues/6313)，最后更新 21:35 UTC）；[#6304](https://github.com/livekit/agents/pull/6304) 通过 `SpeechHandle.exception()` 暴露语音生成错误；[#6235](https://github.com/livekit/agents/pull/6235) 支持运行时 `update_options(stt=, tts=)` 热切换；[#6321](https://github.com/livekit/agents/pull/6321) / [#6324](https://github.com/livekit/agents/pull/6324) 分别加固 LLM formatter 与 thinking-token 剥离的容错。
+
+- **1.6.5 发布 PR 仍开放** ([#6302](https://github.com/livekit/agents/pull/6302)，最后更新 2026-07-04)：上游最新 PyPI 发布仍为 `livekit-agents@1.6.4`（2026-06-24）；今日 SDK bump 合入后尚未伴随 agents 包版本发布。
+
+---
+
+## Watchlist
+
+1. **#6311 SDK 升级 rollout 风险**：`livekit` 1.1.12→1.1.13 涉及原生 FFI wheel 替换，跨平台 CI 与生产镜像需在升级后做一次 smoke test（房间连接、音视频 publish/subscribe）；`livekit-api` 下限提升可能导致与旧版 server 或自定义 API wrapper 的 semver 冲突。
+
+2. **#6315 handoff 竞态尚未合入**：issue [#6313](https://github.com/livekit/agents/issues/6313) 描述的 `session.run()` 与 `AgentTask` handoff 时序问题在 1.6.1 可导致 hang；PR 于今日晚间更新但仍 open。使用 `on_enter` + tool 触发 handoff 的 agent 在升级前应评估 `capture_run=True` workaround。
+
+3. **Fork 漂移 207 commits**：含今日 SDK bump 及 7/3–7/4 窗口的 TTFB 度量语义变更、OpenAI 工具链修复等；若生产基于本 fork，同步上游后需重校依赖版本与 voice/llm 回归。
+
+---
+
+*生成时间：2026-07-06（自动化 cron）*