Skip to main content
L’ingresso dei canali è il confine sperimentale di controllo degli accessi per gli eventi in entrata dai canali. I Plugin gestiscono i dati specifici della piattaforma e gli effetti collaterali; il core gestisce i criteri generici: elenchi consentiti per messaggi diretti e gruppi, voci per messaggi diretti nell’archivio di associazione, controlli delle route, controlli dei comandi, autorizzazione degli eventi, attivazione tramite menzione, diagnostica oscurata e ammissione. Usare openclaw/plugin-sdk/channel-ingress-runtime per i percorsi di ricezione.

Resolver di runtime

Non precalcolare gli elenchi consentiti effettivi, i proprietari dei comandi o i gruppi di comandi. Il resolver li ricava dagli elenchi consentiti non elaborati, dai callback dell’archivio, dai descrittori delle route, dai gruppi di accesso, dai criteri e dal tipo di conversazione.

Risultato

I Plugin inclusi devono utilizzare direttamente le proiezioni moderne: L’autorizzazione degli eventi rimane disponibile nell’elemento ordinato ingress.graph e in quello decisivo ingress.reasonCode; non viene emessa alcuna proiezione separata degli eventi. Gli helper SDK deprecati di terze parti possono ricostruire internamente le strutture precedenti. I nuovi percorsi di ricezione inclusi non devono riconvertire i risultati moderni in DTO locali.

Gruppi di accesso

Le voci accessGroup:<name> rimangono oscurate. Il core risolve autonomamente i gruppi statici message.senders e chiama resolveAccessGroupMembership solo per i gruppi dinamici che richiedono una ricerca sulla piattaforma. I gruppi mancanti, non supportati o non riusciti adottano un comportamento di negazione predefinita.

Modalità degli eventi

Usare mayPair: false per reazioni, pulsanti, callback e comandi nativi.

Route e attivazione

Usare i descrittori delle route per i criteri relativi a stanza, argomento, gilda, thread o route nidificate:
Usare channelIngressRoutes(...) quando un Plugin dispone di diversi descrittori di route facoltativi; filtra i rami disabilitati mantenendo generici i dati delle route e ordinandoli in base al valore precedence di ciascun descrittore. Il controllo delle menzioni è un controllo di attivazione. Una menzione non rilevata restituisce admission: "skip", affinché il kernel del turno non elabori un turno di sola osservazione. La maggior parte dei canali deve mantenere l’attivazione dopo i controlli del mittente e dei comandi. Le superfici di chat pubbliche che devono silenziare il traffico privo di menzioni prima del rumore generato dall’elenco consentito dei mittenti possono adottare activation.order: "before-sender" quando il bypass tramite comandi testuali è disabilitato. I canali con attivazione implicita, come le risposte nei thread dei bot, possono passare activation.allowedImplicitMentionKinds; la proiezione activationAccess.shouldBypassMention indica quindi quando un comando o un’attivazione implicita ha ignorato la necessità di una menzione esplicita.

Oscuramento

I valori non elaborati dei mittenti e le voci non elaborate degli elenchi consentiti sono esclusivamente input del resolver. Non devono comparire nello stato risolto, nelle decisioni, nella diagnostica, negli snapshot o nei dati di compatibilità. Usare ID opachi per soggetti, voci, route e diagnostica.

Verifica