← Docs

الأسئلة الشائعة

ماذا يحدث لبيانات التكلفة المتعقبة عندما أحذف قاعدة الفوترة؟

يتم دائمًا الحفاظ على بيانات التكلفة الخاصة بك. حذف قاعدة الفوترة يزيل القاعدة نفسها فقط — ولا يؤثر أبدًا على تاريخ التكلفة المتعقب. التكاليف التي كانت متطابقة مع تلك القاعدة تصبح ببساطة غير معينة وتظهر مرة أخرى في عرض التكاليف غير المعينة في المرة التالية التي تفتح فيها اللوحة. من هناك يمكنك إعادة تعيينها إلى مشروع أو عميل مختلف في أي وقت.

إذا قمت بإعادة تعيين التكاليف إلى مشروع مختلف بعد حذف قاعدة الفوترة، هل تنطبق إعادة التعيين على التكاليف السابقة أيضًا؟

نعم — إعادة التعيين تنطبق بأثر رجعي على جميع التكاليف المسجلة منذ تثبيت الامتداد. يتم تخزين أحداث التكلفة الخام الخاصة بك بشكل دائم في قاعدة البيانات المحلية ولا ترتبط أبدًا بقاعدة فوترة محددة. عند إضافة تعيين جديد، يقوم محرك المزامنة بمطابقته مع كامل تاريخك المسجل. في المرة التالية التي تقوم فيها بتشغيل Sync Now أو Backfill، يتم إنشاء أو تحديث إدخالات الوقت في برنامج الفوترة الخاص بك لكل يوم متطابق في الماضي، بما في ذلك الأيام التي كانت غير معينة سابقًا. لا يتم فقدان أي شيء بين اللحظة التي تحذف فيها قاعدة واللحظة التي تنشئ فيها قاعدة جديدة.

هل أحتاج إلى تكوين أي شيء قبل بدء تتبع التكاليف؟

لا. يبدأ Vibes to Bucks في تسجيل استخدام Cursor AI الخاص بك بمجرد تثبيته — لا حاجة إلى حساب فوترة أو تعيينات. يستخدم الامتداد إعدادات افتراضية معقولة (فاصل زمني للاستطلاع لمدة 5 دقائق، عرض باليورو، أسعار صرف ECB) ويبدأ في ملء قاعدة البيانات المحلية الخاصة بك على الفور. يمكنك استكشاف لوحة معلومات الاستخدام على الفور. مزامنة الفوترة إلى Moneybird أو Harvest هي خطوة منفصلة تقوم بتكوينها عندما تكون جاهزًا. ملاحظة: يتم تتبع التكاليف التي تحدث فقط أثناء تثبيت الامتداد وتشغيله. لا توجد طريقة لاستيراد أو استعادة التكاليف من قبل التثبيت.

ما الفرق بين خطتي Free و Pro؟

تمنحك خطة Free تتبع التكلفة الكامل: استطلاع مستمر لاستخدام Cursor AI الخاص بك، دفتر محاسبة محلي SQLite، لوحة معلومات الاستخدام مع الرسوم البيانية والفلاتر والتنقل الزمني والشرائط البيانية، وعرض متعدد العملات عبر 30 عملة. تفتح خطة Pro (€24/سنة أو €149 مدى الحياة، مع تجربة مجانية لمدة 14 يومًا) مزامنة التكامل إلى Moneybird أو Harvest، ميزانيات تكلفة AI مع تنبيهات الإنفاق الزائد، ملخصات الالتزام المدعومة بالذكاء الاصطناعي لوصف إدخالات الوقت، أوامر المزامنة الجافة والملء الخلفي، وشريط حالة لكل نافذة يعرض اسم العميل المحلول، واسم المشروع، واستخدام الميزانية الأسبوعية لمساحة العمل الحالية.

ما هو مضاعف التكلفة، ومتى يجب أن أستخدمه؟

يقوم مضاعف التكلفة بتوسيع تكلفة رمز AI الخام الخاص بك قبل تحويله إلى ساعات قابلة للفوترة. استخدمه عندما تريد فوترة العمل المدعوم بالذكاء الاصطناعي بهامش ربح — يلتقط المضاعف القيمة الحقيقية التي تقدمها: صياغة المطالبات، مراجعة وتكرار النتائج، دمج النتيجة، وتحمل المسؤولية عن المنتج النهائي. يعني مضاعف 5 أن كل €1 من إنفاق AI يصبح €5 من الإيرادات القابلة للفوترة. ابدأ عند 5 واضبط لتتناسب مع اتفاقيات العميل الخاصة بك. إذا كنت تريد فقط استرداد التكلفة بدون هامش، فاستخدم وضع التمرير بدلاً من ذلك.

هل يمكنني تعيين عدة عملاء لنفس المستودع؟

نعم. استخدم تعيين مستودع متعدد العملاء مع أنماط الفروع. كل نمط فرع يتطابق مع جهة اتصال ومشروع مختلف في برنامج الفوترة الخاص بك. على سبيل المثال، يمكن للفروع التي تتطابق مع `client-a/*` فوترة العميل A بينما يقوم فرع `dev` بفوترة العميل B بمعدل مختلف. تدعم أنماط الفروع المطابقة الدقيقة، والوايلد كارد ذو المستوى الواحد (`client-a/*`)، والوايلد كارد التكراري (`feature/**`). إذا لم يتطابق أي نمط فرع، يتم التعامل مع الحدث على أنه غير معين ويظهر في عرض التكاليف غير المعينة.

هل يعمل Vibes to Bucks عندما أكون متصلاً بخادم بعيد عبر SSH؟

