file_read

Dateien und Finder · macOS · Windows

Wirkung: Lesen. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Liest eine reine Textdatei anhand ihres absoluten Pfads aus dem lokalen Dateisystem – das primäre Standardtool zum Lesen einer lokalen Textdatei (verwenden Sie dies, es sei denn, es handelt sich bei der Datei um ein PDF-, Word-, Excel- oder PowerPoint-Dokument, das über eigene Lesegeräte verfügt). Liest überall auf diesem Mac – Zuhause, externe Festplatten, Cloud-Laufwerke, /tmp – mit einer Ausnahme: Anmeldeinformations- und Identitätsspeicherorte (Schlüsselbunde, ~/.ssh, ~/.aws, Browser-Anmeldungen, das Zuhause eines anderen Benutzers, Time Machine-Backups) werden nie gelesen. Unterstützt .txt, .md, .csv, .json, .xml, .log, .yaml, .toml und gängige Codedateitypen; Erkennt UTF-8 automatisch mit Latin-1/Windows-1252-Fallback. Für Dateien in OneDrive verwenden Sie onedrive_read_file, in Google Drive gdrive_read_file; für PDFs pdf_read, Word word_read, Excel excel_read.

Erforderliche Eingaben

path

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — macOS

{
  "properties": {
    "max_bytes": {
      "description": "Maximum bytes to read (default 1 MB, max 10 MB)",
      "type": "integer"
    },
    "offset": {
      "description": "Start reading at this byte offset (default 0)",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the file",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für file_read. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "path": "/Users/demo/Documents/meeting-notes.txt"
}

Windows

Zweck

Liest eine Nur-Text-Datei anhand ihres absoluten Pfads aus dem lokalen Dateisystem – das Standardtool zum Lesen einer lokalen Textdatei (verwenden Sie pdf_read/word_read/excel_read/ppt_read für diese Dokumenttypen, onedrive_read_file / gdrive_read_file für Cloud-Speicher). Der Pfad muss sich in einem zulässigen Ordner befinden (standardmäßig das Home-Verzeichnis; Erweiterung über den Konfigurationsschlüssel fs_allowed_roots). Unterstützt offset/max_bytes für geblockte Lesevorgänge großer Dateien.

Erforderliche Eingaben

path

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — Windows

{
  "properties": {
    "max_bytes": {
      "description": "Maximum bytes to read (default 1 MB, max 10 MB).",
      "type": "integer"
    },
    "offset": {
      "description": "Start reading at this byte offset (default 0).",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the file (a leading ~ is expanded).",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Dokumentationsbeispiel

{
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}