khalas

name	khalas
description	Arabic text summarization and token optimization
version	1.0.0
author	Mousa Abu Mazin
license	MIT
platforms	["linux","macos"]
prerequisites	{"commands":["khalas"],"env_vars":[]}
metadata	{"hermes":{"tags":["nlp","summarization","tokens","arabic"]}}

khalas — محسّن التوكنات العربية

أداة لتقليل تكلفة البرومبتات العربية وتحليل كفاءة التوكنات.

الأوامر

مقارنة عربي vs إنجليزي

khalas compare "النص العربي هنا"

مثال عملي:

khalas compare "الذكاء الاصطناعي يغيّر طريقة عملنا في كل المجالات"

النتيجة المتوقعة:

╔══════════════════════════════════════════╗
║        khalas — Token Comparison         ║
╠═══════════════╦═════════╦════════════════╣
║               ║ Arabic  ║ English        ║
╠═══════════════╬═════════╬════════════════╣
║ Text          ║ الذكاء… ║ AI is chang…   ║
║ Characters    ║ 48      ║ 52             ║
║ Tokens (GPT4) ║ 28     ║ 11             ║
║ Tokens (Claude)║ 24    ║ 10             ║
║ Ratio         ║ 2.5x   ║ 1.0x           ║
║ Cost impact   ║ +150%  ║ baseline       ║
╚═══════════════╩═════════╩════════════════╝

تحسين برومبت

khalas optimize "النص العربي الطويل هنا"

مثال عملي:

khalas optimize "أريد منك أن تقوم بكتابة مقالة طويلة ومفصّلة حول موضوع الذكاء الاصطناعي وتأثيره على سوق العمل في المملكة العربية السعودية"

النتيجة المتوقعة:

الأصلي:  38 tokens
المحسّن: 22 tokens (−42%)

النص المحسّن:
"اكتب مقالة مفصّلة عن تأثير الذكاء الاصطناعي على سوق العمل السعودي"

التحسينات:
  ✓ حذف "أريد منك أن تقوم بـ" → أمر مباشر
  ✓ حذف "طويلة و" → "مفصّلة" تكفي
  ✓ اختصار "المملكة العربية السعودية" → "السعودي"

حساب التوفير

khalas savings "النص"

مثال — حساب التوفير لبرومبت كامل:

khalas savings "بناء على المعلومات المذكورة أعلاه، أريد منك أن تقوم بتلخيص النقاط الرئيسية مع التركيز على الجوانب المهمة"

النتيجة المتوقعة:

التوكنات الأصلية:  42
التوكنات بعد التحسين: 18
التوفير: 24 tokens (57%)
التوفير الشهري (10K requests): $2.40 → $1.03

شرح مكان الهدر

khalas explain "النص"

مثال:

khalas explain "بِسْمِ اللَّهِ الرَّحْمَنِ الرَّحِيمِ"

النتيجة المتوقعة:

تحليل هدر التوكنات:
━━━━━━━━━━━━━━━━━━━━━━

مع التشكيل:   12 tokens
بدون تشكيل:    6 tokens
الهدر:         6 tokens (+100%)

مصادر الهدر:
  🔴 التشكيل (6 tokens): كل حركة تُحسب كتوكن منفصل
  🟡 حروف العطف: "الرَّحْمَنِ الرَّحِيمِ" = 6 tokens (الألف واللام منفصلة)

التوصية: احذف التشكيل إلا إذا كان ضروريا للمعنى

دعم اللهجات

الأداة تفهم الفرق في كفاءة التوكنات بين:

• الفصحى: الأعلى كفاءة — مفردات مألوفة للنماذج
• المصري: كفاءة متوسطة — بعض المفردات معروفة
• الخليجي: كفاءة أقل — مفردات أقل في بيانات التدريب
• المغاربي: الأقل كفاءة — خلط فرنسي يزيد التوكنات

khalas compare --dialect khaliji "وش رايك نسوي كذا؟"
khalas compare --dialect masri "إيه رأيك نعمل كده؟"
khalas compare --dialect fusha "ما رأيك أن نفعل ذلك؟"

متى تستخدم

• المستخدم يسأل "ليش العربي أغلى بالتوكنات؟"
• يريد تقليل تكلفة API
• يقارن أسعار بين مزوّدين مختلفين
• يريد يفهم تأثير التشكيل على التكلفة
• يبني تطبيق عربي ويحتاج يحسب الميزانية