以下均为项目官方仓库或官方发布文档。读取发生于 2026-09-17；未取得固定 commit 的完整 checkout，源码与文档存在缓存/版本差异。行号仅用于定位本次读取快照，不代表当前 main 的永久行号。主文中的 [Sxx] 对应以下条目。

S01 旧 Gateway 编排与模型/Client 事件转换

路径：server/src/voice/realtime-gateway.mjs。
定位：约 L589–749 播放回执；L750–910 Task；L912–1314 模型事件；L1316–1852 连接/输入/控制。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/realtime-gateway.mjs ↗

S02 模型响应串行队列及生命周期

路径：server/src/voice/realtime-provider.mjs。
定位：L193–306 音频/工具/注入/取消；L337–609 排队、关联、超时与重试。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/realtime-provider.mjs ↗

S03 旧 OpenAI-compatible 上游 wire 构造

路径：server/src/voice/providers/openai-compatible-protocol.mjs。
定位：L11–61。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/providers/openai-compatible-protocol.mjs ↗

S04 DashScope 会话配置与公告注入

路径：server/src/voice/providers/dashscope.mjs。
定位：L24–90。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/providers/dashscope.mjs ↗

S05 TUI 播放状态及消息处理

路径：tui/src/index.mjs。
定位：约 L590–690 createPlayback；其后 runTui、音频桥和事件处理。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/tui/src/index.mjs ↗

S06 TUI 与原生音频进程的桥

路径：tui/src/macos-voice-io.mjs。
定位：play/done/clear 和 playback 回调。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/tui/src/macos-voice-io.mjs ↗

S07 原生 FIFO 与 done 哨兵

路径：tui/native/macos-voice-io.swift。
定位：L66–194 PlaybackEntry/SampleQueue。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/tui/native/macos-voice-io.swift ↗

S08 旧工具处理及 spawn/query/cancel/permission

路径：server/src/voice/tools/tool-call-handler.mjs。
定位：L179–414 dispatch/spawn；L422–692 授权/取消/状态；L699–807 记忆。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/tools/tool-call-handler.mjs ↗

S09 Task 生命周期、通知状态与 claim

路径：server/src/task/task-manager.mjs。
定位：L259–455 创建/执行；L458–543 取消；L573–676 claim/ack/renew/release。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/task/task-manager.mjs ↗

S10 Task 并发限制

路径：server/src/task/task-scheduler.mjs。
定位：L5–40。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/task/task-scheduler.mjs ↗

S11 ACP Session 串行化与委派

路径：server/src/agent/acp-backend-adapter.mjs。
定位：L257–265 serialize；L563 起权限；L757 起委派；L1197 起运行/完成/恢复/控制。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/agent/acp-backend-adapter.mjs ↗

S12 旧 Coordinator 提示输入与结果 envelope

路径：server/src/agent/coordinator.mjs。
定位：L27–61 结果 schema；L130–203 输入；L205 起执行。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/agent/coordinator.mjs ↗

S13 ACP 进程与原生方法

路径：server/src/agent/acp-process-client.mjs。
定位：L83–164 初始化；L165–195 权限/update；L238–389 session 操作。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/agent/acp-process-client.mjs ↗

S14 通知合批、ACK 和重试

路径：server/src/voice/announcement/announcement-manager.mjs。
定位：L49–125 入队/确认；L158–328 ACK/合批/投递；L334 起暂停。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/announcement/announcement-manager.mjs ↗

S15 最终 ASR 等待与回退

路径：server/src/voice/tools/turn-transcripts.mjs。
定位：L18–48。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/tools/turn-transcripts.mjs ↗

S16 安全播报窗口

路径：server/src/voice/announcement/announcement-window.mjs。
定位：L9–84。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/voice/announcement/announcement-window.mjs ↗

S17 较新架构说明

路径：docs/architecture/deep-dive.md。
定位：文档级证据；本次不能固定对应实现 commit。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/docs/architecture/deep-dive.md ↗

S18 较新英文 GCP 契约

路径：Gateway Client Protocol, English。
定位：页面标题 Stable 6.0 与 wire 7.0.0 并存；记录为文档漂移，不当作一致发布证据。
来源：https://qwenaudio.github.io/qwen-audio-agent/gateway-protocol ↗

S19 中文 GCP 契约

路径：Gateway Client Protocol, 中文。
定位：wire 6.0.0；部分活动权描述与英文较新内容不一致。
来源：https://qwenaudio.github.io/qwen-audio-agent/zh/gateway-protocol ↗

S20 Qwen Realtime Provider 文档

路径：voice-frontends/qwen-audio-realtime。
定位：音频格式与会话音色配置。
来源：https://qwenaudio.github.io/qwen-audio-agent/voice-frontends/qwen-audio-realtime ↗

S21 旧共享事件枚举

路径：shared/realtime-events.mjs。
定位：L0–52；比已读取 Gateway 的部分分支更旧，不能单凭枚举认定事件全集。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/shared/realtime-events.mjs ↗

S22 旧 Gateway 健康/客户端契约

路径：Gateway Contract。
定位：5.x 兼容入口与旧事件族。
来源：https://qwenaudio.github.io/qwen-audio-agent/contract ↗

S23 项目变更记录

路径：CHANGELOG.md。
定位：公开索引中 0.9.1 条目涉及 playback.started 通知确认。
来源：https://github.com/QwenAudio/qwen-audio-agent/blob/main/CHANGELOG.md ↗

S24 旧应用组装与 REST/SSE

路径：server/src/app/bootstrap.mjs。
定位：/api/health、/api/tasks、/api/permissions、Task SSE 等。
来源：https://raw.githubusercontent.com/QwenAudio/qwen-audio-agent/main/server/src/app/bootstrap.mjs ↗