مزيد من أوامر الأداة

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

تسجيل الدخول والخروج

سجّل الدخول عبر متصفحك: تفتح CLI لوحة التحكم، وتوافق أنت على الجهاز، فتُحفظ جلسة مرتبطة بحسابك في ‎~/.syncanix/credentials (لا يقرؤها سواك) — ثم تعمل CLI بدورك، في مساحات عملك. استخدم ‎--key بدلاً من ذلك لمفتاح جهاز خاص بمساحة العمل (CI؛ بموافقة مسؤول)، وتحقق من هويتك عبر syncanix whoami، وسجّل الخروج عبر syncanix logout — الذي يُبطل الجلسة أيضًا على الخادم.

npx syncanix login
npx syncanix logout

تحقّق من هويتك ومن المكان الذي تكتب فيه

تعمل الجلسة نيابةً عنك، لذا قد يكتب الأمر نفسه في مساحة عمل مختلفة حسب المساحة النشطة. يجيب syncanix whoami عن السؤالين معًا: هويتك، ومساحة العمل النشطة ودورك فيها، وموعد انتهاء الجلسة، وكل مساحة يمكنك العمل فيها. يُستخرج ذلك مباشرةً من الخادم، فيصلح أيضًا للتحقق من أن جلستك ما زالت صالحة. ويعرض syncanix workspace list القائمة نفسها بمفردها، بينما يغيّر syncanix workspace use <slug> المساحة التي سيكتب فيها الأمر التالي. شغّل whoami قبل أي عملية رفع.

npx syncanix whoami
npx syncanix workspace list
npx syncanix workspace use acme

استيراد مخطّط

هل لديك بالفعل مخطّط OpenAPI أو GraphQL؟ ابنِ منه كتالوجًا مباشرةً، دون فحص للشيفرة. مرّر ‎--offline‎ لتخطّي الرفع، أو ‎--env‎ لاستهداف بيئة.

npx syncanix import --openapi ./openapi.json
npx syncanix import --graphql ./schema.graphql

هل نسختي متزامنة؟

يقارن ما يجده فحص جديد لهذه النسخة بما تقدّمه مساحة عملك حاليًا، ويطبع الفرق. وهذا هو الأمر الذي تلجأ إليه حين يفعل المساعد شيئًا لم تتوقّعه: فهو يجيب عن «هل يشغّل الإنتاج ما أظنّه؟» دون فتح أي شيء.

npx syncanix status

التقط تغييرًا قبل عملائك

يقارن شجرة عملك بالكتالوج الذي أودعته ويخرج بخطأ إن تباعدا. ضعه في مسار التكامل المستمر لديك، فيُفشل تغييرٌ في شيء يعتمد عليه المساعد عمليةَ البناء بدل أن يظهر في محادثة.

npx syncanix drift

هل الأداة موجودة فعلًا على الصفحة؟

يحمّل عنوانًا ويبلّغ هل تضمين Syncanix حيّ عليه. أسرع من فتح متصفّح، ومفيد في فحص النشر — فأشهر سبب لغياب المحادثة هو بناءٌ أسقط وسم السكربت.

npx syncanix embed check https://app.acme.com

اكتب لي ملفات التكامل

يكتب مجموعة صغيرة من ملفات Syncanix في مشروعك — التضمين والإعدادات وما تحتاجه بنيتك. ولا ينشئ إلا ملفات غير موجودة، فتشغيله مرتين آمن ولا يمكنه أبدًا أن يطمس شيئًا حرّرته.

npx syncanix generate

ادمج الأداة في واجهة أمامية

نسخة موجّهة من العمل نفسه لواجهة أمامية قائمة، في أربع خطوات تنفّذها واحدة تلو الأخرى: يفحص تطبيقك، ويخطّط التغيير، ويعرض عليك الخطة للموافقة، ثم يطبّقها بعد ذلك فقط.

npx syncanix integrate scan
npx syncanix integrate plan
npx syncanix integrate apply

اقرأ كتالوجًا من الطرفية

اسرد ما يحتويه ملف كتالوج — مصفّى حسب فئة المخاطر أو الطريقة أو إطار العمل — أو قارن اثنين منها، أو صدّر تقرير امتثال يسرد كل قدرة مع مخاطرها وما تمسّه. مفيد في المراجعة، والتصدير مستند يمكنك تسليمه لمن يسأل.

npx syncanix catalog list --side-effect destructive
npx syncanix catalog diff ./before.json ./after.json
npx syncanix catalog compliance --format md

ويستطيع الأمر نفسه قراءة أو تغيير الاسم والوصف اللذين يُقدَّمان للوكيل عن قدرة — أي الصياغة الواضحة التي يراها من يوافق على إجراء. مفيد لإصلاح وصف ركيك دون فتح لوحة التحكم.

اقرأ ما يُسمح للوكيل بفعله

ثلاثة أوامر للقراءة فقط تجيب عن أسئلة التدقيق: كل قدرة مع حالة تفعيلها وفئة مخاطرها، وأي تغيير قدرة ينتظر موافقًا ثانيًا، ومفاتيح الـ API التي أصدرتها مساحة عملك — بادئات فقط ولا سرّ أبدًا.

npx syncanix governance list
npx syncanix approvals
npx syncanix keys list

بيئة التطوير المحلية

يشغّل صفحة محلية تُضمّن الأداة مقابل خادم خلفي للتطوير وتعيد التحميل حيًّا عند تغيّر كتالوجك. وتتيح الخيارات ضبط المنفذ وأصل الخادم الخلفي ومصدر الأداة والمفتاح القابل للنشر ومسار الكتالوج.

npx syncanix dev --port 4321

شخّص إعدادك

يفحص بيئتك بحثًا عن المشكلات الشائعة — إصدار Node، وإطار عمل مكتشَف، وإعداد صالح، ومفتاح واجهة برمجة قابل للحل. وينتهي برمز غير صفري إن كان هناك خطأ.

npx syncanix doctor

تسجيل خادم MCP خارجي

إن كانت مساحة عملك تشغّل خادم MCP خاصًا بها بالفعل، فسجّله كي يستطيع Syncanix إعادة توجيه استدعاءات الأدوات إليه. يلزم أن تكون مسجَّل الدخول؛ ويُخزَّن بيان الاعتماد بأمان ولا يُعاد عرضه أبدًا.

npx syncanix byomcp register --server-url https://mcp.example.com

طبقات الكتالوج كشيفرة

أدِر طبقة ‎syncanix.yaml‎ محفوظة في الإصدارات: ينشئ init واحدة، ويتحقّق validate منها، ويدمج apply إياها فوق كتالوج مكتشَف.

npx syncanix yaml init
npx syncanix yaml validate
npx syncanix yaml apply --catalog ./.syncanix/catalog.json

الإصدار

يطبع إصدارات الأداة وNode والبناء — مفيد عند الإبلاغ عن مشكلة.

npx syncanix version

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