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

Syncanix مع Express

اجعل واجهة Express البرمجية جاهزة للوكلاء: ما يقرأه الاكتشاف، وكيف تشغّله، وكيف تُطلق واجهة الدردشة وخادم MCP.

تركّب تطبيقات Express مساراتها عبر الملفات — موجِّه يُعرَّف في وحدة ويُركَّب تحت بادئة في وحدة أخرى. يتتبّع اكتشاف Syncanix هذه التركيبات ثابتًا ويُصدر مسارات كاملة، فيطابق الكتالوج ما تقدّمه واجهتك البرمجية فعلًا.

ما الذي يقرأه الاكتشاف

الاكتشاف ثابت (static) — يقرأ شيفرتك المصدرية لا حركة المرور لديك. وهو يركّب مسارات الطلب الكاملة عبر الملفات، بحيث تكون البادئات المركَّبة جزءًا من كل مسار مستخرَج:

// app.ts
app.use('/api', ordersRouter);

// orders.router.ts
const ordersRouter = Router();
ordersRouter.get('/orders/:id', getOrder);      // → GET /api/orders/:id
ordersRouter.post('/orders/:id/refund', refund); // → POST /api/orders/:id/refund
مسارات تمثيلية يركّبها المستخرِج — مسارات كاملة بما فيها البادئات.

يتتبّع المستخرِج تركيبات app.use(prefix, router) وسلاسل Router().use()‎ عبر الملفات — بما فيها الموجِّهات المستوردة افتراضيًا — فالمسار المعلَن ‎/orders/:id داخل موجِّه مركَّب على ‎/api يُسجَّل في الكتالوج كـ GET /api/orders/:id.

شغّل الاكتشاف

من جذر المستودع، شغّل أمر init. يكتشف إطار العمل تلقائيًا، ويطلب موافقتك قبل أي إثراء عبر نموذج لغوي، ويكتب كتالوجًا حتميًّا:

$ npx syncanix init
✓ detected framework
✓ scanned routes
✓ wrote .syncanix/catalog.json
→ review your capabilities in the dashboard

راجع الكتالوج

يسرد الكتالوج في ‎.syncanix/catalog.json كل قدرة وجدها الاكتشاف — الطريقة والمسار والوصف المُثرى الذي سيراه مستخدموك. راجعه كما تراجع الشيفرة قبل الرفع: فهو العقد الذي تكشفه واجهة الدردشة وخادم MCP لديك.

أطلق الواجهة

بعد رفع الكتالوج، ضمّن الودجت للدردشة داخل تطبيقك واربط خادم MCP الخاص بكل مستأجر مع Claude وChatGPT وCursor. تبقى كل عملية كتابة مقيّدة بالأذونات ومؤكَّدة ومدقَّقة.

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