تخطَّ إلى المحتوى الرئيسي
تصفّح التوثيق

syncanix init

اكتشف واجهة برمجة التطبيقات لديك، وابنِ كتالوج القدرات، وارفعه — مع إثراء بالذكاء الاصطناعي مشروط بالموافقة.

الأمر init هو ما ستشغّله غالبًا. فهو يفحص مشروعك، ويحوّل واجهة برمجة التطبيقات لديك إلى كتالوج قدرات، ويرفعه إلى مساحة عملك.

npx syncanix init

الخيارات

-f, --framework <name>
يفرض إطار عمل محددًا بدلًا من الاكتشاف التلقائي. يقبل أي إطار عمل يدعمه Syncanix — مثل nestjs أو express أو fastapi أو django أو laravel.
--env <env>
يستهدف بيئة development (الافتراضية) أو production عند رفع الكتالوج.
--offline
يكتب الكتالوج محليًا دون رفعه.
-y, --yes
يقبل القيم الافتراضية ويتخطّى المطالبات — يستخدم الإثراء مفاتيح مزوّدك المحلية عند ضبطها، ويُتخطّى خلاف ذلك.
--byok-key <key>
يستخدم مفتاح مزوّد نموذج اللغة الخاص بك للإثراء، بدلًا من المفاتيح الموجودة في بيئتك.
--byok-provider <provider>
مزوّد BYOK — anthropic أو openai. يُستنتج من صيغة المفتاح عند إغفاله.
--force
يتابع ما بعد سقف تكلفة الإثراء، مع قبول الإنفاق المقدّر.
--reset-consent
يمسح موافقة الإثراء المحفوظة ليسأل init من جديد.
--init-config
يعيد توليد ملفي البداية .syncanix.yaml و.syncanixignore (يستبدل الموجودين).
--graphql-endpoint <url>
يستبطن نقطة نهاية GraphQL قيد التشغيل لتحديد أنواع طفرات code-first.
--telemetry
يُفعّل قياس الاستخدام المجهول (معطّل افتراضيًا).

ماذا يفعل

  1. يكتشف أُطر العمل لديكيفحص المشروع ويبلّغ عن كل إطار عمل يتعرّف عليه — لا الأعلى فقط.
  2. يستخرج القدراتيقرأ مساراتك ويبني قائمة منظَّمة بالقدرات، بمدخلاتها وآثارها.
  3. يطبّق ‎.syncanixignore‎يُسقِط كل ما يطابق قواعد الاستبعاد لديك قبل كتابته أو إثرائه أو رفعه.
  4. يسأل عن الإثراء بالذكاء الاصطناعييعرض تقدير تكلفة ويسأل كيف تريد المتابعة قبل إرسال أي نصّ شيفرة إلى مزوّد.
  5. يكتب الكتالوجيحفظ ملف ‎.syncanix/catalog.json‎ حتميًا يمكنك مراجعته وحفظه في نظام الإصدارات.
  6. يرفعهيرسل الكتالوج إلى مساحة عملك، ما لم تمرّر ‎--offline‎ أو لم يكن لديك مفتاح واجهة برمجة بعد.

ثابت افتراضيًا

يقرأ الاكتشاف شيفرتك؛ ولا يشغّلها أبدًا، ولا تغادر أي بيانات إنتاجية جهازك. والشيء الوحيد الذي يمكن إرساله هو الكتالوج المنظَّم — ولا يحدث الإثراء بالذكاء الاصطناعي إلا بموافقتك الصريحة.

يكتب الإثراء بالذكاء الاصطناعي عناوين وأوصافًا أوضح لقدراتك. وقبل إرسال أي شيء، تعرض الأداة بالضبط ما الذي سيُرسَل (معرّفات القدرات، والطرق والمسارات، وأسماء الوسائط، ومقتطفًا قصيرًا من المعالِج محجوب الأسرار) وما الذي لن يُرسَل (ملفات المصدر، وبياناتك، والأسرار، وكل ما جرى تجاهله). ثم تختار وضعًا:

مفاتيح محلية
يستخدم مفتاحي Anthropic وOpenAI الموجودين بالفعل في بيئتك المحلية، مع تطبيق عدم الاحتفاظ بالبيانات. يجري الإثراء من جهازك — ولا توجد خدمة إثراء مستضافة لدى Syncanix.
BYOK
يستخدم مفتاح مزوّدك الخاص؛ ويذهب نصّ المعالِج مباشرةً من جهازك إلى المزوّد، ولا يراه Syncanix أبدًا.
تخطٍّ
لا إثراء — اشحن بيانات المستخرِج فقط وأثرِ لاحقًا من لوحة التحكم.

الخطوات التالية