file_write
Fichiers et Finder · macOS · Windows
Effet: écriture. État: disponibilité conditionnelle.
«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.
macOS
Objectif
Écrit du texte dans un fichier local : créer, écraser ou ajouter. Pour .txt/.md/.csv/.json/.log et tout fichier de texte brut ou de code. (Pour Word, utilisez word_create, Excel excel_create, PowerPoint ppt_create.) Écrit n'importe où sur ce Mac, à deux exceptions près : les fichiers que votre machine exécute par elle-même (fichiers de démarrage du shell, LaunchAgents, hooks git, configurations de client AI) et les emplacements d'informations d'identification ne sont jamais écrits. L'écrasement d'un fichier existant nécessite confirm=true (le premier appel renvoie un aperçu à la place) ; append=true ajoute à la fin et n'a jamais besoin d'être confirmé. Les dossiers parents manquants sont créés.
Entrées requises
pathcontent
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — 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"
}Exemple documentaire
Exemple de documentation pour file_write. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"confirm": false,
"content": "Meeting agenda: review the launch checklist.",
"path": "/Users/demo/Documents/meeting-notes.txt"
}Windows
Objectif
Écrit du texte dans un fichier local : créer, écraser ou ajouter. Le chemin doit se trouver dans un dossier autorisé (répertoire personnel par défaut ; étendre via la clé de configuration fs_allowed_roots). Les dossiers parents manquants sont créés. L'écrasement d'un fichier existant nécessite confirm=true (le premier appel renvoie un aperçu à la place) ; créer un nouveau fichier et append=true n'a jamais besoin de confirmation.
Entrées requises
pathcontent
Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.
Autorisations et confirmation
Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — 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"
}Exemple documentaire
Exemple de documentation pour file_write. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{
"confirm": false,
"content": "Meeting agenda: review the launch checklist.",
"path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}