docs: daily engineering digest 2026-07-01

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

@@ -0,0 +1,41 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间范围
+
+**2026-06-30 00:00 UTC → 2026-07-01 00:00 UTC**（与 cron 触发 `2026-07-01T00:00:28Z` 对齐）
+
+数据来源：`git log upstream/main`（[livekit/agents](https://github.com/livekit/agents)）提交历史与 diff 统计。
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`HEAD` 仍为 `f9b68de7`（2026-05-27）。相对上游 **落后 187 个提交**（`git rev-list --count origin/main..upstream/main`）。
+
+**上游追踪（livekit/agents `main`）**：同期 **6 个 PR 合入**，涵盖 STT 对话感知、xAI Realtime 修复、容器 TLS、LemonSlice 会议集成与 EOT 日志优化。
+
+---
+
+## 要点摘要
+
+- **对话感知 STT（keyterms + chat context）** ([#6039](https://github.com/livekit/agents/pull/6039))：新增 `KeytermsOptions` / `KeytermDetectionOptions` 与 `keyterm_detection.py`（+466 行），`AgentSession` 可按用户轮次自动从对话上下文提取关键术语并注入 STT；`inference/stt.py`、`stt.py` 基类及 AssemblyAI、Deepgram、Google 插件同步支持 `keyterms` / `chat_context` 透传。附带 `tests/test_stt_context.py`（+561 行）。**影响**：专有名词、产品名等识别准确率有望提升；`keyterm_detection` 会触发额外 LLM 调用，需关注 `turn_interval` 与 API 成本。
+
+- **xAI Realtime 两项修复** ([#6272](https://github.com/livekit/agents/pull/6272)、[#6276](https://github.com/livekit/agents/pull/6276))：`#6272` 修复 xAI 将 partial 转写以 `status: "in_progress"` 经 `ConversationItemInputAudioTranscriptionCompletedEvent` 下发、却被 OpenAI 基类一律当作 final 处理的问题，现正确发出 `is_final=False` 的 interim 事件；`#6276` 在 `_wrap_session_update` 中将 `voice` / `turn_detection` 从 OpenAI 嵌套结构重定位到 xAI 要求的顶层 session 字段。**影响**：xAI Realtime 用户可见更流畅的实时字幕与可配置语音；两 PR 均新增/扩展 `test_xai_realtime_model.py`。
+
+- **容器 TLS：certifi 作为系统信任库缺失时的回退** ([#6231](https://github.com/livekit/agents/pull/6231))：`http_context.py` 新增 `_set_default_cert_env()`，在无系统 CA 路径时设置 `SSL_CERT_FILE` 指向 certifi bundle；`worker.py` 启动时调用，使 job 子进程与 Rust `livekit-rtc` SDK 均可继承。**影响**：修复 minimal 容器（无 `ca-certificates`）中 room 连接报 "no native root CA certificates found" 的部署痛点；已有 `SSL_CERT_FILE` / `SSL_CERT_DIR` 环境变量时不会覆盖。
+
+- **LemonSlice Avatar 支持第三方会议平台** ([#6233](https://github.com/livekit/agents/pull/6233))：新增 `meeting/` 子模块（audio、chat、codec、room）与 `agent_worker_meeting.py` 示例（+714 行），扩展 `lemonslice/api.py` 与 `avatar.py`。**影响**：LemonSlice 数字人可接入 Zoom/Teams 等外部会议场景；属较大功能面扩展，集成方需按新 README 配置会议凭证与 worker 入口。
+
+- **EOT 慢 STT 告警逻辑收紧** ([#6179](https://github.com/livekit/agents/pull/6179))：`audio_recognition.py` 将 "transcript arrives after turn has been committed" 警告的触发条件限制为仅 `trigger == "stt"` 时调用 `_on_missing_eot_prediction()`，并更新日志措辞。**影响**：减少非 STT 路径的误报警；运维侧排查慢转写时日志信息更准确。
+
+- **本周期无依赖 bump 或安全 advisory**：6 个 PR 均未触及 `uv.lock` 或 Renovate/Dependabot 提交；变更集中在 `voice/`、插件层与 HTTP/TLS 基础设施。
+
+---
+
+## Watchlist
+
+1. **Fork 漂移扩大至 187 commits**：含本日 6 个上游 PR 及此前未同步的 OpenAI Realtime 稳定性修复（[#6244](https://github.com/livekit/agents/pull/6244)、[#6158](https://github.com/livekit/agents/pull/6158) 等）；若生产基于本 fork，需规划 bulk sync，优先验证 STT keyterm 与 xAI Realtime 路径。
+
+2. **对话感知 STT 的 LLM 成本与延迟**：`keyterm_detection` 默认按轮次调用 LLM 提取术语（`basic_agent.py` 示例设 `turn_interval: 1`）；高并发场景建议调高 `turn_interval` 或关闭自动检测，并监控 `stt_metrics` 与 LLM token 消耗。
+
+3. **LemonSlice 会议集成 rollout 风险**：+714 行新代码路径无本周期内可见的独立测试文件；第三方会议平台的音频编解码与房间生命周期较复杂，上线前建议在目标平台做端到端联调。
+
+---
+
+*生成时间：2026-07-01（自动化 cron）*