MCP Fantom

توثيق Fantom، البحث الدلالي عن الأكواد، والترحيل من SkySpark

v0.1.0 Published عرض المصدر Documentation

علّم مساعدك الذكي Fantom -- وسلّمه مفاتيح ترحيل SkySpark 4.0.

يقوم MCP Fantom بفهرسة توثيق Fantom من fantom.org، والحزم المحلية .fan، وسير عمل Haxall في سطح واحد قابل للبحث. يقوم بالبحث الدلالي عن الأكواد عبر آلاف الأنواع والطرق، ويحلل رسوم البيان للاستدعاءات باستخدام كشف المجتمعات، وبشكل فريد -- يؤتمتة ترحيل SkySpark 3.x إلى 4.0: إعادة كتابة جمل using، وتحويل سلاسل Axon، وإنشاء ملفات Xeto، والتحقق من صحتها باستخدام مترجم Fantom، وأخذ نسخة احتياطية من Git في الطريق.

إذا كسر الترحيل شيئاً، يمكنك التراجع باستدعاء أداة واحدة. كل الرحلة قابلة للمقارنة والعكس والسرد.

لماذا يوجد هذا

غيّر SkySpark 4.0 صيغة الامتداد. ترحيل امتداد أو موصل حقيقي يدويًا هو مشقة من إعادة كتابة using، وتحويلات سلاسل Axon، وملفات مكتبة Xeto جديدة تماماً -- مع مترجم يعض في اللحظة التي تفتقد فيها سطراً. يحول MCP Fantom هذا العمل إلى سير عمل مدفوع بالمساعد الذي يعرف القواعد، وينفذ الفحوصات، ويمكنه التراجع عن نفسه.

من الذي يستخدمه

  • مؤلفو الامتدادات الذين ينقلون حزم SkySpark 3.x إلى 4.0
  • محررو Haxall الذين يبنون الموصلات والوظائف والتطبيقات في Fantom
  • المطورون المساعدون بالذكاء الاصطناعي الذين يحتاجون إلى سياق دقيق Fantom، وليس بناء جملة هلوسة

حجرة التحكم بالترحيل

ترحيل SkySpark 3 إلى 4 بدون إرهاق اليد

أداة واحدة تعيد كتابة امتدادك. وأخرى تلزمها. والثالثة تتراجع عنها. كل تغيير قابل للمقارنة، والمترجم يتحقق، وGit يحافظ على شبكة الأمان.

الترحيل: جاري modbus-connector
67%
مصدر SkySpark 3.x
مخرج SkySpark 4.0
1using sys
2using skyspark::ext
3using skyspark::folio
4 
5@Ext const class MyConnector : ConnExt {
6  override Str sort := "connector"
7  override Str moniker := "myCon"
8 
9  Str axonWatch() { "read(point and siteRef == @hq)" }
10  Str axonSub() { "readAll(point)" }
11}
12 
1using sys
2using haxall::ext
3using haxall::folio
4 
5@Ext const class MyConnector : ConnExt {
6  override Str sort := "connector"
7  override Str moniker := "myCon"
8  // Axon moved to funcs.xeto
9  Str axonWatch() { "axon:MyConnector.watch" }
10  Str axonSub() { "axon:MyConnector.sub" }
11}
12 
إعادة كتابة using: 12 سلاسل axon: 8 ملفات xeto: 3 تم إنشاؤها المترجم: نجح git: تم إنشاء نسخة احتياطية من pre-skyspark-4x-backup
تم التحقق من المخرجات بواسطة fan compile. التراجع متاح عبر rollbackMigration حتى يتم استدعاء commitMigration.

الفهرسة الكسولة

الخادم يجيب قبل انتهاء الفهرسة

تحجب معظم خوادم البحث العميل لمدة 30 إلى 60 ثانية عند الإقلاع الأول أثناء الفهرسة. ينطلق MCP Fantom في أقل من ثانية. تستجيب الأدوات فوراً -- يتم تسخين FlexSearch أولاً، والحزم المحلية بعده، والتضمينات بعد ذلك. المساعد لا ينتظر أبداً.

تتدهور الاستعلامات بشفافية. إذا لم تكن التضمينات جاهزة، تعود أدوات الدلالات إلى البحث بالكلمات الرئيسية. يحصل المساعد على إجابة مع ملاحظة حول دقة، وليس انتهاء صلاحية.

