تثبيت TaskTrace على Cursor
دليل خطوة بخطوة لتثبيت الإضافة، ربط مفتاح API، وبدء تتبع وقت البرمجة تلقائياً.
-
1. ثبّت ملف VSIX
من واجهة الإضافات:
··· → Install from VSIX…أو عبر سطر الأوامر:
cursor --install-extension tasktrace-0.3.1.vsix
-
2. أنشئ مفتاح API
من لوحة التحكم: الإعدادات ← مفاتيح API. أنشئ مفتاحاً جديداً واحتفظ به بأمان.
-
3. اضبط المفتاح في المحرر
افتح لوحة الأوامر (
Cmd/Ctrl+Shift+P) وشغّل TaskTrace: Set API Key. يُخزَّن المفتاح في نظام التشغيل وليس في ملفات الإعدادات. -
4. ابدأ البرمجة
ستظهر ساعات اليوم في شريط الحالة خلال دقيقة. الإضافة ترسل مسارات نسبية فقط — لا يُرسل الكود المصدري أبداً.
الإعدادات المهمة
- tasktrace.apiUrl
- عنوان API (مثال: https://tasktrace.app/api/v1)
- tasktrace.projectDetection
- auto أو workspaceFolder لتحديد جذر المشروع
- tasktrace.ignorePatterns
- أنماط الملفات المستبعدة (node_modules, vendor, .env, …)
عند التشغيل داخل Cursor، تُرسل الإضافة "editor": "cursor" تلقائياً — لا إعداد إضافي مطلوب.
جاهز للتثبيت؟
أنشئ حسابك مجاناً واحصل على مفتاح API خلال دقائق.