انتقل إلى المحتوى الرئيسي

تثبيت ملحقات VSIX في Cursor بعد تغييرات السوق

Cursor VSIX Extensions

قامت Microsoft مؤخرًا بإزالة خيار تنزيل VSIX المباشر من موقع سوق VS Code على الويب. يؤثر هذا التغيير على مستخدمي Cursor الذين يحتاجون إلى تثبيت الملحقات يدويًا. يوضح لك هذا الدليل الحلول البديلة الحالية للحصول على أي ملحق VS Code في Cursor.

لماذا تثبيت ملفات VSIX؟​

قد تحتاج إلى تثبيت VSIX يدويًا عندما:

  • لا يكون الملحق متاحًا في السوق المدمج في Cursor
  • تحتاج إلى إصدار معين من الملحق
  • تعمل في وضع عدم الاتصال أو خلف جدار حماية مؤسسي
  • تمت إزالة الملحق من السوق
  • تريد تثبيت إصدار تجريبي أو بيتا

الطريقة 1: التنزيل من VS Code (موصى به)​

أسهل طريقة للحصول على ملفات VSIX هي من خلال VS Code نفسه.

الخطوة 1: تثبيت VS Code (إذا لم يكن مثبتًا بالفعل)​

التنزيل من code.visualstudio.com

الخطوة 2: تنزيل الملحق​

  1. افتح VS Code
  2. انتقل إلى عرض الملحقات (Cmd/Ctrl + Shift + X)
  3. ابحث عن الملحق الذي تحتاجه
  4. انقر فوق أيقونة الترس (⚙️) بجانب الملحق
  5. حدد "تنزيل VSIX"

VS Code Download VSIX

الخطوة 3: التثبيت في Cursor​

  1. افتح Cursor
  2. انتقل إلى عرض الملحقات (Cmd/Ctrl + Shift + X)
  3. انقر فوق قائمة ... (مزيد من الإجراءات)
  4. حدد "التثبيت من VSIX"
  5. اختر ملف .vsix الذي تم تنزيله
  6. أعد تشغيل Cursor إذا طُلب منك ذلك

الطريقة 2: استخدام سطر الأوامر​

لمستخدمي الطاقة، استخدم سطر الأوامر للتنزيل والتثبيت.

التنزيل عبر VS Code CLI​

# سرد الإصدارات المتاحة
vscode --list-extensions --show-versions

# تنزيل ملحق معين
# (استخدم طريقة VS Code GUI أعلاه للتنزيلات الموثوقة)

التثبيت عبر Cursor CLI​

# فتح Cursor من الطرفية
cursor --install-extension /path/to/extension.vsix

# أو باستخدام المسار الكامل
"/Applications/Cursor.app/Contents/MacOS/Cursor" --install-extension extension.vsix

الطريقة 3: API السوق المباشر (متقدم)​

للتنزيلات التلقائية، استخدم API سوق VS Code مباشرةً.

باستخدام curl​

# الحصول على تفاصيل الملحق
EXTENSION="publisher.extension-name"
curl -s "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${EXTENSION%%.*}/vsextensions/${EXTENSION#*.}/latest/vspackage" \
  -H "Accept: application/json;api-version=7.2-preview.1" \
  -o extension.vsix

باستخدام PowerShell​

$Publisher = "esbenp"
$Name = "prettier-vscode"
$Url = "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/$Publisher/vsextensions/$Name/latest/vspackage"
Invoke-WebRequest -Uri $Url -OutFile "$Name.vsix"

باستخدام سكريبت Python​

import requests

def download_vsix(publisher, name, version="latest"):
    url = f"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{name}/{version}/vspackage"
    response = requests.get(url)
    if response.status_code == 200:
        with open(f"{name}.vsix", "wb") as f:
            f.write(response.content)
        print(f"Downloaded {name}.vsix")
    else:
        print(f"Failed: {response.status_code}")

