التوثيق
أغلفة المقالات: متى تُرسم وكيف يجري التحقق منها
متى يرسم محرك المحتوى غلافًا، وكيف يُنشأ المشهد الخالي من العلامات التجارية والصورة ويُتحقق منهما، والملف الذي يصل إلى موقعك، وكيفية استخدام صورتك الخاصة.
إذا كان موقعك يعرض صورة غلاف مع كل مقال، فإن محرك المحتوى يمنح كل مقال غلافًا. يرسم كاتب AutoPSEO الغلاف أثناء كتابة المقال، على نمط أغلفتك الحالية، ويستبعد نموذج رؤية أي صورة تحتوي على شعار أو نص مقروء. ويمكن للذكاء الاصطناعي الخاص بك أن يأتي بصورته بدلًا من ذلك. أغلفة المقالات صور JPEG بأبعاد 1536 × 1024 بكسل، تُسلَّم مع المقال، ولا تُحتسب من حصة مقالاتك ولا من رصيد البحث لديك.
متى يحصل المقال على غلاف
لا يرسم AutoPSEO الأغلفة إلا للموقع الذي يعرضها:
- موقعك يعرض المقالات عبر webhook، وقد أعلن أنه يعرض الأغلفة: إما أن يتضمن ردّه على ping القيمة
covers: true، أو أن يردّ على عملية تسليم بالقيمةcover: "wanted"مرة واحدة على الأقل. ومنذ ذلك الحين يرسم كاتب AutoPSEO الغلاف مباشرة بعد حفظ كل مسودة، فيحمل التسليم الأول للمقال غلافه. - وصل مقال بلا غلاف. ردّ على ذلك التسليم بالقيمة
cover: "wanted": سيرسم الجدول الزمني الذي يعمل كل خمس دقائق غلافًا، بدءًا بأقدم طلب، ثم يرسله إليك ضمنarticle.updated. - AutoPSEO يستضيف المقالات والقالب الذي تعلّمه من موقعك يعرض الأغلفة (الاستضافة).
الموقع الذي لا يعرض الأغلفة لا يحصل على أي غلاف. ويتوقف الجدول الزمني ذو الخمس دقائق عن محاولة رسم غلاف المقال بعد ثلاث محاولات فاشلة. ويحتفظ المقال المنشور بغلافه إلى أن يستبدله أحد بـ content_set_cover؛ أما النسخة المعدَّلة التي تنتظر المراجعة فلا تغيّره أبدًا.
كيف يُرسم الغلاف
- المشهد. يصف نموذج نصي على Workers AI (Llama 3.3) مشهدًا واحدًا للمقال لا يزيد على 45 كلمة: أشخاص عاديون، والمكان، وما يفعلونه، والأشياء المحيطة بهم. ولا يذكر اسم أي شركة أو علامة تجارية أو منتج أو تطبيق أو موقع إلكتروني أو مدرسة أو شخص أو مكان، ولا يضع في الصورة أي شيء مقروء. ويُرفض أي مشهد لا يزال يذكر علامتك التجارية. ولا يطّلع نموذج الصور على المقال نفسه إطلاقًا.
- الصورة. يرسم FLUX.2 [klein] المشهد "بالنمط والإضاءة والألوان والتكوين نفسها تمامًا" لما لا يزيد على صورتين من صور المشاركة أو الأغلفة الخاصة بك، تُستخدم مراجع. وبلا مراجع يرسم صورة تحريرية هادئة بإضاءة طبيعية. ويطلب الأمر النصي ألا يكون في الصورة نصوص أو حروف أو أرقام أو شعارات أو علامات مائية، وألا تظهر على أي شاشة سوى أشكال تجريدية، وأن تكون أجهزة الحاسوب المحمولة والهواتف والشاشات عادية بلا علامات تجارية.
- التحقق. يفحص نموذج رؤية (Llama 4 Scout) النتيجة. والصورة التي تحتوي على شعار أو نص مقروء تُعدّ محاولة فاشلة، وتُرسم من جديد في تشغيل لاحق.
لا تُعاد خطوة الغلاف لدى الكاتب من تلقاء نفسها. فإذا فشلت، يواصل المقال مساره دون أن يتعطل شيء.
الملف الذي يصل إلى موقعك
| الخاصية | القيمة |
|---|---|
| الصيغة | JPEG |
| الحجم | 1536 × 1024 بكسل، بنسبة 3:2 |
| العنوان | https://app.autopseo.com/media/covers/<property>/<sha256>.jpg |
| التخزين المؤقت | عام وثابت لمدة سنة: اسم الملف هو SHA-256 للصورة |
تحمله عمليات التسليم في الخاصية article.cover مع url وsha256 وcontentType وwidth وheight. نزّله مرة واحدة واحتفظ بنسختك الخاصة؛ فموقعك يملك الصورة كبقية المقال. وعند الاستضافة لدى AutoPSEO، تُقدَّم الأغلفة ضمن مسار نوع المحتوى على /_cover/<slug>.jpg، بالأحجام والصيغ التي يستخدمها قالبك.
استخدم صورتك الخاصة
يمكن للكاتب الذي يعمل عبر MCP أن يقدّم أي صورة يشاء، بأي طريقة صُنعت (ذكاؤك الاصطناعي الخاص):
- مع المسودة: الحقل
coverفيcontent_submit، إماurl(عنوان https على الويب العام، يُجلب مرة واحدة) أوdata(بترميز base64، حتى 2.5 ميغابايت). - كملف: طلب PUT يحمل بايتات الصورة إلى
coverUploadUrlالذي يعيدهcontent_submitحين يريد موقعك غلافًا. - لاحقًا:
content_set_coverمع صورة، أو بدونها للحصول على عنوان رفع. وهذه أيضًا هي طريقة استبدال غلاف مقال منشور.
لا يفحص AutoPSEO صورتك إلا بوصفها صورة: PNG أو JPEG أو WebP، بحجم بين 10 كيلوبايت و12 ميغابايت، وعرض لا يقل عن 800 بكسل وارتفاع لا يقل عن 400، وبوضع أفقي (ألا يزيد ارتفاعها على عرضها، وألا يتجاوز عرضها 2.5 أمثال ارتفاعها). تُقصّ من المنتصف إلى نسبة 3:2 وتُحفظ بصيغة JPEG بأبعاد 1536 × 1024. ولا يُجرى فحص الرؤية على صورتك الخاصة، وتبقى محفوظة حتى لو لم يكن AutoPSEO يعرف هل يعرض موقعك الأغلفة: فالقرار لموقعك.
ارسم من أمر AutoPSEO النصي
الكاتب الذي لديه أداة صور خاصة به يمكنه مع ذلك الاستفادة من الأمر النصي والفحوص لدى AutoPSEO:
- صِف مشهدًا من 20 إلى 600 حرف وأرسله مع
content_cover. يفحصه AutoPSEO كما يفحص مشاهده الخاصة، ويعيد الأمر النصي للصورة، وما يصل إلى غلافين من أغلفة موقعك مراجعَ، وعنوان رفع موقّعًا. - ارسم الصورة من ذلك الأمر بأي أداة صور، وأرسل بايتاتها بطلب PUT إلى العنوان. يبقى العنوان صالحًا ساعة واحدة ويقبل ما يصل إلى خمس صور.
- يعدّل AutoPSEO حجم الصورة إلى 1536 × 1024، ويجري فحص الرؤية، ثم يحتفظ بها. ويُرسَل المقال المنشور إلى موقعك مجددًا بغلافه الجديد.
| ردّ الرفع | المعنى |
|---|---|
| 403 | العنوان غير صالح أو منتهي الصلاحية |
| 413 | يتجاوز 12 ميغابايت |
| 415 | ليس صورة |
| 422 | رفضه الفحص: ارسمه من جديد وأرسله إلى العنوان نفسه |
| 429 | استقبل العنوان خمس صور؛ اطلب عنوانًا جديدًا |
| 409 | الموقع لا يعرض أغلفة |
يستخدم المشغّل غير المراقَب الموصوف في ذكاؤك الاصطناعي الخاص هذا المسار عبر أداته make_cover، فيرسم باستخدام Codex CLI أو Grok CLI على جهاز Mac الخاص بك.