openclaw/plugin-sdk/channel-ingress-runtime لمسارات الاستقبال.
محلّل وقت التشغيل
النتيجة
ينبغي أن تستهلك Plugins المضمّنة الإسقاطات الحديثة مباشرةً:
يظل تخويل الأحداث متاحًا في
ingress.graph المرتّب وفي
ingress.reasonCode الحاسم؛ ولا يُصدر إسقاط مستقل للأحداث.
يجوز لأدوات SDK الخارجية المهملة إعادة إنشاء الأشكال الأقدم داخليًا. ينبغي ألا
تحوّل مسارات الاستقبال المضمّنة الجديدة النتائج الحديثة مجددًا إلى
كائنات DTO محلية.
مجموعات الوصول
تظل إدخالاتaccessGroup:<name> منقّحة. تحل النواة مجموعات
message.senders الثابتة بنفسها، ولا تستدعي resolveAccessGroupMembership
إلا للمجموعات الديناميكية التي تتطلب بحثًا في المنصة. تفشل المجموعات المفقودة وغير المدعومة
والتي تعذّر حلها بصورة مغلقة.
أوضاع الأحداث
استخدم
mayPair: false للتفاعلات والأزرار وعمليات رد النداء والأوامر الأصلية.
المسارات والتفعيل
استخدم واصفات المسارات لسياسة الغرفة أو الموضوع أو الخادم أو سلسلة الرسائل أو المسارات المتداخلة:channelIngressRoutes(...) عندما يحتوي Plugin على عدة واصفات مسارات
اختيارية؛ فهو يرشّح الفروع المعطّلة مع إبقاء حقائق المسارات عامة
ومرتبة وفق precedence لكل واصف.
بوابة الإشارة هي بوابة تفعيل. يؤدي غياب الإشارة إلى إرجاع
admission: "skip" حتى لا تعالج نواة الدور دورًا مخصصًا للمراقبة فقط.
ينبغي لمعظم القنوات وضع التفعيل بعد بوابات المرسل والأوامر. ويمكن لواجهات
المحادثة العامة التي يجب أن تكتم حركة البيانات غير المشار إليها قبل ضوضاء قائمة سماح المرسل
اختيار activation.order: "before-sender" عند تعطيل
تجاوز الأوامر النصية. ويمكن للقنوات ذات التفعيل الضمني، مثل الردود في سلاسل رسائل
البوت، تمرير activation.allowedImplicitMentionKinds؛ وعندئذ يبيّن
activationAccess.shouldBypassMention المسقَط متى تجاوز الأمر أو التفعيل
الضمني إشارة صريحة.