Release and CI

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

Full Release Validation هو مظلة الإصدار. إنه نقطة الدخول اليدوية الوحيدة لإثبات ما قبل الإصدار، لكن معظم العمل يحدث في سير عمل فرعية بحيث يمكن إعادة تشغيل صندوق فاشل دون إعادة بدء الإصدار كله.

شغّله من مرجع سير عمل موثوق، عادةً main، ومرّر فرع الإصدار أو الوسم أو SHA الكامل للالتزام باعتباره ref:

bash

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

تستخدم سير العمل الفرعية مرجع سير العمل الموثوق للحزمة الاختبارية، وتستخدم ref المُدخل للمرشح قيد الاختبار. يتيح ذلك توفر منطق التحقق الجديد عند التحقق من فرع إصدار أو وسم أقدم.

يشغّل release_profile=stable وrelease_profile=full دائمًا اختبار التحمل الحي/Docker الشامل. مرّر run_release_soak=true لتضمين مسارات التحمل نفسها مع ملف تعريف البيتا. يرفض النشر المستقر بيان تحقق لا يحتوي على هذا التحمل ودليل أداء المنتج الحاجب.

يبني قبول الحزمة عادةً أرشيف tarball للمرشح من ref المحلول، بما في ذلك تشغيلات SHA الكامل المرسلة باستخدام pnpm ci:full-release. بعد نشر بيتا، مرّر release_package_spec=openclaw@YYYY.M.PATCH-beta.N لإعادة استخدام حزمة npm المنشورة عبر فحوصات الإصدار، وقبول الحزمة، والأنظمة المتعددة، وDocker لمسار الإصدار، وحزمة Telegram. استخدم package_acceptance_package_spec فقط عندما يجب أن يثبت قبول الحزمة عمدًا حزمة مختلفة. يتبع مسار حزمة Codex Plugin الحي الحالة نفسها: قيم release_package_spec المنشورة تشتق codex_plugin_spec=npm:@openclaw/codex@<version>؛ وتشغيلات SHA/الأثرية تحزم extensions/codex من المرجع المحدد؛ ويمكن للمشغلين تعيين codex_plugin_spec مباشرةً لمصادر Plugin من نوع npm: أو npm-pack: أو git:. يمنح المسار موافقة تثبيت Codex CLI الصريحة المطلوبة من ذلك Plugin، ثم يشغّل فحص Codex CLI التمهيدي ودورات وكيل OpenAI في الجلسة نفسها.

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

