<![CDATA[Test Adapter autodoc]]>Hallo zusammen,

ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker, daher bin ich für konstruktives Feedback und Tipps besonders dankbar.

Was der Adapter heute schon kann
Aus eurer Installation werden HTML- und Markdown-Dokumente (plus JSON) erzeugt — per Knopf oder automatisch (Start, Intervall, Änderungen an Adaptern). In einem Lauf entstehen drei Lesarten:

Admin — technischer Überblick (Adapter, Hosts, Skripte, Wartung, Aliase, eigene Variablen, …)
User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, bewusst ohne Admin-Jargon
Optional: KI-Zusammenfassung (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet; es werden dafür keine Live-Daten „von der KI ausgelesen“, sondern nur der vorbereitete Text an den gewählten Dienst geschickt.

Aktuell liegt der Fokus auf stabiler Doku-Erzeugung und guter Lesbarkeit der drei Profile.

Installation zum Ausprobieren
Im Admin: Adapter → von URL installieren, z. B.:
https://github.com/crunchip77/ioBroker.autodoc/tarball/main
(Hinweis zum Cache bei gleicher Versionsnummer steht im README — kurz lesen, spart Frust beim Update.)

Links

Repo: https://github.com/crunchip77/ioBroker.autodoc
Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

Changelog (Kurzüberblick, Stand 0.9.7)
Auszug — alles Weitere steht im README im Repo.

Changelog (Kurzüberblick, Stand 0.9.7)
Auszug — alles Weitere steht im README im Repo.

0.9.7

12.04.2026
• Generierung: Kein paralleler Lauf mehr — zweiter Start → Warnung + Abbruch (bei Ollama oft spürbar).
• Log: Fortschritt 1/5–5/5 plus KI-Hinweise pro Aufruf — weniger „hängt das noch?“.
• KI: Automatische Wiederholungen bei typischen Netz-/Serverfehlern (z. B. 500, Timeout) mit Backoff (OpenAI-kompatible APIs).
• HTML Desktop: Breitere Hauptspalte; Mobil unverändert. Renderer aktualisiert — wie gewohnt Neu-Generierung auslösen und Seite hart neu laden.
• Admin-Doku (HTML/Markdown): JavaScript-Skripte nach ioBroker-Ordner gruppiert; beim Ordner „Globale Skripte“ kurzer Hinweis zur Ausführungsreihenfolge und sinnvollen Nutzung (entspricht der Script-Engine, keine extra AutoDoc-Option).
• common.desc am Skriptobjekt: nur noch als optionaler Gruppen-/Zwecktext erklärt — keine irreführende „Handlungsbedarf“-Liste mehr wegen fehlender Beschreibung.
• Admin-UI: Texte zu Export/Datenschutz (inkl. optional common.desc bei KI) und kurzer Hinweis im Tab „Erweitert“.

11.04.2026
• Start / Einstellungen: Klarere Log-Meldungen zur Startup-Doku; Hilfetexte präziser (Hintergrundlauf, info.templateVersion, Log-Hinweis).
• Standard: „Dokumentation beim Adapterstart“ ist in den Paket-Defaults für neue Instanzen aktiv (bestehende Instanzen behalten ihre gespeicherte Konfiguration).
• HTML (Admin): Eigene Variablen und Aliase — Filter und Zuklappen zuverlässiger über das Skript am Seitenende; Ordnerverhalten bei leerem Suchfeld stabiler (inkl. BF-Cache/pageshow). Renderer-Version für den Template-Check angehoben.
• KI (lokal / kleine Modelle): sinnvollere Ollama-Standard-Temperaturen bei leerer Temperatur; strengere deutsche System- und Lektor-Prompts (u. a. korrektes ioBroker, keine Tippfehler wie iroBroker / „Adapatoren“, kein erfundenes Personal oder Fantasie-Marken); Qualitätsprüfung nach dem Lektor — bei weiterhin kaputtem Bewohner-Text kurze sachliche Kurzfassung aus echten Statistiken; bei kaputtem Gäste-Text neutraler Gäste-Fallback; typischer Stichpunkt-Müll wird stärker gefiltert.

10.04.2026
• KI: Timeout und optionale Temperaturen (Bewohner vs. Gäste) in den Einstellungen; Grounding (Räume + Gerätekategorien) in den Prompts.
• Gäste-KI: bei technischem „Müll“ neutraler Fallback statt Admin-Sprech; im HTML-Kommentar erkennbar: primary vs. fallback-neutral.
• Parser: robuster bei NARRATIVE / RECOMMENDATIONS, Bereinigung von Markdown-Artefakten und leeren Stichpunkten.
• Deutsch: strengere Regeln (z. B. kein „Vorgesetzte“ im Privathaushalt, Rollläden statt falscher „Blinde“); erweiterte Trigger für den Sie-Lektor-Pass.

]]>https://forum.iobroker.net/topic/84267/test-adapter-autodocRSS for NodeMon, 13 Apr 2026 02:02:51 GMTFri, 10 Apr 2026 21:26:45 GMT60<![CDATA[Reply to Test Adapter autodoc on Sun, 12 Apr 2026 13:41:54 GMT]]>

