扩展 qwen-audio-agent

运行时是通用的；一切场景相关的行为都通过声明好的接缝进入。本页列出全部接缝，并指向对应的指南。

前台工具：MCP、OpenAPI、Profile

不碰语音链路即可给对话加工具：通过前台 MCP 客户端接入 MCP 服务、从 OpenAPI 3.x 文档暴露选定的 REST 操作，或把人设与工具配置打包成版本化的前台 Profile。

把实时语音模型换成其他云服务或自有栈：实现 Provider 契约并注册进 Provider 注册表。

网关只定义一个很小的检索边界，不自带 RAG 栈——接入你已经在运营的知识系统。

四条路径把后台接到协议中立的 BackendPort 之后：零代码的通用 ACP 入口、远程 A2A 智能体、用 Backend Adapter SDK 编写的自定义适配器，或带一键安装的一等公民后台。

助手的名称、人格和声音在 ASSISTANT.md 里；用户的长期事实在 USER.md / MEMORY.md 里。都是配置目录下的普通 Markdown，可以直接编辑，网关自己则走受约束的写入路径。

网关在单条 WebSocket 上讲类型化事件。按客户端协议构建自定义客户端，或通过稳定性契约把助手嵌入宿主页面——桌面悬浮球、TUI、WebUI 用的都是同一条通道。 examples/custom-conversation-client/ 是最小起点。

桌面悬浮球渲染可替换的宠物皮肤：一个 pet.json 清单加一张精灵图。