download_vsix("esbenp", "prettier-vscode")

الطريقة 4: من سجل Open VSX​

Open VSX هو بديل مفتوح المصدر لسوق VS Code.

التنزيل من الموقع​

  1. قم بزيارة open-vsx.org
  2. ابحث عن ملحقك
  3. انقر فوق "تنزيل"
  4. ثبّت VSIX في Cursor

باستخدام Open VSX CLI​

# تثبيت ovsx
npm install -g ovsx

# البحث عن الملحقات
ovsx search prettier

# التنزيل (إذا كان مدعومًا من السجل)
# تحتاج معظم الملحقات إلى تنزيل يدوي من الموقع

الطريقة 5: البناء من المصدر​

للملحقات مفتوحة المصدر، قم ببناء VSIX بنفسك.

الاستنساخ والبناء​

# استنساخ مستودع الملحق
git clone https://github.com/publisher/extension-name.git
cd extension-name

# تثبيت التبعيات
npm install

# بناء الملحق
npm run compile

# التعبئة كـ VSIX
npx vsce package

# سيكون ملف .vsix في الدليل الحالي

التثبيت في Cursor​

cursor --install-extension ./extension-name-1.0.0.vsix

الملحقات الشائعة ومصادر VSIX الخاصة بها​

الملحقالناشرالمصدر البديل
PrettieresbenpOpen VSX, VS Code GUI
ESLintMicrosoftVS Code GUI only
GitLenseamodioOpen VSX, VS Code GUI
DockerMicrosoftVS Code GUI only
PythonMicrosoftVS Code GUI only
Live ShareMicrosoftVS Code GUI only

استكشاف أخطاء التثبيت​

خطأ "Corrupt ZIP"​

السبب: تنزيل غير مكتمل

الإصلاح:

# التحقق من ملف VSIX
unzip -t extension.vsix

# إعادة التنزيل إذا كان تالفًا

خطأ "Extension Not Compatible"​

السبب: عدم تطابق الإصدار بين VS Code و Cursor

الإصلاح:

  1. تحقق من إصدار VS Code الخاص بـ Cursor في المساعدة > حول
  2. قم بتنزيل إصدار متوافق من الملحق
  3. أو قم بتعديل حقل engines.vscode في VSIX

الملحقات لا تظهر في Cursor​

الإصلاح:

# سرد الملحقات المثبتة
cursor --list-extensions

# التحقق من الأخطاء
cursor --verbose --install-extension extension.vsix

أفضل الممارسات​

إدارة الإصدارات​

تتبع ملفات VSIX الخاصة بك:

extensions/
  prettier-vscode-10.1.0.vsix
  eslint-2.4.4.vsix
  gitlens-14.4.1.vsix

الإعداد التلقائي​

أنشئ سكريبت إعداد للأجهزة الجديدة:

#!/bin/bash
# setup-cursor-extensions.sh

EXTENSIONS=(
  "./extensions/prettier-vscode.vsix"
  "./extensions/eslint.vsix"
  "./extensions/gitlens.vsix"
)

for ext in "${EXTENSIONS[@]}"; do
  if [ -f "$ext" ]; then
    cursor --install-extension "$ext"
  else
    echo "Missing: $ext"
  fi
done

استراتيجية النسخ الاحتياطي​

قم بتصدير قائمة الملحقات الخاصة بك بانتظام:

# حفظ الملحقات المثبتة
cursor --list-extensions > extensions.txt

# لاحقًا، إعادة التثبيت
cat extensions.txt | xargs -L1 cursor --install-extension

مرجع سريع​

المهمةالأمر
تثبيت VSIXcursor --install-extension file.vsix
سرد الملحقاتcursor --list-extensions
إلغاء تثبيت الملحقcursor --uninstall-extension publisher.name
تعطيل الملحقcursor --disable-extension publisher.name
تمكين الملحقcursor --enable-extension publisher.name

الموارد ذات الصلة​