التحقق الكامل من الإصدار

Full Release Validation هي مظلة الإصدار. وهي نقطة الدخول اليدوية الوحيدة لإثبات ما قبل الإصدار، لكن معظم العمل يحدث في مسارات عمل فرعية بحيث يمكن إعادة تشغيل صندوق فاشل من دون إعادة بدء الإصدار كله. شغّلها من مرجع سير عمل موثوق، عادةً main، ومرّر فرع الإصدار أو الوسم أو SHA الالتزام الكامل بوصفه ref:

gh workflow run full-release-validation.yml \
  --ref main \
  -f ref=release/YYYY.M.D \
  -f provider=openai \
  -f mode=both \
  -f release_profile=stable

تستخدم مسارات العمل الفرعية مرجع سير العمل الموثوق للحزمة الاختبارية، وتستخدم ref المُدخل للمرشح قيد الاختبار. يضمن ذلك بقاء منطق التحقق الجديد متاحًا عند التحقق من فرع إصدار أو وسم أقدم. افتراضيًا، يشغّل release_profile=stable المسارات الحاجبة للإصدار ويتخطى اختبار التحمل الحي/Docker الشامل. مرّر run_release_soak=true لتضمين مسارات التحمل في تشغيل مستقر. يفعّل release_profile=full دائمًا مسارات التحمل بحيث لا يسقط ملف التعريف الاستشاري الواسع التغطية بصمت. عادةً يبني قبول الحزمة أرشيف الحزمة المرشحة من ref المحلول، بما في ذلك تشغيلات SHA الكامل المُرسلة باستخدام pnpm ci:full-release. بعد نشر تجريبي، مرّر release_package_spec=openclaw@YYYY.M.D-beta.N لإعادة استخدام حزمة npm المشحونة عبر فحوص الإصدار، وقبول الحزمة، وعبر أنظمة التشغيل، ومسار إصدار Docker، وحزمة Telegram. استخدم package_acceptance_package_spec فقط عندما ينبغي لقبول الحزمة أن يثبت حزمة مختلفة عن قصد.

المراحل العليا

المرحلة	التفاصيل
حل الهدف	المهمة: `Resolve target ref` سير العمل الفرعي: لا يوجد يثبت: يحل فرع الإصدار أو الوسم أو SHA الالتزام الكامل ويسجل المُدخلات المحددة. إعادة التشغيل: أعد تشغيل المظلة إذا فشل هذا.
Vitest وCI العادي	المهمة: `Run normal full CI` سير العمل الفرعي: `CI` يثبت: مخطط CI كامل يدويًا مقابل مرجع الهدف، بما في ذلك مسارات Linux Node، وشظايا Plugin المجمعة، وعقود القنوات، وتوافق Node 22، و`check`، و`check-additional`، واختبار بناء سريع، وفحوص المستندات، وSkills Python، وWindows، وmacOS، وتدويل Control UI، وAndroid عبر المظلة. إعادة التشغيل: `rerun_group=ci`.
ما قبل إصدار Plugin	المهمة: `Run plugin prerelease validation` سير العمل الفرعي: `Plugin Prerelease` يثبت: فحوص Plugin ثابتة خاصة بالإصدار، وتغطية Plugin الوكيلية، وشظايا دفعات الامتدادات الكاملة، ومسارات Docker لما قبل إصدار Plugin، وأثرًا غير حاجب `plugin-inspector-advisory` لفرز التوافق. إعادة التشغيل: `rerun_group=plugin-prerelease`.
فحوص الإصدار	المهمة: `Run release/live/Docker/QA validation` سير العمل الفرعي: `OpenClaw Release Checks` يثبت: اختبار تثبيت سريع، وفحوص حزمة عبر أنظمة التشغيل، وقبول الحزمة، وتكافؤ QA Lab، ومصفوفة حية، وTelegram حي. مع `run_release_soak=true` أو `release_profile=full`، يشغّل أيضًا مجموعات حية/E2E شاملة وقطع مسار إصدار Docker. إعادة التشغيل: `rerun_group=release-checks` أو مقبض أضيق لفحوص الإصدار.
أثر الحزمة	المهمة: `Prepare release package artifact` سير العمل الفرعي: لا يوجد يثبت: ينشئ أرشيف `release-package-under-test` الأبكر للحزمة في وقت مبكر بما يكفي للفحوص الموجهة للحزمة التي لا تحتاج إلى انتظار `OpenClaw Release Checks`. إعادة التشغيل: أعد تشغيل المظلة أو وفّر `release_package_spec` لإعادة تشغيل الحزمة المنشورة.
حزمة Telegram	المهمة: `Run package Telegram E2E` سير العمل الفرعي: `NPM Telegram Beta E2E` يثبت: إثبات حزمة Telegram مدعوم بأثر الأب لـ `rerun_group=all` مع `release_profile=full`، أو إثبات Telegram للحزمة المنشورة عندما يكون `release_package_spec` أو `npm_telegram_package_spec` مضبوطًا. إعادة التشغيل: `rerun_group=npm-telegram` مع `release_package_spec` أو `npm_telegram_package_spec`.
متحقق المظلة	المهمة: `Verify full validation` سير العمل الفرعي: لا يوجد يثبت: يعيد فحص نتائج تشغيل المسارات الفرعية المسجلة ويُلحق جداول أبطأ المهام من مسارات العمل الفرعية. إعادة التشغيل: أعد تشغيل هذه المهمة فقط بعد إعادة تشغيل فرع فاشل حتى يصبح أخضر.

بالنسبة إلى ref=main وrerun_group=all، تحل مظلة أحدث محل مظلة أقدم. عند إلغاء الأب، يلغي مراقبه أي سير عمل فرعي كان قد أرسله بالفعل. لا تلغي تشغيلات التحقق من فروع الإصدار والوسوم بعضها بعضًا افتراضيًا.

مراحل فحوص الإصدار

OpenClaw Release Checks هو أكبر سير عمل فرعي. يحل الهدف مرة واحدة ويحضّر أثر release-package-under-test مشتركًا عندما تحتاجه مراحل موجهة للحزمة أو Docker.

المرحلة	التفاصيل
هدف الإصدار	المهمة: `Resolve target ref` سير العمل الداعم: لا يوجد الاختبارات: المرجع المحدد، وSHA المتوقع الاختياري، والملف الشخصي، ومجموعة إعادة التشغيل، ومرشح مجموعة الاختبارات الحية المركزة. إعادة التشغيل: `rerun_group=release-checks`.
أداة حزمة الإصدار	المهمة: `Prepare release package artifact` سير العمل الداعم: لا يوجد الاختبارات: تحزم أو تحل حزمة tarball مرشحة واحدة وترفع `release-package-under-test` للفحوصات اللاحقة الموجهة للحزم. إعادة التشغيل: مجموعة الحزمة المتأثرة أو عبر أنظمة التشغيل أو الحية/E2E.
اختبار تثبيت سريع	المهمة: `Run install smoke` سير العمل الداعم: `Install Smoke` الاختبارات: مسار التثبيت الكامل مع إعادة استخدام صورة اختبار Docker السريع من Dockerfile الجذري، وتثبيت حزمة QR، واختبارات Docker السريعة للجذر وGateway، واختبارات Docker للمثبت، واختبار سريع لموفر الصور عبر التثبيت العام باستخدام Bun، واختبار E2E سريع لتثبيت/إلغاء تثبيت Plugin المضمن. إعادة التشغيل: `rerun_group=install-smoke`.
عبر أنظمة التشغيل	المهمة: `cross_os_release_checks` سير العمل الداعم: `OpenClaw Cross-OS Release Checks (Reusable)` الاختبارات: مسارات التثبيت الجديد والترقية على Linux وWindows وmacOS للموفر والوضع المحددين، باستخدام حزمة tarball المرشحة وحزمة أساس. إعادة التشغيل: `rerun_group=cross-os`.
المستودع وE2E الحي	المهمة: `Run repo/live E2E validation` سير العمل الداعم: `OpenClaw Live And E2E Checks (Reusable)` الاختبارات: E2E للمستودع، والذاكرة المخبأة الحية، وبث websocket من OpenAI، وشرائح الموفر الحي الأصلي وPlugin، وأدوات اختبار النموذج/الخلفية/Gateway الحية المدعومة بـDocker المحددة بواسطة `release_profile`. عمليات التشغيل: `run_release_soak=true` أو `release_profile=full` أو `rerun_group=live-e2e` المركزة. إعادة التشغيل: `rerun_group=live-e2e`، اختياريا مع `live_suite_filter`.
مسار إصدار Docker	المهمة: `Run Docker release-path validation` سير العمل الداعم: `OpenClaw Live And E2E Checks (Reusable)` الاختبارات: أجزاء Docker لمسار الإصدار مقابل أداة الحزمة المشتركة. عمليات التشغيل: `run_release_soak=true` أو `release_profile=full` أو `rerun_group=live-e2e` المركزة. إعادة التشغيل: `rerun_group=live-e2e`.
قبول الحزمة	المهمة: `Run package acceptance` سير العمل الداعم: `Package Acceptance` الاختبارات: تجهيزات حزم Plugin غير المتصلة، وتحديث Plugin، وقبول حزمة Telegram مع OpenAI وهمي، وفحوصات بقاء الترقية المنشورة مقابل حزمة tarball نفسها. تستخدم فحوصات الإصدار الحاجبة أحدث أساس منشور افتراضي؛ وتتوسع فحوصات النقع إلى كل إصدار npm مستقر عند `2026.4.23` أو بعده، إضافة إلى تجهيزات المشكلات المبلغ عنها. إعادة التشغيل: `rerun_group=package`.
تكافؤ QA	المهمة: `Run QA Lab parity lane` و`Run QA Lab parity report` سير العمل الداعم: مهام مباشرة الاختبارات: حزم تكافؤ وكيلية للمرشح والأساس، ثم تقرير التكافؤ. إعادة التشغيل: `rerun_group=qa-parity` أو `rerun_group=qa`.
Matrix الحية لـQA	المهمة: `Run QA Lab live Matrix lane` سير العمل الداعم: مهمة مباشرة الاختبارات: ملف QA سريع وحى لـMatrix في بيئة `qa-live-shared`. إعادة التشغيل: `rerun_group=qa-live` أو `rerun_group=qa`.
Telegram الحية لـQA	المهمة: `Run QA Lab live Telegram lane` سير العمل الداعم: مهمة مباشرة الاختبارات: QA حي لـTelegram مع عقود تأجير بيانات اعتماد Convex CI. إعادة التشغيل: `rerun_group=qa-live` أو `rerun_group=qa`.
مدقق الإصدار	المهمة: `Verify release checks` سير العمل الداعم: لا يوجد الاختبارات: مهام فحص الإصدار المطلوبة لمجموعة إعادة التشغيل المحددة. إعادة التشغيل: أعد التشغيل بعد نجاح المهام الفرعية المركزة.

