Test Adapter autodoc
-
@sigi234 was meinst du mit extra angeben?
Eigentlich deine iobroker ip:port
In meinem Fall 10.1.1.111:8081umgestiegen von Proxmox auf Unraid
-
@sigi234 was meinst du mit extra angeben?
Eigentlich deine iobroker ip:port
In meinem Fall 10.1.1.111:8081@sigi234 was meinst du mit extra angeben?
Eigentlich deine iobroker ip:port
In meinem Fall 10.1.1.111:8081Ja lÀuft jetzt . IOB lÀuft bei mir unter Win ja local.
-
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.
Zu Hilfe gezogen wurden Perplexity, Claude und letztendlich Cursor
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.Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Immer Daten sichern! -
@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Àterumgestiegen von Proxmox auf Unraid
-
@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 -
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.
Zu Hilfe gezogen wurden Perplexity, Claude und letztendlich Cursor
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.Hallo, habe da
Skripte ohne Beschreibung - Handlungsbedarf (338)
wo/wie soll ich die Beschreibung Àndern?
Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Immer Daten sichern! -
Hallo, habe da
Skripte ohne Beschreibung - Handlungsbedarf (338)
wo/wie soll ich die Beschreibung Àndern?
@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 -
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.
Zu Hilfe gezogen wurden Perplexity, Claude und letztendlich Cursor
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.Hallo, irgendwie fehlt mir in der SystemĂŒbersicht die NPM Version?
Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Immer Daten sichern! -
-
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đ€
Proxmox auf iNuc, lxc fĂŒr IoB, InfluxDB2, Grafana, u.a. *** Homematic & Homematic IP, Shellies, Zigbee etc
-
-
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đ€ -
-
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đ€ -
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.
Zu Hilfe gezogen wurden Perplexity, Claude und letztendlich Cursor
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.Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Immer Daten sichern! -
H Homoran verschob dieses Thema von Tester am
-
H Homoran verschob dieses Thema von ...nicht in offiziellem Repo am
-
H Homoran verschob dieses Thema von Tester am
-
-
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.
Zu Hilfe gezogen wurden Perplexity, Claude und letztendlich Cursor
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.Hallo,
cool wĂ€re es noch wenn es eine KurzĂŒbersicht geben wĂŒrde wo die wichtigsten Daten des Systems ersichtlich sind.
Vor allem fĂŒr einen helfenden User um nicht immer nachfragen zu mĂŒssen wie das System ist.Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Immer Daten sichern! -
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.
-
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.
-
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).
-
Notifications â nach einer Erzeugung z.âŻB. Telegram/Pushover/E-Mail informieren (Instanz + optional EmpfĂ€nger + Textvorlage).
-
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.
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.Nach dem Speichern der Konfiguration: âGenerate nowâ oder Automatik abwarten. Die HTML-Dateien liegen unter âŠ/files/autodoc.
wiso da ??
alles Adapter spezfifische landet im iobroker-data verzeichniss
anosnten solltest du die Felder ausblenden wenn nicht benötigt
zigbee hab ich, zwave auch, nuc's genauso und HA auch
-
-
alles Adapter spezfifische landet im iobroker-data verzeichniss
Und??
Da ist doch dann files die nÀchste Ebenekein Support per PN! - Fragen im Forum stellen -
Benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Das Forum freut sich ĂŒber eine Spende. Benutzt dazu den Spendenbutton oben rechts. Danke!
der Installationsfixer: curl -fsL https://iobroker.net/fix.sh | bash - -
Hey! Du scheinst an dieser Unterhaltung interessiert zu sein, hast aber noch kein Konto.
Hast du es satt, bei jedem Besuch durch die gleichen BeitrĂ€ge zu scrollen? Wenn du dich fĂŒr ein Konto anmeldest, kommst du immer genau dorthin zurĂŒck, wo du zuvor warst, und kannst dich ĂŒber neue Antworten benachrichtigen lassen (entweder per E-Mail oder Push-Benachrichtigung). Du kannst auch Lesezeichen speichern und BeitrĂ€ge positiv bewerten, um anderen Community-Mitgliedern deine WertschĂ€tzung zu zeigen.
Mit deinem Input könnte dieser Beitrag noch besser werden đ
Registrieren AnmeldenSupport us
527
Online32.8k
Benutzer82.7k
Themen1.3m
BeitrÀge