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

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 دائما مسارات التحمل بحيث لا يفقد ملف التعريف الاستشاري الواسع التغطية بصمت. يبني قبول الحزمة عادة كرة tar الخاصة بالمرشح من ref المحلول، بما في ذلك تشغيلات SHA الكامل المرسلة باستخدام pnpm ci:full-release. بعد النشر، مرر package_acceptance_package_spec=openclaw@YYYY.M.D (أو openclaw@beta/openclaw@latest) لتشغيل مصفوفة الحزمة/التحديث نفسها على حزمة npm المشحونة بدلا من ذلك.

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

المرحلة	التفاصيل
حل الهدف	المهمة: `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. إعادة التشغيل: `rerun_group=plugin-prerelease`.
فحوص الإصدار	المهمة: `Run release/live/Docker/QA validation` مسار العمل الفرعي: `OpenClaw Release Checks` يثبت: تجربة التثبيت، وفحوص الحزمة عبر أنظمة التشغيل، وقبول الحزمة، وتكافؤ QA Lab، ومصفوفة Matrix الحية، وTelegram الحي. مع `run_release_soak=true` أو `release_profile=full`، يشغل أيضا مجموعات الاختبارات الحية/E2E الشاملة وأجزاء مسار إصدار Docker. إعادة التشغيل: `rerun_group=release-checks` أو مقبض أضيق لفحوص الإصدار.
أثر الحزمة	المهمة: `Prepare release package artifact` مسار العمل الفرعي: لا يوجد يثبت: ينشئ كرة tar الأب `release-package-under-test` في وقت مبكر بما يكفي للفحوص المواجهة للحزم التي لا تحتاج إلى انتظار `OpenClaw Release Checks`. إعادة التشغيل: أعد تشغيل المظلة أو وفر `npm_telegram_package_spec` لـ `rerun_group=npm-telegram`.
حزمة Telegram	المهمة: `Run package Telegram E2E` مسار العمل الفرعي: `NPM Telegram Beta E2E` يثبت: إثبات حزمة Telegram المدعوم بأثر الأب لـ `rerun_group=all` مع `release_profile=full`، أو إثبات Telegram للحزمة المنشورة عند تعيين `npm_telegram_package_spec`. إعادة التشغيل: `rerun_group=npm-telegram` مع `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` لفحوصات لاحقة موجهة للحزمة. إعادة التشغيل: الحزمة المتأثرة، أو مجموعة عبر أنظمة التشغيل، أو مجموعة الحية/E2E.
اختبار التثبيت السريع	المهمة: `Run install smoke` سير العمل الداعم: `Install Smoke` الاختبارات: مسار التثبيت الكامل مع إعادة استخدام صورة الاختبار السريع 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`.
المستودع و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 مع 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`.
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 عند الطلب.
`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 Prerelease، أو اختبار التثبيت السريع، أو قبول الحزمة، أو 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 حي لـOpenAI على Docker.
`stable`	ملف الموافقة الافتراضي للإصدار.	`minimum` بالإضافة إلى اختبار Anthropic السريع، وGoogle، وMiniMax، والخلفية، وحزمة الاختبار الحية الأصلية، وخلفية CLI حية على Docker، وربط Docker ACP، وحزمة Codex على Docker، وشريحة اختبار سريع لـ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 الأخرى، و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 المنشورة؛ يتطلب `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. تتضمن ملخصات عبر أنظمة التشغيل توقيتات لكل مرحلة لمسارات الترقية المعبأة، وتطبع الأوامر طويلة التشغيل أسطر 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

CLI commands

RPC and API

Codex harness

Templates

Technical reference

Concept internals

Project

Release and CI

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

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

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

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

ملفات الإصدار الشخصية

إضافات full فقط

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

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

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

CLI commands

RPC and API

Codex harness

Templates

Technical reference

Concept internals

Project

Release and CI

Documentation Index

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

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

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

​ملفات الإصدار الشخصية

​إضافات full فقط

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

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

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

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

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

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

ملفات الإصدار الشخصية

إضافات full فقط

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

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

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