OBS 叠加层为空白
先检查停靠面板。如果停靠面板为空,请修复来源/平台。如果停靠面板正常,请在普通浏览器中打开完全相同的叠加层 URL,确认使用相同的 session,然后刷新 OBS 浏览器源。
会话错误
来源、停靠面板、叠加层、机器人和 Event Flow 页面必须使用相同会话 ID。可将会话 ID 当作房间名称:拼写不同,就属于不同房间。
dock.html?session=YOUR_SESSION
OBS 听不到 TTS
普通系统 TTS 往往通过电脑发声,而不经过 OBS 浏览器源。可使用提供商/浏览器 TTS 模式,例如 Kokoro、Piper、Kitten、eSpeak、兼容 OpenAI 的服务或云端提供商,也可单独路由系统音频。
Kokoro in Portuguese or Spanish
Kokoro's default voice is English, so pick one of its Spanish or Brazilian Portuguese voices in the voice list (in a link: voicekokoro=ef_dora 或 voicekokoro=pf_dora). Piper and eSpeak also work. For Portuguese, use Piper with pipervoice=pt_BR-faber-medium,或使用 eSpeak 并设置 espeakvoice=pt-br。西班牙语请使用 Piper 并设置 pipervoice=es_ES-davefx-medium,或使用 eSpeak 并设置 espeakvoice=es.
dock.html?session=YOUR_SESSION&speech=pt-BR&ttsprovider=piper&pipervoice=pt_BR-faber-medium
dock.html?session=YOUR_SESSION&speech=es-ES&ttsprovider=piper&pipervoice=es_ES-davefx-medium
Chrome 正常,但桌面应用不正常
桌面应用使用 Electron 会话,不使用常规 Chrome 配置。请在应用的来源窗口内登录;当平台阻止内嵌/应用浏览器环境时,改用 Chrome 扩展方式。
我需要哪种本地服务器?
启用本地服务器 是供受支持 SSN 页面使用的 WebSocket 中继。 本地控制 API 供同机脚本和 AI 工具使用。无头托管是在 Linux 服务器上运行完整桌面应用。Event Flow 媒体服务器仅提供获准的本地媒体。
Event Flow 没有反应
确认来源事件已到达停靠面板。对于音频、媒体和 OBS 操作,请保持 actions.html?session=YOUR_SESSION 使用相同会话保持打开。