عن المشروع

skillstate-proxy هو وكيل HTTP محلي مخصص لسير عمل الوكلاء الذين يمكنهم التعبير عن تقدمهم كحالة منظمة صريحة. يقع بين العميل ومزود نموذج مُهيأ، ويبني السياق من مواصفات المهمة وحالة JSON للجلسة وأحدث ملاحظة، ثم يستخرج state_patch من استجابة النموذج. يصف README تقليل الرموز بأنه يعتمد على عبء العمل، ويذكر صراحة أن التوفير وزمن الاستجابة والدقة والتوافق مع المزودين غير مضمونة. يتم التثبيت باستخدام npm (Node.js 20 أو أحدث). الملف التنفيذي هو skillstate، ومتوفر أيضًا باسم skillstate-proxy. يتم التهيئة عبر متغيرات البيئة مثل SKILLSTATE_UPSTREAM وSKILLSTATE_API_KEY وSKILLSTATE_PORT (الافتراضي 127.0.0.1:8789) وSKILLSTATE_SCHEMA وSKILLSTATE_INITIAL_STATE وSKILLSTATE_CONFIG وSKILLSTATE_VERBOSE، بالإضافة إلى أعلام سطر الأوامر --config و--upstream و--port و--schema و--verbose. ترتيب الأولوية هو أعلام سطر الأوامر، ثم متغيرات البيئة، ثم ملف التهيئة، ثم الإعدادات الافتراضية. يوجه عميل محادثة متوافق إلى http://127.0.0.1:8789/v1. عقد الحالة يدمج التصحيحات عبر استبدال المصفوفات، ودمج الكائنات بشكل متكرر، وحذف مفتاح عندما تكون قيمة تصحيحه null. يؤكد README أن هذا ليس أرشيفًا غير فاقد للنص الكامل: الحقائق غير المحفوظة في الحالة قد لا تكون متاحة لاحقًا، ويُنصح بسجل تدقيق منفصل عندما تكون الأدلة الحرفية مهمة. قوائم المفاتيح المسموح بها لا تحدد حجم القيم أو الملاحظات. تشمل واجهة HTTP: POST /v1/chat/completions وPOST /v1/messages (ترجمة بصيغة Anthropic) وGET /v1/models وGET /health وGET /state (مع ?session=ID) وDELETE /state?session=ID وGET /cost. يحذر README من أن وجود مسار منفذ لا يثبت أن كل ميزة في SDK تعمل، ويوصي باختبار البث وربط استدعاءات الأدوات والجلسات المتزامنة وإعادة المحاولات والإلغاء مقابل العميل والمزود والنموذج المحددين. إعدادات rpm/tpm الاختيارية لكل مزود تستخدم نافذة زمنية محلية متدحرجة مدتها دقيقة واحدة وليست حصصًا من جهة المزود أو محددات موزعة. يتطلب التحقق من المصدر تنفيذ npm ci وnpm run build وnpm test مع package-lock.json الملتزم به؛ تتحقق CI من Node.js 20 و22 و24. فحوصات تخطيط الوثائق الثابتة الاختيارية تستخدم Python Playwright. تتطلب المعايير (المحادثة وحلقة الأدوات) تهيئة مزود صريحة وقد تكلف مالًا؛ ينصح README بالاحتفاظ بالمراجعة وعبء العمل والنموذج والمخطط والاستخدام الخام وإعادة المحاولات ودرجات الجودة والإخفاقات مع أي نتيجة، ومقارنة إجمالي تكاليف الإدخال/الإخراج المفوترة. يشير المشروع إلى ورقة SKILL.state (arXiv:2608.26263) ويلاحظ أن نتائج البحث لا تثبت دقة هذا التنفيذ أو توافقه الشامل. مرخص بموجب MIT، وغير تابع لـ OpenAI أو Anthropic، والترخيص لا يغطي الاستدلال أو الاستضافة من جهة المزود. تُحفظ الحالة محليًا وقد تحتوي على معلومات مهام حساسة؛ يستقبل المزود السياق المعاد كتابته، لذا يجب إبقاء المستمع خاصًا. يذكر README أن المشروع ليس حدودًا أمنية متعددة المستأجرين لمجرد امتلاكه معرفات جلسات.