Channel- und Web-Backend-Daemon-Adapter – Entwurf

Ziel

Channel-Adapter und Web-Chat-Backends sollen qwen serve über DaemonSessionClient nutzen können, während das bestehende Channel-ACP-Subprozess-Verhalten als Standard beibehalten wird.

Dieser Entwurf behandelt nur serverseitige Clients:

Channel-Bot-Backend -> qwen serve
Webbrowser -> Web-Backend / BFF -> qwen serve

Er erlaubt ausdrücklich nicht, dass Browser-JavaScript den Daemon direkt aufruft. Der Daemon lehnt Browser-Origin-Requests derzeit bewusst ab.

Vorgeschlagene Einstiegspunkte

Channel-Backend:


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

Web-Backend:


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

Gemeinsame optionale Variablen:


QWEN_DAEMON_TOKEN=...
QWEN_DAEMON_WORKSPACE=/repo

Minimaler Channel-Ablauf

Dieser PR fügt DaemonChannelBridge hinzu, eine lokal verifizierbare serverseitige Brücke für Channel- und Web-Backend-Adapter. Sie behält die bestehende ACP-Brücke als Standard und verwaltet den Daemon-Session-Zustand innerhalb des Backend-Prozesses.

Channel-Sender/Thread zu einem Channel-Session-Key auflösen.
DaemonClient + DaemonSessionClient.createOrAttach() verwenden.
Eingehenden Benutzertext mit session.prompt() übermitteln.
session.events() abonnieren und Assistenten-Text-Chunks sammeln.
Finalen Text über den Plattform-Adapter zurücksenden.
Berechtigungsstimmen über session.respondToPermission() abgeben.
Aktive Arbeit über session.cancel() abbrechen.

Minimaler Web-Backend-Ablauf

Browser öffnet einen Websocket- oder HTTP-Stream zum Web-Backend.
Backend besitzt DaemonSessionClient.
Backend übersetzt Browser-Nachrichten in Daemon-Prompts.
Backend übersetzt Daemon-SSE-Events in browsertaugliche App-Events.
Backend speichert die Daemon-sessionId und die zuletzt gesehene Event-ID serverseitig.

Browser-Clients dürfen keine Daemon-Bearer-Tokens erhalten.

Session-Isolationsbeschränkung

Das aktuelle Daemon-Stage-1-Verhalten entspricht effektiv sessionScope: single auf der Daemon-Einstellungsebene. Bis sessionScope pro Request verfügbar ist, müssen Multi-User-Channel- oder Web-Deployments eine dieser sicheren Formen wählen:

ein Daemon pro Channel-Thread / Web-Raum
ein Daemon pro Benutzer oder Sicherheitsprinzipal
nur Single-User-Demo

Mehrere unabhängige Channel-Threads dürfen nicht stillschweigend in eine Daemon-Session gemultiplext werden.

Ereignismapping-Vertrag

Daemon-Event	Channel-/Web-Backend-Behandlung
`session_update` / `agent_message_chunk`	Assistenten-Text anhängen
`session_update` / `agent_thought_chunk`	Optionaler versteckter/Debug-Stream
`session_update` / `tool_call`	Tool-Status-Card/-Nachricht ausgeben
`permission_request`	Plattformspezifische Genehmigungsinteraktion
`permission_resolved`	Genehmigungsinteraktion schließen/aktualisieren
`model_switched`	Backend-Session-Metadaten aktualisieren
`session_died`	Benutzer benachrichtigen und Stream stoppen

Unbekannte Daemon-Events müssen ignoriert oder als Debug-Metadaten weitergereicht werden, nicht als fatal.

Die Brücke ist noch nicht in qwen channel start eingebunden. Bestehendes Telegram-, Weixin-, Dingtalk-, Plugin-Channel- und Browser-Verhalten bleibt unverändert.

Explizite Nicht-Ziele

Kein direkter Browser-zu-Daemon-fetch oder EventSource.
Keine CORS-Lockerung in diesem Adapter-PR.
Keine Standardmigration von Telegram-, Weixin-, Dingtalk- oder Plugin-Channels.
Kein Datei-CRUD, Memory-CRUD, MCP-Neustart oder Provider-Mutation.
Keine sessionScope-Emulation im Client, wenn die Daemon-seitige Unterstützung fehlt.

Merge-Sicherheit

Standardmäßig ausgeschaltet.
Bestehende ACP-Channel-Bridge bleibt Standard.
Web-Backend ist eine explizite BFF-Schicht, keine Daemon-Sicherheitsänderung.
Kein Channel-Adapter soll Daemon-Tokens in Frontend-/Browser-Code importieren.

Validierungsplan

Unit-Tests für Channel-Session-Key zu Daemon-Session-Bindung.
Unit-Tests für Daemon-Event-zu-Channel/Web-Nachrichten-Mapping.
Unit-Tests für Prompt-, Cancel-, Model-Switch- und Permission-Response-Weiterleitung.
Smoke-Test eines Single-User-Channel-Backends gegen lokales qwen serve.
Smoke-Test Browser -> BFF -> Daemon ohne Offenlegung des Daemon-Tokens.

Blocker vor der Standardmigration

sessionScope pro Request.
Session-Metadaten + Close/Delete-Lebenszyklus.
Daemon-gestempelte Client-Identität.
Session-bezogene Permission-Route.
Schreibgeschützte Diagnosen für MCP, Skills, Providers und Umgebung.