أدوات عمليات الملفات (7)

سبع أدوات على مستوى الملفات — وهي القسم من MCP الذي يحرّر المسوّدات فعلاً.

1 · read_file

اقرأ ملفاً.

• book_token، path (مثلاً Chapters/Chapter 1.md)
• يُعيد المحتوى + بيانات وصفية (النوع، آخر تحرير)

2 · edit_file

استبدل جزءاً من ملف (بنمط).

• path، old_text، new_text
• جراحي، لا يمسّ المقاطع الأخرى

الأداة الأكثر استخداماً — هي كيف يقوم الذكاء بالمراجعات.

3 · write_file

استبدال كامل.

• path، content
• ⚠️ يستبدل الملف بأكمله
• لـ: إعادة كتابة كاملة، محتوى ابتدائي لملف جديد

4 · create_file

أنشئ ملفاً جديداً.

• path، content، type (مخطوط / مرجع)
• يفشل إن كان الملف موجوداً

5 · delete_file

حذف (إلى سلة مهملات الكتاب، لا نهائي).

• path
• قابل للاستعادة لمدة 30 يوماً — راجع إدارة الملفات والمجلدات

6 · append_to_file

إلحاق محتوى بملف.

• path، content
• لمسارات «أكمل الفصل 3»

7 · search_content

بحث في النص الكامل.

• book_token، query، scope (الفصل / الكتاب)
• يُعيد المطابقات مع المسار + المقطع + السطر

نموذج الصلاحيات

كتاب استوديو الكتابة: الأدوات السبع كلها تستطيع الكتابة في أي مسار.

كتاب استوديو السيناريو: الملفات المهيكلة للقراءة فقط (*.scene / *.character / series.json وغيرها). الكتابة مسموحة فقط في .script_studio/planning/.

راجع:

• سلوك MCP بحسب الـ studio
• حمايات استوديو السيناريو المهيكلة

إنشاء إصدار تلقائي

كل أداة كتابة (edit_file / write_file / create_file / delete_file / append_to_file) تُنشئ إصداراً تلقائياً قبل التغيير.

راجع: قواعد الإصدار التلقائي

مقالات ذات صلة

• أدوات إدارة الكتاب
• أدوات قارئ الذكاء
• سلوك MCP بحسب الـ studio