Separate stable API profile IDs from display names with legacy aliases

API_PROFILE_IDENTITIES.md

@@ -0,0 +1,9 @@
+# Anzeigename und API-ID
+
+Profile haben einen lesbaren `name` und eine stabile `api_id`. Neue IDs werden aus dem Namen mit Kleinbuchstaben und Bindestrichen vorgeschlagen. Der Benutzer kann die ID ändern; sie wird beim späteren Umbenennen nicht automatisch verändert. IDs enthalten keine Leerzeichen.
+
+Vorhandene Profile erhalten beim Start eine deterministische, dauerhaft gespeicherte ID. Bei Kollisionen wird eine numerische Endung verwendet. Bisherige Namen bleiben in `api_aliases` erreichbar. Auch beim Ändern von Name oder ID bleibt die vorherige Identität als Alias erhalten; Konflikte mit anderen Profilen werden abgelehnt.
+
+`/v1/models` liefert die API-ID als `id`, und den Anzeigenamen als `name` und `display_name`. Requests dürfen weiterhin einen alten Namen verwenden. Der gemeinsame Bildalias `athena-image` bleibt erhalten. Backup und Restore erhalten die Identitätsfelder; alte Backups werden beim Restore migriert.
+
+Moltis lehnt Modell-IDs mit Leerzeichen bereits bei Discovery ab. Die Trennung ermöglicht die automatische Erkennung ohne Umbenennen bestehender Client-Konfigurationen oder feste Modelllisten.