kin v0.6.4
التحكم في الإصدارات القائم على الرسم البياني الدلالي للشيفرة المكتوبة بواسطة الذكاء الاصطناعي. يتتبع الكيانات والعلاقات بدلاً من فروقات الملفات، مما يتيح تحليل نطاق التأثير، ومراجعة الدمج الظلي، وسياق الوكيل المدعوم بـ MCP لبرمجيات موثوقة مولّدة بالذكاء الاصطناعي.
غيّر الذكاء الاصطناعي من يكتب الشيفرة.
تغيّر Kin ما يُبنى عليه.
Kin هو مستودع برمجي مفتوح المصدر ونظام للتحكم في الإصدارات للأشخاص ووكلاء الذكاء الاصطناعي. يتتبع كيفية ترابط الشيفرة، لتتمكن من التحقق مما قد يؤثر عليه تغيير ما.
الدوال والأنواع والعلاقات المسجلة وسجل التغييرات هي بيانات المستودع التي تُثبّتها وتُنشئ لها فروعًا وتدمجها. الرسم البياني هو نموذج المستودع، وليس فهرسًا منفصلًا بجانب Git. يُحفظ المصدر الأصلي بايتًا بايتًا، وتتيح إسقاطات نظام الملفات للأدوات المدعومة الاستمرار في العمل مع الملفات العادية.
النجمة تساعد الآخرين في العثور على Kin، والمناقشات هي المكان المناسب لطرح سؤال حوله.
إصدار ألفا عام. ابدأ بمستودع صغير تعرفه جيدًا. توقّع بعض الخشونة والتغييرات الجذرية.
البدء السريع · التوثيق · عرض تجريبي في المتصفح
اكتشف ما يتصل بماذا
قبل تغيير دالة مشتركة، ما الذي ينبغي أن تفحصه أيضًا؟ يتيح لك Kin البحث عن المستدعين المسجلين لها واستكشاف الشيفرة ذات الصلة. يستعلم كل من CLI وخادم MCP من الرسم البياني نفسه، لتتمكن أنت ووكيلك من العمل انطلاقًا من السجل نفسه.
مسجّل على رسم بياني مُجهّز لـ ripgrep عند e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. مخرجات التشغيل الخام ليست عامة. هذا يوضّح سير عمل، وليس مقياسًا للأداء.
استخدمه من Claude Code أو Codex أو Cursor
لـ Claude Code:
/plugin marketplace add firelock-ai/kin
/plugin install kin@kin
لـ Codex، أضف السوق وثبّت الإضافة، أو دع kin setup --intent agent يكتب خادم MCP في ~/.codex/config.toml نيابةً عنك.
لـ Cursor، أضف خادم MCP يدويًا؛ راجع plugins/kin-cursor للحصول على المقتطف الدقيق.
بعد التثبيت، شغّل kin init . في مستودع صغير تعرفه جيدًا؛ سترشدك مهارة kin-setup خلال بقية الخطوات.
Kin غير منشور على crates.io. حزمة kin الموجودة هناك مشروع غير مرتبط.
البدء السريع
استخدم نسخة قابلة للتخلص منها من مستودع Git صغير. يتضمن الاستيراد كامل تاريخه القابل للوصول وقد يستغرق وقتًا وذاكرة كبيرين. النسخ السطحية (shallow clones) والوحدات الفرعية (submodules) وGit LFS غير مدعومة.
1. التثبيت
على macOS أو Linux، شغّل المثبّت وأكمل مطالبات الإعداد:
curl -fsSL https://get.kinlab.dev/install | sh
بعد انتهائه، أعد تحميل الصدفة (shell) كأمر منفصل:
exec "$SHELL" -l
لـ Windows، أو المثبّتات البديلة، أو استكشاف الأخطاء وإصلاحها، راجع البدء السريع الكامل.
2. تهيئة المستودع
عند المطالبة الجديدة، استبدل المسار أدناه:
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
يُظهر kin overview الكيانات التي استوردها Kin. ويُظهر kin status ما تم قبوله وحالة شجرة العمل مقارنةً به. ويبلّغ kin graph status عن رسم الاستعلامات الحيّ للخادم الخفي وتغطيته. التغييرات غير المثبّتة وغير المتتبعة ليست جزءًا من تاريخ Git المستورد؛ ويبلّغ kin init عمّا استبعده.
3. اطرح سؤالًا يمكنك التحقق منه
ابحث عن شيء تعرف مسبقًا أنه موجود في الشيفرة:
kin locate "<something you already know is in this repository>"
استبدل ExactEntityName أدناه برمز من النتيجة:
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
يُرجع refs المراجع المسجلة، ويجلب trace السياق المجاور، ويستكشف impact التأثيرات المحتملة عبر الرسم البياني. تحقق من النتائج مقابل المصدر.
4. اربط وكيلك
جهّز التضمينات المحلية، ثم اضبط عملاء MCP المكتشفين:
kin embed &&
kin setup --intent agent &&
kin setup status --json
يدعم Kin كلاً من Claude Code وCodex وCursor وGemini وعملاء MCP آخرين. استخدم kin setup --intent editor لـ VS Code. يتضمن Kin أيضًا kin agent run لنقاط نهاية النماذج المحلية أو المستضافة المتوافقة مع OpenAI.
إعداد العميل · أدوات MCP · الوكيل المدمج
تعمل عمليات الاستيراد والتخزين والاستعلامات المحلية على جهازك. يحتاج التثبيت والتنزيل الأولي لنموذج التضمين إلى اتصال بالشبكة. قبل أن تصبح التضمينات جاهزة، يستخدم kin locate إشارات معجمية ورسومًا بيانية ويبلّغ عن تغطية المتجهات المفقودة.
راجع تغييرًا
بعد تشغيل kin init على فرع Git الذي تريد مراجعته، قارن بصمات الالتزام (commit SHAs) الصريحة مقابل main:
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
يُرجع التقرير PASS أو NEEDS ATTENTION أو WOULD BLOCK، مع التأثير المستمد من الرسم البياني والأدلة الداعمة. إنه استشاري: لا يمنع الدمج ولا يغيّر حالة الرسم البياني. تُعلَن الملكية ولا تُتحقق منها بشكل مستقل.
استخدم Kin مع Git أو بدونه
يمتلك Kin التزاماته وفروعه وعمليات الدمج والفروقات وسجله الخاص، بما في ذلك في المستودعات التي لا يوجد تحتها Git. يمكن استيراد مستودعات Git الموجودة، ويمكن لسير العمل المدعوم تصدير مستودع Git جديد.
جولة في التحكم الأصلي بالإصدارات · التوافق مع Git وحدود التصدير
حدود إصدار الألفا
التغطية غير مكتملة. تُحلَّل اللغات المدعومة إلى كيانات وعلاقات؛ وتبقى الملفات الأخرى متاحة كمحتوى وتاريخ. النتيجة الفارغة لا تثبت عدم وجود مستدعين أو تبعيات. استمر في استخدام المترجم والاختبارات والمراجعة. راجع دعم اللغات.
التوافق متفاوت. لإسقاط نظام الملفات قيود منفصلة على مستوى المنصة والأدوات. راجع ملاحظات المنصات قبل الاعتماد عليه.
حافظ على الحالة الخاصة بـ Kin. حذف .kin وإعادة الاستيراد من Git لا يستعيد الالتزامات أو المراجعات أو أي حالة أخرى كانت موجودة في Kin فقط. اقرأ ملاحظات الاستيراد والاستعادة والترقية.
Windows. دعم Windows x86_64 الأصلي مبكر. قبول المستودعات يعمل: يستورد kin init مستودع Git وينشر سلطة الرسم البياني، وتُجيب استعلامات الرسم البياني والمعجمية والمدعومة بالخادم الخفي محليًا. إسقاط نظام الملفات الشفاف غير متوفر على Windows، وإثبات التثبيت من البداية إلى النهاية لا يغطي بعد سير عمل MCP أو المراجعة هناك، لذا يبقى WSL2 المسار الموصى به لتجربة Kin الكاملة.
لماذا بنيت Kin
ظللت أشاهد وكلاء البرمجة يجمعون أجزاءً من قاعدة شيفرة كنا قد عملنا عليها بالفعل. ثم كنت أقوم بنسخة من ذلك العمل بنفسي لمراجعة تغييراتهم. بدأت أتساءل لماذا لا يكون المزيد من ذلك الفهم البنيوي جزءًا من المستودع نفسه.
هذا ما أبنيه مع Kin.
Troy
اعرف المزيد وساهم
مرجع CLI · البنية والحدود التفصيلية · المساهمة · المشكلات · الأمان
Kin ومكدسه المحلي، بما في ذلك kin-db، مرخّصان تحت Apache-2.0. KinLab هو المنتج المستضاف الاحتكاري المنفصل. لا يزال تأهيل المستودع العام قيد التطوير.