Weiter zum Inhalt
  • Home
  • Aktuell
  • Tags
  • 0 Ungelesen 0
  • Kategorien
  • Unreplied
  • Beliebt
  • GitHub
  • Docu
  • Hilfe
Skins
  • Hell
  • Brite
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dunkel
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Standard: (Kein Skin)
  • Kein Skin
Einklappen
ioBroker Logo

Community Forum

donate donate
  1. ioBroker Community Home
  2. Deutsch
  3. Tester
  4. ...nicht in offiziellem Repo
  5. Test Adapter autodoc

NEWS

  • Neuer ioBroker-Blog online: Monatsrückblick März/April 2026
    BluefoxB
    Bluefox
    2
    1
    34

  • Verwendung von KI bitte immer deutlich kennzeichnen
    HomoranH
    Homoran
    7
    1
    105

  • Monatsrückblick Januar/Februar 2026 ist online!
    BluefoxB
    Bluefox
    18
    1
    846

Test Adapter autodoc

Geplant Angeheftet Gesperrt Verschoben ...nicht in offiziellem Repo
testadapterollamadoku
27 Beiträge 5 Kommentatoren 228 Aufrufe 5 Beobachtet
  • Älteste zuerst
  • Neuste zuerst
  • Meiste Stimmen
Antworten
  • In einem neuen Thema antworten
