بروتوكول الإخراج الغني

يمكن أن يحمل خرج المساعد مجموعة صغيرة من توجيهات التسليم/العرض:

• MEDIA: لتسليم المرفقات
• [[audio_as_voice]] لتلميحات عرض الصوت
• [[reply_to_current]] / [[reply_to:<id>]] لبيانات تعريف الرد
• [embed ...] للعرض الغني في واجهة التحكم

يجب أن تكون مرفقات MEDIA: البعيدة عناوين URL عامة بصيغة https:. يتم تجاهل http: العادي، وloopback، وlink-local، وأسماء المضيفين الخاصة والداخلية كتوجيهات مرفقات؛ ولا تزال جالبات الوسائط من جهة الخادم تفرض حواجز الشبكة الخاصة بها.

يمكن لمرفقات MEDIA: المحلية استخدام مسارات مطلقة، أو مسارات نسبية إلى مساحة العمل، أو مسارات نسبية إلى المنزل بصيغة ~/. وهي لا تزال تمر عبر سياسة قراءة الملفات الخاصة بالوكيل وفحوصات نوع الوسائط قبل التسليم.

تبقى صيغة صور Markdown العادية نصا بشكل افتراضي. القنوات التي تعيّن ردود صور Markdown عمدا إلى مرفقات وسائط تشترك في ذلك عبر المحول الصادر الخاص بها؛ يفعل Telegram ذلك بحيث يمكن أن تتحول ![alt](url) إلى رد وسائط.

هذه التوجيهات منفصلة. تبقى MEDIA: ووسوم الرد/الصوت بيانات تعريف للتسليم؛ ويمثل [embed ...] مسار العرض الغني الخاص بالويب فقط. تستخدم وسائط نتائج الأدوات الموثوقة محلل MEDIA: / [[audio_as_voice]] نفسه قبل التسليم، بحيث لا تزال مخرجات الأدوات النصية قادرة على وسم مرفق صوتي كملاحظة صوتية.

عند تمكين بث الكتل، تبقى MEDIA: بيانات تعريف لتسليم واحد لكل دورة. إذا أُرسل عنوان URL للوسائط نفسه في كتلة مبثوثة وتكرر في حمولة المساعد النهائية، يسلم OpenClaw المرفق مرة واحدة ويزيل التكرار من الحمولة النهائية.

# [embed ...]

[embed ...] هي صيغة العرض الغني الوحيدة الموجهة إلى الوكيل لواجهة التحكم.

مثال ذاتي الإغلاق:

[embed ref="cv_123" title="Status" /]

القواعد:

• لم تعد [view ...] صالحة للمخرجات الجديدة.
• تعرض الشفرات القصيرة للتضمين في سطح رسالة المساعد فقط.
• لا تعرض إلا التضمينات المدعومة بعناوين URL. استخدم ref="..." أو url="...".
• لا تعرض شفرات التضمين القصيرة بصيغة HTML المضمنة ذات شكل الكتلة.
• تزيل واجهة الويب الشفرة القصيرة من النص المرئي وتعرض التضمين داخل السياق.
• ليست MEDIA: اسما بديلا للتضمين ولا ينبغي استخدامها لعرض التضمينات الغنية.

# شكل العرض المخزن

كتلة محتوى المساعد المعيارية/المخزنة هي عنصر canvas منظم:

{
  "type": "canvas",
  "preview": {
    "kind": "canvas",
    "surface": "assistant_message",
    "render": "url",
    "viewId": "cv_123",
    "url": "/__openclaw__/canvas/documents/cv_123/index.html",
    "title": "Status",
    "preferredHeight": 320
  }
}

تستخدم الكتل الغنية المخزنة/المعروضة شكل canvas هذا مباشرة. لا يتم التعرف على present_view.

# ذات صلة

• محولات RPC
• Typebox