أجزاء مسار إصدار Docker

تشغل مرحلة مسار إصدار Docker هذه الأجزاء عندما يكون live_suite_filter فارغا:

الجزء	التغطية
`core`	مسارات اختبار سريع لمسار إصدار Docker الأساسي.
`package-update-openai`	سلوك تثبيت/تحديث حزمة OpenAI، والتثبيت عند الطلب لـCodex، واستدعاءات أدوات Chat Completions.
`package-update-anthropic`	سلوك تثبيت حزمة Anthropic وتحديثها.
`package-update-core`	سلوك الحزمة والتحديث المحايد للموفر.
`plugins-runtime-plugins`	مسارات وقت تشغيل Plugin التي تمرن سلوك Plugin.
`plugins-runtime-services`	مسارات وقت تشغيل Plugin المدعومة بالخدمات والحية؛ تتضمن OpenWebUI عند الطلب.
`plugins-runtime-install-a` through `plugins-runtime-install-h`	دفعات تثبيت/وقت تشغيل Plugin مقسمة للتحقق المتوازي من الإصدار.

استخدم docker_lanes=<lane[,lane]> المستهدف على سير العمل الحي/E2E القابل لإعادة الاستخدام عندما يفشل مسار Docker واحد فقط. تتضمن أدوات الإصدار أوامر إعادة تشغيل لكل مسار مع مدخلات أداة الحزمة وإعادة استخدام الصورة عندما تكون متاحة.