MCP Fantom
جاهز
مستندات HTML (cheerio) 100%
4,187 من 4,187 صفحة مفهرسة
حزم .fan المحلية 78%
1,246 من 1,600 حزمة تم تحليلها
التضمينات (LanceDB) 45%
723 من 1,600 متجه تم حسابه
رسم البيان للاستدعاءات (graphology) 12%
192 من 1,600 دالة تم ربطها
الإقلاع 0s الأدوات 1s المستندات 8s الفهرسة الكاملة 47s
البحث الدلالي LanceDB
"وظائف تطبيع الوحدات" cosine بحث
normalizeUnit(val, target)
تطبيع قيمة رقمية إلى رمز وحدة مستهدف.
0.91
convertUnit(point, u)
تحويل قيمة نقطة إلى الوحدة المحددة.
0.87
toEngUnit(v, sym)
إرجاع تمثيل الوحدة الهندسية لقيمة خام.
0.82
مجتمعات الأكواد (Louvain)
تطبيع الوحدات تحليل trio قراءات العداد مرافق الموصل

ذكاء الأكواد

فهم دلالي، وليس مجرد مطابقة نصية

semanticCodeSearch و findSimilarCode تضمن أكوادك Fantom إلى فضاء متجه. اطلب "وظائف تطبيع الوحدات" واحصل على نتائج تشترك في البنية، وليس الكلمات الرئيسية.

Graphology مع تجميع Louvain يجد المجتمعات الطبيعية في قاعدة أكوادك -- أي الأنواع تتعلق ببعضها، أي لا. getCodeImpact يتتبع كيفية انتشار التغيير. getCallers و getCallees كمل سطح رسم البيان للاستدعاءات.

semanticCodeSearch findSimilarCode getCallers getCallees getCodeImpact

أمان الترحيل

كل ترحيل على بُعد تراجع واحد

migrateSkySpark4x ينشئ نسخة Git قبل كتابة بايت واحد. إذا فشل أي شيء -- خطأ في المترجم، عدم تطابق التحقق، حدسك -- rollbackMigration يستعيد المستودع إلى الحالة المحددة قبل التشغيل.

commitMigration متعمد. لا شيء يتم دمجه في السجل العملي حتى تقبل المخرجات. حتى ذلك الحين، يعيش الترحيل على فرع، مع نسخة احتياطية، جاهز للتخلص منه.

خط الزمن في Git مستودع mcp-fantom
دمج commitMigration
ghi789
تم كتابة جميع ملفات Xeto؛ تم تأكيد النجاح في الترجمة.
تم تطبيق فرع الترحيل
def456
إعادة كتابة using + تحويل Axon + إنشاء Xeto.
النسخة: pre-skyspark-4x-backup
abc123
تم إنشاء نسخة احتياطية تلقائياً قبل تشغيل الترحيل.
الحالة قبل الترحيل
abc123
حالة المستودع قبل استدعاء migrateSkySpark4x.
أدوات الترحيل
migrateSkySpark4x
قم بتشغيل الإعادة الكاملة.
commitMigration
قبول المخرجات.
rollbackMigration
استعادة النسخة الاحتياطية.
resources/list --> 4 موارد
create-pod
قم بتشييد حزمة Fantom جديدة من البداية للنهاية.
5 خطوات · markdown
use-fanr
نشر حزمة عبر fanr.
6 خطوات · markdown
haxall-basics
بناء امتدادك الأول Haxall.
8 خطوات · markdown
unit-testing
إعداد اختبارات وحدة fant.
4 خطوات · markdown

سير العمل الموجه

أبعد من الأدوات -- أدلة قابلة للقراءة

موارد MCP هي وثائق markdown يمكن للمساعد قراءتها عند الطلب. يوفر MCP Fantom أربعة: محصفة حزمة، دليل نشر fanr، شرح عملي لامتداد Haxall، وتمهيد اختبار وحدة fant.

عندما يسأل المطور "كيف ابدأ؟" يسحب المساعد المورد الصحيح ويختصره وينتقل. كل سير عمل محصن جنباً إلى جنب مع الخادم.

  • ✓ markdown خطوة بخطوة
  • ✓ قابل للاكتشاف عبر resources/list
  • ✓ محصن مع الخادم
  • ✓ سهل الإضافة المزيد

هل أنت مهتم بهذا المشروع؟

استكشف الكود المصدري، ساهم، أو تواصل معنا.

عرض على GitHub تواصل معنا