skill
Vercel CLI بالرموز
نشر المشاريع وإدارتها على Vercel باستخدام المصادقة القائمة على الرمز المميز. تستخدم عند العمل مع Vercel CLI باستخدام رموز الوصول بدلا من تسجيل الدخول التفاعلي، مثل "deploy to vercel" و "set up vercel" و "add environment variables to vercel".
نبذة
# Vercel CLI مع الرموز (Tokens)
نشر وإدارة المشاريع على Vercel باستخدام واجهة سطر الأوامر (CLI) مع المصادقة القائمة على الرموز، دون الاعتماد على `vercel login`.
## الخطوة 1: تحديد موقع رمز Vercel
قبل تشغيل أي أوامر Vercel CLI، حدد مصدر الرمز. اتبع هذه السيناريوهات بالترتيب:
### أ) `VERCEL_TOKEN` مضبوط بالفعل في البيئة
```bash printenv VERCEL_TOKEN ```
إذا أعاد هذا قيمة، فأنت جاهز. انتقل إلى الخطوة 2.
### ب) الرمز موجود في ملف `.env` تحت `VERCEL_TOKEN`
```bash grep '^VERCEL_TOKEN=' .env 2>/dev/null ```
إذا وجد، قم بتصديره:
```bash export VERCEL_TOKEN=$(grep '^VERCEL_TOKEN=' .env | cut -d= -f2-) ```
### ج) الرمز موجود في ملف `.env` تحت اسم مختلف
ابحث عن أي متغير يبدو وكأنه رمز Vercel (تبدأ رموز Vercel عادة ب `vca_`):
```bash grep -i 'vercel' .env 2>/dev/null ```
افحص المخرجات لتحديد المتغير الذي يحمل الرمز، ثم قم بتصديره ك `VERCEL_TOKEN`:
```bash export VERCEL_TOKEN=$(grep '^<VARIABLE_NAME>=' .env | cut -d= -f2-) ```
### د) لم يتم العثور على رمز — اطلب من المستخدم
إذا لم تسفر أي من الطرق المذكورة أعلاه عن رمز، اطلب من المستخدم توفيره. يمكنهم إنشاء رمز وصول Vercel على vercel.com/account/tokens.
---
**هام:** بمجرد تصدير `VERCEL_TOKEN` كمتغير بيئة، تقرأه Vercel CLI بشكل طبيعي — **لا تمرره كعلامة `--token`**. وضع الأسرار في وسائط سطر الأوامر يعرضها في سجل الأوامر وقوائم العمليات.
```bash # خطأ — الرمز مرئي في سجل الأوامر وقوائم العمليات vercel deploy --token "vca_abc123"
# صحيح — CLI تقرأ VERCEL_TOKEN من البيئة export VERCEL_TOKEN="vca_abc123" vercel deploy ```
## الخطوة 2: تحديد موقع المشروع والفريق
وبالمثل، تحقق من معرف المشروع ونطاق الفريق. يسمح هذا ل CLI باستهداف المشروع الصحيح دون الحاجة إلى `vercel link`.
```bash # التحقق من البيئة printenv VERCEL_PROJECT_ID printenv VERCEL_ORG_ID
# أو التحقق من .env grep -i 'vercel' .env 2>/dev/null ```
**إذا كان لديك عنوان URL للمشروع** (مثل `https://vercel.com/my-team/my-project`)، استخرج اسم الفريق (slug):
```bash # على سبيل المثال "my-team" من "https://vercel.com/my-team/my-project" echo "$PROJECT_URL" | sed 's|https://vercel.com/||' | cut -d/ -f1 ```
**إذا كان لديك كل من `VERCEL_ORG_ID` و `VERCEL_PROJECT_ID` في بيئتك**، قم بتصديرهما — ستستخدمهما CLI تلقائيا وتتخطى أي دليل `.vercel/`:
```bash export VERCEL_ORG_ID="<org-id>" export VERCEL_PROJECT_ID="<project-id>" ```
ملاحظة: يجب تعيين `VERCEL_ORG_ID` و `VERCEL_PROJECT_ID` معا — تعيين أحدهما فقط يسبب خطأ.
## إعداد CLI
تأكد من تثبيت Vercel CLI وتحديثها:
```bash npm install -g vercel vercel --version ```
## نشر مشروع
انشر دائما ك **معاينة** ما لم يطلب المستخدم الإنتاج صراحة. اختر طريقة بناء على ما هو متاح لديك.
### نشر سريع (لديك معرف المشروع — لا حاجة للربط)
عندما يتم تعيين `VERCEL_TOKEN` و `VERCEL_PROJECT_ID` في البيئة، انشر مباشرة:
```bash vercel deploy -y --no-wait ```
مع نطاق فريق (إما عبر `VERCEL_ORG_ID` أو `--scope`):
```bash vercel deploy --scope <team-slug> -y --no-wait ```
الإنتاج (فقط عند الطلب الصريح):
```bash vercel deploy --prod --scope <team-slug> -y --no-wait ```
التحقق من الحالة:
```bash vercel inspect <deployment-url> ```
### تدفق النشر الكامل (لا يوجد معرف مشروع — تحتاج إلى ربط)
استخدم هذا عندما يكون لديك رمز وفريق ولكن لا يوجد معرف مشروع موجود مسبقا.
#### تحقق من حالة المشروع أولا
```bash # هل للمشروع git remote؟ git remote get-url origin 2>/dev/null
# هل هو مرتبط بالفعل بمشروع Vercel؟ cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null ```
#### ربط المشروع
**مع git remote (مفضل):**
```bash vercel link --repo --scope <team-slug> -y ```
يقرأ git remote ويتصل بمشروع Vercel المطابق. ينشئ `.vercel/repo.json`. أكثر موثوقية من `vercel link` العادي، الذي يطابق حسب اسم الدليل.
**بدون git remote:**
```bash vercel link --scope <team-slug> -y ```
ينشئ `.vercel/project.json`.
**الربط بمشروع معين بالاسم:**
```bash vercel link --project <project-name> --scope <team-slug> -y ```
إذا كان المشروع مرتبطا بالفعل، تحقق من `orgId` في `.vercel/project.json` أو `.vercel/repo.json` للتحقق من مطابقته للفريق المقصود.
#### النشر بعد الربط
**أ) نشر Git Push — لديه git remote (مفضل)**
تؤدي عمليات دفع Git إلى عمليات نشر Vercel تلقائية.
1. **اسأل المستخدم قبل الدفع.** لا تدفع أبدا بدون موافقة صريحة. 2. الالتزام والدفع: ```bash git add . git commit -m "deploy: <description of changes>" git push ``` 3. يقوم Vercel بالبناء تلقائيا. تحصل الفروع غير الإنتاجية على عمليات نشر معاينة. 4. استرداد عنوان URL للنشر: ```bash sleep 5 vercel ls --format json --scope <team-slug> ``` ابحث عن أحدث إدخال في مصفوفة `deployments`.
**ب) نشر CLI — لا يوجد git remote**
```bash vercel deploy --scope <team-slug> -y --no-wait ```
التحقق من الحالة:
التثبيت
شغل هذا الأمر
npx skills add vercel-labs/agent-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add vercel-labs/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/vercel-cli-with-tokens` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة Vercel CLI بالرموز؟
نشر المشاريع وإدارتها على Vercel باستخدام المصادقة القائمة على الرمز المميز. تستخدم عند العمل مع Vercel CLI باستخدام رموز الوصول بدلا من تسجيل الدخول التفاعلي، مثل "deploy to vercel" و "set up vercel" و "add environment variables to vercel".
كيف أثبت Vercel CLI بالرموز؟
شغل هذا الأمر في الطرفية:
npx skills add vercel-labs/agent-skillsمع أي أدوات ذكاء اصطناعي تعمل Vercel CLI بالرموز؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور Vercel CLI بالرموز؟
طورها vercel-labs.
هل Vercel CLI بالرموز مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى