kin v0.4.8

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

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

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

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

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

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

اكتشف ما يترابط

قبل تغيير دالة مشتركة، ما الذي ينبغي عليك فحصه أيضًا؟ يتيح لك Kin البحث عن مستدعيها المسجّلين واستكشاف الشيفرة ذات الصلة. يستعلم كلٌّ من CLI وخادم MCP من الرسم البياني نفسه، بحيث يمكنك أنت ووكيلك العمل انطلاقًا من السجل نفسه.

مسجّل على رسم بياني مُهيَّأ لـ ripgrep عند e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. مخرجات التشغيل الخام ليست عامة. هذا يوضّح سير عمل، وليس مقياسًا للأداء.

استخدمه من Claude Code أو Codex أو Cursor

بالنسبة إلى Claude Code:

/plugin marketplace add kinlab-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/stores، ولا يكتب شيئًا داخل المستودع؛ ويطبع kin store path مكان مخزن نسخة العمل. افتراضيًا، يقبل أولًا الالتزام المستخرَج، فتُجاب الأسئلة بمجرد قراءة تلك الشجرة، ثم يستورد كل التزام تصل إليه فروعك ووسومك في الخلفية، بأولوية منخفضة؛ ويستورد kin init --history full السجل كاملًا مسبقًا، بينما لا يستورده --history none أبدًا. يستغرق استيراد السجل وقتًا وذاكرة ومساحة قرص تنمو مع السجل لا مع حجم نسخة العمل. قبل أن يبدأ، يتحقق kin init من الذاكرة والمساحة الحرة على القرص ويتوقف مع عرض الأرقام عندما يستطيع أن يتبيّن مسبقًا أن الجهاز يعاني نقصًا. لا تقبل نسخة الاستنساخ السطحية (shallow clone) سوى الالتزام المستخرَج، ولا تُدعم الوحدات الفرعية و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 وتضيف ذلك الدليل إلى ملف تعريف shell الخاص بك للجلسات الجديدة:

exec "$SHELL" -l

على Windows x64 الأصلي، ثبّت من PowerShell باستخدام irm https://get.kinlab.dev/install.ps1 | iex. يثبّت هذا الأمر أداة kin CLI ولا يربط أدوات البرمجة بالذكاء الاصطناعي، لأن 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.

يتحقق kin runtime status --json من التثبيت المشترك لواجهة سطر الأوامر (CLI) والخدمة الخلفية (daemon)، بما في ذلك هوية المصدر الدقيقة لهما. ترفض الأوامر العادية الأزواج غير المتطابقة؛ وتستخدم إصدارات التطوير حالة معزولة. راجع تثبيت وقت التشغيل.

يعمل الاسترجاع البياني والمعجمي دون نموذج. التضمينات وإعادة الترتيب اختيارية، ومزوّدو النماذج الخاصة بها افتراضيًا على none. تتضمن إصدارات CLI والخدمة الخلفية القياسية دعم نماذج HTTP الخارجية. تتطلب النماذج المدمجة إصدارًا بُني مع تمكين الاستدلال المحلي الاختياري.

لبناء فهرس تضمينات باستخدام نقطة نهاية متوافقة مع OpenAI تشغّلها أنت: