أداة مطوّرين مفتوحة المصدر

LLM Cost & Token Estimator

إضافةٌ لـVS Code وخادمُ MCP، كلاهما مفتوح المصدر، يجيبان عن السؤالين اللذين يطرحهما طوال يومه كلُّ مهندس يبني على النماذج اللغوية — كم رمزًا في هذا الموجّه، وكم يكلّف على كلّ نموذج — داخل المحرّر مباشرةً، عبر 28 نموذجًا، بلا مفتاح واجهة برمجة وبلا استدعاء شبكيّ واحد.

مباشر

العميل: Open Source
الدور: المُنشئ والقائم على الصيانة
المدة: Jun 2026
تاريخ التسليم: Jun 2026

TypeScriptVS Code Extension APIjs-tiktokenModel Context Protocol SDKesbuildVitestESLintGitHub ActionsMIT licence

ابدأ مشروعك زيارة الموقع

المستودع

github.com/waqarulwahab/llm-cost-estimator

main

فتح المستودع

نظرة عامة

LLM Cost & Token Estimator أداةُ مطوّرين مفتوحة المصدر تجيب عن السؤالين اللذين يطرحهما طوال يومه كلُّ مهندس يبني على النماذج اللغوية — كم رمزًا في هذا الموجّه؟ وكم سيكلّف هذا الاستدعاء؟ — دون مغادرة المحرّر، ودون مفتاح واجهة برمجة، ودون طلب شبكيّ واحد.

وهي تُشحَن في هيئة منتجَين اثنين من محرّك واحد. فـإضافةُ VS Code تضع الجواب في خمسة مواضع: تلميحٌ عند التحويم فوق أيّ نصّ موجّه، وCodeLens فوق الموجّهات المكتشَفة، وقراءةٌ حيّة في شريط الحالة للتحديد الجاري، ولوحةُ مقارنة كاملة بمنزلقٍ متحرّك لعدد رموز الإخراج، ومسحٌ يعمّ مساحة العمل يُبلّغ بما يكلّفه كلُّ موجّه في المشروع في التشغيلة الواحدة. أمّا خادمُ MCP فيكشف المحرّك نفسه ثلاثَ أدوات لـClaude أو Cursor أو أيّ عميل MCP، فيمكن طرح السؤال نفسه في محادثة بدلًا من ذلك.

ويُسعَّر ثمانيةٌ وعشرون نموذجًا من سبعة مزوّدين جاهزةً بلا تهيئة — سلسلة GPT-4o/4.1/o، وClaude 4/3.7/3.5، وGemini 2.5/2.0/1.5، وDeepSeek، وMistral، وLlama، وGrok — والمقارنة دائمًا جنبًا إلى جنب، والأرخصُ أوّلًا، لأنّ المقصود هو المفاضلة لا رقمٌ واحد. وهي مرخّصة برخصة MIT ومنشورة على Open VSX وnpm والسجلّ الرسمي لـMCP.

التحدي

الصيغة الصادقة لهذه المسألة أصعب من «عُدَّ الرموز».

فوحدها OpenAI تنشر مُقطِّع رموز يمكن تشغيله محلّيًّا. أمّا Anthropic وGoogle وسائرُهم فلا، ومن ثمّ فكلُّ أداة تدّعي عدًّا دقيقًا لـClaude أو Gemini إنّما تُخمّن وتُخفي أنّها تُخمّن. وأداةُ تكلفةٍ تقدّم التخمين حقيقةً في صمت أسوأ من ألّا تكون هناك أداة أصلًا — فعلى رقمها سيبني مهندسٌ قرار ميزانية حقيقيًّا.

وعددُ الرموز نصفُ الثمن لا كلُّه. فما يكلّفه الاستدعاء فعلًا هو الإدخال مضافًا إليه الإكمالُ الذي يكتبه النموذج ردًّا، والإخراجُ مُسعَّر عادةً بأضعاف سعر الإدخال. والأداةُ التي تُبلّغ عن رموز الإدخال وحدها تُخطئ الرقم الذي يهمّ بفارق رتبةٍ كاملة، وطولُ الإكمال تخمينٌ يملكه المستخدم لا الأداة.