@UlliJ sagte:

Die Kombi aus beidem wäre perfekt

Ich hab mal mit auf die todo Liste gesetzt

]]>https://forum.iobroker.net/post/1334230https://forum.iobroker.net/post/1334230Sun, 12 Apr 2026 13:41:54 GMT<![CDATA[Reply to Test Adapter autodoc on Sun, 12 Apr 2026 09:17:52 GMT]]>

@crunchip sagte:

Ja das fehlt bei mir noch ein wenig

mal quick & dirty auf Teile der Autodoku verlinkt
b59aae01-9386-4542-929d-f0ed35449b59-image.jpeg

]]>https://forum.iobroker.net/post/1334167https://forum.iobroker.net/post/1334167Sun, 12 Apr 2026 09:17:52 GMT<![CDATA[Reply to Test Adapter autodoc on Sun, 12 Apr 2026 08:10:36 GMT]]>

@UlliJ sagte:

Mehr darauf ausgerichtet die Zusammenhänge verständlich zu machen

Ja das fehlt bei mir noch ein wenig

]]>https://forum.iobroker.net/post/1334141https://forum.iobroker.net/post/1334141Sun, 12 Apr 2026 08:10:36 GMT<![CDATA[Reply to Test Adapter autodoc on Sun, 12 Apr 2026 08:09:12 GMT]]>

@crunchip sagte:

@sigi234 sollte jetzt alles behoben sein

Ja, Danke

]]>https://forum.iobroker.net/post/1334139https://forum.iobroker.net/post/1334139Sun, 12 Apr 2026 08:09:12 GMT<![CDATA[Reply to Test Adapter autodoc on Sun, 12 Apr 2026 08:04:54 GMT]]>super gemacht👍
Hatte auch gerade mit Doku angefangen, mit etwas anderem Ansatz und manuell generiert. Mehr darauf ausgerichtet die Zusammenhänge verständlich zu machen. Die Kombi aus beidem wäre perfekt🤔

3a427022-4107-4c4e-b047-59838c9a223e-image.jpeg

]]>https://forum.iobroker.net/post/1334134https://forum.iobroker.net/post/1334134Sun, 12 Apr 2026 08:04:54 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 18:41:09 GMT]]>@sigi234 sollte jetzt alles behoben sein

]]>https://forum.iobroker.net/post/1334063https://forum.iobroker.net/post/1334063Sat, 11 Apr 2026 18:41:09 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 16:37:05 GMT]]>@crunchip

Hallo, irgendwie fehlt mir in der Systemübersicht die NPM Version?

]]>https://forum.iobroker.net/post/1334054https://forum.iobroker.net/post/1334054Sat, 11 Apr 2026 16:37:05 GMT<![CDATA[Reply to Test Adapter autodoc on Sun, 12 Apr 2026 16:43:35 GMT]]>@sigi234 das sollte dazu dienen Beschreibungen aus den Scripten auszulesen, welche direkt im Script (common.desc) hinterlegt sind, weiterführend dann zu verarbeiten, was macht das Script.
edit
selbst gemerkt, das dies der falsche Ansatz war, muss ich mir was anderes überlegen

]]>https://forum.iobroker.net/post/1333996https://forum.iobroker.net/post/1333996Sun, 12 Apr 2026 16:43:35 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 09:12:35 GMT]]>@crunchip

Hallo, habe da

Skripte ohne Beschreibung - Handlungsbedarf (338)

wo/wie soll ich die Beschreibung ändern?

Screenshot (1478).png

]]>https://forum.iobroker.net/post/1333979https://forum.iobroker.net/post/1333979Sat, 11 Apr 2026 09:12:35 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 09:08:28 GMT]]>

@crunchip sagte:

ok, guck mal durch ob noch weitere Felder dabei sind.

