Anleitung für KIs

Die Anleitung für KIs richtet sich an KI-Assistenten (und die Menschen, die sie anleiten), die Artikel in diesem Wiki schreiben oder am Quellcode von OmegaSim arbeiten. Sie fasst die Arbeitsweise zusammen, nach der OmegaSim entwickelt wird. Für Menschen gelten dieselben Regeln, siehe auch Mitmachen.

1. Erste Zeile: {{Stand|app=<Version>|appdatum=<TT.MM.JJJJ>}}. Die Version ist die, deren Quellcode bzw. App du beschreibst. Die Vorlage setzt den Hinweis „mithilfe von KI erstellt“ und die Kategorie Mit KI erstellt.
2. Einleitung wie in einem Lexikon: Stichwort fett im ersten Satz, knappe Definition, dann Einordnung.
3. Abschnitte == … ==; Bedienung vor Technik. Menüpfade fett (Optionen → Ton), Schalter in „Anführungszeichen“ mit ihrem Standardwert.
4. Am Ende: Siehe auch (interne Links), Weblinks (mindestens Luuke42/omegasim) und Kategorien ([[Kategorie:OmegaSim]] plus passende).

• Nur Belegtes. Fakten aus dem Quellcode, der Doku (CARRERA_HYBRID.md), den Patchnotes in der App oder aus Versuchen am Tisch. Nichts erfinden, keine geschätzten Zahlen. Wenn etwas unklar ist: weglassen oder „noch nicht gesichert“ schreiben.
• In Arbeit kennzeichnen. Funktionen, die in der App das Etikett WIP oder experimentell tragen, im Text als „(in Arbeit)“ bzw. „(experimentell)“ führen.
• Bestehende Seiten respektieren. Seiten anderer Autoren (z. B. CH ControlBox, Startampel) nur ergänzen oder berichtigen, nicht umschreiben, und in der Zusammenfassung sagen, was sich geändert hat.
• Stil: sachlich, Präsens, keine Werbung, keine Geviertstriche (—); Halbgeviertstrich (–) ist in Ordnung.

• Screenshots von OmegaSim sind MIT-lizenziert und erlaubt. Beschreibung mit Version, Datum, Quelle und Lizenz; Kategorie Screenshots.
• Fotos nur mit Quelle und passender Lizenz. Im Zweifel nicht hochladen, sondern den Menschen fragen.

• Keine Passwörter oder Zugangsdaten eingeben. Der Mensch meldet sich selbst an.
• Keine Seiten löschen oder verschieben, ohne dass ein Mensch es ausdrücklich will.
• Das Wiki begrenzt Bearbeitungen und Uploads je Minute. Lieber langsam arbeiten als viele Fehlversuche erzeugen.

Ort	Inhalt
src/00-index.head.html	gesamtes Markup und CSS, inklusive Optionen, Hilfetexte und Patchnotes
src/*.js	die Logik, nummeriert in Ladereihenfolge; alle Dateien teilen sich einen Gültigkeitsbereich
index.html, sw.js, app-update.json	erzeugt – nie von Hand ändern
tools/build.py	baut index.html aus src/
tools/bump_version.py	setzt die Version und baut sw.js und app-update.json neu
android-app/	native Android-Hülle mit dem Bluetooth-Plugin OmegaBle
CARRERA_HYBRID.md	Technik-Doku: Protokoll, Messungen, Begründungen

1. Änderung in src/ machen.
2. Neue sichtbare Texte auch übersetzen: Englisch und Spanisch stehen als Wörterbücher in src/10-ble-explorer.js.
3. Neue Funktionen von Anfang an mit dem Etikett <span class="wip-tag">WIP</span> kennzeichnen.
4. Erklärungen zu Optionen gehören in das ⓘ-Fenster (<small> im .opt-label), nicht als Text unter die Zeile.
5. Selbsttest schreiben: stAdd('Name vX.Y.Z: …', () => ({ ok, mass })) in src/95-selftest.js.
6. python tools/build.py ausführen.
7. Selbsttest in der App laufen lassen (Kachel Selbsttest im Bereich Sonstiges; der Adresszusatz ?st=Name beschränkt den Lauf auf passende Tests). Rot darf nur werden, was vorher schon rot war; im Zweifel mit dem vorigen Stand vergleichen.
8. Patchnotes ergänzen (Abschnitt je Nebenversion, mit englischer Übersetzung).
9. Version mit python tools/bump_version.py setzen. Das Schema ist 1.<Woche>.<Push>; die gültige Nummer ist die, die das Werkzeug ausgibt.

• Den Sendeweg. Die App schickt jedem Auto alle 45 ms ein Fahrpaket. Alles, was diesen Takt verzögert oder Pakete unterdrückt, macht das Fahren schlechter. Änderungen daran nur mit Messung (Funk-Rundlauf, Zähler „gesperrt“).
• Bluetooth-Verbindungen. Jede fehlgeschlagene Verbindung muss sauber getrennt werden, sonst bleibt das Auto in einem Zustand wie unter Keine Reaktion des Fahrzeugs.
• Gespeicherte Einstellungen. Neue Speicherschlüssel statt alte umdeuten.

• Beim automatischen Testen den Ton stummschalten (AudioContext-Ausgänge auf Lautstärke 0, Sprachausgabe abschalten), nach jedem Neuladen erneut.
• In einem verborgenen Browserfenster drosselt der Browser Zeitgeber auf etwa einen Takt je Sekunde. Für Wartezeiten in Tests ist ein MessageChannel-Takt zuverlässiger als setTimeout.
• Nach dem Testen Testserver und Tabs schließen, damit keine Seite im Hintergrund weiterläuft und Bluetooth hält.
• Alles mit echten Autos (Kopplung, Latenz, Klang) lässt sich nur am Tisch prüfen. Das in der Rückmeldung ausdrücklich sagen.

• Nur src/, tools/, android-app/ und Doku ändern; erzeugte Dateien nicht mitschicken oder beim Übernehmen neu bauen lassen.
• Beschreiben, was getestet wurde und was nicht (insbesondere am echten Auto).
• Änderungen an der nativen App (android-app/) brauchen eine neue APK und einen Test am Auto.

• Mitmachen
• OmegaSim
• OmegaBle
• Vorlage:Stand

• Browserfassung, Android-App und Quellcode: Links auf der Hauptseite