Esboço do Adaptador de Daemon para Canais e Backend Web

Objetivo

Permitir que adaptadores de canal e backends de chat web consumam qwen serve através do DaemonSessionClient, mantendo o comportamento existente do subprocesso ACP do canal como padrão.

Este esboço abrange apenas clientes do lado do servidor:

Bot backend de canal -> qwen serve
Navegador web -> backend web / BFF -> qwen serve

Ele explicitamente não permite que JavaScript do navegador chame o daemon diretamente. O daemon atualmente rejeita requisições com Origin de navegadores por design.

Pontos de Entrada Propostos

Backend de canal:


QWEN_CHANNEL_DAEMON_URL=http://127.0.0.1:4170 qwen channel start telegram

Backend web:


QWEN_WEB_DAEMON_URL=http://127.0.0.1:4170 qwen web-chat-backend

Variáveis opcionais compartilhadas:


QWEN_DAEMON_TOKEN=...
QWEN_DAEMON_WORKSPACE=/repo

Fluxo Mínimo de Canal

Este PR adiciona DaemonChannelBridge, uma ponte do lado do servidor localmente verificável para adaptadores de canal e backend web. Ela mantém a ponte ACP existente como padrão e gerencia o estado da sessão do daemon dentro do processo do backend.

Resolver o remetente/thread do canal para uma chave de sessão do canal.
Usar DaemonClient + DaemonSessionClient.createOrAttach().
Enviar texto de entrada do usuário com session.prompt().
Assinar session.events() e coletar fragmentos de texto do assistente.
Enviar o texto final de volta através do adaptador da plataforma.
Lançar votos de permissão através de session.respondToPermission().
Cancelar trabalho ativo através de session.cancel().

Fluxo Mínimo de Backend Web

O navegador abre um websocket ou stream HTTP para o backend web.
O backend gerencia o DaemonSessionClient.
O backend traduz as mensagens do navegador para prompts do daemon.
O backend traduz os eventos SSE do daemon para eventos de aplicativo seguros para o navegador.
O backend armazena o sessionId do daemon e o último id de evento visto no lado do servidor.

Clientes do navegador não devem receber tokens bearer do daemon.

Restrição de Isolamento de Sessão

O comportamento atual do Estágio 1 do daemon é efetivamente sessionScope: single no nível de configuração do daemon. Até que sessionScope por requisição seja implementado, implantações de canal multi-usuário ou web devem escolher uma destas formas seguras:

um daemon por thread de canal / sala web
um daemon por workspace de usuário
apenas demonstração mono-usuário

Não multiplexar silenciosamente threads de canal não relacionadas em uma única sessão do daemon.

Contrato de Mapeamento de Eventos

Evento do daemon	Tratamento no backend de canal/web
`session_update` / `agent_message_chunk`	Acrescentar texto do assistente
`session_update` / `agent_thought_chunk`	Stream opcional oculta/de depuração
`session_update` / `tool_call`	Emitir cartão/mensagem de status de ferramenta
`permission_request`	Interação de aprovação específica da plataforma
`permission_resolved`	Fechar/atualizar interação de aprovação
`model_switched`	Atualizar metadados da sessão no backend
`session_died`	Notificar usuário e interromper stream

Eventos desconhecidos do daemon devem ser ignorados ou encaminhados como metadados de depuração, e não como erro fatal.

A ponte ainda não está conectada ao qwen channel start. O comportamento existente dos canais Telegram, Weixin, Dingtalk, plugin e navegador permanece inalterado.

Não-Objetivos Explícitos

Nenhum fetch ou EventSource direto do navegador para o daemon.
Nenhuma flexibilização de CORS neste PR de adaptador.
Nenhuma migração padrão dos canais Telegram, Weixin, Dingtalk ou plugin.
Nenhuma operação CRUD de arquivos, CRUD de memória, reinicialização de MCP ou mutação de provedores.
Nenhuma emulação de sessionScope no cliente quando o suporte do lado do daemon estiver ausente.

Segurança para Merge

Desligado por padrão.
A ponte ACP existente do canal continua sendo o padrão.
O backend web é uma camada BFF explícita, não uma alteração de segurança do daemon.
Nenhum adaptador de canal deve importar tokens do daemon para o código do frontend/navegador.

Plano de Validação

Teste unitário da vinculação chave-de-sessão-do-canal para sessão-do-daemon.
Teste unitário do mapeamento de evento do daemon para mensagem de canal/web.
Teste unitário do encaminhamento de prompt, cancelamento, troca de modelo e resposta de permissão.
Teste de fumaça de um backend de canal mono-usuário contra qwen serve local.
Teste de fumaça de navegador -> BFF -> daemon sem expor o token do daemon.

Bloqueadores Antes da Migração Padrão

sessionScope por requisição.
Metadados de sessão + ciclo de vida de fechamento/exclusão.
Identidade do cliente carimbada pelo daemon.
Rota de permissão com escopo de sessão.
Diagnósticos somente leitura para MCP, skills, provedores e ambiente.