chat export

chat export schreibt eine ganze Konversation als Markdown-Notiz vom Typ conversation in den Vault. Die Notiz enthält den Frage-Antwort-Verlauf in ## Frage (Zeit­stempel) / ## Antwort-Sektionen und listet im Frontmatter-Feld references: die NanoIDs aller Entitäten, die das Sprachmodell in seinen Antworten zitiert hat. Im Frontmatter stehen außerdem model: und endpoint: — das Sprachmodell und der Dienst, die beim Start der Konversation eingefroren wurden, sodass beim späteren Lesen klar ist, womit die Antworten erzeugt wurden.

Wofür ist das?

• Eine wertvolle Recherche festhalten. Eine Konversation hat ein gutes Ergebnis hervorgebracht — du willst sowohl die Frage als auch die Antwort langfristig im Vault haben, suchbar, verlinkt, Teil deiner Sammlung.
• Den Dialog selbst kommentieren. Die exportierte Notiz läuft danach durch den normalen Graph- und Vektor-Index — sie taucht in zukünftigen Suchen auf, du kannst sie weiter­bearbeiten und mit eigenen Notizen verknüpfen.
• Vor dem Löschen sichern. Ergänzend zu chat delete: den Dialog erst exportieren, dann den Eintrag aus dem Konversations-Speicher entfernen.

Die Variante, die nur die fachliche Substanz einer einzelnen Antwort als Notiz übernimmt — ohne Frage-Bezug, mit Reformulierungs-Pass — ist chat synthesize.

Aufruf

apparat chat export V1StGXAA --title="Recherche zu WCAG-Kontrast"
apparat chat export V1StGXAA --vault=demo --type=conversation --language=de
apparat chat export V1StGXAA --title="…" --force

Das Kommando läuft host-lokal — kein Sprachmodell-Aufruf, nur Lese­zugriff auf die Konversation und auf den Graphen plus den regulären Vault-Schreibvorgang.

Beispielausgabe

$ apparat chat export V1StGXAA --title="Recherche zu Personen im Demo-Vault" --vault=demo
Conversation: V1StGXAA
  Title:      Recherche zu Personen im Demo-Vault
  Type:       conversation
  Language:   de
  Created:    2026-05-02
  References: 4 (existing: 3, dropped: 1)
⚠ 1 cited NanoID(s) no longer resolve in the vault and will not appear in `references`: ZzZz9999
 Write "Recherche zu Personen im Demo-Vault" to vault "demo"? [Y/n] y
✅ Exported conversation "V1StGXAA" as entity "Q9pLm2nP" (2026-05-02--recherche-zu-personen-im-demo-vault--Q9pLm2nP.md).

Die Vorschau führt vier Felder an, die die Schreibe steuern:

• References: N (existing: M, dropped: K) — wie viele NanoID-Tokens das Modell in seinen Antworten genannt hat (N), wie viele davon noch im Graph existieren (M) und wie viele nicht mehr (K).
• Falls K > 0: ein gelber Hinweis nennt die nicht mehr auflösbaren NanoIDs. Sie werden nicht in references: aufgenommen — die Notiz würde sonst tote Verweise schreiben.

Eine --no-interaction-Variante ohne --force bricht mit ❌ Refusing to write in --no-interaction mode without --force. ab. Eine --no-interaction-Variante ohne --title bricht mit ❌ --title is required in --no-interaction mode (conversation has no stored title). ab.

Aufbau der geschriebenen Notiz

---
type: conversation
created: 2026-05-02
title: "Recherche zu Personen im Demo-Vault"
language: de
references:
  - V1StGXAA
  - Bx7tYu3v
  - c9d4mNaA
---

## Frage (2026-04-30 15:50)

Welche Personen kennt der Vault?

## Antwort

Im Vault sind aktuell zehn Personen erfasst, …

Die Sektionsüberschriften folgen der über --language gewählten Sprache: ein englischer Export schreibt entsprechend ## Question (…) / ## Answer.

Werkzeug-Returns aus dem Verlauf werden bewusst nicht in die Notiz übernommen — sie sind technisches Zwischen­material, das eine spätere Lese­erfahrung der Notiz nur belasten würde.

Zitate, die das Modell in seinen Antworten als [Title](nano_id) formuliert hat, werden vor dem Schreiben in die kanonische Form [Title](./<dateiname>.md) gebracht — die exportierte Notiz hat damit funktionierende relative Links auf alle erwähnten Entitäten, ohne dass entity edit noch einmal nachsehen muss. Eine NanoID, die zum Zeitpunkt des Exports keiner Vault-Datei mehr entspricht, bleibt als roher [Title](nano_id)-Link erhalten und taucht zusätzlich in der oben gezeigten Warnzeile auf — so erkennst du tote Verweise sofort.

Was passiert nach dem Export

Die neue Notiz ist eine ganz normale Vault-Entität. Der nächste graph rebuild (oder der Hintergrund-Watcher, wenn er läuft) nimmt sie in den Beziehungs-Graph auf; der Embedding-Worker ergänzt sie im Vektor-Index. Du kannst sie über entity show inspizieren, mit entity edit erweitern und über entity link mit anderen Entitäten verknüpfen.

Der Konversations-Eintrag im vault-lokalen Speicher bleibt unverändert — chat export ist eine reine Lese­operation auf der Konversation. Wer die Konversation danach loswerden will, ruft anschließend chat delete auf.

Exit-Codes

Verwandt

• chat synthesize — eine einzelne Antwort als eigenständige Notiz, ohne Frage-Bezug, mit Reformulierungs-Pass.
• chat show — den Verlauf vorab inspizieren.
• chat delete — die Konversation nach dem Export aus dem Speicher entfernen.
• entity show — die exportierte Notiz inspizieren.