# Variables API
SUMMARY: تخزين سريع للقيم الأساسية لحالة LLM — عدّادات، أعلام، طوابع زمنية لآخر مشاهدة، تقدّم جزئي.

KEY CONTEXT:
Auth: Mind Key
Set: POST /var { key, value }
Get: GET /var/:key
List: GET /var
Delete: DELETE /var/:key
Use case: store last-seen timestamps, counters, flags, partial workflow state
Faster than memory (PostgreSQL direct, no FTS5 indexing)
Not for: structured facts (use /memory), long content (use /script)

Variables API
Variables API تخزين سريع للقيم الأساسية للحالة المؤقتة. على عكس
الذكريات (المُفهرَسة والقابلة للبحث والمنظمة)، المتغيرات مُحسّنة
للوصول السريع للقراءة/الكتابة — مثالية للعدّادات والأعلام وحالة
الجلسة.
نقاط النهاية
POST /var
تعيين متغير أو تحديثه.
[CODE BLOCK]
GET /var/:key
الحصول على متغير واحد.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
GET /var
قائمة بجميع المتغيرات.
[CODE BLOCK]
DELETE /var/:key
حذف متغير.
[CODE BLOCK]
متى تستخدم المتغيرات مقابل الذاكرة
| حالة الاستخدام | استخدم |
|----------|-----|
| اسم المستخدم، التفضيلات | الذاكرة (قابلة للبحث، منظمة) |
| طابع زمني لآخر جلسة | متغير (حالة مؤقتة) |
| عدّاد (مثل الرسائل المُرسلة) | متغير (تحديثات متكررة) |
| حالة سير العمل ("الخطوة 3 من 5 مكتملة") | متغير (عابرة) |
| ملاحظات مشروع طويلة | الذاكرة (مفهرسة بنص كامل) |
| سكربتات قابلة لإعادة الاستخدام | تخزين السكربتات (مُسمّاة، مُصدَّرة) |
الأنماط الشائعة
تتبع آخر جلسة
[CODE BLOCK]
نمط العدّاد
[CODE BLOCK]
أعلام الميزات
[CODE BLOCK]
الخطوات التالية
- Memory API — للبيانات المنظمة القابلة للبحث
- Cron والمجدول