The all-in-one local AI studio for your desktop: chat, image and video generation and a coding agent in one free, open source app. Windows and Linux. No Docker, no terminal, no cloud required.
data-testid in der Mobile-Shell: Vorgabe fuer die UI-Bauer
Der Abnahmerahmen findet Elemente ueber data-testid. Ohne sie haengen die Flows an Texten und Klassen und brechen bei jeder Umformulierung.
Die Regel
data-testid="m-<screen>-<element>"
- Kleinbuchstaben, Ziffern und Bindestriche. Englisch.
msteht fuer Mobile und trennt die Shell vom Desktop.<screen>ist ein Wort ohne Bindestrich:onboarding,chat,models,create,remote,settings,account,nav,app.<element>sagt, was es ist oder tut, nicht wie es aussieht:send, nichtblue-button.- Varianten haengen hinten an:
m-chat-model-local,m-models-item-toolarge. - Eine testid ist auf einem Screen eindeutig. Ausnahme sind Listen, siehe unten.
Pflicht
- Jeder Screen hat ein Wurzelelement mit
data-testid="m-<screen>-screen". Daran erkennen Inventar und Sweep, wo sie sind. - Jedes bedienbare Element hat eine testid: Knoepfe, Links, Felder, Schalter, Tabs, Menuepunkte.
- Jede Meldung, auf die ein Mensch reagieren soll, hat eine testid, und ihr Aktionsknopf auch:
m-chat-errorundm-chat-error-action. - Zustand steht in
data-state, nicht in der testid:data-state="idle|loading|streaming|done|error". - Listen: Jedes Element traegt dieselbe testid plus
data-m-id="<stabile id>". Chatnachrichten zusaetzlichdata-m-role="user|assistant". - Risiko: Was Geld kostet, bekommt
data-m-risk="paid". Was etwas unwiderruflich loescht oder abmeldet oder etwas an Menschen abschickt, das sich nicht zurueckholen laesst (m-report-send), bekommtdata-m-risk="destructive". Die Bestaetigung einer Rueckfrage (m-dialog-confirm) traegt die Marke der Aktion, die gefragt hat: rot istdestructive, Cloud-violett istpaid. Der Sweep tippt solche Elemente nie an. Das Mikrofon im Chat (m-chat-mic) traegtpaidimmer: Mit LU Cloud kostet die Aufnahme Guthaben, ohne oeffnet der Tipp das Mikrofon des Handys oder den Weg zum Konto. In Create tragen die Wahl der vier Werkzeugeanimate,eraser,extendundremovebg(m-create-tools-<id>im Blatt,m-create-tool-<id>in der Leiste)paid, obwohl erst der Lauf etwas bucht: Ihre Namen sperrt der Sweep ohnehin, die Marke sagt am Element dasselbe (Nachabnahme Android, N9). Was die App verlaesst (Link im Browser, Mail-App, Einstellungen des Systems, Teilen-Blatt), bekommtdata-m-risk="leaves-app". Was Kamera oder Mediathek oeffnet, bekommtdata-m-risk="sensor". Eine Marke je Element, die schwerere gewinnt:m-chat-micbleibtpaid. Der Sweep tippt auch diese Elemente nie an und fuehrt sie im Bericht unter ihrer eigenen Marke. - Bedienbar heisst auch zugaenglich: echtes
button,a,inputoder einerole. Eindivmit Klick-Handler meldet das Inventar als "ohne Rolle". - Jedes Touch-Ziel ist mindestens 44 mal 44 CSS-px gross.
Was das Geruest der Shell dazu vorgibt
Die Shell (src/mobile/STRAENGE.md, Abschnitt 7) hat die Regel um Bausteine erweitert, die es hier noch nicht gab. Der Rahmen kennt sie (lib/shell.mjs):
- Seite:
.m-page[data-route="<route>"], darinm-<screen>-screen. Die Seite darunter bleibt eingehaengt (data-m-hidden,inert). - Blatt:
[role="dialog"]mitm-sheet-<id>, darinm-sheet-closeund bei Unterseitenm-sheet-back. Seit Runde 2 sitztm-sheet-<id>immer am Blatt selbst, auch waehrend es laedt. Eine eigene Kennung eines Strangs (m-options,m-account-credits-empty,m-account-session-expired) sitzt am Rahmen darum. Wer die Groesse des Blatts misst, nimmtm-sheet-<id>. - Einfahrt eines Blatts: solange das Blatt hereinfaehrt, traegt es
data-m-settling, und sein Inhalt nimmt noch keine Tipps an. Ein Treiber wartet, bis das Attribut weg ist. Schliessen und der Hintergrund gehen sofort. - Blaetter und Seiten unter dem obersten:
m-page-back-under,m-page-back-leaving,m-sheet-close-under-<n>,m-sheet-back-under-<n>,m-sheet-scrim-under-<n>. Sie sind nicht bedienbar und gehoeren in kein Inventar. - Griff des Blatts:
aria-hiddenunddata-m-decor. Das Inventar laesst Elemente mitdata-m-decoraus. - Markdown:
m-md-code,m-md-code-copy,m-md-code-preview,m-md-link. - Attribute:
data-m-risk(paid,destructive,leaves-appodersensor, am bedienbaren Element selbst, geschrieben vom UI-Kit aus der Eigenschaftrisk),data-m-id(feste Kennung eines Listeneintrags),data-stacked(einSegmented, das seine Wahlen untereinander stellt),data-placeam Toast (topauf Seiten mit Composer oder Fuss). Seit Runde 5:data-m-field-group(eine Seite fasst ein Feld und den Knopf darunter zusammen, beides bleibt bei offener Tastatur in Sicht) unddata-m-capped(ein mehrzeiliges Feld, das gerade hoeher waere als sein Raum ueber der Tastatur: seine Hoehe ist begrenzt, der Text rollt im Feld. Wer die Hoehe eines Felds misst, liest das Attribut mit). - Rueckfrage:
[role="alertdialog"]mitm-dialog-<name>, darinm-dialog-confirmundm-dialog-cancel. - Toast:
m-toast-<name>. - Reiter:
m-nav-chat,m-nav-create,m-nav-models,m-nav-settingsinm-nav.
Wo die Shell von der Regel oben abweicht, steht in ABWEICHUNGEN.md.
Reservierte Woerter
Die Sperrliste (lib/sperre.mjs) erkennt diese Woerter als ganzen Abschnitt einer Kennung, auch ohne data-m-risk:
- kostenpflichtig:
generate,render,buy,send,download,transcribe,speak,speaking,train,enhance,improve,animate,extend,removebg,eraser,install,regenerate,mic,pay,invoice,plan,plans,run,test,preview - zerstoerend:
delete,signout,clear,reset,remove,forget,disconnect,wipe,withdraw - immer gesperrt:
m-dialog-confirm,m-fatal-reset*,m-account-signin,m-account-google,m-account-github,m-account-apple
Ein Abschnitt wie -cancel, -keep, -close, -error oder -screen am Ende hebt die Sperre auf (der Ausweg aus einer Rueckfrage ist harmlos). Die Liste ist mit Absicht weit: Ein harmloser Knopf zu viel landet im Sweep unter "einzeln testen", ein Kauf zu wenig waere teuer.
Welche Kennungen es gibt
Nicht mehr hier, sondern erzeugt:
TABELLE.md: jede Route, jedes Blatt, jeder Tippweg und alle Kennungen je Strang, aus den Quellen der Shell gelesen (npm run tabelle).flows/selektoren.mjs: was die Fluesse davon benutzen.npm run trockenprueft jede Kennung dort gegen die Tabelle und gegen die Schnappschuesse der Vorschau.ABWEICHUNGEN.md: wo die Shell von der Regel abweicht.
Wer in der Shell eine Kennung umbenennt, laesst danach npm run tabelle und npm run trocken laufen. Der Trockenlauf nennt jede Stelle in den Fluessen, die dann ins Leere greift.
Testhaken
Was sich von aussen nicht herstellen laesst, stellt die App im Abnahmebau selbst her: window.__LU_TEST__. Der Vertrag steht in der Shell, src/mobile/dev/test-hook.ts (Version 2, 08.10.2026). Es gibt das Objekt nur in einem Bau mit VITE_LU_ABNAHME=1, im Store-Paket fehlen Objekt und Datei. Der Rahmen spricht es ueber lib/haken.mjs an.
| Haken | Wirkung | Der Rahmen nutzt es fuer |
|---|---|---|
where() |
Flow, Reiter, Route, Parameter, offenes Blatt, storePreset (open, play, appstore), account (Zustand des Kontos als Wort, zum Beispiel signed-in, signed-out), alle Routen und Blaetter |
Lage lesen, Preset und Anmeldung ohne Umweg ueber die Kontoseite |
go(pfad, params?) |
oeffnet eine Seite als Ausgangslage | Sweep, Aufnahme der Schnappschuesse |
openSheet(id, props?), closeSheet() |
oeffnet oder schliesst ein Blatt | Sweep, Aufnahme |
setSettings(patch), onboardingDone(bool) |
Einstellungen setzen, Onboarding als erledigt oder offen | Ausgangslage |
storePreset(preset, {reload}) |
zeigt ein Store-Preset, bleibt ueber ein Neuladen | Altersabfrage je Preset |
geraet({ramBytes, freeBytes}), geraet(null) |
taeuscht ein Geraet vor: der Arbeitsspeicher erreicht die Passrechnung auf jedem Weg, offene Seiten fragen neu (Ereignis lu-test-device). null nimmt es zurueck |
"Modell zu gross" auf einem grossen Testgeraet |
speicherVoll(bool) |
Die Geraeteauskunft meldet 0 Byte frei. Wirkt auf das, was die WebView fragt, NICHT auf die native Pruefung vor einem Download (die Antwort des Hakens nennt das in nichtAuf) |
Fehlerfall 2 |
guthabenLeer(bool) |
Zaehler auf 0, die App bekommt das Ereignis "bezahlter Aufruf abgelehnt". Braucht eine Anmeldung | Fehlerfall 6 |
sitzungAblaufen() |
schreibt, was die Logik schreibt, wenn der Server das Token ablehnt. Braucht eine Anmeldung | Fehlerfall 7 |
speicherWarnung() |
meldet der App wenig Arbeitsspeicher (App-Ereignis, nicht die Warnung des Systems) | lowMemory auf iOS |
Jede Funktion antwortet mit {ok: true, ...} oder {ok: false, reason}. Ein Nein macht den Schritt "nicht pruefbar" mit dem Grund der App. Fehlt der Haken oder eine Funktion, ist der Schritt "offen" und kein Fehler.
Regel: Der Haken stellt Ausgangslagen her und liest Zustand. Was der Kunde tut, laeuft im Kundenfluss immer ueber echte Touches.
Seit Runde 16: testData() legt einmal je einen Eintrag ab, den eine Detailseite zeigt (Chat mit Antwort, Memory-Eintrag "Test memory entry", Workflow "Test workflow" mit zwei Schritten, Gruppe im Chat "Test group chat", Ergebnis test-create-item in der Galerie von Create als Bild in der Seite, ohne Cloud-Aufruf) und antwortet mit den Kennwerten. Der Rahmen oeffnet damit die Seite selbst statt der Ersatzseite (tabelle/wege.mjs, DATEN_PARAMS und BLATT_DATEN). Die Eintraege bleiben nach dem Lauf auf dem Geraet.
Was Version 2 nicht kann und der Rahmen braucht (Wunsch an die Shell):
netz(bool): nur iOS, schaltet die Rust-Seite und Hintergrund-Downloads offline. Der Treiber kann im Simulator nur die Anfragen der WebView sperren.speicherVollvor einem Download: Der Download fragt die native Seite direkt (checkDownloadSpaceinsrc/api/discover.ts, Aufruf inscreens/models/parts/start-download.ts), und kein Skript der WebView kann diese Antwort faelschen. Ein voller Speicher vor einem Download ist nur mit einem vollen Speicher pruefbar.flows/fehlerfaelle.mjsmeldet das als Fehler des Schritts und verwirft den Download.
Erledigt mit Version 2: geraet(...), und where() nennt Store-Preset und Kontozustand.
Umbenannt in Runde 2
m-settings-languageheisstm-settings-voice(Zeile E1.6 der Einstellungen, oeffnet/settings/voice).flows/selektoren.mjs,flows/freigaben.mjsundtabelle/wege.mjssind nachgezogen.
Neu in Runde 5
Die ganze Liste steht in TABELLE.md (neu erzeugt aus mobile/r5-rest). Hier, was die Fluesse und die Abnahme davon wissen muessen, nach den Notizen unter mobile-docs/r5/.
Modelle (models.md):
m-models-item-tools,m-models-detail-tools: Marke "Tools" an Karte und Detailseite, auch an jeder anderen Packung eines Katalogmodells.m-models-item-queued: Zeile "Loads after " an der Karte, deren "Use in chat" vorgemerkt ist.m-models-useist erst dann gesperrt.m-models-item-waiting: Zeile "Loading " an den anderen Karten, solange ein Modell laedt.- Toasts:
m-toast-chat-model(das Modell, bei dem der Nutzer landet),m-toast-load-failed. m-models-detail-thinkingist eine Marke, kein Schalter. Geschaltet wird in den Chat-Optionen (m-options-thinking).
Chat und Agent (chat.md, models.md):
m-chat-no-tool: Zeile unter einer Agent-Antwort, die Suchergebnisse nennt, ohne dass ein Werkzeug lief.m-chat-waits-for-document: Hinweis in der Antwort, solange die Frage auf ein Dokument wartet.m-chat-slot-turn,m-documents-slot-turn: die Zeile dazu unter dem Kopf und auf der Dokumentseite.m-documents-failedmitm-documents-retryundm-documents-failed-remove(traegtdestructive): ein Dokument, das nicht gelesen werden konnte.m-documents-working-name: Name der Datei in der Fortschrittszeile.- Toasts:
m-toast-send-failed,m-toast-choose-model,m-toast-agent-turned-off,m-toast-document-duplicate,m-toast-document-failed. - Der Hinweis nach einem Abschuss (
m-app-resume) nennt seinen Chat, wenn ein anderer Chat offen ist ("It belongs to another chat: .").
Einstellungen und Remote:
m-toast-remote-still-offline: Antwort auf "Try again" (m-settings-remote-retry), wenn der Desktop weiter schweigt.m-remote-attach-camera,m-remote-attach-library: ohne Chat gesperrt, mit Grund. Der Sweep fuehrt sie dann unter "uebersprungen".- Mit
data-m-riskseit Runde 5:m-account-delete-website,m-account-reset-send,m-account-reset-again(alledestructive),m-cloud-open-account(paid),m-chat-mic(paid), die vier Werkzeuge oben.
Neu in Runde 6 (mobile-docs/r6/agent.md):
m-chat-remembered: Zeile unter einer Antwort auf eine Bitte, sich etwas zu merken.data-stateistsaved("Saved to Memory.") odernothing(die Bitte nannte nichts). Keine Schaltflaeche.
Entwicklerseite (nur Vorschau, in keinem Inventar): m-dev-ui-notes, m-dev-ui-long-notes (Feld mit zwoelf Zeilen fuer die Pruefung der Hoehenbegrenzung).
Rahmen:
checks/persistenz.mjsstellt als Einstellung den Schalterm-settings-privacy-counterum und danach zurueck (config.mjs,persistenz.naht).flows/fehlerfaelle.mjsbestaetigt beim Aufraeumen die Rueckfragem-dialog-download-cancel.
Neu in Runde 10 (mobile-docs/r10/rest.md)
Altersfrage (vor der Shell, Wort age, Android und iOS gleich):
m-age-nospeichert nichts mehr, sondern oeffnet die zweite Fragem-age-confirm("You said you are under 18 ...").data-ageam Torm-age-gateist dannconfirm.m-age-confirm-back("Go back"): zurueck zur ersten Frage, nichts ist gespeichert.m-age-confirm-minor("Yes, I am under 18"): erst diese Antwort speichert. Traegtdata-m-risk="destructive", weil sie sich auf dem Geraet nicht zuruecknehmen laesst; ein Fluss tippt sie nur uebertapBewusst(flows/alter.mjs).- Die Sperrseite
m-age-blockedhat weiter keinen Knopf.
Neu in 3.1.0: 3D in Create (Handy, nur LU Cloud)
Das Werkzeug 3d steht als letztes in der Leiste (m-create-tool-3d, im Blatt m-create-tools-3d). Es erscheint nur, wenn der Katalog ein 3D-Modell fuehrt. Auf "My computer" gibt es 3D in v1 nicht.
m-create-3d-way(Segmented) mitm-create-3d-way-text,m-create-3d-way-image,m-create-3d-way-video: der Weg. Die Zeile darum heisstm-create-3d-way-row.- Weg Image: die Quelle wie bei jedem Werkzeug (
m-create-source,m-create-source-add). Nimmt das Modell mehrere Seiten:m-create-3d-sides(data-stateist die Zahl der weiteren Seiten),m-create-3d-side-add(traegtsensor),m-create-3d-side-remove. - Weg Video:
m-create-3d-videomitdata-stateempty,readingoderready;m-create-3d-video-add(traegtsensor),m-create-3d-video-remove,m-create-3d-video-error. Die Standbilder:m-create-3d-framesmit jem-create-3d-frame(data-m-idist die Nummer des Moments,aria-pressedsagt, ob er gewaehlt ist).data-m-pickedam Kasten nennt die gewaehlten Nummern. Das Video wird nie hochgeladen. - Im Blatt "Add source" (
m-sheet-source) beim Werkzeug 3D zusaetzlichm-create-source-video(traegtsensor). - Detailstufe, wo das Modell eine hat:
m-create-3d-detail-card,m-create-3d-detail(Segmented) mitm-create-3d-detail-draft,m-create-3d-detail-standard,m-create-3d-detail-fine. - Sperrgrund ohne Video:
m-create-blockedmitdata-m-reason="no-3d-video". - Ergebnis auf der Buehne:
m-create-resultmitdata-m-kind="3d", darinm-create-result-3dmit dem 3D-Betrachter (model-viewer,data-phaseloading,ready,heavy,erroroderno-webgl; Leistemodel-viewer-barmitmv-turn,mv-look-color,mv-look-clay,mv-look-wireframe,mv-backdrop,mv-reset,mv-fullscreen,mv-download, Faktenzeilemodel-viewer-facts). Die Kennungen des Betrachters kommen aussrc/components/threeund folgen nicht dem Schemam-*. - Grosser Blick (
/create/item/:id):m-create-item-3dimm-create-item-stage. Speichern und Teilen gehen als.glbnach Files. - Galerie: die Kachel
m-create-gallery-tilemitdata-m-kind="3d"zeigtthumb-3d(Standbild oder Wuerfel). Der Filterm-create-gallery-filter-3derscheint nur, wenn die Galerie ein 3D-Modell hat.