نعم. يعمل الامتداد كامتداد لواجهة المستخدم، مما يعني أنه ينفذ دائمًا على جهازك المحلي — حتى عندما يكون Cursor متصلاً بمضيف بعيد عبر SSH. يبقى المجلد المحلي `~/.vibes-to-bucks/` (قاعدة بيانات الدفتر، التكوين، وملف الترخيص) دائمًا على جهاز الكمبيوتر المحمول الخاص بك، لذلك تحتوي لوحة معلومات الاستخدام دائمًا على عرض كامل لجميع الأنشطة بغض النظر عن مساحة العمل البعيدة التي تتصل بها. الشرط الوحيد للمسافات البعيدة عبر SSH هو المصادقة بدون كلمة مرور باستخدام المفاتيح حتى يتمكن الامتداد من تشغيل `git log` على البعيد لجلب رسائل الالتزام.

هل يدعم Vibes to Bucks وكلاء Cursor Cloud (التطوير المستند إلى السحابة لـ Cursor)؟

لا — التطوير المستند إلى السحابة غير مدعوم حاليًا. يعمل Vibes to Bucks من خلال مراقبة النشاط عبر نوافذ Cursor المحلية المفتوحة لديك لإسناد تكاليف AI إلى مساحة العمل الصحيحة. يعمل وكلاء Cursor Cloud بالكامل في بنية السحابة الخاصة بـ Cursor بدون نافذة Cursor محلية، لذلك لا يمكن للامتداد مراقبة أو إسناد تلك التكاليف. أي إنفاق AI يتم إنشاؤه بواسطة الوكلاء السحابيين سيظهر كتكاليف غير معينة في عرض التكاليف غير المعينة. يتم دعم التطوير المحلي وتطوير SSH البعيد بالكامل.

أين يتم تخزين بياناتي، وهل يرسل Vibes to Bucks أي شيء إلى السحابة؟

تعيش جميع بيانات التكلفة في قاعدة بيانات محلية SQLite في `~/.vibes-to-bucks/ledger.db` على جهازك. لا يتم إرسال أي شيء إلى أي خادم Vibes to Bucks. يقوم الامتداد بأربع اتصالات صادرة: إلى API لوحة معلومات Cursor لجلب أحداث الاستخدام الخاصة بك، إلى API Frankfurter (البنك المركزي الأوروبي) للحصول على أسعار الصرف اليومية، إلى API Lemon Squeezy للتحقق من ترخيص Pro الخاص بك (إعادة التحقق الدورية، لا يتم إرسال بيانات الاستخدام)، وإلى موفر الفوترة الخاص بك (Moneybird أو Harvest) عند المزامنة. لا يوجد تتبع، لا يوجد تحليلات، لا تغادر بيانات التكلفة جهازك إلا ما يذهب مباشرة إلى حساب الفوترة الخاص بك.

ماذا يحدث إذا لم يكن لدى المشروع مستودع git بعيد؟

يمكنك لا يزال تتبع وفوترة تكاليف AI له باستخدام قاعدة تعيين مستندة إلى المجلد. أضف تعيينًا بمسار `folder` بدلاً من عنوان URL للمستودع `repo` — على سبيل المثال، `/home/user/experiments`. سيتم مطابقة أي أحداث استخدام Cursor من مجلد مساحة العمل تلك مع العميل والمشروع المحددين. تعد تعيينات المجلد مفيدة أيضًا كقاعدة شاملة لالتقاط التكاليف من المجلدات التجريبية، المستودعات في مراحلها المبكرة، أو أي مساحة عمل لم يتم إعداد مستودع بعيد لها بعد.

كيف يختلف Sync Now عن Backfill؟

يدفع 'Sync Now' الساعات القابلة للفوترة إلى برنامج الفوترة الخاص بك لجميع الأيام المسجلة حتى الآن. يتيح لك 'Backfill' مزامنة نطاق تاريخي محدد — تختار تاريخ قطع ويقوم الامتداد بإنشاء أو تحديث إدخالات الوقت لكل يوم متطابق بين ذلك التاريخ واليوم. تغطي كلا الأمرين فقط التكاليف المسجلة منذ تثبيت الامتداد؛ لا توجد طريقة لاستعادة التكاليف من قبل تلك النقطة. كلا الأمرين متطابقان: إذا كان هناك إدخال وقت موجود بالفعل ليوم معين، وعميل، ومشروع ولم تتغير الإجماليات، فإن المزامنة تتخطاه دون إجراء أي استدعاء API.

ما هي العملات المدعومة، وكيف يتم جلب سعر الصرف؟

يدعم الامتداد جميع العملات الـ30 المنشورة بواسطة API Frankfurter (مصدر البنك المركزي الأوروبي)، بما في ذلك EUR، USD، GBP، CHF، JPY، CAD، AUD، والمزيد. يتم استخدام USD دائمًا كقاعدة نظرًا لأن تكاليف Cursor مقومة بالدولار الأمريكي — لعرض الدولار الأمريكي لا يلزم التحويل. بالنسبة لجميع العملات الأخرى، يتم جلب الأسعار اليومية من Frankfurter وتخزينها محليًا في SQLite. إذا كان API غير متاح، يعود الامتداد إلى قيمة `fallback_rate` في التكوين الخاص بك (الافتراضي 0.92، معاير لليورو). بالنسبة لـ Backfill، يسترجع الامتداد السعر التاريخي لكل يوم سابق محدد حتى تكون التحويلات دقيقة حتى بالنسبة للإدخالات التي تم إنشاؤها قبل أشهر. العملة الافتراضية للعرض هي اليورو ويمكن تغييرها في إعدادات الامتداد.