Alle Werkzeuge

file_write

Dateien und Finder · macOS · Windows

Wirkung: Schreiben. 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

Schreibt Text in eine lokale Datei – erstellen, überschreiben oder anhängen. Für .txt/.md/.csv/.json/.log und alle Klartext- oder Codedateien. (Für Word verwenden Sie word_create, Excel excel_create, PowerPoint ppt_create.) Schreibt überall auf diesem Mac, mit zwei Ausnahmen: Dateien, die Ihr Computer selbst ausführt (Shell-Startdateien, LaunchAgents, Git-Hooks, AI-Client-Konfigurationen) und Speicherorte für Anmeldeinformationen werden nie geschrieben. Das Überschreiben einer vorhandenen Datei erfordert confirm=true (der erste Aufruf gibt stattdessen eine Vorschau zurück); append=true fügt am Ende hinzu und muss nie bestätigt werden. Fehlende übergeordnete Ordner werden erstellt.

Erforderliche Eingaben

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 einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — macOS
{
  "properties": {
    "append": {
      "description": "Append to the end instead of overwriting (default false)",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für file_write. 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.

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "/Users/demo/Documents/meeting-notes.txt"
}

Windows

Zweck

Schreibt Text in eine lokale Datei – erstellen, überschreiben oder anhängen. Der Pfad muss sich in einem zulässigen Ordner befinden (standardmäßig Home-Verzeichnis; Erweiterung über den Konfigurationsschlüssel fs_allowed_roots). Fehlende übergeordnete Ordner werden erstellt. Das Überschreiben einer vorhandenen Datei erfordert confirm=true (der erste Aufruf gibt stattdessen eine Vorschau zurück); Erstellen einer neuen Datei und append=true müssen nie bestätigt werden.

Erforderliche Eingaben

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 einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Kanonisches technisches Schema auf Englisch — Windows
{
  "properties": {
    "append": {
      "description": "Append to the end instead of overwriting (default false).",
      "type": "boolean"
    },
    "confirm": {
      "description": "Required (true) to OVERWRITE an existing file. Not needed to create a new file or to append.",
      "type": "boolean"
    },
    "content": {
      "description": "Text content to write.",
      "type": "string"
    },
    "path": {
      "description": "Absolute path to the file to write.",
      "type": "string"
    }
  },
  "required": [
    "path",
    "content"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für file_write. 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.

{
  "confirm": false,
  "content": "Meeting agenda: review the launch checklist.",
  "path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}