لا تزال التفاصيل التقنية والوثائق القانونية وبعض إجراءات الحساب باللغة الإنجليزية. هذه نسخة عربية فصحى للوسم الإقليمي المغربي؛ مراجعة الدارجة معلّقة.
بدا باللغة وبروتوكول graph اللي كيستعملهم التطبيق ديالك دابا.
صايب جلسة باستعمال Passkey ولا محفظة SIWE ديال EIP-4361. من بعد، Kotobase كيصدر Biscuit قصير المدة ومقيّد بواحد الـtenant، والـgraph، والـholder، ومدة الصلاحية، ومجموعة الصلاحيات.
الاعتماد الأساسي ديال API هو Biscuit قصير المدة، كيتصدر غير من بعد المصادقة بـ Passkey ولا SIWE. طلبو بالضبط للـgraph والصلاحيات اللي محتاج:
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
استعمل قيمة التفويض كاملة اللي رجعاتها نقطة النهاية:
Authorization: Biscuit <token>
CACAO واعتمادات Bearer غير الشفافة باقين غير مسارات توافقية مؤقتة للهجرة.
دوز قيمة التفويض اللي رجعات مباشرة لـ SDK ديال TypeScript ولا Python ولا PHP:
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
Biscuit مرفوض ما كيتعاودش المحاولة ديالو كـ CACAO ولا Bearer.
سطّب CLI بأمر واحد:
curl -fsSL https://kotobase.net/install.sh | sh
كيحتاج babashka وكيكتب غير فـ ديالك ~/.local.
العملاء ديال TypeScript وPython وPHP كيتشاركو نفس النقل ونفس عقد المصادقة.
Datomic Client API، SPARQL (بما فيه توافق مسار HTTP ديال RDF4J)، Cypher، Gremlin، وGraphQL كيتتبّعو عبر اكتشاف صريح للقدرات واختبارات المطابقة.
استعمل endpoint ديال MCP فـ
https://kotobase.net/mcp
مقابل نفس گراف ديال التينانت، ولا شغّل
kotobase mcp
باش يخرّج إعدادات الكليان.
دخّل ولا دير مزامنة فالاتجاهين مع خزنة Obsidian مع الحفاظ على Markdown وfrontmatter و[[wikilinks]].
Ayatori هو التركيب ديال طبقة الاستعلام اللي كيحوّل اكتشاف المزوّد وكتل IPLD غير القابلة للتغيير إلى projection دائمة وقابلة للاستعلام.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
الاكتشاف غير تلميح على المزوّد. Ayatori ما كيتعاملاش معاه كدليل على الاسترجاع، ولا على صحة CID، ولا على تنفيذ الاستعلام.
حتى لـ 30 غشت 2026، مسار طلبات الاستعلام فالإنتاج المشترك ديال kotobase.net كيتكوّن على ayatori.query، وlock ديال مكوّنات الإنتاج كيسمّي ayatori.
هادشي تغيير فاشمن repository كيوفّر الإنتاج، ماشي فشنو كيحسب: ayatori.query هو namespace alias فوق نفس الجسر. اكتشاف المزوّدين ديال IPNI والقراية الموثَّقة ديال البلوكات من بعيد مازال ما كيدوزوش فمسار الطلب.
| المكتبة | المسؤولية | العلاقة المباشرة | الحالة |
|---|---|---|---|
| ayatori | كينسّق الاكتشاف، والقراية الموثَّقة من بعيد، والمؤشرات الدائمة، وتحضير نتائج الاستعلامات. | كيستعمل io-ipni-specs وio-ipld وarrangement و kotobase. | فمسار طلبات الإنتاج؛ طائرات الاكتشاف والقراية من بعيد ديالو ماشي |
| io-ipni-specs | كيفلّل إعلانات IPNI ونتائج المزوّدين ديال التوجيه المفوَّض. | كيرجّع المرشحين ديال المزوّدين؛ ما كيجبدش البلوكات وما كيتحقّقش منها. | اعتمادية Ayatori |
| io-ipld | كيشفّر وكيحلّ IPLD ديال الروابط، وكيتحقّق من البلوكات مقابل CIDs المطلوبة. | كيستعملو Ayatori وstack ديال الفهرس الدائم. | اعتمادية مكوّنات الإنتاج |
| arrangement | كيحفظ ربعة ديال الفهارس الشاملة كلقطات معنونة بـ CID، وكيكشف على قرايات cursor. | كيستعمل prolly-tree و datom-source و datalog. | اعتمادية مكوّنات الإنتاج |
| prolly-tree | كيخزّن العُقَد ديال الفهارس المرتّبة فـ بلوكات DAG-CBOR معنونة بالمحتوى. | كيوفّر البحث، والمسح ديال البادئة، والمسح ديال النطاق لـ arrangement. | اعتمادية مكوّنات الإنتاج |
| datom-source | كيحدّد العقد ديال cursor ديال الأنماط المحايد للتخزين، اللي كيتستعمل فمسارات الاستعلام. | كيفصل تقييم الاستعلام على أي تطبيق معيّن ديال التخزين. | اعتمادية مكوّنات الإنتاج |
| datalog | كيقيّم Datalog فوق ربعة ديال الفهارس الشاملة؛ وماعندوش حتى تخزين ولا إدخال/إخراج ديال الشبكة. | كيستهلك مصادر datom والفهارس اللي كيزوّد بيها المستعمل. | اعتمادية مكوّنات الإنتاج |
| kotobase-query | جسر ديال التوافق من مخزن Kotobase المسطّح لمادّة Datalog. | الـ namespaces بجوج ديالو كيتحملو من طرف ayatori، وداكشي علاش المستعملين اللي مازال كيسمّيوهم كيبقاو كيلقاوهم. | تجاوزاتو الإصدارات الجديدة؛ نفس الـ namespaces دابا كيتوزّعو من ayatori |
كتوصف تسميات الحالة مكوّنات الاستعلام المشتركة فالإنتاج، اللي تفتّشنا فيها نهار 30 غشت 2026. تثبيت المصدر ولا نجاح benchmark بوحدو ماكيبرهنش بلي مكتبة كتخدم طلبات الإنتاج.