Skip to content

EXPORTFORMAT.md

Latest commit

 

History

History
103 lines (89 loc) · 3.2 KB

EXPORTFORMAT.md

File metadata and controls

103 lines (89 loc) · 3.2 KB
Raw

Exportformat -- notespacellm-workspace-v1

Stand: 2026-06-05

Zweck

notespacellm-workspace-v1.json ist der Austauschvertrag zwischen der Desktop-App und Web-/PWA-/Mobile-Companions. Das Format ermöglicht mobile Recherche- und Review-Workflows, ohne lokale Rohdatenordner, Vektordatenbanken oder API-Schlüssel zu kopieren.

Der erste Consumer liegt unter web_companion/: ein read-only PWA-Reader, der Workspace-JSON lokal im Browser importiert, Bericht und Dokumentmetadaten anzeigt, den zuletzt geladenen Workspace offline wiederherstellt und eigene Review-Notizen als Markdown exportiert.

Implementierungsstatus

  • Desktop-Export ist umgesetzt: src/core/workspace_exporter.py erzeugt das Payload und schreibt es atomar als UTF-8-JSON.
  • GUI-Auslöser ist vorhanden: Datei -> Workspace exportieren (JSON)....
  • Tests: tests/test_workspace_export.py deckt Schema, Datenschutzregeln, UTF-8, atomare Ausgabe und Auszugslogik ab.
  • Web/PWA-Companion validiert und liest das Format über web_companion/library.js und web_companion/tests/library.test.mjs.

Datenschutzregeln

  • API-Schlüssel werden nie exportiert.
  • chroma_db/, lokale Datenbanken und Cache-Verzeichnisse werden nie exportiert.
  • Rohdokumente werden standardmäßig nicht eingebettet.
  • Dokumentauszüge werden nur exportiert, wenn sie bereits für Bericht, Chat, Prompt oder Review ausgewählt wurden.
  • Externe Provider werden nur als Typ und Konfigurationshinweis dokumentiert, nicht mit geheimen Werten.
  • Lokale absolute Pfade werden auf redigierte Hinweise oder relative path_hint-Werte reduziert.

Minimales Schema

{
  "schema_version": "notespacellm-workspace-v1",
  "app": {
    "name": "NoteSpaceLLM",
    "version": "1.0.0",
    "exported_at": "2026-05-26T00:00:00Z"
  },
  "workspace": {
    "title": "Projektname",
    "question": "Zentrale Fragestellung",
    "workflow_type": "analysis",
    "locale": "de"
  },
  "documents": [
    {
      "id": "doc-1",
      "name": "quelle.pdf",
      "path_hint": "quelle.pdf",
      "format": "pdf",
      "selected": true,
      "content_included": false,
      "excerpts": [
        {
          "id": "doc-1-excerpt-1",
          "text": "Kurzer ausgewählter Auszug.",
          "source_hint": "Seite 3"
        }
      ]
    }
  ],
  "report": {
    "title": "Bericht",
    "format": "markdown",
    "content": "# Bericht\n\n..."
  },
  "chat": {
    "messages": []
  },
  "provider": {
    "mode": "local-or-remote",
    "name": "ollama",
    "secret_exported": false
  }
}

Erweiterungsregeln

  • Neue optionale Felder sind erlaubt, solange bestehende Felder ihre Bedeutung behalten.
  • Consumer müssen unbekannte Felder ignorieren.
  • Breaking Changes erhöhen den Schema-Namen auf notespacellm-workspace-v2.
  • Große Binärdateien bleiben außerhalb des JSON und werden nur über optionale Manifeste referenziert.

Nächste Format-Aufgaben

  • Companion-Rückkanal erst definieren, wenn echte Review-Notizen reimportiert werden sollen.
  • Geräte-Smokes gegen web_companion/PWA_TESTPLAN.md mit realen Android-/iOS- oder Emulatorumgebungen durchführen.
  • Bei Bedarf ein separates optionales Rohdokument-Manifest entwerfen; nicht als Standardbestandteil des Workspace-JSON.