Zum Hauptinhalt springen

Mini-Programme Übersicht

Mini-Programme sind sandboxed Web-Apps, die direkt innerhalb der AISCouncil Plattform laufen. Sie erweitern die Plattform mit benutzerdefinierten Funktionen – von Geräte-Sync-Tools bis hin zu visuellen Page-Buildern – und laufen dabei in einer sicheren, berechtigungskontrollierten Umgebung.

Was sind Mini-Programme?​

Ein Mini-Programm ist eine Standard-HTML/CSS/JS-Web-App, die in einem sandboxed iframe innerhalb der Plattform läuft. Anstatt zu einer separaten Website zu navigieren, starten Benutzer Mini-Programme aus dem Apps-Bereich in der Seitenleiste. Die App ersetzt den Chat-Bereich und hat über das window.ais SDK Zugriff auf Plattform-APIs.

Mini-Programme können:

  • Chat-Nachrichten lesen und senden, um mit KI-Modellen zu interagieren
  • Daten lokal speichern mit pro-App isoliertem Speicher
  • Bot-Konfiguration lesen, um zu wissen, welches Modell aktiv ist
  • Benachrichtigungen und Dialoge anzeigen durch die Plattform-UI
  • Benutzerinformationen lesen zur Personalisierung
  • Hooks registrieren, um Plattform-Verhalten zu erweitern

Wie sie funktionieren​

+---------------------------+
|   AISCouncil      |
|   (Host-Seite)            |
|                           |
|  +---------------------+ |
|  | Sandboxed iframe     | |
|  | (null origin)        | |
|  |                      | |
|  | window.ais SDK       | |
|  |   |                  | |
|  +---|------------------+ |
|      | postMessage          |
|      v                     |
|  Message Bridge            |
|  (Berechtigungsprüfung)    |
|  (Methoden-Dispatch)       |
+---------------------------+

  1. SDK-Injektion – Wenn ein Mini-Programm startet, erstellt die Plattform einen sandboxed iframe und injiziert das window.ais SDK (~2 KB) als <script>-Preamble vor Ihrem App-Code.

  2. postMessage-Bridge – Jeder SDK-Aufruf (ais.storage.get(), ais.chat.send(), etc.) sendet ein postMessage an die Host-Seite. Der Host validiert die Berechtigungen der aufrufenden App und leitet die Anfrage an das entsprechende Plattform-Modul weiter.

  3. Antworten – Ergebnisse werden über postMessage an den iframe zurückgesendet, wo das SDK das entsprechende Promise auflöst.

Sicherheitsmodell​

Mini-Programme laufen in einer strikten Sicherheits-Sandbox:

SchutzWie
Null originsandbox="allow-scripts allow-forms" – kein allow-same-origin, daher erhält der iframe eine null origin
Kein Zugriff auf Eltern-DOMKann das DOM, localStorage oder Cookies der Host-Seite nicht lesen oder ändern
Kein Netzwerkzugriff auf Host-OriginKann keine Same-Origin-Requests zu aiscouncil.net machen
Berechtigungsgesteuerte APIsJede SDK-Methode außer Speicher erfordert eine explizite Berechtigungserteilung vom Benutzer
Pro-App-SpeicherisolationSpeicherschlüssel werden mit mp:{app-name}: präfixiert – Apps können nicht auf die Daten anderer Apps zugreifen
Inhaltsadressiertes CachingEntry-HTML wird bei der Installation abgerufen und zwischengespeichert, nicht bei jedem Start aus dem Netzwerk geladen
Warnung

Mini-Programme können weiterhin Netzwerkrequests an externe Origins machen (ihren eigenen CDN, Drittanbieter-APIs, etc.), da allow-scripts fetch() und XMLHttpRequest erlaubt. Die network:fetch-Berechtigung ist für zukünftige Proxied-Requests durch die Plattform gedacht, nicht zur Einschränkung des ausgehenden Netzwerkzugriffs.

Berechtigungsdialog​

