أدوات تسلك سلوكًا مختلفًا مع ملفات بعينها

في سطر واحد: الأدوات التي تسلك سلوكًا مختلفًا مع ملفات بعينها أو كتب بعينها، وما تفعله أمام كل اختلاف منها.

ما الذي يحلّه هذا

معظم أدوات MCP تعامل كل ملف بالطريقة نفسها. أما التي أدناه فلا. ولا واحدة منها تُخطئ صراحةً — بل تعيد شيئًا لم تكن تتوقّعه، والنجاح غير المتوقّع أصعب في الانتباه إليه من الفشل الصريح.

read_file: نوعان يعودان مغيَّرين

خرائط العلاقات .map تعود بصيغة JSON خام: مُعرّفات عقد، وإحداثيات بكسل، وقوائم عضوية في المجموعات. سليمٌ تقنيًا، غير قابل للاستخدام عمليًا. استخدم view_relationship_map بدلًا منه، فهو يعيد صورة مع ملخّص يسرد كل شخصية وكل علاقة — انظر دعِ الـ AI يرى خريطة العلاقات.

خرائط العالم .geomap تعود وقد استُبدلت شبكات التضاريس الثلاث بسطر توضيحي. وذلك ليس اقتطاعًا بل قصدًا: التضاريس مُرمّزة للآلة، ولا شيء فيها يُقرأ، والعمليات التي تغيّرها تعمل بخلايا الشبكة.

search_content: ما يجده يتوقّف على عُمر الكتاب

في كتب 4.0 تُبحث كل الملفات، بما فيها الـ JSON الخام للملفات المهيكلة. فكلمة شائعة مثل name أو title قد تعود بأسماء حقول لا غير. مرِّر file_types: ["md"] حين تريد النثر وحده.

في كتب استوديو السيناريو القديمة يعمل بالعكس: *.character و*.scene و*.storyline و*.note و*.location وملفات *.json الواقعة تحت .script_studio/ مستثناة افتراضيًا، لأن الـ JSON الخام فيها ضجيج في بحث نصّي. مرِّر include_structured: true لتشملها.

semantic_search: لا يرى إلا ما دخل commit

البحث الدلالي يفهرس محتوى آخر commit في الكتاب. والفقرة التي كتبها المؤلف في التطبيق قبل لحظات ولم تصبح جزءًا من commit ليست هناك.

والكتاب الكبير الذي لم يُفهرس قط يُحال إلى بناء في الخلفية، فيعود ذلك البحث فارغًا — «لم يُبنَ بعد» لا «لا يوجد شيء». ابحث مرة أخرى بعد قليل. التفاصيل كاملة في البحث الدلالي مقابل البحث النصي.

analyze_chapter: وجّهه إلى النثر لا إلى ملف مهيكل

كتب استوديو السيناريو القديمة غير مدعومة إطلاقًا. النداء يُرفض مباشرة، والرسالة تشير إلى ميزات التحليل داخل التطبيق نفسه.

وفي كتب 4.0 المسؤولية عليك. لا شيء يمنعك من وضع file_path على ملف .script أو .beats، وفعل ذلك يشبه أن تطلب من قارئ أن يقرأ لك مستند JSON. سينفّذ الطلب، وسيخرج التقرير غريبًا. وجّه قارئ بيتا AI إلى ملفات المخطوطة .md.

get_writing_stats: أربعة أنواع تُحتسب صفرًا دائمًا

.map و.beats و.timeline و.geomap عدد كلماتها صفرٌ بحكم العقد؛ فلا واحد منها نثرٌ كتبه المؤلف. و.script عكسها: يحتسب الكلمات داخل مشاهده، ويدخل في عدد الكلمات اليومي والسلسلة.

فترتيب خط زمني لمؤلف لا يترك تقدّمًا زائفًا في إحصاءاته. أما كتابة حلقة فتفعل.

create_file: على الامتدادات المهيكلة الخمسة، محتواك يُتجاهَل

يكتب الخادم هيكلًا فارغًا، ويصير اسم الملف اسمَ المستند، ويقول الردّ بوضوح إن محتواك استُبدل. وكل ما أردت وضعه فيه يدخل عبر دفعات update_* — انظر أدوات التحرير المهيكل.

delete_file: المجلد غير الفارغ يجب أن يُقال بصوت عالٍ

حذف مجلد ما زال فيه أشياء مرفوضٌ افتراضيًا (FOLDER_NOT_EMPTY). وإن كنت تعني الشجرة كلها فعلًا، أعد الإرسال مع recursive: true.

هذه الحماية موجودة بسبب حادث حقيقي: حذف صفّ المجلد وحده يبعثر كل ملف تحته إلى جذر الكتاب، والخادم يجيب 200.

get_chapter وread_file: استخدم الثانية إذا عرفت المسار

get_chapter يقبل اسم ملف مجرّدًا (الفصل 01 - ناسخة الكتب.md) أو مسارًا جزئيًا، وحين لا يجده يسرد لك الملفات الموجودة فعلًا. والثمن استعلامات إضافية.

ومتى صار المسار معروفًا، فـread_file يؤدّي المهمة نفسها بشكل أكثر مباشرة.

ذات صلة

• Docs: أدوات الملفات
• Docs: البحث الدلالي مقابل البحث النصي
• Docs: دعِ الـ AI يرى خريطة العلاقات
• Docs: ما الذي يستطيعه MCP مع كل نوع ملف
• Docs: أدوات قارئ بيتا AI