Nein, nur diese.

]]>https://forum.iobroker.net/post/1333978https://forum.iobroker.net/post/1333978Sat, 11 Apr 2026 09:08:28 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 08:59:30 GMT]]>@sigi234 ok, guck mal durch ob noch weitere Felder dabei sind. Hatte bisher nur auf nem Testserver laufen, da ist nicht viel installiert, von daher nicht alles ausgefüllt.
Korrigiere ich später

]]>https://forum.iobroker.net/post/1333976https://forum.iobroker.net/post/1333976Sat, 11 Apr 2026 08:59:30 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 08:32:06 GMT]]>@crunchip

Hallo,

f18e2ecd-8835-4dd5-9c66-50b20fa2b38a-image.jpeg

Ist im Dark Mode nicht zu lesen!

]]>https://forum.iobroker.net/post/1333973https://forum.iobroker.net/post/1333973Sat, 11 Apr 2026 08:32:06 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 08:25:35 GMT]]>

@crunchip sagte:

@sigi234 was meinst du mit extra angeben?
Eigentlich deine iobroker ip:port
In meinem Fall 10.1.1.111:8081

Ja läuft jetzt . IOB läuft bei mir unter Win ja local.

http://localhost:8091

Screenshot (1476).png

]]>https://forum.iobroker.net/post/1333972https://forum.iobroker.net/post/1333972Sat, 11 Apr 2026 08:25:35 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 07:47:17 GMT]]>@sigi234 was meinst du mit extra angeben?
Eigentlich deine iobroker ip:port
In meinem Fall 10.1.1.111:8081

]]>https://forum.iobroker.net/post/1333969https://forum.iobroker.net/post/1333969Sat, 11 Apr 2026 07:47:17 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 07:13:53 GMT]]>

@crunchip sagte:

wenn die Basis-URL passt.

Muss ich die unter Windows extra angeben?

Screenshot (1475).png

]]>https://forum.iobroker.net/post/1333965https://forum.iobroker.net/post/1333965Sat, 11 Apr 2026 07:13:53 GMT<![CDATA[Reply to Test Adapter autodoc on Sat, 11 Apr 2026 20:30:11 GMT]]>Konfiguration & Bedienung (Instanz)
Die Einstellungen sind in Tabs gegliedert:

  • Basic / Grundeinstellungen — Projekt-/Dokusprache, Profil (steuert v. a. den Fokus des Markdown-Exports; alle drei HTML-Seiten Admin / User / Onboarding werden immer erzeugt). Automatik: beim Start, bei Adapter-Änderungen (mit kurzer Verzögerung), optional Intervall in Stunden. Live-Werte (Temperatur, Tür/Fenster, Alarm) nur für Onboarding, wenn du es aktivierst. Zum sofortigen Start: „Generate documentation now“; darunter siehst du, wann zuletzt erzeugt wurde.
    765ad81a-0e5b-44e4-8d52-4daf3205d45c-image.jpeg

  • My documentation — Projektname, Beschreibung, Kontakt, allgemeine Notizen; Tabellen für Hinweise pro Adapter und pro Raum; Listen, welche Räume/Adapter du in User- bzw. Onboarding-HTML ausblendest.
    9d0c551d-6b0b-40cb-9318-9dbb5ca9b725-image.jpeg

  • Advanced — nur aktivierte Instanzen dokumentieren, Markdown kürzer (ohne volle Instanzliste), Obergrenzen für Instanzen und für die Anzahl archivierter Dateisätze, optional Basis-URL für die Direktlinks in den States (sinnvoll bei Docker/fester Adresse).
    cd4ee6b7-d1f2-4ab5-a8bf-7a799c96cc32-image.jpeg

  • Notifications — nach einer Erzeugung z. B. Telegram/Pushover/E-Mail informieren (Instanz + optional Empfänger + Textvorlage).
    6592d87a-2c52-4574-ae9d-00dafe465bdf-image.jpeg

  • AI documentation — optional: Anbieter (z. B. Ollama lokal), Modell, API-Key (falls nötig), Ollama-URL, Timeout und Temperaturen getrennt für Bewohner- und Gästetext. Ohne Anbieter bleibt die KI-Box aus bzw. neutral.
    90e3e2bd-6391-41d0-8bc6-5cfff7c1beb3-image.jpeg

Benutzung im Alltag
Nach dem Speichern der Konfiguration: „Generate now“ oder Automatik abwarten. Die HTML-Dateien liegen unter …/files/autodoc.<Instanz>/ (z. B. autodoc-admin.html, autodoc-user.html, autodoc-onboarding.html). Im Objektbaum findest du u. a. States mit Direktlinks zu den letzten HTML-Seiten (info.htmlUrlAdmin usw.), wenn die Basis-URL passt.

]]>https://forum.iobroker.net/post/1333927https://forum.iobroker.net/post/1333927Sat, 11 Apr 2026 20:30:11 GMT