Anmelden zum Antworten
Dieses Thema wurde gelöscht. Nur Nutzer mit entsprechenden Rechten können es sehen.
  • crunchipC crunchip

    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.

    sigi234S Online
    sigi234S Online
    sigi234
    Forum Testing Most Active
    schrieb am zuletzt editiert von sigi234
    #9

    @crunchip

    Hallo, habe da

    Skripte ohne Beschreibung - Handlungsbedarf (338)

    wo/wie soll ich die Beschreibung ändern?

    Screenshot (1478).png

    Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
    Immer Daten sichern!

    crunchipC 1 Antwort Letzte Antwort
    0
    • sigi234S sigi234

      @crunchip

      Hallo, habe da

      Skripte ohne Beschreibung - Handlungsbedarf (338)

      wo/wie soll ich die Beschreibung ändern?

      Screenshot (1478).png

      crunchipC Abwesend
      crunchipC Abwesend
      crunchip
      Forum Testing Most Active Developer
      schrieb am zuletzt editiert von crunchip
      #10

      @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

      umgestiegen von Proxmox auf Unraid

      1 Antwort Letzte Antwort
      0
      • crunchipC crunchip

        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.

        sigi234S Online
        sigi234S Online
        sigi234
        Forum Testing Most Active
        schrieb am zuletzt editiert von sigi234
        #11

        @crunchip

        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!

        crunchipC 1 Antwort Letzte Antwort
        0
        • sigi234S sigi234

          @crunchip

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

          crunchipC Abwesend
          crunchipC Abwesend
          crunchip
          Forum Testing Most Active Developer
          schrieb am zuletzt editiert von
          #12

          @sigi234 sollte jetzt alles behoben sein

          umgestiegen von Proxmox auf Unraid

          sigi234S 1 Antwort Letzte Antwort
          1
          • U Offline
            U Offline
            UlliJ
            schrieb am zuletzt editiert von
            #13

            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

            Proxmox auf iNuc, lxc für IoB, InfluxDB2, Grafana, u.a. *** Homematic & Homematic IP, Shellies, Zigbee etc

            crunchipC 2 Antworten Letzte Antwort
            0
            • crunchipC crunchip

              @sigi234 sollte jetzt alles behoben sein

              sigi234S Online
              sigi234S Online
              sigi234
              Forum Testing Most Active
              schrieb am zuletzt editiert von
              #14

              @crunchip sagte:

              @sigi234 sollte jetzt alles behoben sein

              Ja, Danke

              Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
              Immer Daten sichern!

              1 Antwort Letzte Antwort
              0
              • U UlliJ

                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

                crunchipC Abwesend
                crunchipC Abwesend
                crunchip
                Forum Testing Most Active Developer
                schrieb am zuletzt editiert von
                #15

                @UlliJ sagte:

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

                Ja das fehlt bei mir noch ein wenig

                umgestiegen von Proxmox auf Unraid

                U 1 Antwort Letzte Antwort
                0
                • crunchipC crunchip

                  @UlliJ sagte:

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

                  Ja das fehlt bei mir noch ein wenig

                  U Offline
                  U Offline
                  UlliJ
                  schrieb am zuletzt editiert von
                  #16

                  @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

                  Proxmox auf iNuc, lxc für IoB, InfluxDB2, Grafana, u.a. *** Homematic & Homematic IP, Shellies, Zigbee etc

                  1 Antwort Letzte Antwort
                  0
                  • U UlliJ

                    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

                    crunchipC Abwesend
                    crunchipC Abwesend
                    crunchip
                    Forum Testing Most Active Developer
                    schrieb am zuletzt editiert von
                    #17

                    @UlliJ sagte:

                    Die Kombi aus beidem wäre perfekt

                    Ich hab mal mit auf die todo Liste gesetzt

                    umgestiegen von Proxmox auf Unraid

                    1 Antwort Letzte Antwort
                    0
                    • crunchipC crunchip

                      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.

                      sigi234S Online
                      sigi234S Online
                      sigi234
                      Forum Testing Most Active
                      schrieb am zuletzt editiert von
                      #18

                      @crunchip

                      Hallo,

                      wie sehe ich Live Werte?

                      Screenshot (1479).png

                      Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
                      Immer Daten sichern!

                      crunchipC 1 Antwort Letzte Antwort
                      0
                      • HomoranH Homoran verschob dieses Thema von Tester
                      • HomoranH Homoran verschob dieses Thema von ...nicht in offiziellem Repo
                      • HomoranH Homoran verschob dieses Thema von Tester
                      • sigi234S sigi234

                        @crunchip

                        Hallo,

                        wie sehe ich Live Werte?

                        Screenshot (1479).png

                        crunchipC Abwesend
                        crunchipC Abwesend
                        crunchip
                        Forum Testing Most Active Developer
                        schrieb zuletzt editiert von
                        #19

                        @sigi234 sagte:

                        Live Werte

                        Sind es eigentlich nicht, eher Momentaufnahmen, seh ich mir an, vllt nehme ich das auch raus

                        umgestiegen von Proxmox auf Unraid

                        1 Antwort Letzte Antwort
                        0
                        • crunchipC crunchip

                          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.

                          sigi234S Online
                          sigi234S Online
                          sigi234
                          Forum Testing Most Active
                          schrieb zuletzt editiert von
                          #20

                          @crunchip

                          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!

                          crunchipC 1 Antwort Letzte Antwort
                          0
                          • crunchipC crunchip

                            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.

                            arteckA Offline
                            arteckA Offline
                            arteck
                            Developer Most Active
                            schrieb zuletzt editiert von arteck
                            #21

                            @crunchip sagte:

                            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

                            09960e43-0a19-4968-b169-0039337b066f-image.jpeg

                            zigbee hab ich, zwave auch, nuc's genauso und HA auch

                            HomoranH crunchipC 2 Antworten Letzte Antwort
                            0
                            • arteckA arteck

                              @crunchip sagte:

                              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

                              09960e43-0a19-4968-b169-0039337b066f-image.jpeg

                              HomoranH Nicht stören
                              HomoranH Nicht stören
                              Homoran
                              Global Moderator Administrators
                              schrieb zuletzt editiert von
                              #22

                              @arteck sagte:

                              alles Adapter spezfifische landet im iobroker-data verzeichniss

                              Und??
                              Da ist doch dann files die nächste Ebene

                              kein 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 -

                              arteckA 1 Antwort Letzte Antwort
                              0
                              • HomoranH Homoran

                                @arteck sagte:

                                alles Adapter spezfifische landet im iobroker-data verzeichniss

                                Und??
                                Da ist doch dann files die nächste Ebene

                                arteckA Offline
                                arteckA Offline
                                arteck
                                Developer Most Active
                                schrieb zuletzt editiert von
                                #23

                                @Homoran sagte:

                                Da ist doch dann files die nächste Ebene

                                und

                                rate was da nicht steht

                                zigbee hab ich, zwave auch, nuc's genauso und HA auch

                                1 Antwort Letzte Antwort
                                0
                                • arteckA arteck

                                  @crunchip sagte:

                                  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

                                  09960e43-0a19-4968-b169-0039337b066f-image.jpeg

                                  crunchipC Abwesend
                                  crunchipC Abwesend
                                  crunchip
                                  Forum Testing Most Active Developer
                                  schrieb zuletzt editiert von
                                  #24

                                  @arteck ok, wenn das so falsch ist mit der Ablage, ändert ich das ab.
                                  Bei den Feldern dachte ich mir, füge ich Beschreibungen hinzu, damit es verständlicher ist.

                                  umgestiegen von Proxmox auf Unraid

                                  1 Antwort Letzte Antwort
                                  0
                                  • sigi234S sigi234

                                    @crunchip

                                    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.

                                    crunchipC Abwesend
                                    crunchipC Abwesend
                                    crunchip
                                    Forum Testing Most Active Developer
                                    schrieb zuletzt editiert von
                                    #25

                                    @sigi234 geb mir mal ein Beispiel was du genau meinst?

                                    umgestiegen von Proxmox auf Unraid

                                    sigi234S 1 Antwort Letzte Antwort
                                    0
                                    • crunchipC crunchip

                                      @sigi234 geb mir mal ein Beispiel was du genau meinst?

                                      sigi234S Online
                                      sigi234S Online
                                      sigi234
                                      Forum Testing Most Active
                                      schrieb zuletzt editiert von sigi234
                                      #26

                                      @crunchip sagte:

                                      @sigi234 geb mir mal ein Beispiel was du genau meinst?

                                      Screenshot (1483).png Screenshot (1482).png

                                      RAM und CPU zum 1. Bild dazu

                                      Aber hier:

                                      Phase 5 — Erweiterungen (Nice-to-Have)
                                      PDF-Export
                                      Backup-Adapter Integration
                                      Custom Templates
                                      QR-Code für Onboarding (qrcodejs CDN + Fallback)

                                      hast du ja Custom Templates geplant, damit könnte man ja dann eine eigene zusammen stellen?

                                      Bitte benutzt das Voting rechts unten im Beitrag wenn er euch geholfen hat.
                                      Immer Daten sichern!

                                      crunchipC 1 Antwort Letzte Antwort
                                      0
                                      • sigi234S sigi234

                                        @crunchip sagte:

                                        @sigi234 geb mir mal ein Beispiel was du genau meinst?

                                        Screenshot (1483).png Screenshot (1482).png

                                        RAM und CPU zum 1. Bild dazu

                                        Aber hier:

                                        Phase 5 — Erweiterungen (Nice-to-Have)
                                        PDF-Export
                                        Backup-Adapter Integration
                                        Custom Templates
                                        QR-Code für Onboarding (qrcodejs CDN + Fallback)

                                        hast du ja Custom Templates geplant, damit könnte man ja dann eine eigene zusammen stellen?

                                        crunchipC Abwesend
                                        crunchipC Abwesend
                                        crunchip
                                        Forum Testing Most Active Developer
                                        schrieb zuletzt editiert von
                                        #27

                                        @sigi234 sagte:

                                        RAM und CPU zum 1. Bild dazu

                                        Achso, du meinst eine komplette gesamt Übersicht

                                        @sigi234 sagte:

                                        hast du ja Custom Templates geplant

                                        Ja, das war zu Anfangszeiten mal als Gedankengang festgehalten

                                        umgestiegen von Proxmox auf Unraid

                                        1 Antwort Letzte Antwort
                                        0

                                        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 Anmelden
                                        Antworten
                                        • In einem neuen Thema antworten
                                        Anmelden zum Antworten
                                        • Älteste zuerst
                                        • Neuste zuerst
                                        • Meiste Stimmen


                                        Support us

                                        ioBroker
                                        Community Adapters
                                        Donate

                                        493

                                        Online

                                        32.8k

                                        Benutzer

                                        82.7k

                                        Themen

                                        1.3m

                                        Beiträge
                                        Community
                                        Impressum | Datenschutz-Bestimmungen | Nutzungsbedingungen | Einwilligungseinstellungen
                                        ioBroker Community 2014-2025
                                        logo
                                        • Anmelden

                                        • Du hast noch kein Konto? Registrieren

                                        • Anmelden oder registrieren, um zu suchen
                                        • Erster Beitrag
                                          Letzter Beitrag
                                        0
                                        • Home
                                        • Aktuell
                                        • Tags
                                        • Ungelesen 0
                                        • Kategorien
                                        • Unreplied
                                        • Beliebt
                                        • GitHub
                                        • Docu
                                        • Hilfe