Test Adapter autodoc
-
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.umgestiegen von Proxmox auf Unraid
-
-
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.Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
Immer Daten sichern! -
-
@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.
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.0.9.7
11.04.2026
- Generierung beim Start: Klarere Log-Meldungen (wann eine Startup-Erzeugung ansteht bzw. bewusst übersprungen wird); Hilfetext in den Einstellungen präzisiert (Hintergrundlauf, info.templateVersion, Log-Hinweis).
- Standard: „Dokumentation beim Adapterstart“ ist in den Paket-Defaults voreingestellt aktiv (bestehende Instanzen behalten ihre gespeicherte Konfiguration).
- HTML (Admin): Eigene Variablen und Aliase — Filter/Zuklappen läuft über das Skript am Seitenende (zuverlässiger, wenn Viewer kein JS mitten in <main> ausführen); Ordner bei leerem Suchfeld werden zuverlässig geschlossen (open entfernt, BF-Cache/pageshow). Renderer-Version für Template-Check wurde angehoben.
- KI (lokal / kleine Modelle): für Ollama bei leerer Temperatur niedrigere Standard-Temperaturen; 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; Stichpunkte mit typischem Müll werden 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; HTML-Kommentar zeigt primary vs. fallback-neutral.
- Parser: robusteres 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.
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.0.9.7
11.04.2026
- Generierung beim Start: Klarere Log-Meldungen (wann eine Startup-Erzeugung ansteht bzw. bewusst übersprungen wird); Hilfetext in den Einstellungen präzisiert (Hintergrundlauf, info.templateVersion, Log-Hinweis).
- Standard: „Dokumentation beim Adapterstart“ ist in den Paket-Defaults voreingestellt aktiv (bestehende Instanzen behalten ihre gespeicherte Konfiguration).
- HTML (Admin): Eigene Variablen und Aliase — Filter/Zuklappen läuft über das Skript am Seitenende (zuverlässiger, wenn Viewer kein JS mitten in <main> ausführen); Ordner bei leerem Suchfeld werden zuverlässig geschlossen (open entfernt, BF-Cache/pageshow). Renderer-Version für Template-Check wurde angehoben.
- KI (lokal / kleine Modelle): für Ollama bei leerer Temperatur niedrigere Standard-Temperaturen; 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; Stichpunkte mit typischem Müll werden 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; HTML-Kommentar zeigt primary vs. fallback-neutral.
- Parser: robusteres 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.
-
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.0.9.7
11.04.2026
- Generierung beim Start: Klarere Log-Meldungen (wann eine Startup-Erzeugung ansteht bzw. bewusst übersprungen wird); Hilfetext in den Einstellungen präzisiert (Hintergrundlauf, info.templateVersion, Log-Hinweis).
- Standard: „Dokumentation beim Adapterstart“ ist in den Paket-Defaults voreingestellt aktiv (bestehende Instanzen behalten ihre gespeicherte Konfiguration).
- HTML (Admin): Eigene Variablen und Aliase — Filter/Zuklappen läuft über das Skript am Seitenende (zuverlässiger, wenn Viewer kein JS mitten in <main> ausführen); Ordner bei leerem Suchfeld werden zuverlässig geschlossen (open entfernt, BF-Cache/pageshow). Renderer-Version für Template-Check wurde angehoben.
- KI (lokal / kleine Modelle): für Ollama bei leerer Temperatur niedrigere Standard-Temperaturen; 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; Stichpunkte mit typischem Müll werden 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; HTML-Kommentar zeigt primary vs. fallback-neutral.
- Parser: robusteres 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! -
@sigi234 sollte jetzt alles behoben sein
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
494
Online32.8k
Benutzer82.7k
Themen1.3m
Beiträge