פרטים טכניים, מסמכים משפטיים וחלק מתהליכי החשבון עדיין באנגלית.
התחילו עם השפה ופרוטוקול הגרפים שבהם היישום שלכם כבר משתמש.
צרו סשן באמצעות Passkey או ארנק SIWE של EIP-4361. לאחר מכן 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 ומאמת בלוקים מול מזהי התוכן המבוקשים. | בשימוש של Ayatori ושל מחסנית האינדקס המתמשכת. | תלות של רכיב הייצור |
| arrangement | מתמיד ארבעה אינדקסים מכסים כתצלומי מצב בעלי כתובות CID וחושף קריאות סמן. | משתמש ב-prolly-tree, במקור-datom וב-datalog. | תלות של רכיב הייצור |
| prolly-tree | מאחסן צומתי אינדקס מסודרים כבלוקי DAG-CBOR בעלי כתובת המבוססת על תוכן. | מספק חיפוש, סריקת קידומת וסריקת טווח לסידור. | תלות של רכיב הייצור |
| datom-source | מגדיר את חוזה הסמן לתבניות, בלתי תלוי באחסון, המשמש נתיבי שאילתה. | מפריד את הערכת השאילתה ממימוש אחסון מסוים. | תלות של רכיב הייצור |
| datalog | מעריך Datalog על פני ארבעה אינדקסים מכסים; אין בבעלותו קלט/פלט של אחסון או רשת. | צורך מקורות datom ואינדקסים שסופקו על ידי הקורא. | תלות של רכיב הייצור |
| kotobase-query | גשר תאימות מהמאגר השטוח Kotobase למימוש Datalog. | שני מרחבי השמות שלו נישאים על ידי ayatori, כך שקוראים שעדיין מציינים אותם ממשיכים להיפתר. | הוחלף; אותם מרחבי שמות נשלחים כעת מ-ayatori |
תוויות הסטטוס מתארות את רכיבי השאילתה המשותפים בסביבת הייצור שנבדקו ב-30 באוגוסט 2026. הצמדת מקור או אמת מידה שעוברת אינם מוכיחים כשלעצמם שספרייה משרתת בקשות ייצור.