file_write
Dosyalar ve Finder · macOS · Windows
Etki: yazma. Durum: koşullu kullanılabilir.
“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.
macOS
Amaç
Yerel bir dosyaya metin yazar; oluşturur, üzerine yazar veya sonuna ekler. .txt/.md/.csv/.json/.log ile tüm düz metin ve kod dosyaları içindir. Word için word_create, Excel için excel_create, PowerPoint için ppt_create kullanın. Bu Mac'te her yere yazar; ancak makinenizin kendiliğinden çalıştırdığı dosyalara (shell başlangıç dosyaları, LaunchAgents, git hooks, AI-client configs) ve kimlik bilgisi konumlarına asla yazmaz. Mevcut dosyanın üzerine yazmak confirm=true gerektirir; ilk çağrı yalnızca önizleme döndürür. append=true sona ekler ve onay gerektirmez. Eksik üst klasörler oluşturulur.
Zorunlu girdiler
pathcontent
Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.
İzinler ve onay
Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.
- Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.
İngilizce kanonik teknik şema — 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"
}Belge örneği
file_write için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.
{
"confirm": false,
"content": "Meeting agenda: review the launch checklist.",
"path": "/Users/demo/Documents/meeting-notes.txt"
}Windows
Amaç
Yerel bir dosyaya metin yazar; oluşturur, üzerine yazar veya sonuna ekler. Yol izin verilen bir klasörün içinde olmalıdır (varsayılan olarak ana dizin; fs_allowed_roots yapılandırma anahtarıyla genişletilebilir). Eksik üst klasörler oluşturulur. Mevcut dosyanın üzerine yazmak confirm=true gerektirir; ilk çağrı önizleme döndürür. Yeni dosya oluşturmak ve append=true onay gerektirmez.
Zorunlu girdiler
pathcontent
Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.
İzinler ve onay
Şema açık bir onay parametresi bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.
- Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.
İngilizce kanonik teknik şema — 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"
}Belge örneği
file_write için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.
{
"confirm": false,
"content": "Meeting agenda: review the launch checklist.",
"path": "C:\\Users\\demo\\Documents\\meeting-notes.txt"
}