docs: daily engineering digest for 2026-06-10

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

@@ -0,0 +1,41 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间
+
+**2026-06-09 00:01 UTC — 2026-06-10 00:01 UTC**（与 cron 触发 `2026-06-10T00:01:18Z` 对齐）
+
+数据来源：`git log`、`gh` API 查询 [livekit/agents](https://github.com/livekit/agents) `main` 合并 PR。
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`HEAD` 仍为 `f9b68de7`（2026-05-27，[#5857](https://github.com/livekit/agents/pull/5857)）。相对上游 **落后 79 个提交**（`git rev-list --count origin/main..upstream/main`）。
+
+**上游追踪（livekit/agents `main`）**：同期 **6 个已合并 PR**；以下要点均来自上游提交/PR 证据。
+
+---
+
+## 要点变更
+
+- **Simulation 基础设施 + CLI 大重构**（[#5688](https://github.com/livekit/agents/pull/5688)，2026-06-09 02:32 UTC）：54 个文件、+3912/−2213 行。将 CLI 主体逻辑拆至 `cli/_legacy.py`，新增 `cli/tcp_console.py`、`simulation.py`，并更新 `__main__.py`、watcher、proto 等；附带 `examples/hotel_receptionist/` 的 benchmark 与 scenarios。影响：simulation 启动路径与 CLI 内部结构发生根本性变化，依赖旧 CLI 导入路径或自定义启动脚本的集成需重新验证。
+
+- **Worker `agent_name` 优先级调整**（[#6022](https://github.com/livekit/agents/pull/6022)，2026-06-09 02:27 UTC）：`LIVEKIT_AGENT_NAME_OVERRIDE`（平台注入，如 lk simulation launcher）强制优先于 `@rtc_session` 装饰器参数，装饰器参数优先于 `LIVEKIT_AGENT_NAME` 环境变量；`tests/test_worker_config.py` 同步更新 precedence 文档。影响：simulation/多 agent 调度场景下名称解析行为变更，需确认生产环境未意外设置 `LIVEKIT_AGENT_NAME_OVERRIDE`。
+
+- **CLI 入口简化**（[#6024](https://github.com/livekit/agents/pull/6024)，2026-06-09 04:17 UTC）：`python -m livekit.agents start|console <entrypoint>` 可自动发现 `AgentServer`，移除 `run_app(server: AgentServer)` 中显式传入 server 的要求。影响：开发者启动体验改善；与 [#5688](https://github.com/livekit/agents/pull/5688) CLI 重构叠加，建议回归 `start`、`console`、`dev` 三条路径。
+
+- **单元测试加速**（[#5980](https://github.com/livekit/agents/pull/5980)，2026-06-09 09:23 UTC）：40 个文件；引入 virtual time（`asyncio.sleep` 瞬时返回）与 concurrent test execution（`pytest-asyncio-concurrent`），`pytest --unit` 从 **3 分 44 秒降至 30 秒**（PR 自述）。影响：CI 与本地反馈循环显著加快；virtual/concurrent 模式可能掩盖真实时序 bug，需关注 `--real-time` / `--no-concurrent` 标记的测试是否覆盖关键路径。
+
+- **Barge-in 默认阈值 + 托管流量路径变更**（[#5946](https://github.com/livekit/agents/pull/5946)，2026-06-09 13:02 UTC）：仅在用户显式指定时向 gateway 传递 threshold，否则使用 gateway 默认值；**移除 hosted agents 的 HTTP transport**，全部流量经 gateway 并以 worker token 识别 cloud agent（JS 对应 [agents-js#1698](https://github.com/livekit/agents-js/pull/1698)）。影响：托管环境 interruption 行为与传输层变化；PR 作者已在 hosted env 验证 cloud agent 识别，但 rollout 需关注自定义 threshold 配置与 failover 路径（`inference/interruption.py`、`worker.py`）。
+
+- **Anam Avatar 视频尺寸可配置**（[#5935](https://github.com/livekit/agents/pull/5935)，2026-06-09 20:17 UTC，closes [#5954](https://github.com/livekit/agents/issues/5954)）：新增 `anam.SessionOptions(video_width, video_height)`，转发至 Anam session-token 请求的 `sessionOptions.videoWidth` / `videoHeight`，avatar 视频按 Anam 解析尺寸发布。影响：使用 Anam avatar 的 agent 可控制输出分辨率，避免默认尺寸不匹配导致的布局问题。
+
+---
+
+## Watchlist
+
+1. **CLI + Simulation 合入风险**：[#5688](https://github.com/livekit/agents/pull/5688) 为本周最大变更（54 文件），与 [#6024](https://github.com/livekit/agents/pull/6024)、[#6022](https://github.com/livekit/agents/pull/6022) 同日合入；建议在预发环境完整跑通 simulation launcher、`python -m livekit.agents` 启动、以及 hot-reload watcher 路径，确认无导入/循环依赖回归。
+
+2. **Hosted agent HTTP transport 移除**：[#5946](https://github.com/livekit/agents/pull/5946) 改变 cloud agent 与 gateway 的通信方式；若生产使用自定义 interruption threshold 或依赖旧 HTTP 路径，需验证 barge-in 灵敏度与 failover 测试（`test_interruption_failover.py`、`test_interruption_session_create.py`）在真实环境仍通过。
+
+3. **Fork 漂移持续扩大**：本仓库 `main` 已 **14 天无合并**，上游同期新增 simulation 全栈与测试基础设施变更；若生产基于本 fork，需计划 bulk sync 或 cherry-pick，尤其 [#5688](https://github.com/livekit/agents/pull/5688) / [#5946](https://github.com/livekit/agents/pull/5946) 等影响运行时行为的 PR。
+
+---
+
+*生成时间：2026-06-10（自动化 cron）*