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
    8
    1
    827

  • Verwendung von KI bitte immer deutlich kennzeichnen
    HomoranH
    Homoran
    10
    1
    622

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

Test Adapter autodoc

Geplant Angeheftet Gesperrt Verschoben ...nicht in offiziellem Repo
testadapterollamadoku
44 Beiträge 6 Kommentatoren 1.4k Aufrufe 10 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 Abwesend
    crunchipC Abwesend
    crunchip
    Forum Testing Most Active Developer
    schrieb am zuletzt editiert von crunchip
    #2

    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.

    umgestiegen von Proxmox auf Unraid

    sigi234S arteckA 2 Antworten Letzte Antwort
    1
    • 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.

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

      @crunchip sagte:

      wenn die Basis-URL passt.

      Muss ich die unter Windows extra angeben?

      Screenshot (1475).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 sagte:

        wenn die Basis-URL passt.

        Muss ich die unter Windows extra angeben?

        Screenshot (1475).png

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

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

        umgestiegen von Proxmox auf Unraid

        sigi234S 1 Antwort Letzte Antwort
        0
        • crunchipC crunchip

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

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

          @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

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

          1 Antwort Letzte Antwort
          1
          • crunchipC crunchip

            Hallo zusammen,
            ich stelle hier meinen Adapter ioBroker.autodoc vor — das ist mein erster Adapter für ioBroker; über konstruktives Feedback und Tipps freue ich mich sehr.
            Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.
            Was der Adapter heute schon kann
            Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente 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 Datenpunkte, …)
            • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
            • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon
              Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.
              Aktuell liegt der Fokus auf stabiler Dokuerzeugung 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.)
            → Instanz neu starten; bei Bedarf im Adapterordner npm install (u. a. Paket qrcode, optional für erweiterte Toolchains siehe README).
            Ein stabiler Liste-Install wie bei npm-Adaptern folgt später mit npm und Eintrag in ioBroker.repositories — bis dahin ist der Weg über Git/Tarball normal.

            Links

            • Repo: https://github.com/crunchip77/ioBroker.autodoc
            • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
            • Kurzanleitungen im Repo: User-Guide EN · Szenario DE
              Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

            ioBroker.autodoc — Update (main, v0.9.34, Stand 2026-05-08)

            Neu seit dem letzten Foren-Post (0.9.32 → jetzt)

            0.9.33

            • Optional PDF-Export (drei Dateien: Admin / User / Onboarding), wenn puppeteer im Adapterordner installiert ist. Ohne das: unverändert nur HTML & Co. Zusätzlich Datenpunkt, um nur PDF zu erzeugen.
              0.9.34
            • documentation.exportHashes berücksichtigt nach einem gelingenden PDF-Lauf auch die PDF-Dateien.
            • Mermaid: Wenn Diagramme schon eingebettet sind, wird kein jsDelivr-Skript mehr nachgeladen.
            • Admin: kurzer PDF-Hinweis im Tab HTML-Export; kleine Verbesserung Quick-Start (Skripte stabiler sortiert).
              Doku
            • Kurzanleitung unter docs/user-guide/ mit Screenshots aller Konfig-Tabs (DE/EN) + Tipps zu Lesbarkeit/Datenschutz bei eigenen Bildern.

            ioBroker.autodoc — Update (main, v0.9.32, Stand 2026-05-08)


            Neu in 0.9.32

            • docs/user-guide/ — englische Kurzanleitung + deutsches Muster-Szenario; Platzhalter-Grafiken (SVG) und Hinweise für echte Screenshots
            • Admin: mehr Hilfe zu Mermaid, zu Export-Hashes und Documentation-States (z. B. documentation.exportHashes, Speicher full vs. metadata) sowie Platzhalter bei langen Feldern; KI-Registerkarte aufgeräumt ohne aktiven Provider
            • common.extIcon und die Guide-URLs folgen main; Icon als PNG (512×512)
            • CI: Workflow-Concurrency wie von ioBroker empfohlen (Adapter Checker E3009); lokales npm run check ignoriert versehentliche Bootstrap-Reste im Klon wie bei ESLint

            Forum (Kurzüberblick, Stand, 0.9.29–0.9.31)


            Neu in 0.9.31

            • Check „Instanzen ohne Raum“ fließt nicht mehr in den Score (war oft irreführend).
            • Dafür u. a.: eigenes Doku‑Kapitel mit Inhalt; KI‑Provider, wenn Skripte existieren (ohne Skripte zählt der Punkt nicht).
            • Alte Admin‑Felder zu „ohne Raum“ bleiben, wirken aber nicht mehr auf den Score.

            Neu in 0.9.30

            • Statt einem Wert gibt es drei Teil‑Scores: Datenerfassung · manuelle Angaben · Doku‑Tiefe, plus Gesamtpunktzahl (Durchschnitt).
            • Oberfläche und Texte (EN / DE / FR) angepasst.

            Neu in 0.9.29

            • User‑Ansicht „Verbundene Systeme“ als Raster‑Layout.
            • Mermaid: ruhigere Farben; Diagramme nach Dark/Light‑Wechsel neu gerendert.
            • „Ohne Raum“ nur noch für aktive Instanzen; Hinweis zu common.desc bei Skripten entfernt.
            • Pro Instanz wird die Adapter‑Kategorie (common.type) mit ausgewertet.

            Forum (Kurzüberblick, Stand 0.9.26–0.9.28)


            Neu in 0.9.28 (Phase 5.x.3 · Stufe 2)

            • Optional „Auto host topology diagram“ (autoMermaidHostGraph) + Max. Instanzen (8–80, Standard 40): zweites Mermaid-Diagramm, Adapter-Instanzen pro ioBroker-Host (Multihost sinnvoll; begrenzte Knotenzahl, Round-Robin bei vielen Instanzen). Kein vollständiger Verbindungsgraph.
            • Ebenfalls über mermaid ausblendbar wie das eigene Diagramm.
            • Anzeige z. B. in Onboarding-Begrüßung nach dem manuellen Diagramm; gleiche Hide-Logik.

            Neu in 0.9.27 (Phase 5.x.3 · Stufe 1)

            • Unter „Meine Dokumentation“: optionales Feld „Mermaid diagram“ (manualMermaidDiagram) — eigenes Diagramm (z. B. flowchart TB …).
            • HTML: Diagramm wird im Browser über Mermaid (CDN jsdelivr) gerendert; JavaScript aktiv und Zugriff auf das CDN sollten möglich sein, sonst bleibt Text sichtbar.
            • Markdown: Zusätzlicher ```mermaid-Block unter den manuellen Informationen.
            • Ausblenden in User/Onboarding über Kapitel-Id mermaid.

            Neu in 0.9.26 (Phase 5.x.2 · Quick-Start-Anpassung)

            • Onboarding Quick Start (HTML + Markdown): kürzerer Schnitt aus denselben Daten — 3 Setup-Zeilen, 4 Raum-Karten, 2 Highlights pro Raum (sliceQuickStartForOnboarding).
            • User „Überblick“: weiterhin die volle Tiefe; Einleitungstext klärt Bewohner vs. Gast; Link zum Räume-Kapitel, wenn Highlights da sind und das Kapitel nicht versteckt ist (User-HTML + User-Markdown).
            • KI-Zugrundelegung Nutzerprofil: weiterhin die vollen Quick-Start-Fakten.

            Forum (Kurzüberblick, Stand 0.9.25)

            • Meine Dokumentation: neues Freitextfeld ownerPlaybookNote („Ablauf / Playbook“): typische Reihenfolge, was erledigt werden muss, was Gäste oder Familie nicht ändern soll — in eigenen Worten.
            • Ausgabe:
              • eigenes Kapitel in User- und Onboarding-HTML (Navigation, wenn ausgefüllt),
              • im Admin-Handbuch als Unterpunkt,
              • im Markdown-Export unter Manual information, wenn das gewählte Dokumentationsprofil User bzw. Onboarding ist.
            • Ausblenden: Kapitel-Id ownerPlaybook in den JSON-Feldern auf dem Tab HTML-Export & Zusatzkapitel (User- bzw. Onboarding-Profil — ausgeblendete Kapitel).
            • KI: Playbook-Text fließt in den Owner-Kontext (analog zu Hilfe & Notfall / Abläufe).
            • Admin-UI: DE/FR für das neue Feld; Hinweis Doc layout intro präzisiert Admin-Kapitel vs. User/Onboarding-Ausblenden.
            • RENDERER_VERSION: 2026.04.28.5 — bei Bedarf Doku neu erzeugen.

            Kurz zuvor (0.9.22–0.9.24)

            • Doku-Setup-Score / Wartung: konfigurierbare Checks und Schwellen; einheitliche Benennung Dokumentations-Setup vs. Diagnose; Quick-Start u. a. stabile Sortierung wenn Räume die gleiche Gerätezahl haben.
            sigi234S Online
            sigi234S Online
            sigi234
            Forum Testing Most Active
            schrieb am zuletzt editiert von
            #6

            @crunchip

            Hallo,

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

            Ist im Dark Mode nicht zu lesen!

            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,

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

              Ist im Dark Mode nicht zu lesen!

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

              @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

              umgestiegen von Proxmox auf Unraid

              sigi234S 1 Antwort Letzte Antwort
              0
              • crunchipC crunchip

                @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

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

                @crunchip sagte:

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

                Nein, nur diese.

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

                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; über konstruktives Feedback und Tipps freue ich mich sehr.
                  Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.
                  Was der Adapter heute schon kann
                  Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente 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 Datenpunkte, …)
                  • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                  • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon
                    Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.
                    Aktuell liegt der Fokus auf stabiler Dokuerzeugung 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.)
                  → Instanz neu starten; bei Bedarf im Adapterordner npm install (u. a. Paket qrcode, optional für erweiterte Toolchains siehe README).
                  Ein stabiler Liste-Install wie bei npm-Adaptern folgt später mit npm und Eintrag in ioBroker.repositories — bis dahin ist der Weg über Git/Tarball normal.

                  Links

                  • Repo: https://github.com/crunchip77/ioBroker.autodoc
                  • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                  • Kurzanleitungen im Repo: User-Guide EN · Szenario DE
                    Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

                  ioBroker.autodoc — Update (main, v0.9.34, Stand 2026-05-08)

                  Neu seit dem letzten Foren-Post (0.9.32 → jetzt)

                  0.9.33

                  • Optional PDF-Export (drei Dateien: Admin / User / Onboarding), wenn puppeteer im Adapterordner installiert ist. Ohne das: unverändert nur HTML & Co. Zusätzlich Datenpunkt, um nur PDF zu erzeugen.
                    0.9.34
                  • documentation.exportHashes berücksichtigt nach einem gelingenden PDF-Lauf auch die PDF-Dateien.
                  • Mermaid: Wenn Diagramme schon eingebettet sind, wird kein jsDelivr-Skript mehr nachgeladen.
                  • Admin: kurzer PDF-Hinweis im Tab HTML-Export; kleine Verbesserung Quick-Start (Skripte stabiler sortiert).
                    Doku
                  • Kurzanleitung unter docs/user-guide/ mit Screenshots aller Konfig-Tabs (DE/EN) + Tipps zu Lesbarkeit/Datenschutz bei eigenen Bildern.

                  ioBroker.autodoc — Update (main, v0.9.32, Stand 2026-05-08)


                  Neu in 0.9.32

                  • docs/user-guide/ — englische Kurzanleitung + deutsches Muster-Szenario; Platzhalter-Grafiken (SVG) und Hinweise für echte Screenshots
                  • Admin: mehr Hilfe zu Mermaid, zu Export-Hashes und Documentation-States (z. B. documentation.exportHashes, Speicher full vs. metadata) sowie Platzhalter bei langen Feldern; KI-Registerkarte aufgeräumt ohne aktiven Provider
                  • common.extIcon und die Guide-URLs folgen main; Icon als PNG (512×512)
                  • CI: Workflow-Concurrency wie von ioBroker empfohlen (Adapter Checker E3009); lokales npm run check ignoriert versehentliche Bootstrap-Reste im Klon wie bei ESLint

                  Forum (Kurzüberblick, Stand, 0.9.29–0.9.31)


                  Neu in 0.9.31

                  • Check „Instanzen ohne Raum“ fließt nicht mehr in den Score (war oft irreführend).
                  • Dafür u. a.: eigenes Doku‑Kapitel mit Inhalt; KI‑Provider, wenn Skripte existieren (ohne Skripte zählt der Punkt nicht).
                  • Alte Admin‑Felder zu „ohne Raum“ bleiben, wirken aber nicht mehr auf den Score.

                  Neu in 0.9.30

                  • Statt einem Wert gibt es drei Teil‑Scores: Datenerfassung · manuelle Angaben · Doku‑Tiefe, plus Gesamtpunktzahl (Durchschnitt).
                  • Oberfläche und Texte (EN / DE / FR) angepasst.

                  Neu in 0.9.29

                  • User‑Ansicht „Verbundene Systeme“ als Raster‑Layout.
                  • Mermaid: ruhigere Farben; Diagramme nach Dark/Light‑Wechsel neu gerendert.
                  • „Ohne Raum“ nur noch für aktive Instanzen; Hinweis zu common.desc bei Skripten entfernt.
                  • Pro Instanz wird die Adapter‑Kategorie (common.type) mit ausgewertet.

                  Forum (Kurzüberblick, Stand 0.9.26–0.9.28)


                  Neu in 0.9.28 (Phase 5.x.3 · Stufe 2)

                  • Optional „Auto host topology diagram“ (autoMermaidHostGraph) + Max. Instanzen (8–80, Standard 40): zweites Mermaid-Diagramm, Adapter-Instanzen pro ioBroker-Host (Multihost sinnvoll; begrenzte Knotenzahl, Round-Robin bei vielen Instanzen). Kein vollständiger Verbindungsgraph.
                  • Ebenfalls über mermaid ausblendbar wie das eigene Diagramm.
                  • Anzeige z. B. in Onboarding-Begrüßung nach dem manuellen Diagramm; gleiche Hide-Logik.

                  Neu in 0.9.27 (Phase 5.x.3 · Stufe 1)

                  • Unter „Meine Dokumentation“: optionales Feld „Mermaid diagram“ (manualMermaidDiagram) — eigenes Diagramm (z. B. flowchart TB …).
                  • HTML: Diagramm wird im Browser über Mermaid (CDN jsdelivr) gerendert; JavaScript aktiv und Zugriff auf das CDN sollten möglich sein, sonst bleibt Text sichtbar.
                  • Markdown: Zusätzlicher ```mermaid-Block unter den manuellen Informationen.
                  • Ausblenden in User/Onboarding über Kapitel-Id mermaid.

                  Neu in 0.9.26 (Phase 5.x.2 · Quick-Start-Anpassung)

                  • Onboarding Quick Start (HTML + Markdown): kürzerer Schnitt aus denselben Daten — 3 Setup-Zeilen, 4 Raum-Karten, 2 Highlights pro Raum (sliceQuickStartForOnboarding).
                  • User „Überblick“: weiterhin die volle Tiefe; Einleitungstext klärt Bewohner vs. Gast; Link zum Räume-Kapitel, wenn Highlights da sind und das Kapitel nicht versteckt ist (User-HTML + User-Markdown).
                  • KI-Zugrundelegung Nutzerprofil: weiterhin die vollen Quick-Start-Fakten.

                  Forum (Kurzüberblick, Stand 0.9.25)

                  • Meine Dokumentation: neues Freitextfeld ownerPlaybookNote („Ablauf / Playbook“): typische Reihenfolge, was erledigt werden muss, was Gäste oder Familie nicht ändern soll — in eigenen Worten.
                  • Ausgabe:
                    • eigenes Kapitel in User- und Onboarding-HTML (Navigation, wenn ausgefüllt),
                    • im Admin-Handbuch als Unterpunkt,
                    • im Markdown-Export unter Manual information, wenn das gewählte Dokumentationsprofil User bzw. Onboarding ist.
                  • Ausblenden: Kapitel-Id ownerPlaybook in den JSON-Feldern auf dem Tab HTML-Export & Zusatzkapitel (User- bzw. Onboarding-Profil — ausgeblendete Kapitel).
                  • KI: Playbook-Text fließt in den Owner-Kontext (analog zu Hilfe & Notfall / Abläufe).
                  • Admin-UI: DE/FR für das neue Feld; Hinweis Doc layout intro präzisiert Admin-Kapitel vs. User/Onboarding-Ausblenden.
                  • RENDERER_VERSION: 2026.04.28.5 — bei Bedarf Doku neu erzeugen.

                  Kurz zuvor (0.9.22–0.9.24)

                  • Doku-Setup-Score / Wartung: konfigurierbare Checks und Schwellen; einheitliche Benennung Dokumentations-Setup vs. Diagnose; Quick-Start u. a. stabile Sortierung wenn Räume die gleiche Gerätezahl haben.
                  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; über konstruktives Feedback und Tipps freue ich mich sehr.
                      Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.
                      Was der Adapter heute schon kann
                      Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente 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 Datenpunkte, …)
                      • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                      • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon
                        Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.
                        Aktuell liegt der Fokus auf stabiler Dokuerzeugung 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.)
                      → Instanz neu starten; bei Bedarf im Adapterordner npm install (u. a. Paket qrcode, optional für erweiterte Toolchains siehe README).
                      Ein stabiler Liste-Install wie bei npm-Adaptern folgt später mit npm und Eintrag in ioBroker.repositories — bis dahin ist der Weg über Git/Tarball normal.

                      Links

                      • Repo: https://github.com/crunchip77/ioBroker.autodoc
                      • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                      • Kurzanleitungen im Repo: User-Guide EN · Szenario DE
                        Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

                      ioBroker.autodoc — Update (main, v0.9.34, Stand 2026-05-08)

                      Neu seit dem letzten Foren-Post (0.9.32 → jetzt)

                      0.9.33

                      • Optional PDF-Export (drei Dateien: Admin / User / Onboarding), wenn puppeteer im Adapterordner installiert ist. Ohne das: unverändert nur HTML & Co. Zusätzlich Datenpunkt, um nur PDF zu erzeugen.
                        0.9.34
                      • documentation.exportHashes berücksichtigt nach einem gelingenden PDF-Lauf auch die PDF-Dateien.
                      • Mermaid: Wenn Diagramme schon eingebettet sind, wird kein jsDelivr-Skript mehr nachgeladen.
                      • Admin: kurzer PDF-Hinweis im Tab HTML-Export; kleine Verbesserung Quick-Start (Skripte stabiler sortiert).
                        Doku
                      • Kurzanleitung unter docs/user-guide/ mit Screenshots aller Konfig-Tabs (DE/EN) + Tipps zu Lesbarkeit/Datenschutz bei eigenen Bildern.

                      ioBroker.autodoc — Update (main, v0.9.32, Stand 2026-05-08)


                      Neu in 0.9.32

                      • docs/user-guide/ — englische Kurzanleitung + deutsches Muster-Szenario; Platzhalter-Grafiken (SVG) und Hinweise für echte Screenshots
                      • Admin: mehr Hilfe zu Mermaid, zu Export-Hashes und Documentation-States (z. B. documentation.exportHashes, Speicher full vs. metadata) sowie Platzhalter bei langen Feldern; KI-Registerkarte aufgeräumt ohne aktiven Provider
                      • common.extIcon und die Guide-URLs folgen main; Icon als PNG (512×512)
                      • CI: Workflow-Concurrency wie von ioBroker empfohlen (Adapter Checker E3009); lokales npm run check ignoriert versehentliche Bootstrap-Reste im Klon wie bei ESLint

                      Forum (Kurzüberblick, Stand, 0.9.29–0.9.31)


                      Neu in 0.9.31

                      • Check „Instanzen ohne Raum“ fließt nicht mehr in den Score (war oft irreführend).
                      • Dafür u. a.: eigenes Doku‑Kapitel mit Inhalt; KI‑Provider, wenn Skripte existieren (ohne Skripte zählt der Punkt nicht).
                      • Alte Admin‑Felder zu „ohne Raum“ bleiben, wirken aber nicht mehr auf den Score.

                      Neu in 0.9.30

                      • Statt einem Wert gibt es drei Teil‑Scores: Datenerfassung · manuelle Angaben · Doku‑Tiefe, plus Gesamtpunktzahl (Durchschnitt).
                      • Oberfläche und Texte (EN / DE / FR) angepasst.

                      Neu in 0.9.29

                      • User‑Ansicht „Verbundene Systeme“ als Raster‑Layout.
                      • Mermaid: ruhigere Farben; Diagramme nach Dark/Light‑Wechsel neu gerendert.
                      • „Ohne Raum“ nur noch für aktive Instanzen; Hinweis zu common.desc bei Skripten entfernt.
                      • Pro Instanz wird die Adapter‑Kategorie (common.type) mit ausgewertet.

                      Forum (Kurzüberblick, Stand 0.9.26–0.9.28)


                      Neu in 0.9.28 (Phase 5.x.3 · Stufe 2)

                      • Optional „Auto host topology diagram“ (autoMermaidHostGraph) + Max. Instanzen (8–80, Standard 40): zweites Mermaid-Diagramm, Adapter-Instanzen pro ioBroker-Host (Multihost sinnvoll; begrenzte Knotenzahl, Round-Robin bei vielen Instanzen). Kein vollständiger Verbindungsgraph.
                      • Ebenfalls über mermaid ausblendbar wie das eigene Diagramm.
                      • Anzeige z. B. in Onboarding-Begrüßung nach dem manuellen Diagramm; gleiche Hide-Logik.

                      Neu in 0.9.27 (Phase 5.x.3 · Stufe 1)

                      • Unter „Meine Dokumentation“: optionales Feld „Mermaid diagram“ (manualMermaidDiagram) — eigenes Diagramm (z. B. flowchart TB …).
                      • HTML: Diagramm wird im Browser über Mermaid (CDN jsdelivr) gerendert; JavaScript aktiv und Zugriff auf das CDN sollten möglich sein, sonst bleibt Text sichtbar.
                      • Markdown: Zusätzlicher ```mermaid-Block unter den manuellen Informationen.
                      • Ausblenden in User/Onboarding über Kapitel-Id mermaid.

                      Neu in 0.9.26 (Phase 5.x.2 · Quick-Start-Anpassung)

                      • Onboarding Quick Start (HTML + Markdown): kürzerer Schnitt aus denselben Daten — 3 Setup-Zeilen, 4 Raum-Karten, 2 Highlights pro Raum (sliceQuickStartForOnboarding).
                      • User „Überblick“: weiterhin die volle Tiefe; Einleitungstext klärt Bewohner vs. Gast; Link zum Räume-Kapitel, wenn Highlights da sind und das Kapitel nicht versteckt ist (User-HTML + User-Markdown).
                      • KI-Zugrundelegung Nutzerprofil: weiterhin die vollen Quick-Start-Fakten.

                      Forum (Kurzüberblick, Stand 0.9.25)

                      • Meine Dokumentation: neues Freitextfeld ownerPlaybookNote („Ablauf / Playbook“): typische Reihenfolge, was erledigt werden muss, was Gäste oder Familie nicht ändern soll — in eigenen Worten.
                      • Ausgabe:
                        • eigenes Kapitel in User- und Onboarding-HTML (Navigation, wenn ausgefüllt),
                        • im Admin-Handbuch als Unterpunkt,
                        • im Markdown-Export unter Manual information, wenn das gewählte Dokumentationsprofil User bzw. Onboarding ist.
                      • Ausblenden: Kapitel-Id ownerPlaybook in den JSON-Feldern auf dem Tab HTML-Export & Zusatzkapitel (User- bzw. Onboarding-Profil — ausgeblendete Kapitel).
                      • KI: Playbook-Text fließt in den Owner-Kontext (analog zu Hilfe & Notfall / Abläufe).
                      • Admin-UI: DE/FR für das neue Feld; Hinweis Doc layout intro präzisiert Admin-Kapitel vs. User/Onboarding-Ausblenden.
                      • RENDERER_VERSION: 2026.04.28.5 — bei Bedarf Doku neu erzeugen.

                      Kurz zuvor (0.9.22–0.9.24)

                      • Doku-Setup-Score / Wartung: konfigurierbare Checks und Schwellen; einheitliche Benennung Dokumentations-Setup vs. Diagnose; Quick-Start u. a. stabile Sortierung wenn Räume die gleiche Gerätezahl haben.
                      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; über konstruktives Feedback und Tipps freue ich mich sehr.
                                    Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.
                                    Was der Adapter heute schon kann
                                    Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente 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 Datenpunkte, …)
                                    • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                                    • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon
                                      Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.
                                      Aktuell liegt der Fokus auf stabiler Dokuerzeugung 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.)
                                    → Instanz neu starten; bei Bedarf im Adapterordner npm install (u. a. Paket qrcode, optional für erweiterte Toolchains siehe README).
                                    Ein stabiler Liste-Install wie bei npm-Adaptern folgt später mit npm und Eintrag in ioBroker.repositories — bis dahin ist der Weg über Git/Tarball normal.

                                    Links

                                    • Repo: https://github.com/crunchip77/ioBroker.autodoc
                                    • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                                    • Kurzanleitungen im Repo: User-Guide EN · Szenario DE
                                      Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

                                    ioBroker.autodoc — Update (main, v0.9.34, Stand 2026-05-08)

                                    Neu seit dem letzten Foren-Post (0.9.32 → jetzt)

                                    0.9.33

                                    • Optional PDF-Export (drei Dateien: Admin / User / Onboarding), wenn puppeteer im Adapterordner installiert ist. Ohne das: unverändert nur HTML & Co. Zusätzlich Datenpunkt, um nur PDF zu erzeugen.
                                      0.9.34
                                    • documentation.exportHashes berücksichtigt nach einem gelingenden PDF-Lauf auch die PDF-Dateien.
                                    • Mermaid: Wenn Diagramme schon eingebettet sind, wird kein jsDelivr-Skript mehr nachgeladen.
                                    • Admin: kurzer PDF-Hinweis im Tab HTML-Export; kleine Verbesserung Quick-Start (Skripte stabiler sortiert).
                                      Doku
                                    • Kurzanleitung unter docs/user-guide/ mit Screenshots aller Konfig-Tabs (DE/EN) + Tipps zu Lesbarkeit/Datenschutz bei eigenen Bildern.

                                    ioBroker.autodoc — Update (main, v0.9.32, Stand 2026-05-08)


                                    Neu in 0.9.32

                                    • docs/user-guide/ — englische Kurzanleitung + deutsches Muster-Szenario; Platzhalter-Grafiken (SVG) und Hinweise für echte Screenshots
                                    • Admin: mehr Hilfe zu Mermaid, zu Export-Hashes und Documentation-States (z. B. documentation.exportHashes, Speicher full vs. metadata) sowie Platzhalter bei langen Feldern; KI-Registerkarte aufgeräumt ohne aktiven Provider
                                    • common.extIcon und die Guide-URLs folgen main; Icon als PNG (512×512)
                                    • CI: Workflow-Concurrency wie von ioBroker empfohlen (Adapter Checker E3009); lokales npm run check ignoriert versehentliche Bootstrap-Reste im Klon wie bei ESLint

                                    Forum (Kurzüberblick, Stand, 0.9.29–0.9.31)


                                    Neu in 0.9.31

                                    • Check „Instanzen ohne Raum“ fließt nicht mehr in den Score (war oft irreführend).
                                    • Dafür u. a.: eigenes Doku‑Kapitel mit Inhalt; KI‑Provider, wenn Skripte existieren (ohne Skripte zählt der Punkt nicht).
                                    • Alte Admin‑Felder zu „ohne Raum“ bleiben, wirken aber nicht mehr auf den Score.

                                    Neu in 0.9.30

                                    • Statt einem Wert gibt es drei Teil‑Scores: Datenerfassung · manuelle Angaben · Doku‑Tiefe, plus Gesamtpunktzahl (Durchschnitt).
                                    • Oberfläche und Texte (EN / DE / FR) angepasst.

                                    Neu in 0.9.29

                                    • User‑Ansicht „Verbundene Systeme“ als Raster‑Layout.
                                    • Mermaid: ruhigere Farben; Diagramme nach Dark/Light‑Wechsel neu gerendert.
                                    • „Ohne Raum“ nur noch für aktive Instanzen; Hinweis zu common.desc bei Skripten entfernt.
                                    • Pro Instanz wird die Adapter‑Kategorie (common.type) mit ausgewertet.

                                    Forum (Kurzüberblick, Stand 0.9.26–0.9.28)


                                    Neu in 0.9.28 (Phase 5.x.3 · Stufe 2)

                                    • Optional „Auto host topology diagram“ (autoMermaidHostGraph) + Max. Instanzen (8–80, Standard 40): zweites Mermaid-Diagramm, Adapter-Instanzen pro ioBroker-Host (Multihost sinnvoll; begrenzte Knotenzahl, Round-Robin bei vielen Instanzen). Kein vollständiger Verbindungsgraph.
                                    • Ebenfalls über mermaid ausblendbar wie das eigene Diagramm.
                                    • Anzeige z. B. in Onboarding-Begrüßung nach dem manuellen Diagramm; gleiche Hide-Logik.

                                    Neu in 0.9.27 (Phase 5.x.3 · Stufe 1)

                                    • Unter „Meine Dokumentation“: optionales Feld „Mermaid diagram“ (manualMermaidDiagram) — eigenes Diagramm (z. B. flowchart TB …).
                                    • HTML: Diagramm wird im Browser über Mermaid (CDN jsdelivr) gerendert; JavaScript aktiv und Zugriff auf das CDN sollten möglich sein, sonst bleibt Text sichtbar.
                                    • Markdown: Zusätzlicher ```mermaid-Block unter den manuellen Informationen.
                                    • Ausblenden in User/Onboarding über Kapitel-Id mermaid.

                                    Neu in 0.9.26 (Phase 5.x.2 · Quick-Start-Anpassung)

                                    • Onboarding Quick Start (HTML + Markdown): kürzerer Schnitt aus denselben Daten — 3 Setup-Zeilen, 4 Raum-Karten, 2 Highlights pro Raum (sliceQuickStartForOnboarding).
                                    • User „Überblick“: weiterhin die volle Tiefe; Einleitungstext klärt Bewohner vs. Gast; Link zum Räume-Kapitel, wenn Highlights da sind und das Kapitel nicht versteckt ist (User-HTML + User-Markdown).
                                    • KI-Zugrundelegung Nutzerprofil: weiterhin die vollen Quick-Start-Fakten.

                                    Forum (Kurzüberblick, Stand 0.9.25)

                                    • Meine Dokumentation: neues Freitextfeld ownerPlaybookNote („Ablauf / Playbook“): typische Reihenfolge, was erledigt werden muss, was Gäste oder Familie nicht ändern soll — in eigenen Worten.
                                    • Ausgabe:
                                      • eigenes Kapitel in User- und Onboarding-HTML (Navigation, wenn ausgefüllt),
                                      • im Admin-Handbuch als Unterpunkt,
                                      • im Markdown-Export unter Manual information, wenn das gewählte Dokumentationsprofil User bzw. Onboarding ist.
                                    • Ausblenden: Kapitel-Id ownerPlaybook in den JSON-Feldern auf dem Tab HTML-Export & Zusatzkapitel (User- bzw. Onboarding-Profil — ausgeblendete Kapitel).
                                    • KI: Playbook-Text fließt in den Owner-Kontext (analog zu Hilfe & Notfall / Abläufe).
                                    • Admin-UI: DE/FR für das neue Feld; Hinweis Doc layout intro präzisiert Admin-Kapitel vs. User/Onboarding-Ausblenden.
                                    • RENDERER_VERSION: 2026.04.28.5 — bei Bedarf Doku neu erzeugen.

                                    Kurz zuvor (0.9.22–0.9.24)

                                    • Doku-Setup-Score / Wartung: konfigurierbare Checks und Schwellen; einheitliche Benennung Dokumentations-Setup vs. Diagnose; Quick-Start u. a. stabile Sortierung wenn Räume die gleiche Gerätezahl haben.
                                    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 am
                                    • HomoranH Homoran verschob dieses Thema von ...nicht in offiziellem Repo am
                                    • HomoranH Homoran verschob dieses Thema von Tester am
                                    • sigi234S sigi234

                                      @crunchip

                                      Hallo,

                                      wie sehe ich Live Werte?

                                      Screenshot (1479).png

                                      crunchipC Abwesend
                                      crunchipC Abwesend
                                      crunchip
                                      Forum Testing Most Active Developer
                                      schrieb am 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; über konstruktives Feedback und Tipps freue ich mich sehr.
                                        Bei der Entwicklung habe ich u. a. Perplexity, Claude und zuletzt Cursor genutzt.
                                        Was der Adapter heute schon kann
                                        Aus eurer Installation werden HTML-, Markdown- und JSON-Dokumente 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 Datenpunkte, …)
                                        • User / Familie — Alltagssprache, Räume und Funktionen ohne „Technik-Wände“
                                        • Onboarding / Gäste — Willkommen, Orientierung, QR zum Teilen der Seite, ohne Admin-Jargon
                                          Optional: KI (z. B. Ollama lokal oder andere Anbieter), getrennt nach Bewohner- und Gäste-Profil — nur wenn ihr es einschaltet. Es werden keine Live-Daten von der Installation „von der KI ausgelesen“; es geht nur der vorbereitete Dokutext an den gewählten Dienst.
                                          Aktuell liegt der Fokus auf stabiler Dokuerzeugung 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.)
                                        → Instanz neu starten; bei Bedarf im Adapterordner npm install (u. a. Paket qrcode, optional für erweiterte Toolchains siehe README).
                                        Ein stabiler Liste-Install wie bei npm-Adaptern folgt später mit npm und Eintrag in ioBroker.repositories — bis dahin ist der Weg über Git/Tarball normal.

                                        Links

                                        • Repo: https://github.com/crunchip77/ioBroker.autodoc
                                        • Issues / Wünsche: https://github.com/crunchip77/ioBroker.autodoc/issues
                                        • Kurzanleitungen im Repo: User-Guide EN · Szenario DE
                                          Ich freue mich über Erfahrungsberichte, Screenshots und konkrete Wünsche für die nächsten Schritte.

                                        ioBroker.autodoc — Update (main, v0.9.34, Stand 2026-05-08)

                                        Neu seit dem letzten Foren-Post (0.9.32 → jetzt)

                                        0.9.33

                                        • Optional PDF-Export (drei Dateien: Admin / User / Onboarding), wenn puppeteer im Adapterordner installiert ist. Ohne das: unverändert nur HTML & Co. Zusätzlich Datenpunkt, um nur PDF zu erzeugen.
                                          0.9.34
                                        • documentation.exportHashes berücksichtigt nach einem gelingenden PDF-Lauf auch die PDF-Dateien.
                                        • Mermaid: Wenn Diagramme schon eingebettet sind, wird kein jsDelivr-Skript mehr nachgeladen.
                                        • Admin: kurzer PDF-Hinweis im Tab HTML-Export; kleine Verbesserung Quick-Start (Skripte stabiler sortiert).
                                          Doku
                                        • Kurzanleitung unter docs/user-guide/ mit Screenshots aller Konfig-Tabs (DE/EN) + Tipps zu Lesbarkeit/Datenschutz bei eigenen Bildern.

                                        ioBroker.autodoc — Update (main, v0.9.32, Stand 2026-05-08)


                                        Neu in 0.9.32

                                        • docs/user-guide/ — englische Kurzanleitung + deutsches Muster-Szenario; Platzhalter-Grafiken (SVG) und Hinweise für echte Screenshots
                                        • Admin: mehr Hilfe zu Mermaid, zu Export-Hashes und Documentation-States (z. B. documentation.exportHashes, Speicher full vs. metadata) sowie Platzhalter bei langen Feldern; KI-Registerkarte aufgeräumt ohne aktiven Provider
                                        • common.extIcon und die Guide-URLs folgen main; Icon als PNG (512×512)
                                        • CI: Workflow-Concurrency wie von ioBroker empfohlen (Adapter Checker E3009); lokales npm run check ignoriert versehentliche Bootstrap-Reste im Klon wie bei ESLint

                                        Forum (Kurzüberblick, Stand, 0.9.29–0.9.31)


                                        Neu in 0.9.31

                                        • Check „Instanzen ohne Raum“ fließt nicht mehr in den Score (war oft irreführend).
                                        • Dafür u. a.: eigenes Doku‑Kapitel mit Inhalt; KI‑Provider, wenn Skripte existieren (ohne Skripte zählt der Punkt nicht).
                                        • Alte Admin‑Felder zu „ohne Raum“ bleiben, wirken aber nicht mehr auf den Score.

                                        Neu in 0.9.30

                                        • Statt einem Wert gibt es drei Teil‑Scores: Datenerfassung · manuelle Angaben · Doku‑Tiefe, plus Gesamtpunktzahl (Durchschnitt).
                                        • Oberfläche und Texte (EN / DE / FR) angepasst.

                                        Neu in 0.9.29

                                        • User‑Ansicht „Verbundene Systeme“ als Raster‑Layout.
                                        • Mermaid: ruhigere Farben; Diagramme nach Dark/Light‑Wechsel neu gerendert.
                                        • „Ohne Raum“ nur noch für aktive Instanzen; Hinweis zu common.desc bei Skripten entfernt.
                                        • Pro Instanz wird die Adapter‑Kategorie (common.type) mit ausgewertet.

                                        Forum (Kurzüberblick, Stand 0.9.26–0.9.28)


                                        Neu in 0.9.28 (Phase 5.x.3 · Stufe 2)

                                        • Optional „Auto host topology diagram“ (autoMermaidHostGraph) + Max. Instanzen (8–80, Standard 40): zweites Mermaid-Diagramm, Adapter-Instanzen pro ioBroker-Host (Multihost sinnvoll; begrenzte Knotenzahl, Round-Robin bei vielen Instanzen). Kein vollständiger Verbindungsgraph.
                                        • Ebenfalls über mermaid ausblendbar wie das eigene Diagramm.
                                        • Anzeige z. B. in Onboarding-Begrüßung nach dem manuellen Diagramm; gleiche Hide-Logik.

                                        Neu in 0.9.27 (Phase 5.x.3 · Stufe 1)

                                        • Unter „Meine Dokumentation“: optionales Feld „Mermaid diagram“ (manualMermaidDiagram) — eigenes Diagramm (z. B. flowchart TB …).
                                        • HTML: Diagramm wird im Browser über Mermaid (CDN jsdelivr) gerendert; JavaScript aktiv und Zugriff auf das CDN sollten möglich sein, sonst bleibt Text sichtbar.
                                        • Markdown: Zusätzlicher ```mermaid-Block unter den manuellen Informationen.
                                        • Ausblenden in User/Onboarding über Kapitel-Id mermaid.

                                        Neu in 0.9.26 (Phase 5.x.2 · Quick-Start-Anpassung)

                                        • Onboarding Quick Start (HTML + Markdown): kürzerer Schnitt aus denselben Daten — 3 Setup-Zeilen, 4 Raum-Karten, 2 Highlights pro Raum (sliceQuickStartForOnboarding).
                                        • User „Überblick“: weiterhin die volle Tiefe; Einleitungstext klärt Bewohner vs. Gast; Link zum Räume-Kapitel, wenn Highlights da sind und das Kapitel nicht versteckt ist (User-HTML + User-Markdown).
                                        • KI-Zugrundelegung Nutzerprofil: weiterhin die vollen Quick-Start-Fakten.

                                        Forum (Kurzüberblick, Stand 0.9.25)

                                        • Meine Dokumentation: neues Freitextfeld ownerPlaybookNote („Ablauf / Playbook“): typische Reihenfolge, was erledigt werden muss, was Gäste oder Familie nicht ändern soll — in eigenen Worten.
                                        • Ausgabe:
                                          • eigenes Kapitel in User- und Onboarding-HTML (Navigation, wenn ausgefüllt),
                                          • im Admin-Handbuch als Unterpunkt,
                                          • im Markdown-Export unter Manual information, wenn das gewählte Dokumentationsprofil User bzw. Onboarding ist.
                                        • Ausblenden: Kapitel-Id ownerPlaybook in den JSON-Feldern auf dem Tab HTML-Export & Zusatzkapitel (User- bzw. Onboarding-Profil — ausgeblendete Kapitel).
                                        • KI: Playbook-Text fließt in den Owner-Kontext (analog zu Hilfe & Notfall / Abläufe).
                                        • Admin-UI: DE/FR für das neue Feld; Hinweis Doc layout intro präzisiert Admin-Kapitel vs. User/Onboarding-Ausblenden.
                                        • RENDERER_VERSION: 2026.04.28.5 — bei Bedarf Doku neu erzeugen.

                                        Kurz zuvor (0.9.22–0.9.24)

                                        • Doku-Setup-Score / Wartung: konfigurierbare Checks und Schwellen; einheitliche Benennung Dokumentations-Setup vs. Diagnose; Quick-Start u. a. stabile Sortierung wenn Räume die gleiche Gerätezahl haben.
                                        sigi234S Online
                                        sigi234S Online
                                        sigi234
                                        Forum Testing Most Active
                                        schrieb am 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 am 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 3 Antworten 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

                                          464

                                          Online

                                          32.8k

                                          Benutzer

                                          82.9k

                                          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