OKF-Bundle exportieren & KB OKF-tauglich halten
AdminCompanyWizard kann Wissen als OKF-Bundle ausgeben — ein herstellerneutrales, portables Paket aus Markdown-Dateien. Was OKF ist und warum, erklärt der Konzeptartikel Open Knowledge Format (OKF). Dieser Artikel zeigt, was Sie als Admin dafür tun.
Ein OKF-Bundle exportieren
Section titled “Ein OKF-Bundle exportieren”Der Export ist eine Admin-Aktion auf Ordner- oder Vault-Ebene:
- Im Kontextmenü eines Ordners bzw. Vaults „Als OKF-Bundle exportieren” wählen.
- Im Dialog den Scope-Hinweis prüfen (welcher Bereich exportiert wird) und entscheiden, ob die Checkbox „Vertrauliche/geheime Inhalte einschließen” gesetzt wird — sie ist standardmäßig aus.
- Bundle als
.zipherunterladen.
Der Export-Dialog auf Ordner-Ebene — Scope-Hinweis, die standardmäßig deaktivierte Checkbox und der Export-Button.
Ohne Übersteuerung exportiert der Standardlauf nur die Stufen public und internal. Erfüllt das Ergebnis die OKF-Konformität nicht (z. B. fehlende index.md), erscheint das als eigener Konformitäts-Hinweis (HTTP 422) — klar unterscheidbar von „Download fehlgeschlagen”.
Was der Export macht
Section titled “Was der Export macht”Der Export projiziert, statt zu mutieren — der Live-Vault bleibt unverändert. Auf dem Weg ins Bundle:
- RBAC-Felder (
classification,access_roles) werden entfernt. - Links werden auf bundle-relative Form umgeschrieben.
- Je Ordner wird eine frontmatter-lose
index.mderzeugt.
Ein Validator prüft die projizierte Ausgabe gegen die OKF-Konformitätsregeln (§9); grün heißt: das Bundle ist OKF-v0.1-konform.
Die Wissensbasis OKF-tauglich halten
Section titled “Die Wissensbasis OKF-tauglich halten”Zwei idempotente Admin-Wartungsaktionen halten die KB in Form (RBAC bleibt dabei erhalten):
- Frontmatter-Normalisierung — sorgt für ein durchgängiges
type-Feld und saubere Zeitstempel. description-Backfill — ergänzt fehlende Beschreibungen aus dem ersten Absatz, sonst per LLM.
Beides zahlt direkt auf OKF ein (das von durchgängigem type/description profitiert) und verbessert nebenbei die eigenen Such-Snippets.
Import über cw-import
Section titled “Import über cw-import”Das Dokument-Import-Werkzeug cw-import (PDF/DOCX/HTML/Confluence/SharePoint → KB-Markdown) ist der Standardweg, Inhalte in die Wissensbasis einzuspeisen. Es erzeugt bereits beim Import OKF-taugliche Frontmatter inklusive description (Absatz-first, LLM-Fallback) — neu importierte Artikel landen also nicht ohne Beschreibung im Vault. Ablauf siehe Ein Dokument importieren und freigeben.
Für MCP-Konsumenten
Section titled “Für MCP-Konsumenten”Über die CompanyWizard-MCP-Schnittstelle liefern die Read-Projektionen okf_read und okf_tree eine OKF-Sicht auf den Vault — hinter dem RBAC-Gate, also pro Aufrufer gefiltert und strukturell ohne Leak. Kontext zur MCP-Anbindung: Einen MCP-Server verbinden.
Ausblick: OKF-Import
Section titled “Ausblick: OKF-Import”Der umgekehrte Weg — ein fremdes OKF-Bundle in die KB importieren — ist noch nicht verfügbar und als Folgefeature geplant. Bis dahin ist der Standard-Importweg cw-import.