Tuning-Referenz — Umgebungsvariablen

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end -->

Alle Parameter, die Tesserae aus der Umgebung liest, ihre Standardwerte und wann Sie diese tatsächlich ändern möchten. Hier ist nichts erforderlich: die Standardwerte werden gewählt, damit ein einfaches tesserae compile das Richtige tut.

Die Projekt- und globale Konfiguration (.tesserae/config.json, ~/.tesserae/config.json) haben Vorrang vor den LLM-Backend-Einstellungen; die Umgebungsvariablen unten setzen beide in der Ausführung, in der sie gesetzt sind, außer Kraft.

Hooks die Geld kosten

Das Claude Code Plugin liefert Hooks, die eine Kompilierung im Hintergrund ausführen können. Alles, das Geld kostet, ist standardmäßig deaktiviert:

export TESSERAE_HOOK_AUTOCOMPILE=1   # opt in to automatic recompiles

Gated: posttooluse-edit.sh (wird bei jedem Edit/Write ausgelöst) und session-end.sh. Nicht gated, weil sie nichts kosten: session-start.sh führt deterministisches code sync aus, und pretooluse-compile.sh fängt nur einen tesserae compile Befehl ab, den du selbst eingegeben hast.

Dieser Standard existiert, weil die Alternative gemessen wurde. Eine Wissensbasis in ~/.tesserae lässt $HOME wie einen Projektstamm aussehen, und der Hook-Resolver wanderte aufwärts vom Arbeitsverzeichnis zum ersten .tesserae/, das er fand — so dass jede Sitzung außerhalb eines registrierten Projekts zu $HOME auflöste und die gesamte Home-Verzeichnis kompilierte: 15k Dateien, ein 795 MB Graph, ~10 Stunden LLM-Ausgaben, von einem detached Prozess, der die Sitzung überlebte, die ihn startete.

resolve_project_root() weigert sich jetzt $HOME durch beide Pfade, und gibt eine leere Antwort zurück anstatt auf das Arbeitsverzeichnis zurückzufallen, daher no-op Aufrufer anstatt zu raten. Ein Hook, der Model-Arbeit im Hintergrund ausführt, sollte absichtlich aktiviert werden, nicht nach der Rechnung deaktiviert werden.

Extraktion

TESSERAE_EXTRACT_TIMEOUT

Standard 1800 (Sekunden), pro Versuch. Begrenzt jeden codex/claude-Extraktionsaufruf, damit ein steckengebliebener CLI-Kindprozess kein Kompilieren aufhängen kann.

Dies ist passiert: Ein Kompilieren wurde bei 0% CPU für 5 h 43 m beobachtet, hinter einem codex exec-Kindprozess, der 4 h 6 m lang untätig war und .tesserae/compile.lock die ganze Zeit hielt. Er hatte bereits 32 Community-Zusammenfassungen im Speicher aufgebaut und schaffte es nie, sie zu persistieren.

Pro Versuch, nicht pro Dokument — bei Timeout rotiert der Client zum nächsten CODEX_HOME / claude Konfigurationsverzeichnis, daher ist der schlechteste Fall für ein Dokument timeout × konfigurierte Profile.

export TESSERAE_EXTRACT_TIMEOUT=3600   # mehr Spielraum für sehr große Dokumente
export TESSERAE_EXTRACT_TIMEOUT=0      # kein Cutoff — bis zum Abschluss ausführen

Ein Wert, der gesetzt aber nicht verwendbar ist (10m, 600s, negativ, inf), warnt auf stderr und behält den Standard. Ein Tippfehler darf ein Sicherheitsventil nicht stillschweigend deaktivieren.

TESSERAE_EXTRACT_CONCURRENCY

Standard 4. Dokumente, die parallel extrahiert werden. Jedes ist ein blockierender CLI-Kindprozess, der etwa eine Minute dauert, daher macht eine sequenzielle Schleife die Wanduhr zur buchstäblichen Summe jedes Modell-Roundtrips — gemessen mit ~2 h 40 m für 161 Dokumente.

Die Obergrenze ist die Rate-Limit-Grenze Ihres Provider-Kontos, nicht Ihrer Maschine, daher ist der Standard bescheiden. Setzen Sie 1 für streng sequenzielles Verhalten.

Concurrency ändert nie die Ausgabe: Die Arbeitsliste ist in Pfadreihenfolge behoben und Ergebnisse werden nach Index gesammelt, daher ist eine parallele Ausführung byte-identisch mit einer sequenziellen.

TESSERAE_LLM_CACHE

Standard ein. Inhaltsadressierter Cache von CLI-Provider-Antworten unter ~/.tesserae/llm_cache, indiziert nach (Dokument, Art, Leitfaden) sowie Modell und Reasoning Effort — daher fragt das Wechseln von Modellen erneut ab, anstatt frühere Modell-Antworten zu servieren. Nur parsierbare Antworten werden gespeichert, daher kann eine schlechte Generierung nicht dauerhaft werden.

export TESSERAE_LLM_CACHE=0   # immer erneut fragen

TESSERAE_LLM_CHUNK_CHARS

Zeichen pro Chunk, wenn ein Dokument zu groß für einen Aufruf ist. Lassen Sie ungesetzt, es sei denn, Sie stoßen auf Kontext-Limits.

LLM-Backend

tesserae config status gibt das aufgelöste Backend aus und prüft es auf Verfügbarkeit.

Kompilierungs-Pässe

