Install
npm install workflowلمن يناسب
تناسب هذه المهارة من يريد كتابة دوال «قابلة للاستمرار» في TypeScript أو JavaScript: يقول النص الرسمي إنه يحفظ تقدم سير العمل، ويعيد محاولة الخطوات الفاشلة، ويوفّر قابلية رصد مدمجة. تناسب أيضًا من يستخدم Next.js أصلًا ويعتزم ربط الغلاف الرسمي في الإعداد.
لا تناسب من يريد فقط بدء سير عمل مباشرة في المتصفح. يحدّ النص الأصلي موضع البدء بمسارات API أو Server Action أو شفرة خادم أخرى. إن لم تستطع تشغيل npm بعد، أو لم تقبل تثبيت حزمة محليًا، توقف عند قراءة الدليل.
بعد تثبيت الحزمة يستطيع وكيل الترميز قراءة أدلة مطابقة للإصدار الحالي من node_modules/workflow/docs. المستودع الرسمي هو
https://github.com/vercel/workflow
اتبع الأوامر المكتوبة أصلًا في تلك الصفحة.
أكمل أول محاولة في 3 دقائق
اسلك فقط مسار التثبيت الواحد الذي يكتبه النص الرسمي.
الشرط المسبق: يستطيع هذا الجهاز تشغيل npm، والدليل الحالي مشروع يجوز كتابة تبعيات فيه. أكّد أولاً: npm install workflow سيغيّر قائمة التبعيات وينزّل حزمة. إن لم ترد تغيير هذا المشروع بعد فلا تنفّذ.
موضع التثبيت: افتح طرفية في جذر المشروع، أكّد تلك الآثار الجانبية ثم نفّذ:
npm install workflow
مهمة منخفضة المخاطر: بعد تثبيت الحزمة لا تتسرع في بدء سير عمل في مسار حي. اطلب أولاً من وكيل الترميز فتح node_modules/workflow/docs للقراءة فقط، والتحقق من ظهور دليل محلي مطابق للإصدار الحالي، وإيجاد جملة الاستيراد التي يجب أن يستخدمها Next.js. لا تكتب ملفات ولا ترسل طلبات للخارج.
إشارة النجاح: تظهر حزمة workflow في تبعيات المشروع، ويمكن فتح node_modules/workflow/docs محليًا، ويستطيع الوكيل الإشارة إلى الاستيراد الرسمي import { withWorkflow } from 'workflow/next'. إن اخترع أمر تثبيت آخر فارجع إلى الأمر الرسمي أعلاه وأعد المحاولة.
حالات الاستخدام
الحالة الأولى: ربط الغلاف الرسمي بمشروع Next.js. الاستيراد الذي يعطيه النص هو import { withWorkflow } from 'workflow/next'. يناسب من لديه أصلًا مشروع Next.js ويريد التحقق أولاً من مدخل الإعداد. يمكنك أولاً أن تطلب من الوكيل تعليم ملف الإعداد الذي يجب تغييره للقراءة فقط ثم الكتابة بعد التأكيد. إن لم يوسّع النص كائن إعداد كامل فتوقف عند «استخدم ذلك الاستيراد»؛ لا تُكمل خيارات لم تظهر.
الحالة الثانية: بدء سير عمل قابل للاستمرار من الخادم. يقول النص إنه يمكن بعد ذلك بدء سير عمل من مسار API أو Server Action أو شفرة خادم أخرى. يناسب من ثبّت الحزمة أصلًا ولديه مدخل خادم واحد. في المرة الأولى اطلب من الوكيل أن يشير إلى أي مدخل خادم قائم ستبدأ منه؛ لا تنشئ مدخل عميل غير مشروح. يُحفظ التقدم وتُعاد محاولة الخطوات الفاشلة؛ عدد إعادة المحاولة وكيفية فتح لوحة الرصد غير مكتوبين فلا تُكملهما.
حدود الاستخدام
أمر التثبيت الرسمي المكتوب واحد فقط: npm install workflow. لا تضع مثبّتًا لم يظهر في المسار الرئيسي. تغطي القدرات الاستمرار وإعادة محاولة الخطوات الفاشلة وقابلية الرصد المدمجة لدوال TypeScript و JavaScript؛ ولا تثبت الاستخدام في لغات أخرى.
موضع البدء مكتوب فقط كمسارات API أو Server Action أو شفرة خادم أخرى. لا تبدأ مباشرة من المتصفح أو عميل غير مسمّى. مسار الوثائق المحلي هو node_modules/workflow/docs ليقرأ وكيل الترميز أدلة مطابقة للإصدار؛ لا يعطي قائمة عملاء فلا تعتبره حكرًا على بضعة مساعدين.
الأسرار وخلفيات الطوابير وحسابات رصد الإنتاج غير موسّعة. الصفحة الرسمية هي
https://github.com/vercel/workflow
إن اختلف أمر يقترحه وكيل عن تلك الصفحة فاعتد بتلك الصفحة.