kin v0.3.4

أساس جديد للشيفرة البرمجية.

Kin هو مستودع برمجي أصيل بالرسم البياني للأشخاص ووكلاء الذكاء الاصطناعي. يخزّن الشيفرة المصدرية، والعلاقات المسجّلة بين الشيفرات، والتاريخ المُصدَّر كحالة للمستودع. الرسم البياني هو نموذج المستودع، وليس فهرس بحث يُصان بجانب مستودع آخر.

الدوال والأنواع والعلاقات بينها هي بيانات تُثبّتها وتُنشئ لها فروعًا وتدمجها. تُحفظ الشيفرة المصدرية الدقيقة بايتًا ببايت، وتتيح إسقاطات نظام الملفات للأدوات المدعومة الاستمرار في العمل مع الملفات العادية.

إصدار تجريبي عام. جرّب Kin على مشروع حقيقي تعرفه جيدًا. توقّع بعض الخشونة.

البدء السريع · التوثيق · عرض توضيحي في المتصفح

النجمة تساعد الآخرين في العثور على Kin، والمناقشات هي المكان المناسب لطرح أي سؤال عنه.

انظر ما الذي يترابط

قبل تغيير دالة مشتركة، ما الذي ينبغي عليك فحصه أيضًا؟ يتيح لك Kin البحث عن المستدعين المسجّلين لها واستكشاف الشيفرة ذات الصلة. تستعلم واجهة سطر الأوامر وخادم 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 هناك مشروع غير ذي صلة.

البدء السريع

ابدأ في نسخة كاملة حديثة الاستنساخ من مشروع تعرفه جيدًا. يقرأ kin init تاريخ Git لديك دون تغييره أو تغيير ملفاتك المتعقّبة. يضيف دليل .kin وسطرًا واحدًا إلى .git/info/exclude. يغطي الاستيراد كل إيداع تصل إليه فروعك ووسومك، لذا ينمو الوقت والذاكرة والقرص مع التاريخ لا مع حجم النسخة المستنسخة. قبل أن يبدأ، يتحقق kin init من الذاكرة والمساحة الحرة على القرص ويتوقف مع عرض الأرقام عندما يستطيع أن يتبيّن مسبقًا أن الجهاز يعاني نقصًا. النسخ السطحية (shallow clones) والوحدات الفرعية (submodules) وGit LFS غير مدعومة، كما أن خطافات Git أو النسخة المستنسخة المتناثرة (sparse checkout) أو عملية دمج أو إعادة تأسيس غير مكتملة توقف الاستيراد أيضًا. يسمّي kin init الحل لكل منها، والنسخة المستنسخة الحديثة تتجنّب معظمها.

1. التثبيت

على macOS وLinux وWSL2، يثبّت أمر واحد Kin ويوصل أدوات البرمجة بالذكاء الاصطناعي التي يجدها. يحتاج إلى Node.js 20 أو أحدث:

npx -y @kinlab/kin setup

على جهاز بدون Node، شغّل المُثبِّت بدلًا من ذلك. يقدّم get.kinlab.ai وget.kinlab.dev النص البرمجي نفسه:

curl -fsSL https://get.kinlab.dev/install | sh

في كلتا الحالتين، أعد تحميل الصدفة (shell) بأمر منفصل، لأن التثبيت يضع kin في ~/.kin/bin ويضيف ذلك الدليل إلى ملف تعريف الصدفة للجلسات الجديدة:

exec "$SHELL" -l

على Windows x64 الأصلي، ثبّت من PowerShell باستخدام irm https://get.kinlab.dev/install.ps1 | iex. يثبّت واجهة kin ولا يوصل أدوات البرمجة بالذكاء الاصطناعي، لأن WSL2 يبقى المسار الموصى به على Windows. يوضّح مدخل Windows تحت حدود النسخة التجريبية ما يعمل هناك. لا يُنشر إصدار أصلي لـ Windows ARM64. على جهاز ARM64، شغّل ذلك السطر من PowerShell x64 لتثبيت إصدار x86_64 تحت المحاكاة، أو استخدم WSL2. يضيف المُثبِّت kin إلى PATH الخاص بالمستخدم، لذا افتح نافذة PowerShell جديدة بدلًا من exec "$SHELL" -l قبل الخطوة التالية.

للمُثبِّتات الأخرى أو استكشاف الأخطاء وإصلاحها، راجع البدء السريع الكامل.

2. تهيئة المستودع

عند المطالبة الجديدة، استنسخ مستودعًا باستخدام Kin:

kin clone https://github.com/pallets/itsdangerous

أو هيّئ واحدًا لديك بالفعل، مع استبدال المسار أدناه:

cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status

ينتهي كلاهما بالأمر التالي الذي يجب تشغيله، وهو سؤال kin refs عن دالة في ذلك المستودع. كما يربطان Codex CLI وGrok CLI به عندما سمحت بذلك في الإعداد، لأن هذين العميلين يحتفظان بمدخل واحد يسمّي مستودعًا.

لا يحتوي Windows PowerShell 5.1 على &&، لذا على Windows الأصلي شغّل الأوامر نفسها واحدًا تلو الآخر وتوقف إذا فشل أحدها:

cd C:\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. أدوات البرمجة بالذكاء الاصطناعي والبحث الدلالي

سأل kin setup بالفعل قبل توصيل أدوات البرمجة بالذكاء الاصطناعي التي وجدها، ووصلها إذا قلت نعم. لا توجد خطوة ربط منفصلة. بعد تثبيت أداة أخرى، شغّل kin setup مرة أخرى، ويعرض kin setup status ما هو موصول. على Windows، وصّل أدوات الذكاء الاصطناعي داخل WSL2.

يعمل البحث الدلالي على نموذج محلي بحجم يقارب 523 ميغابايت، ويسأل الإعداد قبل أن يُنزَّل أي شيء. إذا قلت لا، أو قال kin init إن فهرس البحث في انتظار النموذج، فإن هذا ينزّله ويبني الفهرس:

kin embed

يدعم Kin كلاً من Claude Code وCodex وCursor وGemini وعملاء MCP الآخرين. استخدم kin setup --intent editor لـ VS Code. يتضمن Kin أيضًا kin agent run لنقاط نهاية النماذج المحلية أو المستضافة المتوافقة مع OpenAI.

إعداد العميل · أدوات MCP · الوكيل المدمج

تعمل الاستيرادات المحلية والتخزين والاستعلامات على جهازك. يحتاج التثبيت والتنزيل الأولي لنموذج التضمين إلى اتصال بالشبكة. قبل أن تصبح التضمينات جاهزة، يستخدم kin locate إشارات معجمية ورسومًا بيانية ويبلّغ عن تغطية المتجهات المفقودة.

راجع تغييرًا

بعد تشغيل kin init على فرع Git الذي تريد مراجعته، قارن بصمات الإيداع الصريحة مقابل main:

kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"