الدليل › Slima MCP › رفض الكتابة: ما العمل

رفض الكتابة: ما العمل

آخر تحديث 9/09/2026 · قراءة 8 دقيقة

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

اقرأ الرمز قبل أن تعيد المحاولة

للكتابة المرفوضة أسبابٌ عدّة لا يجمعها شيء، وعلاجاتها لا يجمعها شيء كذلك. ورمز الخطأ هو ما تميّزها به:

الرمز	الحالة	معناه	الخطوة التالية
`AI_READONLY_FILE_TYPE`	403	هذا النوع لا يقبل كتابة كاملة	ملف مهيكل: استخدم أداة `update_*` التي تسمّيها الرسالة. أما `.character` / `.json` وما شابههما: فلا بديل
`SUBSCRIPTION_REQUIRED`	403	هذه القدرة تخصّ خطط الاشتراك	القراءة غير مقيّدة — اقرأ الملف وصِف التعديل الذي توصي به
`INVALID_PATH`	400	كتاب قديم من استوديو السيناريو، والكتابة وقعت خارج شجرة التخطيط	اكتب تحت `.script_studio/planning/` بدلًا من ذلك
`FOLDER_NOT_EMPTY`	422	المجلد الذي طلبت حذفه فيه أشياء	إن كنت تعنيها، أعد الإرسال مع `recursive: true`

وفي أيٍّ من هذه الحالات الأربع، إعادة إرسال الوسائط نفسها لا تتحوّل إلى نجاح.

1 · الملفات المهيكلة: الرسالة تسمّي الأداة

وجِّه write_file أو edit_file أو append_to_file إلى ملف .map أو .beats أو .timeline أو .script أو .geomap، فيعود إليك هذا:

.map files are structured documents — a generic write would corrupt them.
Use POST /api/v1/books/:book_token/mcp/files/structured (the MCP client
exposes it as update_relationship_map): it takes one field-level operation at
a time, so the parts of the document you were never shown cannot be dropped.
If update_relationship_map is not in your tool list, your Slima MCP client is
older than this server — ask the author to update the Slima MCP package.
A missing tool always means an out-of-date client; nothing about this account
ever hides a tool from you.

في الرسالة أمران: أي أداة تستخدم، وما تفعله إن لم تكن تلك الأداة في قائمتك. والثاني مهمّ، لأن 0.2.0 لا يملك تلك الأدوات والخادم لا يقبل الكتابة الكاملة أيضًا — فالعميل القديم طريقاه مغلقان. والترقية مشروحة في كيف تعمل إصدارات slima-mcp.

أما .character و.location و.json و.yaml فتعيد الرمز نفسه بلا جملة المسار البديل: اقرأ الملف، ثم قل بالكلمات ما كنت ستغيّره.

2 · بوابة الاشتراك: القراءة غير مقيّدة أبدًا

حين لا تكون الخطة قد فتحت الكتابة المهيكلة، يكون الرمز SUBSCRIPTION_REQUIRED وتقول الرسالة:

Writing .map files is part of Slima's subscription plans. Reading them is not
restricted — read the file and describe the change you recommend, and the
author can make it in the app or subscribe to let you make it directly.
(Credits bought as a one-off pack cover AI usage inside the Slima app;
structured file writing goes with a plan.)

ويتبع ذلك ثلاثة أمور:

القراءة سليمة لم تُمَسّ. الـ AI على حساب مجاني يقرأ كل ملف .map و.timeline في الكتاب. لكنه لا يستطيع تغييرها.
المعيار هو الخطة، لا إن كان قد صُرف مالٌ يومًا. حزمة النقاط المشتراة مرة واحدة تغطّي استخدام الـ AI داخل تطبيق Slima؛ وهي لا تفتح الكتابة المهيكلة.
الحذف مُقيَّد كالكتابة تمامًا. على خطة مجانية، ملف .map لا يُنشأ ولا يُعدَّل ولا يُحذف كذلك.

والردّ المفيد هنا ليس إعادة المحاولة، بل أن تقرأ الملف وتقول بدقّة ما كنت ستغيّره، ليفعله المؤلف في التطبيق.

3 · كتب استوديو السيناريو القديمة: `INVALID_PATH`

إن كان الكتاب من كتب استوديو السيناريو القديمة، فمجموعة قواعد منفصلة تمامًا تسري عليه، وهي تعمل على المسارات: المنطقة الوحيدة القابلة للكتابة هي شجرة .script_studio/planning/، بينما series.json و*.character و*.location و*.scene و*.storyline و*.note و.script_studio/planning/.initialized كلها للقراءة فقط عبر MCP.

.script_studio/planning/scene-3-1-revision.md   ← writable
Episodes/03/scene-1.scene                        ← 400 INVALID_PATH

المسار الأول في المثال أعلاه مسموحٌ بالكتابة فيه، والثاني يعيد 400 INVALID_PATH. والمخرج أن تكتب المقترح في شجرة التخطيط تلك وتدع المؤلف يطبّقه في التطبيق. ولتعرف القواعد قبل أن تحاول، اقرأ المورد slima://books/{book_token}/schema، أو نادِ get_book فحسب — فهو على كتاب كهذا يطبع قيود الكتابة فيه بنفسه.

4 · أسهل حالة تفوتك: نجحت العملية، والملف فارغ

create_file لا يُرفض على الامتدادات المهيكلة الخمسة. إنه ينجح — وما كتبه الخادم هيكلٌ فارغ، والمحتوى الذي أرسلته أُسقط. والردّ يقول ذلك صراحةً.

ولأنها ليست حالة فشل، فهي تُقرأ على أنها «أُنشئ». والمسار الصحيح خطوتان: create_file للحصول على ملف فارغ، ثم دفعات update_* لملئه.

سببان لا علاقة لهما بنوع الملف

الكتاب في سلة المحذوفات. الكتاب المُلقى في السلة غير قابل للكتابة. استعده أولًا.
الكتاب شاركه معك غيرك. بلا صلاحية كتابة على ذلك الكتاب، لا تملك غير القراءة.

لا تحتَل على الرفض

أخطاء MCP في Slima مكتوبة لتكون قابلة للإصلاح من الرسالة: المُعرّف المجهول يعود ومعه المُعرّفات الحقيقية، ومستوى المكان المجهول ومعه المستويات الحقيقية، والحقل الموضوع في غير موضعه ومعه اسم العملية التي يخصّها. كلفة الطريق الملتوي تقع على المؤلف، وكلفة قراءة الرسالة تقع عليك، وهذه أرخص الاثنتين بكثير.