ثمّ يأتي شكل الأداة نفسه. فإضافةُ محرّرٍ تمدّ يدها إلى واجهة تسعير برمجية أداةٌ تفشل خارج الشبكة، وتُسرّب ما تكتبه، وتطلب مفتاحًا قبل أن تنفع. وكان على المحرّك الواحد أن يخدم واجهتين أماميّتين شديدتَي الاختلاف — محرّرًا له واجهة مستخدم، وعميلَ محادثة له بروتوكول أدوات — دون أن تُفرِّع إحداهما المنطق.

تصميم النظام

كيف يعمل

01/04

حوّم فوق موجّه، تَرَ المفاضلة

كيف يصير نصُّ موجّه في ملفّ مقارنةَ تكلفة مرتّبة وصادقة، دون استدعاء شبكيّ واحد.

1يُتعرَّف على نصّ حرفيّ بأنّه شبيه بالموجّه من شكله ومن المُعرّف المجاور له
2ويُقطَّع النصّ إلى رموز مرّةً واحدة لكلّ ترميز — تقطيعًا دقيقًا لـOpenAI وتقريبيًّا لما سواها — ويُخزَّن مؤقّتًا فلا يُعاد تقطيعه للنماذج التي تشترك في ترميز واحد
3ويُسعَّر كلُّ نموذج بسعرَي الإدخال والإخراج الخاصَّين به، بطول الإكمال المفترَض المأخوذ من الإعدادات
4وتُرتَّب النتائج بالأرخص أوّلًا، وتُعلَّم التقريبات، ويُرفع تنبيهٌ عن كلّ ما يتجاوز نافذة سياق النموذج
5وتُعرَض المقارنة في مكانها — في التلميح وفي CodeLens وفي شريط الحالة — من النتيجة نفسها

اسحب الافتراض

كيف تجعل اللوحةُ تخمينَ رموز الإخراج — وهو المتغيّر الذي يحكم الفاتورة — شيئًا يمكن تحريكه.

1تتلقّى اللوحة الكتالوج كلَّه مُسعَّرًا على الافتراض الجاري، ومعه أسعار كلّ نموذج خامًا
2وتحريكُ المنزلق يُعيد حساب كلّ صفّ داخل اللوحة نفسها، فلا حاجة إلى إعادة تقطيع النصّ
3فيُعاد ترتيب ثمانية وعشرين نموذجًا في الحال، ويمكن فرز الأعمدة أو تصفيتها حتى المجموعة المُهيّأة وحدها
4ويمكن نسخ الجدول الناتج بصيغة Markdown لطلب دمج أو لنقاش ميزانية

سعّر المشروع كلَّه

كيف يصير مستودعٌ مليء بالموجّهات رقمًا واحدًا يحمله المهندس إلى اجتماع تخطيط.

1أمرٌ واحد يمشي على مساحة العمل ويمسح كلَّ ملفّ مدعوم بحثًا عن النصوص الشبيهة بالموجّهات
2ويُقطَّع كلُّ موجّه إلى رموز ويُسعَّر على أوّل نموذج مُهيّأ، وتُجمَّع الإجماليات لكلّ ملفّ
3ويعرض تقريرٌ التكلفةَ المقدَّرة في التشغيلة الواحدة وعددَ الموجّهات وعددَ الرموز، مرتَّبةً بالتكلفة
4وكلُّ صفّ يوصل مباشرةً إلى الموجّه الذي أنتجه

وسمٌ واحد يشحن المُخرَجَين

كيف يتحوّل وسمُ إصدارٍ إلى إضافة منشورة وخادم MCP منشور، بلا خطوة يدوية واحدة.

