ما هو Vercel Doctor؟
قلّل فاتورة Vercel عبر فحص قاعدة كود Next.js بحثاً عن الأنماط المكلفة.
Vercel Doctor هو أداة فحص صحة متخصصة لمشاريع Next.js المُنشورة على Vercel. يفحص قاعدة الكود بحثاً عن أنماط تزيد فاتورتك — مدة تنفيذ الدوال، والمسارات غير المخزنة مؤقتاً، والصور غير المحسّنة، والمزيد — ثم يعطيك درجة من 100 مع إصلاحات قابلة للتطبيق. كما تتكيّف الإرشادات مع الإصدار الرئيسي المكتشف من Next.js.
البدء السريع
تشغيله على مشروعك
npx -y vercel-doctor@latest .هذا كل شيء. بدون تثبيت أو إعداد. يفحص قاعدة الكود ويخرج درجة مع التشخيصات.
إصلاح المشكلات
كل تشخيص يتضمن رسالة مساعدة توضح ما يجب تغييره ولماذا. أصلح قواعد التأثير الأكبر أولاً — الأخطاء قبل التحذيرات.
إعادة التشغيل للتحقق
npx -y vercel-doctor@latest . --diffاستخدم --diff في الفروع الوظيفية لفحص الملفات التي غيّرتها فقط.
ما يفحصه
يشغّل Vercel Doctor مرحلتي تحليل بالتوازي:
- Billing lint — قواعد مبنية على AST والأنماط تكشف أنماط Next.js و Vercel المكلفة
- اكتشاف الكود الميت — يجد الملفات والصادرات والأنواع غير المستخدمة التي تنتفخ المجمّع وتُبطئ بدء التشغيل البارد
فئات القواعد
| Category | Rules | ما يلتقطه |
|---|---|---|
| Function Duration | 3 | awaits متتابعة، تسجيل حجب، I/O غير متوازي |
| Caching | 6 | force-dynamic، سياسات cache مفقودة، fetch مع no-store، آثار جانبية في معالجات GET |
| Invocations | 2 | جلب من جانب العميل في الصفحات، prefetch عدواني للروابط |
| Image Optimization | 4 | unoptimized عام، sizes مفقود، أنماط remote واسعة، SVG بدون unoptimized |
| Platform | 8 | استيرادات ثقيلة للـ Edge، وظائف cron، runtime لـ Bun، Fluid Compute، أرشيف النشر، cache Turbopack |
| Dead Code | 4 | ملفات غير مستخدمة، صادرات، أنواع، وتكرارات |
الميزات
- صفر إعداد — يعمل مباشرة على أي مشروع Next.js
- دعم monorepo — يكتشف مساحات العمل تلقائياً، يتيح اختيار المشاريع للفحص
- وضع Diff — فحص الملفات المتغيرة فقط في الفروع الوظيفية
- التسجيل — درجة 0–100 مع تسميات Great / Needs work / Critical
- متوافق مع CI — وضع غير تفاعلي للأنابيب المؤتمتة
- قابل للتكوين — تجاهل القواعد أو الملفات عبر ملف التكوين
- مهارة AI — تثبيت ك skill لـ Claude Code و Cursor و Codex والمزيد
- إرشادات واعية بالإصدار — تتكيّف التوصيات مع الإصدار الرئيسي المكتشف من Next.js
Edit on GitHub
Last updated on