مرجع المزودين
يُرسِل كلّ طلب استدلال في EstaCoda عبر مزوّد. تعرض هذه الصفحة كلّ مزوّد يعرفه النظام، والتصنيف الذي يحمله، وما يعني هذا التصنيف في الممارسة. التصنيف يحدّد ما يمكنك ادّعاءه، وما يمكنك تصحيحه، وما لا يجب أن تتوقّعه.
معرفة المزوّد لا تعني أنه قابل للتشغيل. وتسجيله لا يعني أنه مؤهّل. افحص التصنيف قبل الإعداد.
تصنيفات النضج
| التصنيف | المعنى | ما يمكنك فعله |
|---|---|---|
live-proven | مُعدَّ ومُختبَ ومتمحّن في استخدام واقعي. | اجعله مسارًا رئيسيًا بثقة. |
implemented | يوجد الكود، وتتم معالجة البيانات المعتمدة، والطلبات تتنفّذ. لم يُحقّق بعد في استخدام حيّ مستمر. | اعدّده واختبره. أبلغ عن أيّ فجوات. |
configurable | يظهر في الإعداد/اختيار النموذج ويمتلك دعم محوّل قابل للتشغيل، لكنه قد لا يكون مثبتاً عملياً. | اعدّده إذا كنت تختبر أو تُرسِل. |
catalog-known | مسجّل في كاتالوغ النماذج المحلّي. لا محوّل استدلال قابل للتشغيل في الإصدار الحالي. | ليس مسارًا رئيسيًا في v0.1.0. |
experimental | مُحاصر بواسطة أدوات الميزات أو غير مستقر بالطبيعة. | فعّله بشكل صريح. توقّع الأعطال. |
unsupported | لا توجد تنفيذ. لا محوّل. لا دعم. | لا تُعدّده. |
التصنيفات تتراكم صعودًا. المزوّد live-proven هو أيضًا implemented. المزوّد catalog-known ليس configurable للاستدلال.
مزوّد النماذج اللغوية (LLM)
| المزوّد | النضج | ملاحظات |
|---|---|---|
| Kimi | live-proven | هدف التحقّق الأساسي. دقة الإجراءات الأدواتية مؤهّلة. |
| OpenAI | live-proven | يدعم وضعي المحادثات ووضعي الإجابات. |
| DeepSeek | live-proven | مؤهّل للمحادثات مع دعم الأدوات. |
| OpenRouter | live-proven | يعمل في وقت التشغيل. دقة الإجراءات الأدواتية قد تكون غير متساقية أحيانًا. |
| Codex | implemented | يُعدّ من منتقي النماذج باختيار OpenAI ثم Codex، أو من تعديلات المسار الأساسي/الاحتياطي في محرّر الإعدادات، أو عبر estacoda model setup codex. يستخدم OAuth، والمزوّد codex، والنموذج الافتراضي gpt-5.5، وطريقة المصادقة oauth_device_pkce، ونمط API openai_responses. مستبعد عن onboarding الأولي وعن إعداد OAuth للمسارات المساعدة في هذا المرور. |
configurable | مؤهّل في الكاتالوغ. الاختبار الحيّ محدود في هذا الإصدار. | |
| Anthropic | catalog-known | توجد بياناته الوصفية ومدخلاته في الكاتالوغ، لكنه غير ظاهر كمسار إعداد/اختيار نموذج وغير قابل للتشغيل كمسار لغوي رئيس في هذا الإصدار. |
| MiniMax | catalog-known | مسجّل في كاتالوغ النماذج. غير قابل للتشغيل في الإصدار الحالي. |
| Nous | catalog-known | مسجّل في كاتالوغ النماذج. غير قابل للتشغيل في الإصدار الحالي. |
| نقطة نهاية محلية / مخصصة | implemented | المزود المدمج local لـ Ollama وLM Studio وllama.cpp وvLLM وLiteLLM أو نقطة نهاية محلية/مخصصة أخرى متوافقة مع OpenAI. القيمة الافتراضية http://localhost:11434/v1، وauthMethod: "none"، ومفتاح API الاختياري OPENAI_COMPATIBLE_API_KEY. |
| Custom (OpenAI-compatible) | implemented | أي معرف مزوّد غير مدمج مع baseUrl صريح يعامل كمزوّد OpenAI-compatible مخصص. يتطلب baseUrl. متغير مفتاح API الافتراضي هو OPENAI_COMPATIBLE_API_KEY. استخدمه عندما تحتاج هوية مزود منفصلة بدل local. |
| unconfigured | unsupported | نائب. غير قابل للتشغيل. |
أنماط تنفيذ API
الأنماط التالية قابلة للتشغيل في الكود الحالي:
openai_chat_completionscustom_openai_compatibleopenai_responses
طرق المصادقة
apiKey— يُقرَّأ منapiKeyEnvفي وقت التشغيلnone— لا تلزم بيانات الاعتمادoauth_device_pkce— تدفق OAuth عبر رمز الجهاز الخاص بـ Codex
مهلات الطلب
تستخدم مسارات LLM الرئيسية والاحتياطية مهلة كلية ومهلة ركود/انعدام تقدم:
| الحقل | الافتراضي | ملاحظات |
|---|---|---|
timeoutMs | 1800000 | ميزانية طلب المزود الكلية. |
staleTimeoutMs | 120000 | مدة انتظار رؤوس الاستجابة في الطلبات غير المتدفقة؛ والمدة بين البايتات المستلمة في الطلبات المتدفقة. |
الأسبقية خاصة بكل مسار: قيمة model أو مسار احتياطي، ثم قيمة providers.<id>، ثم الافتراضي المدمج. تحتفظ مسارات النماذج المساعدة بسلوك auxiliaryModels.*.timeoutMs الحالي ولا تحصل على ضوابط staleTimeoutMs في هذا التنفيذ. لا تعرض أوامر إعداد CLI أعلامًا لمهلات المزود؛ اضبط هذه القيم في إعدادات الملف الشخصي المحدد.
مزوّد الصوت (Voice)
TTS (النص إلى ملف صوتي)
| المزوّد | النضج | ملاحظات |
|---|---|---|
| OpenAI | live-proven | TTS مستضاف. يتطلب OPENAI_API_KEY. |
| ElevenLabs | live-proven | TTS مستضاف. يتطلب ELEVENLABS_API_KEY. |
| MiniMax | live-proven | TTS مستضاف. |
| Gemini | live-proven | TTS مستضاف. |
| xAI | live-proven | TTS مستضاف. |
| Edge | implemented | Microsoft Edge TTS. لا يتطلب مفتاح API، لكن نص التوليف يُرسل عبر الشبكة إلى خدمة Microsoft Edge speech. ليس محليًا/offline. |
| Mistral | experimental | مؤجل لـ v0.1.0. محصور. |
| Local TTS | unsupported | neutts و kittentts مؤجلان في هذا الإصدار. |
STT (الملف الصوتي إلى نص)
| المزوّد | النضج | ملاحظات |
|---|---|---|
| OpenAI | live-proven | STT مستضاف. |
| Groq | live-proven | STT مستضاف. |
| xAI | live-proven | STT مستضاف. |
| local | implemented | faster-whisper مُدار افتراضياً عند stt.provider: "local"؛ محرك الأوامر عبر stt.local.engine: "command" صراحةً. تنزيل نموذج faster-whisper عبر البوابة معطّل افتراضيًا. |
| Mistral | experimental | مؤجل لـ v0.1.0. |
مزوّد إنتاج الصور
| المزوّد | النضج | ملاحظات |
|---|---|---|
| FAL | live-proven | مزوّد الإنتاج الافتراضي. يتطلب FAL_KEY. |
| BytePlus / Seedream | live-proven | يتطلب BYTEPLUS_ARK_API_KEY؛ ويمكن للإعداد المراجع إعادة استخدام ARK_API_KEY الموجود. |
| OpenAI / GPT Image | live-proven | يتطلب OPENAI_API_KEY؛ ويمكن للإعداد المراجع إعادة استخدام متغير بيئة بيانات اعتماد OpenAI موجود في الملف الشخصي المحدد. |
مزوّد بحث الويب
Brave Search وDDGS مزودا بحث مُنفّذان. fetch هو خط أساس الاستخراج الحارس. تبقى بقية المزودات المسماة أطرًا مسجلة.
| المزوّد | القدرات المعلنة | النضج | ملاحظات |
|---|---|---|---|
| fetch | extract | live-proven | المسار الافتراضي للاستخراج المحمي. لا يتطلب مفتاح API. |
| Brave | search | implemented | مزود حي عبر Brave Search API. يتطلب مرجع بيئة تحت web.brave.apiKeyEnv، وافتراضيه BRAVE_SEARCH_API_KEY. |
| DDGS | search | implemented | مزود حي عبر subprocess مدعوم بقدرة Python المُدارة ddgs. شغّل estacoda python-env setup ddgs قبل الاستخدام. |
| Firecrawl | search, extract, crawl | unsupported | نموذج مسجّل. غير متوفّر حتى بعد الإعداد. |
| Parallel | search | unsupported | نموذج مسجّل. |
| Tavily | search, extract | unsupported | نموذج مسجّل. |
| Exa | search | unsupported | نموذج مسجّل. |
| SearXNG | search | unsupported | نموذج مسجّل. |
يمكن لـ web.search استخدام Brave أو DDGS عندما يكون المزود المحدد متاحًا. يرجع web.extract إلى الاستخراج الحارس عبر fetch فقط عندما لا يكون هناك مزود استخراج صريح غير متاح ولا مزود استخراج متاح مكتشف تلقائيًا. توجد web.crawl كبنية أدوات، لكن لا يوجد مزود زحف حي.
يفحص اختيار المزود web.searchBackend أو web.extractBackend أو web.crawlBackend أولًا، ثم web.backend، ثم يكتشف المزودين المتاحين تلقائيًا. المزود الصريح غير المتاح لا يؤدي إلى fallback صامت.
مزوّد المتصفّح السحابي
| المزوّد | النضج | ملاحظات |
|---|---|---|
| local-cdp | live-proven | بروتوكول Chrome DevTools المحلي. الوضع المُشرف عليه اختياري. |
| mock | implemented | واجهة اختبار. لا متصفّح حقيقي. |
| Browserbase | implemented | خلفية متصفح سحابية. تتطلب بيانات اعتماد وموافقة صريحة على إنفاق السحابة. |
| browser-use | unsupported | نموذج مسجّل. غير مُنفّذ. |
| Firecrawl (browser) | unsupported | نموذج مسجّل. غير مُنفّذ. |
| Camofox | unsupported | نموذج مسجّل. غير مُنفّذ. |
يتطلب Browserbase كلًا من BROWSERBASE_API_KEY وBROWSERBASE_PROJECT_ID وbrowser.cloudSpendApproved: true صريحة قبل إنشاء جلسات سحابية. يوافق estacoda browser approve-cloud على إنشاء الجلسات القابلة للفوترة، ويحظرها estacoda browser revoke-cloud مرة أخرى. لا تزال استدعاءات createSession() المباشرة في سجل مزود Browserbase ترمي خطأ لأن موافقة إنفاق السحابة تُفرض عبر خلفية المتصفح. تبقى قيم firecrawl وcamofox القديمة لـ browser.backend مقبولة للتوافق لكنها تُبلغ حالة غير متاحة.
المسارات الإضافية للنماذج
المسارات الإضافية هي ميّالات تفضيل، ليست بيئات تشغيل منفصلة. تتم المعالجة عبر نفس بنية المزوّد الرئيسي.
| المسار | الغرض | النضج |
|---|---|---|
vision | تحليل الصور | implemented |
compression | الضغط الدلالي للجلسات | experimental |
assessor | تصنيف الموافقة الأمنية الذكي | implemented |
web_extract | استخراج الويب | implemented |
session_search | البحث الدلالي في الجلسات | implemented |
mcp | تفويض أدوات MCP | implemented |
memory_flush | عمليات الذاكرة | implemented |
delegation | تفويض الوكيل الفرعي | implemented |
skills_library | توزيع المهارات | implemented |
title_generation | توليد عناوين الجلسات | implemented |
curator | التنظيم المنطقي للذاكرة | implemented |
memory_compaction | ضغط ملفات الذاكرة | implemented |
profile_context | توليد سياق الملف الشخصي | implemented |
أسماء المسارات الإضافية غير المعتمدة ترمي خطأ أثناء تطبيع الإعداد. لا تستخدم أسماء موروثة مثل models.auxiliary أو auxiliary.default.
طلبات modelOverride للأطفال المفوضين تستخدم مسارات مزودين مضبوطة فقط. التجاوزات على المزود نفسه وعبر مزود آخر مراجع تحفظ إعداد المزود الهدف، وتستخدم بيانات اعتماد apiKeyEnv الموجودة، وتحترم authMethod: "none"، وترفض enableNetwork: false قبل التنفيذ، وتعطل fallback routes للطفل المتجاوز. لا تضيف credential pools ولا تعدّل مسارات الأب/session/profile.
غير المدعوم في v0.1.0
التالي محدّد بشكل صريح للإصدار الحالي:
- محوّل Anthropic Messages API كمسار رئيسي
- محوّلات MiniMax أو Nous
- البحث الحيّ عبر Firecrawl، Parallel، Tavily، Exa، أو SearXNG
- جلسات المتصفّح السحابي عبر browser-use، Firecrawl، أو Camofox
- مزوّدات ذاكرة خارجية مُعدّة بالاسم دون تنفيذ مدمج
مرتبطات
- المزوّدون — إعداد المزوّدين وتبديل النماذج
- الإعداد — مَخطّط ملف الإعداد
- متغيرات البيئة — مرجع متغيرات البيئة