Dateien und Terminal

Anyy kann Dateien lesen und durchsuchen, gezielt bearbeiten, Shell-Befehle ausführen und Hintergrundprozesssitzungen verwalten. Diese Werkzeuge sind besonders nützlich, wenn die Sitzung einen klaren Workspace und ein klares Ziel hat.

Dateiwerkzeuge

Fähigkeit	Verhalten
Lesen	Liest Text oder unterstützte JPEG-/PNG-/GIF-/WebP-/BMP-Bilder; großer Text wird begrenzt
Auflisten	Listet ein Verzeichnis alphabetisch einschließlich Punktdateien
Finden	Sucht Pfade per Glob unter Beachtung von .gitignore
Grep	Durchsucht Dateiinhalte mit Pfaden und Zeilennummern unter Beachtung von .gitignore
Schreiben	Erstellt oder überschreibt eine Datei und erstellt Elternverzeichnisse
Bearbeiten	Ersetzt exakte, eindeutige, nicht überlappende Textbereiche in einer Datei

Suchergebnisse und Lesevorgänge sind bewusst begrenzt. Bitten Sie Anyy, ab einem Offset fortzufahren oder die Suche einzugrenzen, statt abgeschnittene Ausgabe für vollständig zu halten.

Terminalwerkzeuge

Das Terminal kann einen Shell-Befehl im Vordergrund ausführen oder einen verwalteten Hintergrundprozess starten. Verwaltete Prozesse unterstützen Lebenszyklusaktionen wie Auflisten, Abfragen, Protokoll, Warten, Eingabe schreiben/absenden, Eingabe schließen und Beenden.

Beispielanfragen:

In this Workspace, find every reference to the old setting and show me the affected files. Do not edit anything.

Run the focused tests for this package. If they pass, update the two affected files and summarize the diff.

Dateiänderungen

write und edit wenden die angeforderte Änderung direkt an. write erstellt fehlende Elternverzeichnisse; edit verlangt, dass jede Ersetzung einen eindeutigen, nicht überlappenden Bereich trifft. Ungültige Quellcodesyntax wird wie angefordert ohne zusätzliche Syntaxprüfung geschrieben.

Relative Pfade werden vom Arbeitsverzeichnis des Werkzeugs aufgelöst. Absolute Pfade, Elternverzeichnispfade und gewöhnliche symbolische Links folgen Dateisystemregeln. Workspace liefert Kontext; es beschränkt Dateizugriff nicht auf ein Verzeichnis. Betriebssystemrechte gelten weiterhin.

Änderungen am selben Ziel werden der Reihe nach eingereiht. Schlägt eine Dateioperation fehl oder wird sie nach Beginn der Ein-/Ausgabe abgebrochen, prüfen Sie die Datei vor einem erneuten Versuch; bereits ausgeführte Wirkungen werden nicht automatisch zurückgerollt.

Arbeitsweise

1. Bitten Sie Anyy, den aktuellen Zustand zu prüfen und zu erklären.
2. Fordern Sie eine konkrete Änderung an und nennen Sie die relevanten Pfade.
3. Prüfen Sie den entstandenen Diff.
4. Führen Sie gezielte Validierung aus.

Laufzeit und Abhängigkeiten

Das lokale Werkzeug bash führt auf dem Anyy-Host eine Shell aus: die konfigurierte Shell oder ein verfügbares bash, mit /bin/sh als Ersatz. Befehle benötigen ihre eigenen Programme, Interpreter und Zugangsdaten in dieser Umgebung. Ein auf Ihrem Clientrechner verfügbarer Befehl ist nicht unbedingt auf dem residenten Host verfügbar.

grep verwendet rg; find verwendet fd oder fdfind. Anyy prüft zuerst bin/ des Profils, dann PATH und kann einen fehlenden Helfer aus dessen offizieller Veröffentlichung beziehen. ANYY_OFFLINE=1 deaktiviert das Beschaffen, erlaubt aber installierte Helfer; Android überspringt die Beschaffung. Siehe Verfügbarkeit von Suchhelfern.

Die standardmäßig anfänglich ausgewählten portablen Dateiwerkzeuge sind read, bash, edit und write. grep, find und ls können separat ausgewählt oder bei Eignung über aktiven Codemode aufgerufen werden. Verwenden Sie den aktuellen Katalog für die tatsächliche Auswahl.

Bekannte Zugangsdaten werden redigiert, bevor Ergebnisse und Prozessprotokolle sichtbar werden. Modellsichtbare Ausgabe und programmatische Rückgaben haben getrennte Grenzen. Codemodes tools.bash liefert beispielsweise output, truncated, exit_code und wall_time_seconds; Ausgabe über 1 MiB bewahrt Anfang/Ende und zusätzlich full_output_path. Auch bei Exitstatus ungleich null kann dieses Objekt zurückgegeben werden; prüfen Sie daher exit_code. Folgen Sie Fortsetzungshinweisen beim Textlesen oder verwenden Sie eine gültige logische Ergebnisreferenz mit tool_result_read.

Hintergrundprozesse

Verwenden Sie einen verwalteten Prozess für Server, Watcher oder lang laufende Tests. Bitten Sie Anyy, den Prozesssitzungshandle zu melden, Status oder Protokolle zu zeigen und den Prozess nach Aufgabenende zu stoppen. Ein Prozess gehört zum startenden Gespräch; ein anderes Gespräch kann weder Eingaben senden noch Protokolle lesen oder ihn stoppen.

Standardmäßig gelten höchstens vier verwaltete Hintergrundprozesse über alle Gespräche des Profils. Vordergrund-Shell-Befehle fallen nicht unter dieses Limit. Beendete Aufträge werden nicht erneut signalisiert. Nach einem residenten Neustart kann eine gespeicherte Prozess-ID allein die Kontrolle nicht wiederherstellen; Anyy meldet fehlende Steuerbarkeit, statt einen Prozess anhand einer alten ID zu stoppen.

Unabhängige Agentenarbeit ist unter Hintergrundaufträge beschrieben.