ملفات تعريف الإصدار

يتحكم release_profile غالبا في اتساع التغطية الحية/الموفر داخل فحوصات الإصدار. لا يزيل CI الكامل العادي، أو Plugin قبل الإصدار، أو اختبار التثبيت السريع، أو قبول الحزمة، أو QA Lab. بالنسبة إلى stable، تكون تغطية E2E الشاملة للمستودع/الحية وأجزاء مسار إصدار Docker تغطية نقع وتعمل عندما يكون run_release_soak=true. يفرض full تشغيل تغطية النقع ويجعل أيضا التشغيل الشامل يشغل E2E لحزمة Telegram مقابل أداة حزمة الإصدار الأصلية عندما يكون rerun_group=all، بحيث لا يتخطى مرشح ما قبل النشر الكامل مسار حزمة Telegram بصمت.

الملف الشخصي	الاستخدام المقصود	التغطية الحية/الموفر المضمنة
`minimum`	أسرع اختبار سريع حرج للإصدار.	المسار الحي لـOpenAI/الأساس، ونماذج Docker الحية لـOpenAI، وأساس Gateway الأصلي، وملف تعريف Gateway الأصلي لـOpenAI، وPlugin الأصلي لـOpenAI، وGateway Docker الحي لـOpenAI.
`stable`	ملف تعريف اعتماد الإصدار الافتراضي.	`minimum` إضافة إلى اختبار Anthropic سريع، وGoogle، وMiniMax، والخلفية، وأداة اختبار حية أصلية، وخلفية CLI حية عبر Docker، وربط Docker ACP، وأداة اختبار Docker لـCodex، وشريحة اختبار سريع لـOpenCode Go.
`full`	مسح استشاري واسع.	`stable` إضافة إلى موفري الاستشارات، وشرائح Plugin الحية، وشرائح الوسائط الحية.

إضافات full فقط

تتخطى stable هذه المجموعات وتدرجها full:

المجال	تغطية full فقط
نماذج Docker الحية	OpenCode Go، وOpenRouter، وxAI، وZ.ai، وFireworks.
Gateway Docker الحي	موفرو الاستشارات مقسمون إلى شرائح DeepSeek/Fireworks، وOpenCode Go/OpenRouter، وxAI/Z.ai.
ملفات تعريف موفري Gateway الأصلي	شرائح Anthropic Opus وSonnet/Haiku الكاملة، وFireworks، وDeepSeek، وشرائح نماذج OpenCode Go الكاملة، وOpenRouter، وxAI، وZ.ai.
شرائح Plugin الحية الأصلية	Plugins A-K، وL-N، وO-Z other، وMoonshot، وxAI.
شرائح الوسائط الحية الأصلية	الصوت، وموسيقى Google، وموسيقى MiniMax، ومجموعات الفيديو A-D.

تتضمن stable كلا من native-live-src-gateway-profiles-anthropic-smoke و native-live-src-gateway-profiles-opencode-go-smoke؛ تستخدم full شرائح نماذج Anthropic وOpenCode Go الأوسع بدلا من ذلك. لا تزال إعادة التشغيل المركزة قادرة على استخدام المعرفين المجمعين native-live-src-gateway-profiles-anthropic أو native-live-src-gateway-profiles-opencode-go.

عمليات إعادة التشغيل المركزة

استخدم rerun_group لتجنب تكرار مربعات إصدار غير ذات صلة:

المعرّف	النطاق
`all`	كل مراحل التحقق الكامل من الإصدار.
`ci`	تابع CI الكامل اليدوي فقط.
`plugin-prerelease`	تابع ما قبل إصدار Plugin فقط.
`release-checks`	كل مراحل فحوصات إصدار OpenClaw.
`install-smoke`	فحص التثبيت السريع ضمن فحوصات الإصدار.
`cross-os`	فحوصات الإصدار عبر أنظمة التشغيل.
`live-e2e`	تحقق E2E للمستودع/المباشر ومسار إصدار Docker.
`package`	قبول الحزمة.
`qa`	تكافؤ QA بالإضافة إلى مسارات QA المباشرة.
`qa-parity`	مسارات تكافؤ QA والتقرير فقط.
`qa-live`	مصفوفة QA المباشرة وTelegram فقط.
`npm-telegram`	E2E لـ Telegram للحزمة المنشورة؛ يتطلب `release_package_spec` أو `npm_telegram_package_spec`.

استخدم live_suite_filter مع rerun_group=live-e2e عندما تفشل مجموعة مباشرة واحدة. تُعرَّف معرّفات المرشح الصالحة في سير عمل المباشر/E2E القابل لإعادة الاستخدام، بما في ذلك docker-live-models وlive-gateway-docker و live-gateway-anthropic-docker وlive-gateway-google-docker و live-gateway-minimax-docker وlive-gateway-advisory-docker و live-cli-backend-docker وlive-acp-bind-docker و live-codex-harness-docker. المعرّف live-gateway-advisory-docker هو معرّف إعادة تشغيل تجميعي لشرائحه الثلاث الخاصة بالمزوّدين، لذلك يظل يتوسع إلى كل وظائف Gateway الاستشارية الخاصة بـ Docker. استخدم cross_os_suite_filter مع rerun_group=cross-os عندما يفشل مسار واحد عبر أنظمة التشغيل. يقبل المرشح معرّف نظام تشغيل، أو معرّف مجموعة، أو زوج نظام تشغيل/مجموعة، على سبيل المثال windows/packaged-upgrade أو windows أو packaged-fresh. تتضمن ملخصات عبر أنظمة التشغيل توقيتات لكل مرحلة لمسارات الترقية المعبأة، وتطبع الأوامر الطويلة أسطر Heartbeat بحيث يكون تحديث Windows العالق مرئيًا قبل انتهاء مهلة الوظيفة. مسارات فحوصات إصدار QA استشارية. يُبلَّغ عن الفشل الخاص بـ QA فقط كتحذير ولا يحظر متحقق فحوصات الإصدار؛ أعد تشغيل rerun_group=qa أو qa-parity أو qa-live عندما تحتاج إلى دليل QA جديد.

الأدلة الواجب الاحتفاظ بها

احتفظ بملخص Full Release Validation كفهرس على مستوى الإصدار. فهو يربط معرّفات التشغيل التابعة ويتضمن جداول أبطأ الوظائف. عند حدوث إخفاقات، افحص سير العمل التابع أولًا، ثم أعد تشغيل أصغر معرّف مطابق أعلاه. الآثار المفيدة:

release-package-under-test من أصل التحقق الكامل من الإصدار وOpenClaw Release Checks
آثار مسار إصدار Docker ضمن .artifacts/docker-tests/
package-under-test لقبول الحزمة وآثار قبول Docker
آثار فحوصات الإصدار عبر أنظمة التشغيل لكل نظام تشغيل ومجموعة
آثار تكافؤ QA وMatrix وTelegram

ملفات سير العمل

.github/workflows/full-release-validation.yml
.github/workflows/openclaw-release-checks.yml
.github/workflows/openclaw-live-and-e2e-checks-reusable.yml
.github/workflows/plugin-prerelease.yml
.github/workflows/install-smoke.yml
.github/workflows/openclaw-cross-os-release-checks-reusable.yml
.github/workflows/package-acceptance.yml

Documentation Index

​المراحل العليا

​مراحل فحوص الإصدار

​أجزاء مسار إصدار Docker

​ملفات تعريف الإصدار

​إضافات full فقط

​عمليات إعادة التشغيل المركزة

​الأدلة الواجب الاحتفاظ بها

​ملفات سير العمل