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": {
    "force_download": {
      "description": "If the file is stored in the cloud and evicted from this Mac (dataless), request the download and wait for it instead of failing. Off by default: a download can take minutes and use metered data, so it is the caller's decision.",
      "type": "boolean"
    },
    "max_bytes": {
      "description": "Maximum bytes to read (default 256 KB, max 2 MB). A longer file comes back with truncated=true and next_offset: pass next_offset as offset to continue.",
      "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). Liest überall auf diesem PC, ausgenommen Speicherorte für Anmeldeinformationen und Identitäten (Browser-Anmeldungen, SSH- und Cloud-Schlüssel, Windows-Anmeldeinformationsspeicher, das Profil eines anderen Benutzers), die nie gelesen werden. Unterstützt offset/max_bytes für geblockte Lesevorgänge großer Dateien: Ein abgeschnittener Lesevorgang meldet truncated=true und next_offset, den Offset, ab dem weitergelesen wird.

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": {
    "force_download": {
      "description": "For a cloud placeholder (OneDrive online-only) bigger than 25 MB: download it and wait up to 60 s. Smaller ones are downloaded on their own.",
      "type": "boolean"
    },
    "max_bytes": {
      "description": "Maximum bytes to read (default 256 KB, max 2 MB). A cut read says next_offset.",
      "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"
}