أداة سطر أوامر مبنية على Go تقوم بمسح قواعد الأكواد للتأكد من جاهزيتها للإطلاق، حيث تكتشف التكوينات المفقودة، مشكلات الأمان، تسريبات الأسرار، والفجوات في التكامل قبل النشر في الإنتاج.
Preflight.sh هي أداة سطر أوامر تفحص قاعدة الشيفرة الخاصة بك للتأكد من جاهزيتها للإطلاق. تحدد الإعدادات المفقودة، ومشكلات التكامل، والمخاوف الأمنية، وثغرات بيانات SEO الوصفية، والأخطاء الشائعة الأخرى قبل أن تنشر إلى بيئة الإنتاج.
لا تُحرج نفسك في بيئة الإنتاج. ما عليك سوى تشغيل الأمر.
brew install preflightsh/preflight/preflight
npm install -g @preflightsh/preflight
go install github.com/preflightsh/preflight@latest
docker pull ghcr.io/preflightsh/preflight
curl -fsSL https://preflight.sh/install.sh | sh
نزّل أحدث إصدار من GitHub Releases.
بدءًا من الإصدار v0.23.0، يحمل كل أرشيف مصدر بناء موقّعًا. للتحقق من أن أحد التنزيلات قد بُني بواسطة سير عمل الإصدار الخاص بهذا المستودع:
gh attestation verify preflight_<version>_<os>_<arch>.tar.gz --repo preflightsh/preflight
# Initialize in your project directory
cd your-project
preflight init
# (asks before replacing an existing preflight.yml; --force skips the question)
# In a script or CI job, where nobody can answer, pass --yes to accept the
# detected defaults. Without it, init stops and writes nothing when its input
# ends before the questions do.
# Run all checks
preflight scan
# Scan a specific directory
preflight scan /path/to/project
# Run with verbose output (shows which files matched each check)
preflight scan --verbose
preflight scan -v # short form
# Run in CI mode with JSON output
preflight scan --ci --format json
# Run only specific checks, or skip some, for fast iteration
# (one-off; unlike `preflight ignore` it doesn't change preflight.yml)
preflight scan --only seo_meta,og_twitter
preflight scan --skip vulnerability,secrets
# Silence a check
preflight ignore sitemap
# Unsilence a check
preflight unignore sitemap
# List all check IDs
preflight checks
يتضمن هذا المستودع مهارة وكيل متوافقة مع skills.sh في skills/preflight/SKILL.md. وهي تمنح وكلاء البرمجة سير عمل Preflight قابلًا للتكرار: فحص preflight.yml، وتشغيل فحوصات آمنة لـ CI، وفرز النتائج، وتجنّب التجاهلات غير الآمنة، وإعادة تشغيل التحقق، والإبلاغ عن مخاطر الإطلاق المتبقية.
اعرض المهارة من هذا المستودع:
# With Bun
bunx --yes skills add preflightsh/preflight --list
# Or with npm
npx --yes skills add preflightsh/preflight --list
ثبّت مهارة Preflight فقط:
# With Bun
bunx --yes skills add preflightsh/preflight --skill preflight
# Or with npm
npx --yes skills add preflightsh/preflight --skill preflight
يمكن استخدام Preflight بالكامل من سطر الأوامر دون حساب. تضيف لوحة المعلومات الاختيارية على app.preflight.sh سجلاً مستضافًا لفحوصاتك واقتراحات إصلاح مولّدة بالذكاء الاصطناعي لكل نتيجة. لا يغادر كودك جهازك أبدًا: يجري الفحص محليًا، ولا يُرسل أي شيء ما لم تنشر. رموز حامل لوحة المعلومات مقيّدة بالأصل الذي أصدرها، ولا يمكن لإعادة التوجيه الموثّقة عبور الأصول أو خفض HTTPS.
security_headers، وssl، وwww_redirect، وemail_auth، وdebug_statements، وerror_pages، وimage_optimization، وlegal_pages، وفحوصات ملفات المعايير الويب. تتضمن debug_statements وimage_optimization ما يصل إلى خمس نتائج (ملف وسطر، أو ملف وحجم).seoMeta وأسماء ملفات env، وكذلك بيانات اعتماد URL وسلاسل الاستعلام والأجزاء.secrets، وvulnerability، وenv_parity، وhealth_endpoint، وstripe، وindex_now، وكل فحص خدمة، وأي خطأ "Check failed:".preflight.yml منقّح: اسم المشروع، والحزمة التقنية، وأصول URL، وتعريفات الخدمات، والفحوصات المفعّلة. تُسقط مفتاح IndexNow وعنوان URL لخطاف Stripe وقائمة السماح للأسرار وأسماء ملفات env ومسار الصحة ومسار التخطيط وقائمة التجاهل.لا يتم إرسال الاقتراحات أو محتويات الملفات أو مخرجات أدوات التدقيق أو القيم السرية أبدًا.
أنشئ حسابًا مجانيًا، ثم اربط سطر الأوامر:
preflight auth login # opens your browser to authorize this CLI
preflight auth status # show who you're logged in as
preflight auth logout # remove stored credentials
انشر فحصًا إلى لوحة التحكم الخاصة بك باستخدام --publish. يطبع رابطًا لعرض التشغيل. النشر بأفضل جهد ممكن: إذا كنت غير متصل بالإنترنت أو لم تسجّل الدخول، فإن الفحص لا يزال يعمل وينتهي بشكل طبيعي.
preflight scan --publish
في لوحة المعلومات تحصل على تفصيل النجاح/التحذير/الفشل لكل تشغيل، وقائمة نتائج الفحوصات، وسجل لكل مشروع حتى تتمكن من رؤية ما تغيّر بين عمليات النشر.
يمكنك أيضًا قراءة ذلك السجل من الطرفية باستخدام preflight history:
preflight history # recent runs across your projects
preflight history --here # only the current project's runs
preflight history <run-id> # one run's full check results
preflight history --here --format json # machine-readable, for agents
يتطلب preflight auth login. يطابق --here عمليات التشغيل بالمستودع الحالي عبر git remote الخاص به، وهو المفتاح نفسه المستخدم عند النشر. يُربط التطبيق المفحوص من دليل فرعي داخل مستودعه (تطبيق واحد في monorepo) بذلك الدليل الفرعي أيضاً، لذا ينشر apps/web وapps/api إلى مشروعين منفصلين في لوحة التحكم. يحمل history --format json الحقلين schema_version وcli_version نفسيهما الموجودين في JSON الخاص بالفحص.
على CI أو جهاز آخر بلا متصفح، سجّل الدخول باستخدام رمز مميز بدلاً من ذلك: يقرأ preflight auth login --token - الرمز من stdin، أو عيّن PREFLIGHT_TOKEN ثم شغّل preflight auth login. في كلتا الحالتين يُتحقق من الرمز ويُخزَّن كما في تسجيل الدخول عبر المتصفح؛ وتقرأ الأوامر اللاحقة بيانات الاعتماد المخزنة، لا المتغير.
افتح أي فحص فاشل أو تحذيري في عملية تشغيل منشورة لإنشاء إصلاح خطوة بخطوة مخصص لحزمة التقنيات المكتشفة لديك، مع أوامر وشيفرة جاهزة للنسخ.