用途:为 Quartz 的 IEventStore 及其 SQLite 参考实现定义权威行为契约,把可观测行为写成具名编号规则,使下游实现(如仓库内文件系统存储、外部 Vespa 存储等)出现一致性偏差时可直接查表定位,而非翻查 QueryBuilder/MergeQueryExecutor。规则以代码为准,若与测试冲突以测试为准。
主要能力与覆盖范围:过滤匹配(STORE-F)、写入路径(STORE-W)、删除生命周期含 NIP-09/NIP-62(STORE-D)、NIP-45 计数(STORE-C)、NIP-50 存储内搜索(STORE-S)。关键文件包括 IEventStore.kt(KDoc 具规范性)、sqlite/EventStore.kt、SQLiteEventStore.kt、QueryBuilder.kt、MergeQueryExecutor.kt、EventIndexesModule.kt、TagNameValueHasher.kt、ReplaceableModule.kt、AddressableModule.kt 及各删除/过期/消失/全文检索模块,还有 sqlite/README.md。
要点示例:since/until 均为包含;ids/authors 仅精确匹配 64 位十六进制,不支持前缀;同一标签名下取值 OR、不同标签名间 AND,tagsAll 逐值要求存在;默认只索引单字母标签名;#d 走 d_tag 列且有已知不一致;标签与作者匹配基于 64 位 MurmurHash3,理论存在极小误命中;多过滤器为去重并集且 limit 按过滤器计算,无全局 limit;默认排序 created_at DESC,同一秒顺序未定义;空过滤器匹配全部但删除为空操作;可替换/可寻址事件按最新获胜、同时间取最小 id;临时事件不入库但确认接受;过期在写入时与清扫时强制,查询时不过滤;GiftWrap 归属收件人;行不可变,更新被触发器中止;批量插入逐行 SAVEPOINT;kind-5 的 id 删除无时间条件、地址删除为含等;重新插入阻断存在不对称;kind-5 可删除 kind-5 并解除阻断(已知怪癖);NIP-62 消失按 relay 范围、删除严格小于而阻断含等。
用法与限制:下游实现按 commit 固定 Quartz,升级时对照本文件审查;修改存储行为需在同一 PR 更新规则与 changelog。官方文本未提供,具体命令、安装方式及收费信息暂未提供。