Zu Community-Summaries: Der Kompilierungs-Pass deckt eifrig die gröbste Ebene ab; graph_map materialisiert zusätzlich lazy eine Summary beim ersten Abstieg in einen cold Scope, gecacht pro Ebene. Das Ausschalten des Passes ist eine legitime Cost-Strategie — Sie zahlen nur für tatsächlich besuchte Zweige — mit einer Warnung: Föderales Abstieg materialisiert niemals lazy. Karten eines Geschwister-Projekts können nur aus seinen In-Graph-Summaries oder bereits-warmen Caches benannt werden, daher möchte ein Projekt, das Sie cross-project navigieren, den eifrigen Pass ein.

Abfrage und Synthese

Pfade und Infrastruktur

Wiederherstellung eines degradierten Corpus

Wenn die Extraktion für ein Dokument fehlschlägt, wird es von der deterministischen Basislinie bedient und markiert in .tesserae/manifest.json. Ohne die Markierung wäre es von einer sauberen Extraktion nicht zu unterscheiden, daher würde --changed-only es für immer überspringen und die Degradation wäre permanent, bis sich der Dateiinhalt ändert.

tesserae compile --changed-only --retry-fallbacks

Versucht nur die markierten Dokumente erneut; saubere bleiben übersprungen.

Inspizieren der Hierarchie

tesserae graph-map                          # root map
tesserae graph-map --scope <scope_id>       # hinabsteigen
tesserae graph-map --scope '<alias>::'      # ein geschwister registriertes Projekt

Jede Karte meldet size und leaf_member_count aus der Hierarchie-Sidecar, plus live_member_count — wie viele Mitglieder der aktuelle Graph tatsächlich trägt. Ein 0 dort bedeutet der Scope ist tot (Sidecar/Graph-Skew): überspringen Sie ihn, anstatt hinabzusteigen.

Agenten schreiben in den Graphen

\graph_write\ (MCP) nimmt schemavalidierte typisierte Knoten und Kanten mit verbindlicher Herkunft, sodass ein Agent einen Fund als Struktur statt als Prosa aufzeichnet, deren Typen ein Extraktor erraten muss.

Es lehnt ab statt zu erzwingen: Untypte Kanten, Knoten- oder Kantentypen außerhalb des kontrollierten Vokabulars, baumelnde Endpunkte und Schreibvorgänge ohne Herkunft werden alle abgelehnt. Doppelte Schreibvorgänge sind idempotent. Von Agenten geschriebene Knoten überleben eine vollständige Neukompilierung, gelöschtes \graph.json\, \--limit\ und vollständige Corpus-Löschung.

Eine Behauptung gegen den Graphen überprüfen

\verify_claim\ (MCP) antwortet, ob der Graph ein Triple lizenziert. Es nimmt \(subject, predicate, object)\ — es gibt keinen Parameter in natürlicher Sprache, absichtlich, weil ein Parser die vorherige Version dazu brachte, auf die Negation einer Behauptung, die sie unterstützte, mit SUPPORTED zu antworten.

Das Urteil ist eine reine Funktion der Graph-Bytes: kein LLM, keine Einbettung, nirgends auf dem Entscheidungsweg Fuzzy-Matching.

Es gibt zwei Dinge, die es absichtlich nicht tut. Es behandelt \supersedes\ nie als Widerlegung — diese Beziehung sagt, dass ein Knoten ersetzt wurde, nicht dass ein Triple falsch ist. Und ein Agent-Write kann nur eine Herkunftsklasse schwächen, niemals eine aktualisieren, also kann nichts, das ein Agent behauptet, als dokumentgestützt dargestellt werden.

Es ist wissenswert beim Lesen von Ergebnissen: auf einem echten Graph mit 15.284 Kanten sind etwa 40% der \SUPPORTED\-Urteile tautologisch — \evidenced_by\-Kanten, deren zitierter Span das eigene Ziel der Kante ist. Wahr, aber nicht informativ.

Eine Frage weiterleiten

\tesserae ask\ wählt einen Abrufpfad nach Frageform aus: Einfache Entitätssuchen gehen zu günstig Backend, Multi-Hop / "was hat sich geändert" / "warum" / Corpus-breite Fragen gehen zum Graph. Unabhängige Benchmarks zeigen, dass Graphen bei Multi-Hop-, Zeit- und Synthesefragen führend sind und bei einfacher Faktsuche und Kosten hinterherhinken — also an jedem Graphen-Preisen für jede Frage zu zahlen ist ein Verlust.

Die Entscheidung wird in dem zurückgegebenen Umschlag angezeigt, daher ist eine billige Antwort prüfbar. Überschreiben Sie es mit \--route\ auf der CLI oder dem Parameter \route\ im MCP-Tool.

REGELN:

• NICHT übersetzen: graph_write, verify_claim, SUPPORTED, PRESENT_UNEVIDENCED, CONTRADICTED, DISPUTED_UNEVIDENCED, CONFLICTING, ABSENT, NOT_RESOLVABLE, supersedes, contradicts_claim, evidenced_by, subject, predicate, object, MCP, --route
• Behalten Sie alle Zahlen genau bei: 15.284, 40 %
• Behalten Sie die Tabellenstruktur mit denselben Spaltenkopfzeilen bei
• Übersetzen Sie die Prosa für jede Sprache natürlich
• Fügen Sie am Ende jeder Datei an, ohne vorhandene Inhalte zu stören