Zum Inhalt springen

Handbuch

Kontext und Index

Dateien, Anhänge, Kontextbudgets und die unterschiedlichen Datei- und Semantikindexaktionen verstehen.

Geprüfter CLI-Quellstand: 2.4.0 · Redaktionell aktualisiert:

Dateien und Ordner referenzieren

Tippen Sie @ im Chat und suchen Sie nach einer Datei oder einem Ordner. Mit ↑/↓ wählen Sie einen Eintrag; Tab oder Enter übernimmt ihn, Escape schließt die Auswahl. Ein Anhang dient als Kontextreferenz und erteilt keine allgemeine Zugriffsfreigabe. Secrets und Pfade außerhalb des Projekts benötigen weiterhin gezielte Zustimmung.

Explain @src/example.ts and its tests without edits.
/context
/detach 1

Ersetzen Sie die Beispielpfade durch vorhandene Dateien. /context zeigt die Zusammensetzung des Kontexts, den Tokenverbrauch und das verbleibende Budget. /detach [Index|Name/Pfadfragment], auch als /drop verfügbar, entfernt ohne Argument alle Referenzen. Mit einem Argument entfernt es den Eintrag mit dem bei 1 beginnenden Index oder die erste passende Referenz. Die Dateien bleiben bestehen.

Bei leerem Eingabefeld entfernt Ctrl+D alle Anhänge, Backspace den letzten. Meta+Enter erzeugt eine neue Eingabezeile. Die Unterstützung dieser Tastenkombinationen hängt vom Terminal ab.

Clipboard und zusätzlicher Kontext

/copy kopiert die letzte Agentantwort in die Zwischenablage des Betriebssystems. Dafür müssen die nötigen Plattformprogramme installiert sein. /paste speichert ein Bild aus der Zwischenablage und hängt es an, ohne sofort einen Prompt zu senden. Die Datei kann bestehen bleiben, auch wenn das Modell den Anhang nicht unterstützt.

lurus chat --add-dir ../shared

--add-dir <dirs...> nimmt zusätzliche Verzeichnisse auf. Pfadgrenzen und Freigaberegeln gelten weiterhin; die Option erlaubt nicht automatisch den Zugriff auf jede lokale Datei. Prüfen Sie vorab, ob das Modell die gewünschten Bild- oder Dokumentanhänge unterstützt, insbesondere PDFs.

Drei unterschiedliche Wartungsaktionen

AktionWirkung
/compress, Alias /compactKomprimiert den Gesprächskontext. Dabei können Details verloren gehen; der Vorgang kann auch ohne Änderung enden oder fehlschlagen.
/refresh, Alias /reindexErneuert Dateisuchcache für @, nicht semantischen Index.
/indexing rebuildBaut semantischen Index neu, nur wenn aktiv.
/indexing
/indexing off
/indexing on
/indexing rebuild
/indexing clear
/indexing delete

Ohne Argument zeigt /indexing den Status. on und off ändern die aktuelle Einstellung und speichern einen Projektwert. clear und delete entfernen Indexdaten, lassen die Einstellung aber unverändert. rebuild ist nur bei aktiver Indexierung verfügbar. Dieser Slashbefehl hat kein --global-Flag.

Nach einem Neustart: Der Projektwert für indexing wird beim normalen Laden der Einstellungen nicht übernommen. /indexing off ist deshalb kein verlässlicher dauerhafter Opt-out. Für eine dauerhafte lokale Deaktivierung setzen Sie global "indexing": false in ~/.lurus/settings.json. Eine Deaktivierung im Konto kann eine lokale Aktivierung weiterhin verhindern. Das Löschen des Index ist nicht dasselbe wie das Ändern der Einstellung oder der Kontorichtlinie.

Budget und Memory

contextBudget beträgt standardmäßig 15.000 Tokens. Davon sind 30 % für Memory vorgesehen. Das Budget begrenzt den Memoryblock, nicht verpflichtende Anweisungen oder das gesamte Kontextfenster des Modells. /max schaltet zwischen dem vollständigen Modellfenster und der normalen Grenze um; eine Komprimierung kann trotzdem nötig sein. /context, /cost und /stats zeigen unterschiedliche Informationen zu Kontext, Kosten und Nutzung.

Hängen Sie relevante Dateien gezielt an, prüfen Sie /context und entfernen Sie unnötige Referenzen. Komprimieren Sie nur, wenn ein möglicher Detailverlust vertretbar ist. Erneuern Sie anschließend bei Bedarf den Dateisuchcache oder den semantischen Index passend zum Problem. Eine neue Aufgabe starten Sie mit /task new, nicht mit /reindex.

Fehlersuche

Fehlt eine Datei in der @-Auswahl, prüfen Sie Projektverzeichnis, Pfad und Zugriff und verwenden Sie /refresh. Fehlt die semantische Suche, prüfen Sie die globale Einstellung, die Kontofreigabe und /indexing. Geht eine Deaktivierung beim Neustart verloren, beachten Sie die oben beschriebene Einschränkung des Projektwerts. Das Entfernen eines Anhangs löscht keine Datei; /paste kann zuvor eine Datei angelegt haben.

Weiter: Einstellungen, Sitzungen, Memory.

Eine bewusste Entscheidung

Vor dem ersten Prompt.

Interaktive Demo
Lurus Codeprivacy-demo · beispielhafter Workspace

Demo-Sitzung bereit. Modellwahl und Datenweg sind getrennte Entscheidungen.

Inszeniertes Beispiel. Keine echte Anmeldung, Sicherheitsprüfung oder Codeübertragung.

Bildvorschau