Wenn ein Benutzer ein Mini-Programm installiert, zeigt ein Berechtigungsdialog den App-Namen, die Beschreibung und die Liste der angeforderten Berechtigungen an. Der Benutzer muss zustimmen, bevor die Installation fortgesetzt wird. Apps, die nur storage anfordern (immer erlaubt), zeigen den Dialog dennoch zur Transparenz an.

Vergleich mit anderen Plattformen​

Funktionaiscouncil Mini-ProgrammeWeChat Mini ProgramsChrome ExtensionsPWAs
LaufzeitumgebungSandboxed iframeCustom WebViewIsolated world + Service WorkerVollständiger Browser-Tab
Max. Größe5 MB (HTML) / 50 MB (Bundle)2-20 MBKein festes LimitKein Limit
Review erforderlichNein (Direct Install)Ja (Pflicht)Ja (Chrome Web Store)Nein
Offline-UnterstützungJa (bei Installation gecacht)JaJaJa (Service Worker)
Plattform-APIswindow.ais SDKwx APIchrome APINur Web-APIs
SicherheitsmodellNull-origin iframeCustom SandboxContent Security PolicySame-origin
VerbreitungURL, Datei-Upload, RegistryNur WeChat StoreChrome Web StoreNur URL

Apps finden und installieren​

Aus dem App Store​

  1. Klicken Sie auf das Apps-Symbol in der linken Seitenleiste (oder das App-Grid-Symbol im Header auf Mobil)
  2. Durchsuchen Sie den App Store-Bereich unten im Apps-Panel
  3. Klicken Sie auf Installieren auf einer beliebigen App-Karte
  4. Überprüfen Sie die Berechtigungen im Dialog und klicken Sie auf Erlauben

Per URL (Sideloading)​

  1. Im Apps-Panel finden Sie den Sideload-Bereich
  2. Fügen Sie eine Manifest-URL in das Textfeld ein
  3. Klicken Sie auf Installieren
  4. Überprüfen Sie die Berechtigungen und bestätigen Sie

Per Datei-Upload​

  1. Klicken Sie im Apps-Panel auf App hochladen
  2. Wählen Sie eine .html-Datei (Single-File-App) oder ein .ais-Bundle (ZIP-Archiv)
  3. Überprüfen Sie die Berechtigungen und bestätigen Sie

Siehe Apps sideloading für vollständige Details zu allen Installationsmethoden.

Apps starten und schließen​

Starten: Klicken Sie auf die Öffnen-Schaltfläche auf einer beliebigen installierten App-Karte. Die App ersetzt den Chat-Bereich und übernimmt das Hauptinhalts-Panel.

Schließen: Apps können sich selbst durch Aufruf von ais.close() schließen, oder der Benutzer kann auf die X-Schaltfläche in der Apps-Titelleiste klicken, um zur Chat-Ansicht zurückzukehren.

Wenn eine App geschlossen wird:

  • Wird der iframe zerstört und sein Message-Handler entfernt
  • Wird der Chat-Bereich wiederhergestellt
  • Geht jeder ungespeicherte Zustand in der App verloren (Apps sollten ais.storage verwenden, um Daten zu persistieren)

Integrierte Apps​

Die Plattform wird mit zwei integrierten Mini-Programmen ausgeliefert:

Geräte-Sync​

Synchronisiert Profile, API-Schlüssel und Einstellungen zwischen Geräten. Unterstützt drei Übertragungsmethoden:

  • LAN-Sync – Direkte Verbindung zwischen Geräten im selben Netzwerk
  • QR-Code – Scannen Sie einen Code, um Geräte zu koppeln
  • Internet-Relay – WebRTC-Signalisierung über die API für Geräte in verschiedenen Netzwerken

Berechtigungen: storage, config:read, auth:read, ui:toast, secrets:sync

App Builder​

Erstellen Sie Webseiten visuell mit KI-Inhaltsgenerierung. Wählen Sie ein Template, bearbeiten Sie Sektionen mit dem aktiven KI-Modell und exportieren Sie als URL oder HTML-Datei. Veröffentlichen Sie direkt auf bcz.co mit einem benutzerdefinierten Slug.

Berechtigungen: storage, chat:read, chat:write, ui:toast, auth:read, pages:publish

Nächste Schritte​