1كلُّ دفعة git تُشغّل المُدقّق، وفحصَ الأنواع الصارم، وحزمتَي اختبارات الوحدات والحِمل، وتشغيلةً من طرف إلى طرف على محرّر مُحاكى
2ووسمُ الإصدار يُعيد التحقّق كاملًا، ثمّ يحزم الإضافة ويبني خادم MCP
3ويُنشَر الاثنان إلى سجلَّيهما، ويُرفَق البناء بإصدار على GitHub
4ويُنشَر بيانُ السجلّ الخاصّ بخادم MCP في التشغيلة نفسها، فلا ينحرف أحدهما عن الآخر أبدًا

أبرز الميزات

مقارنةٌ متعدّدة النماذج — عدد الرموز والتكلفة المقدَّرة على كلّ نموذج مُهيّأ، جنبًا إلى جنب، والأرخصُ أوّلًا
خمسة مواضع داخل المحرّر — تلميحٌ عند التحويم، وCodeLens فوق الموجّهات المكتشَفة، وقراءةٌ حيّة في شريط الحالة، ولوحةُ مقارنة، وتقريرُ مسحٍ لمساحة العمل
28 نموذجًا من سبعة مزوّدين جاهزةً بلا تهيئة، مع منتقٍ مرئيّ لاختيار ما يُقارَن منها
تقطيعٌ دقيق لرموز OpenAI على الجهاز نفسه؛ وكلُّ عدٍّ تقريبيّ مُعلَّم بعلامة `~` وبتنويه صريح
منزلقٌ حيّ لعدد رموز الإخراج يُعيد ترتيب الكتالوج كلّه في الحال، مع أعمدة قابلة للفرز ومُرشِّح للنماذج المُهيّأة
مسحُ مساحة العمل — أمرٌ واحد يُبلّغ بالتكلفة المقدَّرة في التشغيلة الواحدة لكلّ موجّه في المشروع، مع تفصيلٍ قابل للنقر لكلّ ملفّ
نماذج مخصّصة وأسعار متفاوَض عليها من الإعدادات، يُتحقَّق منها عند التحميل، والمُدخلاتُ غير الصالحة يُبلَّغ عنها بدل إسقاطها
تسعيرٌ حيّ اختياريّ من مصدر عامّ مصان، مُخزَّن مؤقّتًا، ببديل احتياطي يعمل خارج الشبكة — إضافةً إلى تنبيهات نافذة السياق، والتصدير بصيغة Markdown، وخادمِ MCP يكشف المحرّك نفسه لأيّ عميل MCP

Outcomes

شحنتُ أداةَ مطوّرين عاملة من طرف إلى طرف ونشرتُها في ثلاثة سجلّات — الإضافة إلى Open VSX، وخادم MCP إلى npm، والخادم إلى السجلّ الرسمي لـMCP
وبنيتُ محرّكًا واحدًا يخدم منتجَين: فخادم MCP يستورد مُقطِّع الرموز وجدول الأسعار والمُقدِّر من الإضافة نفسها بدل إعادة تنفيذها، فلا يمكن للاثنين أن يختلفا أبدًا
وجعلتُ عدمَ يقين الأداة نفسِها ميزةً — فالعدُّ الدقيق والعدُّ التقريبيّ متمايزان بصريًّا في كلّ موضع، والأسعارُ المضمَّنة موسومة بأنّها استرشادية وقابلة للتحقّق عند كلّ مزوّد
وأبقيتُها محلّيّة الأساس حقًّا: تشحن الإضافة اعتمادية واحدة وقت التشغيل، وبلا مفتاح واجهة برمجة، وبلا حساب، وبلا استدعاء شبكيّ واحد في المسار الافتراضي
وحاكمتُها إلى معايير المنتجات لا إلى معايير المشاريع الجانبية — 60 اختبارًا للوحدات وللحِمل، وأنواعٌ صارمة، ومُدقّقٌ، وتشغيلةٌ من طرف إلى طرف تحرس كلّ دفعة git، مع توثيق للمساهمين ومدوّنة سلوك وقوالب بلاغات في المستودع
وفتحتُ مصدرها برخصة MIT، وقد بدأ المستودع يجتذب تفريعات وطلبات دمج من خارجه