الانتقال إلى المحتوى الرئيسي

​
Task Flow

Task Flow هي البنية الأساسية لتنسيق التدفقات التي تقع فوق المهام الخلفية. وهي تدير تدفقات مستدامة متعددة الخطوات لها حالتها الخاصة، وتتبع المراجعات، ودلالات المزامنة، بينما تظل المهام الفردية هي وحدة العمل المنفصل.

​
متى تستخدم Task Flow

استخدم Task Flow عندما يمتد العمل عبر خطوات متسلسلة متعددة أو متفرعة وتحتاج إلى تتبع مستدام للتقدم عبر عمليات إعادة تشغيل البوابة. بالنسبة إلى العمليات الخلفية المفردة، تكون المهمة العادية كافية.
السيناريوالاستخدام
مهمة خلفية واحدةمهمة عادية
مسار متعدد الخطوات (A ثم B ثم C)Task Flow (مُدارة)
مراقبة المهام المُنشأة خارجيًاTask Flow (معكوسة)
تذكير لمرة واحدةمهمة Cron

​
أوضاع المزامنة

​
الوضع المُدار

تتولى Task Flow دورة الحياة من البداية إلى النهاية. فهي تنشئ المهام كخطوات للتدفق، وتدفعها إلى الاكتمال، وتُقدّم حالة التدفق تلقائيًا. مثال: تدفق تقرير أسبوعي يقوم (1) بجمع البيانات، و(2) بإنشاء التقرير، و(3) بتسليمه. تنشئ Task Flow كل خطوة كمهمة خلفية، وتنتظر اكتمالها، ثم تنتقل إلى الخطوة التالية. 
Flow: weekly-report
  Step 1: gather-data     → task created → succeeded
  Step 2: generate-report → task created → succeeded
  Step 3: deliver         → task created → running

​
الوضع المعكوس

تراقب Task Flow المهام المُنشأة خارجيًا وتحافظ على مزامنة حالة التدفق من دون تولي مسؤولية إنشاء المهام. يكون هذا مفيدًا عندما تنشأ المهام من مهام Cron أو أوامر CLI أو مصادر أخرى وتريد عرضًا موحدًا لتقدمها كتدفق. مثال: ثلاث مهام Cron مستقلة تشكّل معًا روتين “عمليات الصباح”. يتتبع التدفق المعكوس تقدمها الجماعي من دون التحكم في وقت تشغيلها أو كيفية تشغيلها.

​
الحالة المستدامة وتتبع المراجعات

يحفظ كل تدفق حالته الخاصة ويتتبع المراجعات بحيث يستمر التقدم عبر عمليات إعادة تشغيل البوابة. ويتيح تتبع المراجعات اكتشاف التعارضات عندما تحاول مصادر متعددة تقديم التدفق نفسه بالتزامن.

​
سلوك الإلغاء

يضبط openclaw tasks flow cancel نية إلغاء ثابتة على التدفق. تُلغى المهام النشطة داخل التدفق، ولا تبدأ أي خطوات جديدة. تستمر نية الإلغاء عبر عمليات إعادة التشغيل، لذا يظل التدفق المُلغى مُلغًى حتى إذا أُعيد تشغيل البوابة قبل انتهاء جميع المهام الفرعية.

​
أوامر CLI

# List active and recent flows
openclaw tasks flow list

# Show details for a specific flow
openclaw tasks flow show <lookup>

# Cancel a running flow and its active tasks
openclaw tasks flow cancel <lookup>
الأمرالوصف
openclaw tasks flow listيعرض التدفقات المتتبعة مع الحالة ووضع المزامنة
openclaw tasks flow show <id>يفحص تدفقًا واحدًا حسب معرّف التدفق أو مفتاح البحث
openclaw tasks flow cancel <id>يُلغي تدفقًا قيد التشغيل ومهامه النشطة

​
كيف ترتبط التدفقات بالمهام

تنسّق التدفقات المهام، ولا تستبدلها. قد يقود تدفق واحد عدة مهام خلفية خلال مدة عمله. استخدم openclaw tasks لفحص سجلات المهام الفردية، واستخدم openclaw tasks flow لفحص التدفق المنسِّق.

​
ذو صلة