لا تزال التفاصيل التقنية والوثائق القانونية وبعض إجراءات الحساب باللغة الإنجليزية.
ابدأ بالبروتوكول اللغوي والبروتوكول البياني الذي يستخدمه تطبيقك بالفعل.
أنشئ جلسة باستخدام Passkey أو محفظة EIP-4361 SIWE. ثم تصدر Kotobase Biscuit قصير العمر مقيد بمستأجر واحد، رسم بياني، حامل، انتهاء صلاحية، ومجموعة أذونات.
بيانات اعتماد API الأساسية هي Biscuit قصير العمر يصدر فقط بعد مصادقة Passkey أو SIWE. اطلبه للرسم البياني والأذونات التي تحتاجها بالضبط:
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 من خلال اكتشاف القدرات الصريحة واختبارات المطابقة.
استخدم نقطة نهاية MCP على
https://kotobase.net/mcp
ضد نفس رسم المستأجر البياني، أو شغّل
kotobase mcp
لإصدار تكوين العميل.
استورد أو قم بمزامنة ثنائية الاتجاه لخزنة Obsidian مع الحفاظ على Markdown و frontmatter و [[wikilinks]].
Ayatori هو تركيب مستوى الاستعلام الذي يحول اكتشاف المزود وكتل IPLD غير القابلة للتغيير إلى إسقاط دائم وقابل للاستعلام.
IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog
الاكتشاف هو مجرد تلميح مزود. لا يعامل Ayatori ذلك كدليل على الاسترجاع أو صلاحية CID أو تنفيذ الاستعلام.
اعتبارًا من 30 أغسطس 2026، يتكون مسار طلب الاستعلام الإنتاجي المشترك kotobase.net من ayatori.query، وأسماء قفل مكونات الإنتاج ayatori.
هذا تغيير في المستودع الذي يخدم الإنتاج، وليس في ما يحسبه: ayatori.query هو مساحة أسماء بديلة على نفس الجسر. لا يزال اكتشاف مزود IPNI وقراءات الكتل البعيدة الموثقة غير منفذة على مسار الطلب.
| المكتبة | المسؤولية | العلاقة المباشرة | الحالة |
|---|---|---|---|
| ayatori | ينسق الاكتشاف، القراءات البعيدة الموثقة، المؤشرات الدائمة، وتجسيد الاستعلام. | يستخدم io-ipni-specs و io-ipld و arrangement و kotobase. | على مسار طلب الإنتاج؛ لا يتم تنفيذ مستويي الاكتشاف والقراءة البعيدة الخاصين به |
| io-ipni-specs | يحلل إعلانات IPNI ونتائج مزود التوجيه المفوض. | يعيد مرشحي المزودين؛ لا يجلب أو يتحقق من الكتل. | اعتماد Ayatori |
| io-ipld | يشفر ويفك تشفير روابط IPLD ويتحقق من الكتل مقابل CIDs المطلوبة. | يستخدمه Ayatori وطبقة الفهرس الدائم. | اعتماد مكون الإنتاج |
| arrangement | يحفظ أربعة فهارس تغطية كلقطات موجهة بواسطة CID ويعرض قراءات المؤشر. | يستخدم prolly-tree و datom-source و datalog. | اعتماد مكون الإنتاج |
| prolly-tree | يخزن عقد الفهرس المرتبة ككتل DAG-CBOR موجهة بالمحتوى. | يوفر البحث، ومسح البادئة، ومسح النطاق لـ arrangement. | اعتماد مكون الإنتاج |
| datom-source | يحدد عقد مؤشر النمط المحايد للتخزين المستخدم بواسطة مسارات الاستعلام. | يفصل تقييم الاستعلام عن تنفيذ تخزين معين. | اعتماد مكون الإنتاج |
| داتالوج | يقيم Datalog عبر أربعة فهارس تغطية؛ لا يمتلك تخزينًا أو إدخال/إخراج شبكة. | يستهلك مصادر الداتوم والفهارس التي يزودها المستدعي. | اعتماد مكون الإنتاج |
| kotobase-query | جسر التوافق من مخزن Kotobase المسطح إلى تجسيد Datalog. | تحمل مساحتا الأسماء الخاصتان به بواسطة ayatori، لذا يستمر المستدعون الذين لا يزالون يسمونها في الحل. | تم استبداله؛ نفس مساحات الأسماء تُشحن الآن من ayatori |
تصف تسميات الحالة مكونات استعلام الإنتاج المشتركة التي تم فحصها في 30 أغسطس 2026. لا يثبت تثبيت مصدر أو اجتياز معيار بمفرده أن مكتبة تخدم طلبات الإنتاج.