المرحلة	التفاصيل
حل الهدف	المهمة: `Resolve target ref`
سير العمل الفرعي: لا يوجد
يثبت: يحل فرع الإصدار أو الوسم أو SHA الكامل للالتزام ويسجل المُدخلات المحددة.
إعادة التشغيل: أعد تشغيل المظلة إذا فشل هذا.
Vitest وCI العادي	المهمة: `Run normal full CI`
سير العمل الفرعي: `CI`
يثبت: مخطط CI كامل يدوي مقابل المرجع الهدف، بما في ذلك مسارات Linux Node، وشظايا Plugin المضمّنة، وشظايا عقود Plugin والقنوات، وتوافق Node 22، و`check-`، و`check-additional-`، وفحوصات smoke للأثرية المبنية، وفحوصات المستندات، وPython skills، و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`
يثبت: smoke للتثبيت، وفحوصات الحزمة عبر الأنظمة، وقبول الحزمة، وتكافؤ QA Lab، وMatrix الحية، وTelegram الحي. تشغّل ملفات التعريف المستقرة والكاملة أيضًا مجموعات live/E2E الشاملة وأجزاء Docker لمسار الإصدار؛ ويمكن للبيتا الاشتراك باستخدام `run_release_soak=true`.
إعادة التشغيل: `rerun_group=release-checks` أو معالج release-checks أضيق.
حزمة Telegram	المهمة: `Run package Telegram E2E`
سير العمل الفرعي: `NPM Telegram Beta E2E`
يثبت: E2E مركزًا لحزمة Telegram المنشورة عند تعيين `release_package_spec` أو `npm_telegram_package_spec`. يستخدم تحقق المرشح الكامل E2E القانوني لقبول حزمة Telegram بدلًا من ذلك.
إعادة التشغيل: `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`
سير العمل الداعم: لا يوجد
الاختبارات: يحزم أو يحل كرة tar مرشحة واحدة ويرفع `release-package-under-test` لفحوصات الحزمة اللاحقة.
إعادة التشغيل: مجموعة الحزمة أو الأنظمة المتعددة أو live/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 للموفر والوضع المحددين، باستخدام كرة tar المرشحة وحزمة أساس.
إعادة التشغيل: `rerun_group=cross-os`.
المستودع وlive E2E	المهمة: `Run repo/live E2E validation`
سير العمل الداعم: `OpenClaw Live And E2E Checks (Reusable)`
الاختبارات: E2E للمستودع، وذاكرة التخزين المؤقت الحية، وبث OpenAI websocket، وشرائح الموفر الحي الأصلي و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، وE2E لحزمة Telegram القياسية مع mock-OpenAI، وفحوصات نجاة الترقية المنشورة مقابل كرة tar نفسها. تستخدم فحوصات الإصدار الحاجبة أساس أحدث إصدار منشور افتراضي؛ وتتوسع فحوصات النقع لتشمل كل إصدار 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`.
مصفوفة QA الحية	المهمة: `Run QA Lab live Matrix lane`
سير العمل الداعم: مهمة مباشرة
الاختبارات: ملف QA تعريفي حي وسريع لـ Matrix في بيئة `qa-live-shared`.
إعادة التشغيل: `rerun_group=qa-live` أو `rerun_group=qa`.
QA الحية لـ Telegram	المهمة: `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 السريع لمسار إصدار Core.
`package-update-openai`	سلوك تثبيت/تحديث حزمة OpenAI، وتثبيت Codex عند الطلب، ودورات Codex Plugin الحية، واستدعاءات أدوات Chat Completions.
`package-update-anthropic`	سلوك تثبيت وتحديث حزمة Anthropic.
`package-update-core`	سلوك الحزمة والتحديث المحايد للموفر.
`plugins-runtime-plugins`	مسارات وقت تشغيل Plugin التي تمرن سلوك Plugin.
`plugins-runtime-services`	مسارات وقت تشغيل Plugin المدعومة بالخدمات والحية؛ تتضمن OpenWebUI عند طلبها.
`plugins-runtime-install-a` حتى `plugins-runtime-install-h`	دفعات تثبيت/وقت تشغيل Plugin مقسمة للتحقق المتوازي من الإصدار.

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

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

يتحكم release_profile في الغالب في اتساع النطاق الحي/الموفر داخل فحوصات الإصدار. ولا يزيل CI الكامل العادي، أو Plugin Prerelease، أو اختبار التثبيت السريع، أو قبول الحزمة، أو QA Lab. تشغل الملفات التعريفية المستقرة والكاملة دائمًا تغطية نقع شاملة لـ E2E المستودع/live ومسار إصدار Docker. يمكن لملف beta التعريفي الاشتراك باستخدام run_release_soak=true. يوفر قبول الحزمة E2E القياسي لحزمة Telegram لكل مرشح كامل، لذلك لا تكرر المظلة ذلك المستطلع الحي.

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

الإضافات المخصصة لـ full فقط

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

المنطقة	تغطية full فقط
نماذج Docker الحية	OpenCode Go، وOpenRouter، وxAI، وZ.ai، وFireworks.
Docker live gateway	الموفرون الاستشاريون مقسمون إلى شرائح 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 أخرى، و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`	Install Smoke عبر فحوصات الإصدار.
`cross-os`	فحوصات الإصدار عبر أنظمة التشغيل.
`live-e2e`	تحقق E2E للمستودع/المباشر ومسار إصدار Docker.
`package`	قبول الحزمة.
`qa`	تكافؤ QA إضافة إلى مسارات QA المباشرة.
`qa-parity`	مسارات تكافؤ QA والتقرير فقط.
`qa-live`	Matrix/Telegram المباشران لـ QA إضافة إلى مسارات Discord وWhatsApp وSlack المقيّدة عند تمكينها.
`npm-telegram`	E2E لـ Telegram للحزمة المنشورة؛ يتطلب `release_package_spec` أو `npm_telegram_package_spec`.

استخدم live_suite_filter مع rerun_group=live-e2e عندما تفشل حزمة مباشرة واحدة. تُعرَّف معرّفات المرشحات الصالحة في سير عمل live/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. تتضمن ملخصات Cross-OS توقيتات لكل مرحلة لمسارات الترقية المعبأة، وتطبع الأوامر طويلة التشغيل أسطر Heartbeat حتى يكون تحديث Windows العالق مرئيًا قبل انتهاء مهلة المهمة.

تمنع إخفاقات فحوصات إصدار QA التحقق العادي من الإصدار. كما يمنع الانحراف المطلوب في أدوات OpenClaw الديناميكية ضمن المستوى القياسي محقق فحوصات الإصدار. قد تظل تشغيلات Tideclaw alpha تتعامل مع مسارات فحوصات الإصدار غير المتعلقة بسلامة الحزمة كاستشارية. عندما يطلب live_suite_filter صراحة مسار QA مباشرًا مقيّدًا مثل Discord أو WhatsApp أو Slack، يجب تمكين متغير المستودع المطابق OPENCLAW_RELEASE_QA_*_LIVE_CI_ENABLED؛ وإلا يفشل التقاط الإدخال بدلًا من تخطي المسار بصمت. أعد تشغيل 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

Was this useful?