kotobase
القائمة

المطوّرين

التفاصيل التقنية والمستندات القانونية وبعض خطوات الحساب لسه بالإنجليزي.

ابدأ باللغة وبروتوكول الجراف اللي تطبيقك بيستخدمه بالفعل.

خد توكن

مش محتاج كارت

اعمل جلسة بـ Passkey أو محفظة EIP-4361 SIWE. بعدين Kotobase بيصدر Biscuit قصير العمر مربوط بمستأجر واحد، جراف، حامل، انتهاء صلاحية، ومجموعة أذونات.

إيه هو KOTOBASE_TOKEN

الاعتماد الأساسي للـ 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

محتاج باباشكا وبيكتب بس على حسابك الخاص ~/.local.

SDKs

عملاء TypeScript، Python، وPHP بيشاركوا في نفس عقدة النقل والمصادقة.

بروتوكولات الاستعلام

Datomic Client API، SPARQL (بما فيهم توافق مسار HTTP بتاع RDF4J)، Cypher، Gremlin، وGraphQL بيتابعوا من خلال اكتشاف القدرات الصريحة واختبارات المطابقة.

الذكاء الاصطناعي والوكلاء

استخدم نقطة النهاية MCP على

https://kotobase.net/mcp

ضد نفس جراف المستأجر، أو شغل

kotobase mcp

عشان تطلع إعدادات العميل.

المعرفة المحلية أولاً

استورد أو مزامنة ثنائية الاتجاه لخزنة Obsidian مع الحفاظ على Markdown، frontmatter، و[[wikilinks]].

هندسة مستوى الاستعلام

أياتوري

أياتوري هو تركيب مستوى الاستعلام اللي بيحول اكتشاف المزود وكتل IPLD الثابتة إلى إسقاط دائم وقابل للاستعلام.

اقرأ مصدر وأي بي آي أياتوري

مسار القراءة المتصل

IPNI discovery → provider block fetch → CID verification → required Arrangement ranges → persistent cursor → Datalog

الاكتشاف مجرد تلميح للمزود. أياتوري مش بيعتبره دليل على الاسترجاع، صحة CID، أو تنفيذ الاستعلام.

حالة النشر الحالية

اعتبارًا من 30 أغسطس 2026، مسار طلب الاستعلام الإنتاجي المشترك kotobase.net متكون على ayatori.query، واسم قفل مكون الإنتاج هو ayatori.

ده تغيير في المستودع اللي بيخدم الإنتاج، مش في اللي بيحسبه: ayatori.query هو اسم مستعار على نفس الجسر. اكتشاف مزود IPNI وقراءات الكتل البعيدة الموثقة لسه مش بتتعمل على مسار الطلب.

حدود المكتبة والاعتمادات

المكتبة المسؤولية العلاقة المباشرة الحالة
أياتوري بينسق الاكتشاف، القراءات البعيدة الموثقة، المؤشرات الدائمة، وتجسيد الاستعلام. بيستخدم io-ipni-specs، io-ipld، arrangement، وkotobase. على مسار طلب الإنتاج؛ مسارات الاكتشاف والقراءة البعيدة مش عليه
io-ipni-specs بيحلل إعلانات IPNI ونتائج مزود التوجيه المفوض. بيرجع مرشحين للمزود؛ مش بيجيب أو يتحقق من الكتل. اعتماد أياتوري
io-ipld بيشفر ويفك تشفير روابط IPLD وبيتأكد من البلوكات مقابل CIDs المطلوبة. بيستخدمه Ayatori وstack الفهرس المستمر. اعتماد مكون الإنتاج
ترتيب بيخزن أربع فهارس تغطية كـ snapshots بعناوين CID وبيوفر قراءة المؤشر. بيستخدم prolly-tree، datom-source، وdatalog. اعتماد مكون الإنتاج
prolly-tree بيخزن عقد الفهرس المرتبة كبلوكات DAG-CBOR بعناوين المحتوى. بيوفر بحث، مسح بادئة، ومسح نطاق للترتيب. اعتماد مكون الإنتاج
datom-source بيعرف عقدة المؤشر المحايدة للتخزين اللي بيستخدمها مسارات الاستعلام. بيفصل تقييم الاستعلام عن تنفيذ تخزين معين. اعتماد مكون الإنتاج
datalog بيقيم Datalog على أربع فهارس تغطية؛ ملوش تخزين أو I/O شبكة. بيستهلك مصادر datom والفهارس اللي بيوفرها المستدعي. اعتماد مكون الإنتاج
kotobase-query جسر توافق من مخزن Kotobase المسطح لتجسيد Datalog. اسمين المساحات بتاعته اتنقلوا على ayatori، فالمستدعين اللي لسه بيسموهم بيستمروا في الحل. متجاوز؛ نفس أسماء المساحات دلوقتي بتتوزع من ayatori

تسميات الحالة بتوصف مكونات استعلام الإنتاج المشتركة اللي اتفحصت في 30 أغسطس 2026. تثبيت مصدر أو نجاح معيار مش بيثبت لوحده إن المكتبة بتخدم طلبات الإنتاج.

ابدأ البناء