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
- يُفعّل قياس الاستخدام المجهول (معطّل افتراضيًا).
ماذا يفعل
- يكتشف أُطر العمل لديكيفحص المشروع ويبلّغ عن كل إطار عمل يتعرّف عليه — لا الأعلى فقط.
- يستخرج القدراتيقرأ مساراتك ويبني قائمة منظَّمة بالقدرات، بمدخلاتها وآثارها.
- يطبّق .syncanixignoreيُسقِط كل ما يطابق قواعد الاستبعاد لديك قبل كتابته أو إثرائه أو رفعه.
- يسأل عن الإثراء بالذكاء الاصطناعييعرض تقدير تكلفة ويسأل كيف تريد المتابعة قبل إرسال أي نصّ شيفرة إلى مزوّد.
- يكتب الكتالوجيحفظ ملف .syncanix/catalog.json حتميًا يمكنك مراجعته وحفظه في نظام الإصدارات.
- يرفعهيرسل الكتالوج إلى مساحة عملك، ما لم تمرّر --offline أو لم يكن لديك مفتاح واجهة برمجة بعد.
ثابت افتراضيًا
يقرأ الاكتشاف شيفرتك؛ ولا يشغّلها أبدًا، ولا تغادر أي بيانات إنتاجية جهازك. والشيء الوحيد الذي يمكن إرساله هو الكتالوج المنظَّم — ولا يحدث الإثراء بالذكاء الاصطناعي إلا بموافقتك الصريحة.
الموافقة على الإثراء بالذكاء الاصطناعي
يكتب الإثراء بالذكاء الاصطناعي عناوين وأوصافًا أوضح لقدراتك. وقبل إرسال أي شيء، تعرض الأداة بالضبط ما الذي سيُرسَل (معرّفات القدرات، والطرق والمسارات، وأسماء الوسائط، ومقتطفًا قصيرًا من المعالِج محجوب الأسرار) وما الذي لن يُرسَل (ملفات المصدر، وبياناتك، والأسرار، وكل ما جرى تجاهله). ثم تختار وضعًا:
- مفاتيح محلية
- يستخدم مفتاحي Anthropic وOpenAI الموجودين بالفعل في بيئتك المحلية، مع تطبيق عدم الاحتفاظ بالبيانات. يجري الإثراء من جهازك — ولا توجد خدمة إثراء مستضافة لدى Syncanix.
- BYOK
- يستخدم مفتاح مزوّدك الخاص؛ ويذهب نصّ المعالِج مباشرةً من جهازك إلى المزوّد، ولا يراه Syncanix أبدًا.
- تخطٍّ
- لا إثراء — اشحن بيانات المستخرِج فقط وأثرِ لاحقًا من لوحة التحكم.