Struct KnowledgeBase 

pub struct KnowledgeBase { /* private fields */ }

Clone shares one process-local engine. Close invalidates all its handles.

Implementations

impl KnowledgeBase

pub fn open(directory: impl AsRef<Path>) -> Result<Self>

pub fn directory(&self) -> &Path

pub fn close(&self) -> Result<()>

pub fn memories(&self) -> MemoryStore

pub fn graph(&self) -> GraphStore

pub fn notes(&self) -> NoteStore

pub fn embeddings(&self) -> EmbeddingStore

pub fn update_index(&self) -> Result<HealthReport>

追平待索引队列：把写入累积的待办一趟索引完、只提交一次。 写入不再就地索引，使用方（尤其批量导入）在合适时机调用本方法即可； 期间读取走 sync_index_if_behind 自愈兜底。

pub fn register_event_sink<F: Fn(&LogEvent) + Send + Sync + 'static>( &self, sink: F, )

注册事件接收回调。库在检索线程里同步调用它，所以回调必须非阻塞—— 在里面做同步 IO 或网络上报，会把检索拖住，和慢的重排回调一样。 回调抛错只丢这一条事件，不影响检索。不注册就完全不产出事件。

pub fn unregister_event_sink(&self) -> bool

注销事件接收回调，返回此前是否有注册。

pub fn event_sink_registered(&self) -> bool

当前是否注册了事件接收回调。

pub fn rebuild_indexes(&self) -> Result<HealthReport>

pub fn rebuild_progress(&self) -> Result<RebuildProgressReport>

读一次全文索引重建的进度快照。纯原子读、不碰写锁，可在重建进行时从另一线程轮询。

pub fn health(&self) -> Result<HealthReport>

pub fn backup(&self, target: impl AsRef<Path>) -> Result<()>

Consistent SQLite snapshot, including embeddings. Refuses to overwrite a file.

pub fn restore( snapshot: impl AsRef<Path>, directory: impl AsRef<Path>, ) -> Result<Self>

Restores to a new directory; search indexes are rebuilt from the snapshot.

impl KnowledgeBase

pub fn register_reranker<F: Reranker + 'static>( &self, reranker: F, ) -> Result<()>

注册重排回调。调用前按声明的定长约束强制截断，宿主不自己重排。

pub fn register_reranker_with<F: Reranker + 'static>( &self, reranker: F, options: RerankerOptions, ) -> Result<()>

pub fn unregister_reranker(&self) -> bool

pub fn reranker_registered(&self) -> bool

pub fn search(&self, request: &SearchRequest) -> Result<SearchResult>

pub fn search_with_context( &self, request: &SearchRequest, limit: usize, ) -> Result<Vec<ContextualHit>>

先按 request 检索，再给每条命中挂上它在图上所在实体的邻域（实体 + 关系）。

「挂载」靠标签文本：命中的记录所带的 tag，与同一 namespace / scope 内某实体的名字或别名 文本相同，就认为该记录挂在这个实体上（两者都落在 strings 表，同一套归一化）。 limit 是每个实体邻域的规模上限。命中记录若没有命中任何实体，返回空邻域。

impl KnowledgeBase

pub fn search_preset(&self, request: &PresetRequest) -> Result<PresetResult>

按预设检索。三个字段各自独立排序，互不挤占。

Trait Implementations

impl Clone for KnowledgeBase

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.