技术详情、法律文件和部分账户流程仍使用英语。
从您的应用程序已经使用的语言和图协议开始。
使用 Passkey 或 EIP-4361 SIWE 钱包创建会话。Kotobase 然后颁发一个短期有效的 Biscuit，限制为单个租户、图、持有者、过期时间和权限集。
主要的 API 凭证是仅在 Passkey 或 SIWE 认证后颁发的短期有效 Biscuit。为您需要的确切图和权限请求它：
POST https://auth.kotobase.net/v1/biscuit/token
{"tenantId":"...","graph":"...","permissions":["data:write"]}
使用端点返回的完整授权值：
Authorization: Biscuit <token>
CACAO 和不透明的 Bearer 凭证仍然是仅用于迁移的兼容路径。
将返回的授权值直接传递给 TypeScript、Python 或 PHP SDK：
export KOTOBASE_TOKEN="Biscuit ..." && kotobase account-status
被拒绝的 Biscuit 永远不会作为 CACAO 或 Bearer 重试。
TypeScript、Python 和 PHP 客户端共享一个传输和认证契约。
Datomic 客户端 API、SPARQL（包括 RDF4J HTTP 路径兼容）、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 链接，并根据请求的 CID 验证块。 | 被 Ayatori 和持久索引栈使用。 | 生产组件依赖 |
| arrangement | 将四个覆盖索引持久化为 CID 地址快照，并暴露游标读取。 | 使用 prolly-tree、datom-source 和 datalog。 | 生产组件依赖 |
| prolly-tree | 将有序索引节点存储为内容寻址的 DAG-CBOR 块。 | 为 arrangement 提供查找、前缀扫描和范围扫描。 | 生产组件依赖 |
| datom-source | 定义查询路径使用的存储中立模式游标契约。 | 将查询评估与特定存储实现分离。 | 生产组件依赖 |
| datalog | 在四个覆盖索引上评估 Datalog；它不拥有存储或网络 I/O。 | 使用调用者提供的 datom 源和索引。 | 生产组件依赖 |
| kotobase-query | 从扁平 Kotobase 存储到 Datalog 物化的兼容桥梁。 | 它的两个命名空间由 ayatori 承载，因此仍然命名它们的调用者继续解析。 | 已被取代；相同的命名空间现在由 ayatori 提供 |
状态标签描述了 30 八月 2026 检查的共享生产查询组件。源代码固定或通过基准测试本身并不能证明库服务于生产请求。